xml.wsdlui/javahelp/org/netbeans/modules/xml/wsdlui/docs/wsdl_editor_config.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 <html>
    46 <head>
    47 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    48 <title>Configuring WSDL File Components</title>
    49 <link rel="stylesheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
    50 </head>
    51 <body>
    52 <h2>Configuring WSDL File Components</h2>
    53 <p><small><a href="#seealso">See Also</a></small></p>
    54 <p>This topic describes how to configure the <a href="#rootelement">root element</a> of the WSDL file, 
    55 how to add <a href="#documentation">documentation</a> to any element, 
    56 and how to <a href="#importing">import</a> XML schemas and WSDL files.</p>
    57 <ul class="note">
    58   <li>If you add <tt>import</tt> statements using the Source view, or if you copy files with URL references 
    59     into your project, the referenced WSDL file may only be accessible through a URL. 
    60     
    61     In this case, your project may not contain the true closure of all the documents. 
    62     
    63     Since the WSDL files are referenced, the IDE will perform the same logic that is used when retrieving 
    64     WSDL resources using the External WSDL Document(s) wizard and transparently fetch the documents and store 
    65     them in a non-version controlled area. 
    66     
    67     This may cause a delay the first time these documents are accessed on your machine, because the referenced 
    68     documents are not local. Subsequent accesses will be faster.</li>
    69 </ul>
    70 <h3><a name="rootelement"></a>Configuring the Root Element</h3>
    71 <p>The root element contains properties for the name of the WSDL file, 
    72 the target namespace, the default namespace, and namespace prefixes.</p>
    73 <p><b>To configure the root element:</b></p>
    74 <ol>
    75   <li>In the WSDL view, select the root node.</li>
    76   <li>If the Properties window is not visible, choose Window &gt; Properties.</li>
    77   <li>Edit the name, target namespace, and default namespace as necessary.</li>
    78   <li>Edit the values of the namespace prefixes as necessary.</li>
    79 </ol>
    80 <h3><a name="documentation"></a>Adding Documentation</h3>
    81 <p>You can add documentation to any element in the WSDL file.</p>
    82 <p><b>To add documentation:</b></p>
    83 <ol>
    84   <li>In the WSDL view, right-click an element and choose Add &gt; Documentation. <br>
    85     A documentation node appears.</li>
    86   <li>Select the documentation node.</li>
    87   <li>If the Properties window is not visible, choose Window &gt; Properties.</li>
    88   <li>Enter the documentation text.</li>
    89 </ol>
    90 <h3><a name="importing"></a>Importing XML Schemas and WSDL Files</h3>
    91 <p>You can use the WSDL Editor to import an XML schema file or another WSDL file that is part of your project.</p>
    92 <p><b>To import an XML schema:</b></p>
    93 <ol>
    94   <li>In the WSDL view, right-click the root node and choose Add &gt; Import Schema.<br>
    95     The Import Customizer dialog box opens.</li>
    96   <li>In the Location list, expand the <tt>By File</tt> or <tt>By Namespace</tt> nodes to navigate to and select the XML schema file.<br>
    97     The Namespace field below the Location list is filled in by the IDE.</li>
    98   <li>(Optional) In the New Prefix field, type the prefix that you want to use.
    99   <li>Click OK.</li>
   100 </ol>
   101 <p><b>To import another WSDL file:</b></p>
   102 <ol>
   103   <li>In the WSDL view, right-click the root node and choose Add &gt; Import WSDL.<br>
   104     The Import Customizer dialog box opens.</li>
   105   <li>In the Location list, expand the <tt>By File</tt> or <tt>By Namespace</tt> nodes to navigate to and select the WSDL file.<br>
   106     The Namespace field below the Location list is filled in by the IDE.</li>
   107   <li>(Optional) In the New Prefix field, type the prefix that you want to use.
   108   <li>Click OK.</li>
   109 </ol>
   110 <dl>
   111 <dt><a name="seealso">See Also</a></dt>
   112 <dd><a href="nbdocs://org.netbeans.modules.xml.schema.core/org/netbeans/modules/xml/schema/core/tasks/referencingextschemas.html" title="Referencing External Schemas">Referencing External Schemas</a></dd> 
   113 <dd><a href="wsdl_editor_messages.html" title="Configuring WSDL Messages">Configuring WSDL Messages</a></dd>
   114 <dd><a href="wsdl_editor_port_types.html" title="Configuring WSDL Port Types">Configuring WSDL Port Types</a></dd>
   115 <dd><a href="wsdl_editor_bindings.html" title="Configuring WSDL Bindings">Configuring WSDL Bindings</a></dd>
   116   <dd><a href="wsdl_editor_services.html" title="Configuring WSDL Services">Configuring WSDL Service</a></dd>
   117 </dl>
   118 <hr>
   119 <small>  
   120 <a href="credits.html">Legal Notices</a></small>
   121 <table border="0" cellpadding="150">
   122 <tr><td>&nbsp;</td></tr>
   123 <tr><td>&nbsp;</td></tr>
   124 <tr><td>&nbsp;</td></tr>
   125 </table>
   126 </body>
   127 </html>