blob: 769aa0d523730df739bf931f60b3958076153a3b [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="(C) Copyright 2005" />
<meta name="DC.rights.owner" content="(C) Copyright 2005" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="task" name="DC.Type" />
<meta name="DC.Title" content="Adding a message" />
<meta name="abstract" content="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)." />
<meta name="description" content="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)." />
<meta scheme="URI" name="DC.Relation" content="../tasks/tedtwsdl.html" />
<meta scheme="URI" name="DC.Relation" content="../concepts/cwsdled.html" />
<meta scheme="URI" name="DC.Relation" content="tcrtwsdl.html" />
<meta scheme="URI" name="DC.Relation" content="tedtwsdl.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="taddmess" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/commonltr.css" type="text/css" rel="stylesheet" />
<title>Adding a message</title>
</head>
<body id="taddmess"><a name="taddmess"><!-- --></a>
<h1 class="topictitle1">Adding a message</h1>
<div><p>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).</p>
<div class="section"><p>If you want to create a new message for your input, output, or
fault element, follow these steps: </p>
</div>
<ol>
<li class="stepexpand"><span>In the Graph view, right-click your input, output, or fault element
and click <strong>Set Message.</strong></span></li>
<li class="stepexpand"><span>Select the <strong>Create a new message</strong> radio button.</span></li>
<li class="stepexpand"><span>Type the name of the message in dialog.</span> This name should
be a unique amongst all messages defined within the enclosing WSDL document.
Click <strong>OK</strong>.</li>
<li class="stepexpand"><span>The new message will appear in the graph view within the messages
section.</span> An line should be visible connecting the input, output
or fault with the message.</li>
</ol>
<div class="section"><p> <strong>Note</strong>: 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).</p>
<p> <strong>Tip</strong>: You can also create a new message for your input,
output, or fault element using the Outline view. Under the <strong>Port Types</strong>
folder, right-click your element and click <strong>Set Message &gt; Create a new
message</strong>. Your message will appear in the Outline view under the <strong>Messages</strong> folder. </p>
<p>If
you want to reuse a message for your input, output, or fault element, follow
these steps: </p>
<ol>
<li>In the Graph view, right-click your input, output, or fault element and
click <strong>Set Message.</strong></li>
<li>Press the <span class="uicontrol">Select an existing message</span> radio button.</li>
<li>The existing messages will be listed. Select one and click <strong>Finish</strong>.</li>
</ol>
<p>If you want to import an existing message for your input, output,
or fault element, follow these steps:</p>
<ol>
<li>In the Graph view, right-click your input, output, or fault element and
click <strong>Set Message.</strong></li>
<li>Select the <strong>Import message from a file</strong> check box. Click <strong>Browse</strong>.</li>
<li>Select the file that contains the message you want to use. Click <strong>OK</strong>.</li>
<li>The messages in the file will be listed. Select one and click <strong>Finish</strong>.</li>
</ol>
<p>You can now add parts to your message. Parts are a flexible mechanism
for describing the logical abstract content of a message.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../tasks/tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div>
</div>
<div class="linklist"><strong>Related concepts</strong><br />
<div><a href="../concepts/cwsdled.html" title="The WSDL editor allows you to easily and graphically create, modify, view, and validate WSDL files.">Editing WSDL files with the WSDL Editor</a></div></div>
<div class="linklist"><strong>Related tasks</strong><br />
<div><a href="tcrtwsdl.html" title="You can create a new, empty WSDL file, then edit it using the WSDL editor.">Creating a new WSDL file</a></div>
<div><a href="tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
</div>
</body>
</html>