docs/org.eclipse.wst.wsdl.ui.doc.user/tasks/tsetbind.dita

<?xml version="1.0" encoding="utf-8"?>
<!--Arbortext, Inc., 1988-2006, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
 "task.dtd">
<task id="tsetbind" xml:lang="en-us">
<title>Setting a binding</title>
<shortdesc>A binding is a top level WSDL object that provides a concrete specification
regarding the transmission of messages to and from a web service. A binding
references exactly one port type. The structure of a binding corresponds very
closely to that of the port type. The binding contains extensibility elements
(for example, SOAP, http, and mime) that specify protocol specific details.
Each port within a service references exactly one binding.</shortdesc>
<prolog><metadata>
<keywords><indexterm>Web services<indexterm>bindings<indexterm>creating</indexterm></indexterm><indexterm>setting
WSDL bindings</indexterm></indexterm><indexterm>WSDL files<indexterm>bindings</indexterm></indexterm>
</keywords>
</metadata></prolog>
<taskbody>
<context><p>You can create a binding by right clicking in any blank space
in the Design view and selecting <uicontrol>Add Binding</uicontrol>. You can
create a new binding, reuse an existing one, or import one. </p></context>
</taskbody>
<task id="createnewbind">
<title>Creating a new binding</title>
<taskbody>
<context><p>To create a new binding for your port, complete the following
steps:</p></context>
<steps>
<step><cmd>In the Design view, right-click your port and click <b>Set Binding
> New Binding</b>.</cmd></step>
<step><cmd>In the <b>Name</b> field, type the name of the binding.</cmd><info>The
name should be unique among all bindings defined within the enclosing WSDL
document. Click <b>OK.</b> To select the new binding, click the binding object.</info>
</step>
<step><cmd>Type any information about the binding you want the user to read
in the <b>Documentation</b> pane.</cmd></step>
</steps>
<result><note>A <b>PortType</b> is a named set of abstract operations and
the abstract messages involved. You can either create a new port type for
your binding, reuse an existing one, or import one. For more information,
see <xref format="html" href="../tasks/tsetprtt.dita" scope="peer">Setting
a Port Type</xref>.</note><note type="tip">You can also create a new binding
for your port using the Outline view. Right click on the <uicontrol>Bindings</uicontrol> folder
and select <uicontrol>Add Binding</uicontrol>.</note></result>
</taskbody>
</task>
<task id="reusebinding">
<title>Reusing a binding for a port</title>
<taskbody>
<context><p>To reuse a binding for your port, complete the following steps:</p></context>
<steps>
<step><cmd>In the Design view, select your port.</cmd></step>
<step><cmd>In the Properties view, click the <b>General</b> pane.</cmd></step>
<step><cmd>From the <b>Binding</b> drop down list, select the binding you
want to use.</cmd></step>
</steps>
</taskbody>
</task>
<task id="regeneratingabinding">
<title>Regenerating a binding</title>
<taskbody>
<context>To regenerate a binding, complete the following steps:</context>
<steps>
<step><cmd>Right-click the binding you want to regenerate.</cmd></step>
<step><cmd>Select <uicontrol>Generate Binding Content</uicontrol>.</cmd></step>
<step><cmd>Specify the required binding information. If you are modifying
an existing binding, select the <uicontrol>Overwrite existing binding information</uicontrol> check
box.</cmd></step>
</steps>
</taskbody>
</task>
<task id="impbinding">
<title>Import an existing binding</title>
<taskbody>
<context>To import an existing binding for your port, complete the following
steps:</context>
<steps>
<step><cmd>In the Design view, right-click your port and click  <b>Set Binding
> Existing Binding.</b></cmd></step>
<step importance="optional"><cmd>In the <b>Name</b> field, type a search string
to filter the list or leave the field blank to view all.</cmd></step>
<step><cmd>You can import a binding by selecting one of the following options:</cmd>
<choices>
<choice><b>Workspace</b>: lists the bindings available in your workspace.</choice>
<choice><b>Enclosing Project</b>: lists the bindings available in the project
that contains your file.</choice>
<choice><b>Current Resource</b>: lists the binding types available in your
current file.</choice>
<choice><b>Working Sets</b>: lists the bindings available in a specified set
of files. To specify a working set, click <b>Choose</b>. You can select files
from an existing working set or create a new working set. Once you have selected
the files, click <b>OK</b>.</choice>
</choices>
</step>
<step><cmd>The bindings will be listed. Select one and click <b>OK</b>. In
the Design view, click the binding object.</cmd></step>
<step><cmd>In the Properties view, type any information about the binding
you wish the user to read in the <b>Documentation</b> pane.</cmd></step>
</steps>
</taskbody>
<related-links>
<linklist><title>Related concepts</title>
<link href="../concepts/cwsdled.dita" scope="local"></link>
</linklist>
<linklist><title>Related tasks</title>
<link href="tcrtwsdl.dita" scope="local"></link>
<link href="tedtwsdl.dita" scope="local"></link>
</linklist>
</related-links>
</task>
</task>