xml.wsdlui/javahelp/org/netbeans/modules/xml/wsdlui/docs/wsdl_editor_partner_types.html
author Milutin Kristofic <mkristofic@netbeans.org>
Tue, 31 Jan 2017 14:20:36 +0100
changeset 1584 ddcac47bfed1
parent 1241 f7c3471c4a3f
permissions -rw-r--r--
Added Missing license terms
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
     2 <!--
     3 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
     4 
     5 Copyright 2009-2017 Oracle and/or its affiliates. All rights reserved.
     6 
     7 Oracle and Java are registered trademarks of Oracle and/or its affiliates.
     8 Other names may be trademarks of their respective owners.
     9 
    10 The contents of this file are subject to the terms of either the GNU
    11 General Public License Version 2 only ("GPL") or the Common
    12 Development and Distribution License("CDDL") (collectively, the
    13 "License"). You may not use this file except in compliance with the
    14 License. You can obtain a copy of the License at
    15 http://www.netbeans.org/cddl-gplv2.html
    16 or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
    17 specific language governing permissions and limitations under the
    18 License.  When distributing the software, include this License Header
    19 Notice in each file and include the License file at
    20 nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
    21 particular file as subject to the "Classpath" exception as provided
    22 by Oracle in the GPL Version 2 section of the License file that
    23 accompanied this code. If applicable, add the following below the
    24 License Header, with the fields enclosed by brackets [] replaced by
    25 your own identifying information:
    26 "Portions Copyrighted [year] [name of copyright owner]"
    27 
    28 Contributor(s):
    29 
    30 The Original Software is NetBeans. The Initial Developer of the Original
    31 Software is Sun Microsystems, Inc. Portions Copyright 2009-2010 Sun
    32 Microsystems, Inc. All Rights Reserved.
    33 
    34 If you wish your version of this file to be governed by only the CDDL
    35 or only the GPL Version 2, indicate your decision by adding
    36 "[Contributor] elects to include this software in this distribution
    37 under the [CDDL or GPL Version 2] license." If you do not indicate a
    38 single choice of license, a recipient has the option to distribute
    39 your version of this file under either the CDDL, the GPL Version 2 or
    40 to extend the choice of license to its licensees as provided above.
    41 However, if you add GPL Version 2 code and therefore, elected the GPL
    42 Version 2 license, then the option applies only if the new code is
    43 made subject to such option by the copyright holder.
    44 -->
    45 
    46 <html>
    47 
    48 <head>
    49 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    50 <title>Creating Partner Link Types Using the Partner View</title>
    51 <link rel="stylesheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
    52 </head>
    53 
    54 <body>
    55 
    56 <h2>Creating Partner Link Types Using the Partner View</h2>
    57 
    58 <p><small><a href="#seealso">See Also</a></small></p>
    59 
    60 <p>The Partner Link Types area in the Partner view contains one configuration box for each partner link type in the WSDL file.</p>
    61 
    62 <p>A partner link type can have one role or two roles. The first role appears in the right side of the configuration box. 
    63 If included, the second role appears in the left side of the configuration box.</p>
    64 
    65 <p>The role's port type appears below the role. A port type has one or more operations, which are illustrated in the area below the port types. 
    66 A solid horizontal arrow indicates an input message. A dashed horizontal arrow indicates an output message.</p>
    67 
    68 <p>If the operation is a request-response operation, then you can optionally add a fault. 
    69 A dashed horizontal arrow indicates a fault message.</p>
    70 
    71 <ul class="note">
    72   <li>The configuration box resembles a sequence diagram in Unified Modeling Language (UML).</li>
    73 </ul>    
    74 
    75 <p>Partner link types from imported WSDL files do not appear in the Partner view.</p>
    76 
    77 
    78 
    79 <p><b>To create a partner link type with one role:</b></p>
    80 
    81 <ul class="note">
    82   <li>If the WSDL file contains a port type that is not associated with a partner link type, 
    83     then the Auto Create button appears in the Partner Link Types area. 
    84     To generate a partner link type that references the port type, click Auto Create.</li>
    85 </ul>
    86 
    87 <ol>
    88 
    89   <li>Do one of the following:<br>
    90   <ul>
    91     <li>Click Add Partner Link Type.</li>
    92     <li>Drag the Partner Link Type icon from the Palette onto a blank portion of the Partner Link Types area.</li>
    93     <li>Right-click a blank portion of the Partner Link Types area and choose Add PartnerLinkType.</li>
    94   </ul>
    95   The configuration box for the partner link type appears. The partner link type contains a default role.</li>
    96 
    97   <li>In the right side of the configuration box, specify the port type that the service will use to receive messages. 
    98   To create a new port type, double-click <tt>Enter or Select a Port Type</tt> and enter the name. 
    99   To use an existing port type, click <tt>Enter or Select a Port Type</tt> and select the port type from the drop-down menu.</li>
   100 
   101   <li>If you created a new port type, or if you want to add one or more operations to an existing port type, then do the following:</li>
   102 
   103   <ol type="a">
   104     <li>Drag one or more operations from the Palette onto the dashed vertical line that extends below the port type.</li>
   105     <li>For each operation, select the messages. 
   106     You can double-click <tt>&lt;No Message Selected&gt;</tt> and select a message from the drop-down list. 
   107     Alternately, you can drag a message from the Navigator window onto <tt>&lt;No Message Selected&gt;</tt>.</li>
   108   </ol>
   109 
   110 </ol>
   111 
   112 
   113 
   114 <p><b>To add a second role to a partner link type:</b></p>
   115 
   116 <ol>
   117 
   118   <li>In the left side of the configuration box, double-click <tt>[External Partner]</tt> and enter the role name.</li>
   119 
   120   <li>In the left side of the configuration box, specify the port type that the service will use to receive messages. 
   121   To create a new port type, double-click <tt>Enter or Select a Port Type</tt> and enter the name. 
   122   To use an existing port type, click <tt>Enter or Select a Port Type</tt> and select the port type from the drop-down menu.</li>
   123 
   124   <li>If you created a new port type, or if you want to add one or more operations to an existing port type, then do the following:</li>
   125 
   126   <ol type="a">
   127     <li>Drag one or more operations from the Palette onto the dashed vertical line that extends below the port type.</li>
   128     <li>For each operation, select the messages. 
   129     You can double-click <tt>&lt;No Message Selected&gt;</tt> and select a message from the drop-down list. 
   130     Alternately, you can drag a message from the Navigator window onto <tt>&lt;No Message Selected&gt;</tt>.</li>
   131   </ol>
   132 
   133 </ol>
   134 
   135 
   136 
   137 <p><b>To add a fault to a request-response operation:</b></p>
   138 
   139 <ol>
   140   <li>Right-click the operation name and choose Add Fault.<br>The fault appears.</li>
   141   <li>Double-click <tt>&lt;No Message Selected&gt;</tt>.</li>
   142   <li>Select the fault message.</li>
   143 </ol>
   144 
   145 
   146 
   147 <dl>
   148 <dt><a name="seealso">See Also</a></dt>
   149 <dd><a href="wsdl_editor_partner.html" title="About the Partner View">About the Partner View</a></dd>
   150 <dd><a href="wsdl_editor_partner_layout.html" title="Partner View Layout">Partner View Layout</a></dd>
   151 </dl>
   152 <hr>
   153 <small>  
   154 <a href="credits.html">Legal Notices</a></small>
   155 <table border="0" cellpadding="150">
   156 <tr><td>&nbsp;</td></tr>
   157 <tr><td>&nbsp;</td></tr>
   158 <tr><td>&nbsp;</td></tr>
   159 </table>
   160 </body>
   161 </html>