| <?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <meta name="copyright" content="(C) Copyright IBM Corporation 2005" /> |
| <meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" /> |
| <meta name="security" content="public" /> |
| <meta name="Robots" content="index,follow" /> |
| <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 name="DC.Type" content="task" /> |
| <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 name="DC.Relation" scheme="URI" content="../concepts/cwsdled.html" /> |
| <meta name="DC.Relation" scheme="URI" content="tcrtwsdl.html" /> |
| <meta name="DC.Relation" scheme="URI" content="tedtwsdl.html" /> |
| <meta name="DC.Relation" scheme="URI" content="../tasks/tedtwsdl.html" /> |
| <meta name="DC.Format" content="XHTML" /> |
| <meta name="DC.Identifier" content="taddmess" /> |
| <meta name="DC.Language" content="en-us" /> |
| <!-- All rights reserved. Licensed Materials Property of IBM --> |
| <!-- US Government Users Restricted Rights --> |
| <!-- Use, duplication or disclosure restricted by --> |
| <!-- GSA ADP Schedule Contract with IBM Corp. --> |
| <link rel="stylesheet" type="text/css" href="../ibmdita.css" /> |
| <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 > 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 outside Rational Developer products 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 outside Rational Developer products into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div> |
| </div> |
| </body> |
| </html> |