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