|
Adding a message
Messages represent an abstract definition of the data being transmitted.
A message consists of logical parts, each of which is associated with a definition
within some type system. WSDL messages are top level objects that can be referenced
by an operation's input, output and fault elements (within a port type).
You can create a message using the Outline view by right-clicking
the Messages folder and clicking Add Message.
To create
a new message for your input, output, or fault element, complete the following
steps:
-
In the Design view, right-click your input, output, or fault element
and click Set Message > New Message.
-
Type the name of the message in the General pane
of the Properties view. This name should be a unique amongst all
messages defined within the enclosing WSDL document.
-
The new message will appear in the Design view within the port
type.
Note: Messages are referenced within a port type (specifically
by an operation's input, output and fault objects). The input, output and
fault objects within a binding do not reference messages. Hence you cannot
create a new message by right clicking on a input, output, or fault within
a binding (these are also known as binding input, binding output and binding
faults).
Tip: You can also create a new message for your input,
output, or fault element using the Outline view. Under the Port Types folder,
right-click your element and click Set Message > Add Message. Your
message will appear in the Outline view under the Messages folder.
Reusing a message
To reuse a message for your input, output, or fault element, complete
the following steps:
-
In the Design view, right-click your input, output, or fault element
and click Set Message > Existing Message.
-
In the Name field, type a search string to filter the list
or leave the field blank to view all
-
You can change the scope of the list by selecting one of the following
options:
-
Workspace: lists the messages available in your workspace.
-
Enclosing Project: lists the messages available in the project
that contains your file.
-
Current Resource: lists the messages available in your current
file.
-
Working Sets: lists the messages available in a specified set of
files. To specify a working set, click Choose. You can select files
from an existing working set or create a new working set. Once you have selected
the files, click OK.
-
The existing messages will be listed. Select one and click OK.
Importing a message
If you want to import an existing message for your input, output,
or fault element, follow these steps:
-
In the Design view, right-click your input, output, or fault element
and click Set Message > Existing Message.
-
In the Name field, type a search string to filter the list
or leave the field blank to view all.
-
You can import a message by selecting one of the following options:
-
Workspace: lists the messages available in your workspace.
-
Enclosing Project: lists the messages available in the project
that contains your file.
-
Working Sets: lists the messages available in a specified set of
files. To specify a working set, click Choose. You can select files
from an existing working set or create a new working set. Once you have selected
the files, click OK.
-
The messages will be listed. Select one and click OK.
You can now add parts to your message. Parts are a flexible mechanism
for describing the logical abstract content of a message. For more information,
see
Adding a part to a message.
|
|