Professional Documents
Culture Documents
webMethods, Inc.
South Tower
3877 Fairfax Ridge Road
Fairfax, VA 22030
USA
703.460.2500
http://www.webmethods.com
webMethods Access, webMethods Administrator, webMethods Broker, webMethods Dashboard, webMethods Developer, webMethods Fabric, webMethods
Glue, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Modeler, webMethods Monitor,
webMethods Optimize, webMethods Portal, webMethods Servicenet, webMethods Trading Networks, and webMethods Workflow are trademarks of
webMethods, Inc. webMethods and the webMethods logo are registered trademarks of webMethods, Inc.
Acrobat and Adobe are registered trademarks, and Reader is a trademark of Adobe Systems Incorporated. Amdocs is a registered trademark, and ClarifyCRM
is a trademark of Amdocs. Ariba is a registered trademark of Ariba, Inc. BEA, BEA WebLogic Server, Jolt, and Tuxedo are registered trademarks, and BEA
WebLogic Platform is a trademark of BEA Systems, Inc. Action Request System, BMC Software, PATROL, and Remedy are registered trademarks of BMC
Software, Inc. BroadVision is a registered trademark of BroadVision, Inc. ChemeStandards and CIDX are trademarks of Chemical Industry Data Exchange.
Unicenter is a registered trademark of Computer Associates International, Inc. PopChart is a registered trademark of CORDA Technologies, Inc. Kenan and
Arbor are registered trademarks of CSG Systems, Inc. Data Connection and SNAP-IX are registered trademarks of Data Connection Corporation. DataDirect,
DataDirect Connect, and SequeLink are registered trademarks of DataDirect Technologies. D&B and D-U-N-S are registered trademarks of Dun & Bradstreet
Corporation. Entrust is a registered trademark of Entrust, Inc. papiNet is a registered trademark of the European Union and the United States. Financial
Information eXchange, F.I.X, and F.I.X Protocol are trademarks of FIX Protocol Ltd. UCCnet and eBusinessReady are registered trademarks, and 1SYNC and
Transora are trademarks of GS1 US. Hewlett-Packard, HP, HP-UX, OpenView, PA-RISC, and SNAplus2 are trademarks of Hewlett-Packard Company. i2 is a
registered trademark of i2 Technologies, Inc. AIX, AS/400, CICS, DB2, Domino, IBM, Informix, Infoprint, Lotus, Lotus Notes, MQSeries, OS/390, OS/400,
RACF, RS/6000, SQL/400, S/390, System/390, VTAM, z/OS, and WebSphere are registered trademarks; and Communications System for Windows NT, DB2
Universal Database, IMS, MVS, and SQL/DS are trademarks of IBM Corporation. InnoDB is a trademark of Innobase Oy. Itanium is a registered trademark of
Intel Corporation. JBoss is a registered trademark, and JBoss Group is a trademark of Jboss, Inc. Linux is a registered trademark of Linus Torvalds. W3C is a
registered trademark, and X Window System is a trademark of the Massachusetts Institute of Technology. MetaSolv is a registered trademark of Metasolv
Software, Inc. ActiveX, Microsoft, Outlook, Visual Basic, Windows, and Windows NT are registered trademarks; and Windows Server is a trademark of
Microsoft Corporation. Six Sigma is a registered trademark of Motorola, Inc. Firefox is a registered trademark, and Mozilla is a trademark of the Mozilla
Foundation. MySQL is a registered trademark of MySQL AB. nCipher is a trademark of nCipher Corporation Ltd. Teradata is a registered trademark of NCR
International, Inc. Netscape is a registered trademark of Netscape Communications Corporation. SUSE is a registered trademark of Novell, Inc. ServletExec is
a registered trademark, and New Atlanta is a trademark of New Atlanta Communications, LLC. CORBA is a registered trademark of Object Management
Group, Inc. JD Edwards, OneWorld, Oracle, PeopleSoft, Siebel, and Vantive are registered trademarks, and PeopleSoft Pure Internet Architecture and
WorldSoftware are trademarks of Oracle Corporation. Infranet and Portal are trademarks of Portal Software, Inc. Red Hat is a registered trademark of Red
Hat, Inc. PIP and RosettaNet are trademarks of RosettaNet, a non-profit organization. SAP and R/3 are registered trademarks of SAP AG. SWIFT and
SWIFTNet are registered trademarks of Society for Worldwide Interbank Financial Telecommunication SCRL. SPARC and SPARCStation are registered
trademarks of SPARC International, Inc. SSA is a registered trademark, and Baan and SSA Global are trademarks of SSA Global Technologies, Inc. EJB,
Enterprise JavaBeans, Java, JavaServer, JDBC, JSP, J2EE, Solaris, Sun, and Sun Microsystems are registered trademarks; and Java Naming and Directory
Interface, SOAP with Attachments API for Java, JavaServer Pages, and SunSoft are trademarks of Sun Microsystems, Inc. Sybase is a registered trademark of
Sybase, Inc. VERITAS is a registered trademark, and VERITAS Cluster Server is a trademark of Symantec Corporation. UNIX is a registered trademark of The
Open Group. Unicode is a trademark of Unicode, Inc. VeriSign is a registered trademark of Verisign, Inc.
All other marks are the property of their respective owners.
Copyright © 2006 by webMethods, Inc. All rights reserved, including the right of reproduction in whole or in part in any form.
Contents
Chapter 1. Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
What Is a Web Service? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Using webMethods Software to Invoke Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Using webMethods Software to Create Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Using webMethods Software to Manage Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
What Is a WSDL Document? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Information Required to Generate a WSDL Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
About Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
XML Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Integration Server Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Specifying Universal Names for Integration Server Services . . . . . . . . . . . . . . . . . . . 12
Associating Integration Server Fields with XML Namespaces . . . . . . . . . . . . . . . . . . 12
Chapter 3. Generating a WSDL Document that Uses the SOAP RPC Protocol . . . . . . . . 21
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Service Requirements when Using the Default SOAP RPC Processor . . . . . . . . . . . . . . . . . . . . . . . 22
Input and Output Signature Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Generating the WSDL Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Chapter 4. Generating a WSDL Document that Uses the SOAP Message Protocol . . . . 31
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Service Requirements when Using the Default SOAP Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Service Requirements When Registering into Servicenet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Input and Output Signature Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Generating the WSDL Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Chapter 5. Generating a WSDL Document that Uses the HTTP POST or GET Protocol . . 43
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Service Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Input and Output Signature Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Text/XML Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
URL Encoded Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Generating the WSDL Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
This guide is for users who want to create Web services and incorporate Web services into
the solutions they develop. This guide explains how to generate WSDL documents for
webMethods Web services and use webMethods software to call Web services located on
remote servers.
Document Conventions
Convention Description
Bold Identifies elements on a screen.
Italic Identifies variable information that you must supply or change based
on your specific situation or environment. Identifies terms the first
time they are defined in text. Also identifies service input and output
variables.
Narrow font Identifies storage locations for services on the webMethods
Integration Server using the convention folder.subfolder:service.
Typewriter Identifies characters and values that you must type exactly or
font messages that the system displays on the console.
UPPERCASE Identifies keyboard keys. Keys that you must press simultaneously are
joined with the “+” symbol.
\ Directory paths use the “\” directory delimiter unless the subject is
UNIX-specific.
[] Optional keywords or values are enclosed in [ ]. Do not type the [ ]
symbols in your own code.
Additional Information
The webMethods Advantage Web site at http://advantage.webmethods.com provides you
with important sources of information about webMethods components:
Troubleshooting Information. webMethods provides troubleshooting information for
many webMethods components in the webMethods Knowledge Base.
Documentation Feedback. To provide documentation feedback to webMethods, go to the
Documentation Feedback Form on the webMethods Bookshelf.
Additional Documentation. All webMethods documentation is available on the
webMethods Bookshelf.
With webMethods software, you can create Web services using programming languages
such as Java, C/C++, or COM. You can also create Web services from existing back-end
systems, without producing custom code or reconfiguring the back-end systems, using
webMethods adapters.
Use a Web services registry to publish a URL that identifies the location of the WSDL
document.
Note: A Web service provider can also distribute a WSDL document and supporting files
to Web service consumers directly.
Information Description
Web service location Production Integration Server on which the Web service will
reside.
Protocol Protocol that Web service consumers must use to communicate
with the Web service. You can specify the SOAP RPC, SOAP
message (document), HTTP POST, or HTTP GET protocol.
Transport Request transport mechanism that Web service consumers must
use to invoke the Web service. You can specify HTTP or HTTPS,
depending on the port you are using.
Service signature Input parameters the Web service requires and output
parameters the Web service produces.
The service for which you generate a WSDL document, and the
input and output parameters that compose the service’s
signature, must meet certain requirements. These requirements
differ depending on the protocol you select for Web service
consumers to communicate with the Web service. For more
information about these requirements, see the individual
chapters that describe how to generate WSDL documents for
each type of protocol.
Target namespace Namespace to which elements, attributes, and type definitions
in the generated WSDL document will belong.
The subsystem of Integration Server that generates WSDL documents is called the WSDL
generator. The WSDL generator creates a WSDL document using the information you
provide along with information from the service.
About Namespaces
Namespaces are collections of names (for example, the names of XML Schema elements,
Integration Server document types, or Integration Server services). A namespace name is
associated with each collection to provide context for the named entities within the
collection. This helps prevent conflicts when the scope of a named entity extends beyond
its current context.
The following sections describe XML namespaces and namespace use within the
Integration Server.
XML Namespaces
By the World Wide Web Consortium (http://www.w3.org) definition, an XML namespace is
a collection of names identified by a URI reference. XML namespaces help avoid naming
conflicts by differentiating between element types or attributes with the same name in an
XML document. As long as these like-named element types or attributes reside in
different namespaces, they are considered different entities.
You can define a prefix to represent an XML namespace URI. Prefixes provide a way to
shorten the reference to the XML namespace URI. In the following XML Schema example,
the prefix address represents the XML namespace URI http://www.example.com:
xmlns:address="http://www.example.com"
You can use this prefix elsewhere in the XML document, in conjunction with an element's
local name attribute, to represent the full URI with which the prefix is associated. For
example:
<address:street>123 Main Street</address:street>
The name of an element type or attribute is referred to as its local name. When an element
type or attribute is associated with a namespace, its name (whether prefaced by a prefix or
not) is also known as an XML namespace qualified name (QName).
Note: The universal name should conform to the XML QName naming conventions
specified in http://www.w3.org/TR/REC-xml-names/#NT-QName.
Note: The WSDL generator defines prefixes in WSDL documents to represent specific
namespaces that identify a binding’s protocol. For more information about these prefixes
and their associated namespaces, see Appendix A, “WSDL Documents”.
In Developer, you assign XML namespaces and prefixes to Integration Server fields as
follows:
To assign an XML namespace to an Integration Server field, complete the XML
Namespace property in the General category of the field’s Properties panel.
To assign a prefix to an Integration Server field, precede the field name with the prefix
followed by a colon (for example, prefix:variableName).
Note: In most cases, if you use a prefix you must also supply an XML namespace. For more
information, see the chapters in this guide for generating WSDL documents for each type
of protocol.
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Overview
To invoke Web services located on remote servers, you generate a Web service connector
from the WSDL document for the remote Web service, then run the connector. A Web
service connector is a flow service that has an input and output signature that
corresponds to the input and output messages from the WSDL document from which it
was created.
Note: To create a Web service connector, you need to specify a WSDL document that
resides either on the Internet or on your local file system. If you do not have a WSDL
document and you would like to use Developer to create one, see the chapters in this
guide for generating WSDL documents that use the SOAP RPC, SOAP Message, HTTP
POST, or HTTP GET protocols.
Note: Web service connectors cannot be created using WSDL documents generated for
XSLT services.
Tip! To automatically generate a Web service connector from an existing service registered
in Servicenet, simply drag the Web service from the Servicenet tab to the folder in which
you want to store the connector. For more information, see Chapter 6, “Using Servicenet to
Register and Bind to Web Services”.
Note: You must have Write access to the folder in which you want to store the Web
service connector.
Note: If the Web site on which the document resides is password protected, you
must download the WSDL document to your local file system, then create the
Web service connector.
If you want to create a Web service connector from a WSDL document that resides
on your local file system, click to navigate to and select the document.
7 Click Finish. Developer validates the WSDL document you selected, creates the
connector and supporting Integration Server elements, and saves the connector and
the elements to the folder you specified. For information about the IS elements that
Developer generates, see “Supporting Elements” on page 18.
Note: If Developer cannot create or cannot completely generate a Web service connector
from the WSDL document because the WSDL document is invalid or is missing WSDL
elements, Developer displays error messages or warning messages. For more information
about errors that can occur when generating connectors, see Appendix B, “Web Service-
Related Errors and Warnings”.
Supporting Elements
When Developer creates a Web service connector from a WSDL document, it also creates
supporting IS elements. Each of the IS elements that Developer creates corresponds to an
element in the WSDL document.
The following table identifies the IS elements that Developer might create when it
generates a Web service connector.
Developer inserts flow steps into the Web service connector by following an internal
template for inserting input data into the service request, sending the request, processing
the response, and adding service output values to the pipeline. The template that
Developer follows depends on the protocol specified in the WSDL document. The
following illustration shows the Web service connector generated for the Web service that
performs credit card authorization.
This SEQUENCE
corresponds to a binding
for the SOAP RPC
protocol.
Note: The $default port corresponds to the first named <port> element in the WSDL
document.
2 Click . Developer displays the Input for ‘connector’ dialog box. The dialog box shows
the inputs required by the remote Web service.
3 Provide the input values, then click OK. Developer runs the connector, which calls the
remote Web service, and displays the results on the Results panel.
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Overview
When you specify SOAP RPC as the protocol for Web service consumers to use to
communicate with a Web service, the RPC processor will receive SOAP messages that call
the service. You can select either the default RPC processor or a registered, custom-built
SOAP RPC processor (for example, an access-controlled RPC processor). The processor
you select will receive requests for the Web service.
The Web service for which you are generating the WSDL document will be a target service
of the selected processor. Consequently, the service needs to conform to the target service
requirements for the specified processor.
If you select a custom SOAP RPC processor, make sure the service for which you are
generating the WSDL document conforms to the target service requirements for the
custom processor. The following section explains the service requirements if you want to
use the default SOAP RPC processor to receive and send SOAP messages for the service.
For information about creating custom SOAP RPC processors, see the SOAP Developer’s
Guide.
Document or Document list type fields can be Yes However, the Integration Server displays a
open (that is, in the Constraints category of the warning and marks the documents as “closed.”
Properties panel, the Allow unspecified fields
property is set to True).
Top-level fields must be associated with an No The Integration Server ignores the XML
XML namespace. namespace value if present.
Fields beneath the top level must be No The Integration Server ignores the XML
associated with an XML namespace. namespace value if present.
Recursive documents are allowed. Yes The Integration Server will generate the WDSL
document but cannot create a Web service
connector from the WSDL document.
Field type constraints
Object constraints are allowed. Yes However, the WSDL generator does not
represent them in the WSDL document.
Strings constrained by older schema types Yes However, the WSDL generator maps them into
(types defined before the W3C XML 2001 2001 XML Schema types.
Schema recommendations) are allowed.
Note: By default, a field must exist at run time, can contain a null value, and (for document
type fields), cannot contain unspecified fields. If you change a field's default properties,
the WSDL generator reflects those changes in the schema section of the WSDL document.
However, the message element of a WSDL document cannot define these properties.
Therefore, when you use the WSDL document to generate a Web service connector, the
Integration Server uses the default properties for all top-level fields.
Stage Description
1 Identify the service for which you want to generate a WSDL document.
2 Specify the protocol and transport mechanism for Web service consumers to
use to communicate with the Web service.
Note: Before you generate a WSDL for an adapter service, verify that the service will only
return values that match its output signature to the pipeline. Otherwise, you must do one
of the following:
Wrap the adapter service in a flow service. Add or drop variables to match the output
signature. Then, generate the WSDL from the flow service.
Change the properties of any variable that does not match the output signature to
make it optional, where applicable. To make a variable optional, set the Required
property in the Constraints category of the Properties panel to False.
1 In the Navigation panel, select the service for which you want to generate a WSDL
document.
2 On the Tools menu, click Generate WSDL. Developer opens the Generate WSDL dialog
box.
3 In the Host box, type the numeric IP address or domain name of the host machine on
which the Web service will reside at production time.
By default, the Host box identifies the Integration Server on which the Web service
currently resides; that is, the Integration Server to which you are currently connected.
You do not need to specify http:// or https:// as part of the host name; the WSDL
generator automatically adds http:// or https:// (based on the transport
mechanism you specify in the Via Transport box) to the host name when it compiles the
network address for the Web service.
4 In the Port box, type the number of the port you want to use to accept requests for the
Web service from Web service consumers.
By default, the Port box identifies the port you used to connect to the current
Integration Server. If you want to use a different port, type the number of that port in
the Port box.
The port you identify must be able to accept either HTTP requests or HTTPS requests.
If you do not require that requests from Web service consumers be sent securely,
specify a port that accepts HTTP requests. If you want requests from Web service
consumers to be sent securely, specify a port that accepts HTTPS requests.
Note: The Directive list displays all registered SOAP processors on the Integration
Server to which you are currently connected. If you plan to move the service to a
production Integration Server, make sure the directive you select corresponds to a
SOAP processor that is registered on the production server as well.
Important! If you specify anything other than the default SOAP RPC processor, be
certain that the directive belongs to a SOAP RPC processor. Otherwise, requests for
this service will not be processed correctly.
For information about creating and registering your own SOAP RPC processor, see
the SOAP Developer’s Guide.
1 In the Target Namespace box, specify the target namespace for the WSDL document.
By default, the Target Namespace box displays http://host/ as the target namespace,
where host is the name of the server you are currently logged on to. If you want to
specify a different namespace, type the URI for that namespace in the box.
2 Click OK. Developer displays a dialog box that prompts you for a location and name
for the generated WSDL document.
1 Under Save in, select the directory in which you want to save the generated WSDL
document.
2 In the File name field, specify a name for the WSDL document. By default, Developer
assigns the document the name serviceName.wsdl.
3 Click Save. The WSDL generator generates the WSDL document. Developer then
displays a message that lists the WSDL document file and the directory in which it
stored the file.
4 Click OK.
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Overview
When you specify SOAP messaging as the protocol for Web service consumers to use to
communicate with a Web service, you can select the SOAP processor you want to use to
handle messages sent by the Web service consumers. You can select either the default
SOAP processor or a registered, custom-built SOAP processor (for example, an access-
controlled processor). The processor you select will receive, process, and send SOAP
messages that call the service.
The Web service for which you are generating the WSDL document will be a target service
of the selected processor. Consequently, the service needs to conform to the target service
requirements for the specified processor.
If you select a custom SOAP processor, make sure the service for which you are
generating the WSDL document conforms to the target service requirements for the
custom processor. The following section explains the service requirements if you want to
use the default SOAP processor to receive and send SOAP messages for the service. For
information about creating custom SOAP processors, see the SOAP Developer’s Guide.
In addition to these requirements, you should also check the target service’s Execute ACL
permission to ensure that consumers of the service can invoke it.
For more information about creating a target service for the default SOAP processor, see
the SOAP Developer’s Guide.
Tip! If you use Servicenet to manage your Web services, you can simply drag a service
from the Navigation panel to the Servicenet tab to automatically generate the WSDL. For
more information, see Chapter 6, “Using Servicenet to Register and Bind to Web
Services”.
Servicenet only accepts services that use the “wrapped” Document Literal binding style.
In other words, the service input signature or output signature must consist of a single
top-level element. If you attempt to register a service using the SOAP Message protocol
and the input or output signature consists of multiple top-level fields, Developer will
display an error message.
The following input and output signatures will be accepted by Servicenet. Each signature
is composed of a single, top-level field (Order and OrderRecord) containing the variables.
The following input and output signatures have the same fields, but all the fields are top-
level elements. These signatures will result in an error message from Servicenet.
If you specify the default SOAP processor for handling the SOAP message requests and
responses for the service, the IS document type or XML Schema element declaration that
describes the input and output signature must meet the following requirement:
The top-level fields of an IS document type or XML Schema component must be
associated with an XML namespace and include an XML namespace prefix. In
Developer, this means that the XML Namespace property must be set for each top-level
field and the field name must contain a prefix in the format prefix:localName.
Note: You can generate a WSDL document using an IS document type or XML Schema
component whose top-level fields are not namespace qualified by setting the server
configuration parameters watt.server.wsdl.enforceSOAPMsgPartNS and
watt.server.SOAP.enforceMsgPartNS to False. For more information about these
parameters, see the webMethods Integration Server Administrator’s Guide.
For example, suppose that the explicit universal name of the service
gl.journals:journalEntry has a namespace name of http://www.exprint.com/GL/ and a
local name of JournalEntry. The first top-level field of the IS document type that
describes the input signature must be named prefix:JournalEntry, where prefix
represents the XML namespace URI. Additionally, the value of the XML Namespace
property for the JournalEntry field must be http://www.exprint.com/GL/.
Note: The WSDL generator treats variables with the same QName as identical variables
even if the variables are declared as different types.
If a top-level field of the service’s input or output signature is of type String, the field
must be namespace qualified and the field name must contain a prefix in the format
prefix:localName. If the field’s Content type property in the Constraints category of the
Properties panel is not set (that is, does not contain a valid URI), the WSDL generator
sets the field to type xsd:String.
In addition, the input signature must also meet the following requirements:
The IS document type or XML Schema component used for an input signature must
contain at least one field.
The first top-level field’s XML Namespace property in Developer must match the
Namespace name value of the service’s explicit universal name and its local name must
match the Local name value of the service’s explicit universal name.
Important! To ensure interoperability with other Web service vendors, the Namespace
name value of the service’s explicit universal name must be a valid URI.
The following table lists additional requirements for developing the service’s input and
output signature and how they apply to the SOAP MSG protocol. The other chapters that
describe how to generate WSDL documents also contain this table so you can easily
compare requirements across protocols.
Object constraints are allowed. Yes However, the WSDL generator does not
represent them in the WSDL document.
Strings constrained by older schema types Yes However, the WSDL generator maps them into
(types defined before the W3C XML 2001 2001 XML Schema types.
Schema recommendations) are allowed.
Note: By default, a field must exist at run time, can contain a null value, and (for document
type fields), cannot contain unspecified fields. If you change a field's default properties,
the WSDL generator reflects those changes in the schema section of the WSDL document.
However, the message element of a WSDL document cannot define these properties.
Therefore, when you use the WSDL document to generate a Web service connector, the
Integration Server uses the default properties for all top-level fields.
Stage Description
1 Identify the service for which you want to generate a WSDL document.
2 Specify the protocol and transport mechanism for Web service consumers to
use to communicate with the Web service.
Stage Description
Note: Before you generate a WSDL for an adapter service, verify that the service will only
return values that match its output signature to the pipeline. Otherwise, you must do one
of the following:
Wrap the adapter service in a flow service. Add or drop variables to match the output
signature. Then, generate the WSDL from the flow service.
Change the properties of any variable that does not match the output signature to
make it optional, where applicable. To make a variable optional, set the Required
property in the Constraints category of the Properties panel to False.
1 Open the service for which you want to generate a WSDL document.
2 On the Tools menu, click Generate WSDL. Developer opens the Generate WSDL dialog
box.
3 In the Host box, type the numeric IP address or domain name of the host machine on
which the Web service will reside at production time.
By default, the Host box identifies the Integration Server on which the Web service
currently resides; that is, the Integration Server to which you are currently connected.
You do not need to specify http:// or https:// as part of the host name; the WSDL
generator automatically adds http:// or https:// (based on the transport
mechanism you specify in the Via Transport box) to the host name when it compiles the
network address for the Web service.
4 In the Port box, type the number of the port you want to use to accept requests for the
Web service from Web service consumers.
By default, the Port box identifies the port you used to open the current Integration
Server. If you want to use a different port, type the number of that port in the Port box.
The port you identify must be able to accept either HTTP requests or HTTPS requests.
If you do not require that requests from Web service consumers be sent securely,
specify a port that accepts HTTP requests. If you want requests from Web service
consumers to be sent securely, specify a port that accepts HTTPS requests.
1 Under Protocol, click SOAP-MSG. Developer enables the Directive, Input, and Output
boxes.
Important! To ensure interoperability with other Web service providers, the Namespace
name value of the service’s explicit universal name must be a valid URI. Use the
Properties panel in Developer to assign a universal name to a service.
2 Under Via Transport, click the request transport mechanism that is accepted by the port
you specified in the Port box. If the port accepts HTTP requests, click HTTP. If the port
accepts HTTPS requests, click HTTPS.
3 From the Directive list, select the process directive for the SOAP processor you want to
use to receive, process, and send SOAP messages that invoke the target service. If you
want to use the default processor, click default.
Note: The Directive list displays all registered SOAP processors on the Integration
Server to which you are currently connected. If you plan to move the service to a
production Integration Server, make sure the directive you select corresponds to a
SOAP processor that is registered on the production server as well.
You can describe the input signature for the WSDL document using an IS document type
or using an element declaration from an XML Schema. Use one of the following
procedures to define the input message for the Web service.
1 Next to the Input box on the Generate WSDL dialog box, click . Developer opens
the Select Input/Output Constraint dialog box.
1 Next to the Input field, click . Developer opens the Select Input/Output Constraint
dialog box.
2 Under Choose Constraint Type, click Schema Component.
3 In the text field, after http://, type the Web location and name of the XML Schema that
contains the element declaration you want to use to describe the input signature.
Important! The XML Schema you identify must be located on the Web and must be
accessible to consumers of the WSDL.
4 Click Load. Developer groups the element declarations in the XML Schema under the
ELEMENTS heading. Expand the heading to view the global element declarations in
the XML Schema.
5 Select the global element declaration that you want to use to represent the input
signature.
6 Click OK. Developer closes the dialog box and displays the name of the selected
element declaration in the Input box on the Generate WSDL dialog box.
You can describe the output signature for the WSDL document using an IS document type
or using an element declaration from an XML Schema. See “To describe the input
signature for the Web service” on page 41 for instructions.
1 In the Target Namespace box, specify the target namespace for the WSDL document.
By default, the Target Namespace box displays http://host/ as the target namespace,
where host is the name of the server you are currently logged on to. If you want to
specify a different namespace, type the URI for that namespace in the box.
2 Click OK. Developer displays a dialog box that prompts you for a location and name
for the generated WSDL document.
1 Under Save in, select the directory in which you want to save the generated WSDL
document.
2 In the File name field, specify a name for the WSDL document. By default, Developer
assigns the document the name serviceName.wsdl.
3 Click Save. The WSDL generator generates the WSDL document. Developer then
displays a message that lists the WSDL document file and the directory in which it
stored the file.
4 Click OK.
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Service Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Overview
When you specify HTTP POST as the protocol for Web service consumers to use to
communicate with a Web service, you can specify text/XML or URL encoded as the input
format for the service. When you select HTTP GET as the protocol, Developer
automatically sets the input format to URL encoded.
When you specify HTTP POST or HTTP GET as the protocol for the WSDL document,
keep the following points in mind:
When you select URL encoded as the input format, the WSDL generator uses the
input parameters declared on the Input/Output tab of the service to create the input
message for the WSDL document. However, for the URL encoded input format, the
input signature can only contain String variables. The input signature should not
contain document, document list, Object, Object list, String list, or String table
variables because these variables cannot be represented in name=value pairs in the
HTTP request.
When you select text/XML as the input format, you can select an IS document type or
XML Schema component (element declaration) to describe the incoming XML
document.
For the HTTP protocols, Developer selects text/XML as the output format. You must
select an IS document type or XML Schema component (element declaration) to
represent the outbound XML document.
For more information about describing the service input and output for the HTTP
protocols, see “Input and Output Signature Requirements” on page 45.
Service Requirements
When you specify HTTP POST or HTTP GET as the protocol for a WSDL document, the
target service for which you are generating the WSDL document must meet these
requirements:
The service must return an XML document to Web service consumers. When
generating a WSDL document, the WSDL generator assumes that all services invoked
via an HTTP request will return an XML document (text/xml content). To return an
XML document, a service can do one of the following:
Call the pub.flow:setResponse service. This service takes any string and returns it as
the body of an HTTP response. For more information about the pub.flow:setResponse
service, see the webMethods Integration Server Built-In Services Reference.
Create and assign an XML output template to the service. You can use an XML
output template to extract values from the pipeline and insert those values as
element content in an XML tag. For more information about output templates, see
Dynamic Server Pages and Output Templates Developer’s Guide.
Important! You must use the pub.flow:setResponse service or an XML output template to
return an XML document, or Integration Server will return an HTML document to the
HTTP request.
If you select HTTP POST as the protocol and text/XML as the input format, the service
input signature must include an object type named node. When webMethods
Integration Server receives an HTTP POST request where the Content-Type header is
text/XML, the server automatically parses the body of the request (the XML
document) and passes it as an XML node to the service specified in the request’s URL.
To extract data from the returned node, you query it using the pub.xml:queryXMLNode
service or convert it to a document using the pub.xml:xmlNodeToDocument service.
Because an XML node object does not provide meaningful signature information for
the WSDL document, you can select an IS document type or XML Schema component
to describe the input signature. The IS document type or XML Schema component
you select describes the XML document the service expects as input. See “Input and
Output Signature Requirements” for more information about specifying IS document
types and XML Schema components.
In addition to these requirements, you should also check the target service’s Execute ACL
permission to ensure that consumers of the service can invoke it.
Text/XML Requirements
The following table lists the requirements for developing the service’s input and output
signature when text/XML is selected as the input or output format. The other chapters that
describe how to generate WSDL documents also contain this table so you can easily
compare requirements across protocols.
Service signature requirements when text/XML is specified as the input or output format
Object constraints are allowed. Yes However, the WSDL generator does not
represent them in the WSDL document.
Strings constrained by older schema types Yes However, the WSDL generator maps them into
(types defined before the W3C XML 2001 2001 XML Schema types.
Schema recommendations) are allowed.
Note: By default, a field must exist at run time, can contain a null value, and (for document
type fields), cannot contain unspecified fields. If you change a field's default properties,
the WSDL generator reflects those changes in the schema section of the WSDL document.
However, the message element of a WSDL document cannot define these properties.
Therefore, when you use the WSDL document to generate a Web service connector, the
Integration Server uses the default properties for all top-level fields.
In addition, The WSDL generator treats variables with the same QName as identical
variables even if the variables are declared as different types.
Service signature requirements when URL encoded is specified as the input format
Document or Document list type fields can be n/a The URL encoded input format does not
open (that is, in the Constraints category of the support Document or Document list type
Properties panel, the Allow unspecified fields fields.
property is set to True).
Top-level fields must be associated with an No The URL encoded input format does not
XML namespace. support XML namespaces. Therefore, fields
must not be associated with an XML namespace.
Fields beneath the top level must be n/a The URL encoded input format does not
associated with an XML namespace. support documents.
Recursive documents are allowed. n/a The URL encoded input format does not
support documents.
Field type constraints
Object constraints are allowed. Yes However, the WSDL generator does not
represent them in the WSDL document.
Strings constrained by older schema types Yes However, the WSDL generator maps them into
(types defined before the W3C XML 2001 2001 XML Schema types.
Schema recommendations) are allowed.
Note: By default, a field must exist at run time, can contain a null value, and (for document
type fields), cannot contain unspecified fields. If you change a field's default properties,
the WSDL generator reflects those changes in the schema section of the WSDL document.
However, the message element of a WSDL document cannot define these properties.
Therefore, when you use the WSDL document to generate a Web service connector, the
Integration Server uses the default properties for all top-level fields.
In addition, The WSDL generator treats variables with the same QName as identical
variables even if the variables are declared as different types.
Stage Description
1 Identify the service for which you want to generate a WSDL document.
2 Specify the protocol and transport mechanism for Web service consumers to
use to communicate with the Web service.
Note: Before you generate a WSDL for an adapter service, verify that the service will only
return values that match its output signature to the pipeline. Otherwise, you must do one
of the following:
Wrap the adapter service in a flow service. Add or drop variables to match the output
signature. Then, generate the WSDL from the flow service.
Change the properties of any variable that does not match the output signature to
make it optional, where applicable. To make a variable optional, set the Required
property in the Constraints category of the Properties panel to False.
1 In the Navigation panel, select the service for which you want to generate a WSDL
document.
2 On the Tools menu, click Generate WSDL. Developer opens the Generate WSDL dialog
box.
3 In the Host box, type the numeric IP address or domain name of the host machine on
which the Web service will reside at production time.
By default, the Host box identifies the Integration Server on which the Web service
currently resides; that is, the Integration Server to which you are currently connected.
You do not need to specify http:// or https:// as part of the host name; the WSDL
generator automatically adds http:// or https:// (based on the transport
mechanism you specify in the Via Transport box) to the host name when it compiles the
network address for the Web service.
4 In the Port box, type the number of the port you want to use to accept requests for the
Web service from Web service consumers.
By default, the Port box identifies the port you used to open the current Integration
Server. If you want to use a different port, type the number of that port in the Port box.
The port you identify must be able to accept either HTTP requests or HTTPS requests.
If you do not require that requests from Web service consumers be sent securely,
specify a port that accepts HTTP requests. If you want requests from Web service
consumers to be sent securely, specify a port that accepts HTTPS requests.
1 Under Protocol, click HTTP-POST or HTTP-GET. Developer changes the boxes on the
dialog box. The following figure shows an example of the dialog box when you click
HTTP-POST; when you click HTTP-GET, the dialog box is similar, except that the Input
format and Input boxes are disabled.
2 Under Via Transport, click the request transport mechanism that is accepted by the port
you specified in the Port box. If the port accepts HTTP requests, click HTTP. If the port
accepts HTTPS requests, click HTTPS.
3 The Integration Server’s default directive for invoking services via an HTTP request is
invoke. If you need to specify another directive for Web service consumers to use to
invoke the service, type the directive in the Directive box.
4 By default, the Path box provides the path to the Web service as it currently exists in
the Navigation panel. If the Web service will reside in a different folder at production
time, type the path to that folder in the Path box. Use the format
folder.subfolder.subfolder/service.
5 If you selected HTTP-GET as the protocol for Web service consumers to use to
communicate with the Web service, skip to “To describe the output signature for the
Web service” on page 56. If you selected HTTP-POST, continue with “To specify the
input format of the Web service (HTTP-POST protocol only)” on page 54.
Stage 3 To specify the input format of the Web service (HTTP-POST protocol only)
If you selected HTTP-POST as the protocol for Web service consumers to use to
communicate with the Web service, you must specify the input format in which the
Web service requires input. You can specify the input format in one of the following
ways:
Name=value pairs in the POST that Click URL encoded in the Input format list,
invokes the Web service then skip to “To describe the output
signature for the Web service” on page 56.
The WSDL generator uses the input
signature on the Input/Output tab of the
Web service to create the input message
for the WSDL document.
An XML document, and you want to Go to “To describe the input signature
describe the input signature for the using an IS document type” on page 54.
WSDL document using an IS
document type
An XML document, and you want to Go to “To describe the input signature
describe the input signature for the using an XML Schema” on page 55.
WSDL document using an element
declaration from an XML Schema
1 In the Input format list on the Generate WSDL dialog box, click text/xml.
2 Next to the Input box, click . Developer opens the Select Input/Output Constraint dialog
box.
2 Next to the Input field, click . Developer opens the Select Input/Output Constraint
dialog box.
3 Under Choose Constraint Type, click Schema Component.
4 In the text field, after http://, type the Web location and name of the XML Schema that
contains the element declaration you want to use to describe the input signature.
Important! The XML Schema you identify must be located on the Web and must be
accessible to consumers of the WSDL.
5 Click Load. Expand the ELEMENTS headings to view the global element declarations
in the XML Schema.
Note: If an XML Schema definition does not contain an element declaration, Developer
does not display the ELMENTS heading.
6 Select the global element declaration that you want to use to represent the input
signature.
7 Click OK. Developer closes the dialog box and displays the name of the selected
element in the Input box on the Generate WSDL dialog box.
Describe the XML document the Web service produces as output. Complete the Output
format box using the instructions in “To specify the input format of the Web service (HTTP-
POST protocol only)” on page 54.
1 In the Target Namespace box, specify the target namespace for the WSDL document.
By default, the Target Namespace box displays http://host/ as the target namespace,
where host is the name of the server you are currently logged on to. If you want to
specify a different namespace, type the URI for that namespace in the box.
2 Click OK. Developer displays a dialog box that prompts you for a location and name
for the generated WSDL document.
1 Under Save in, select the directory in which you want to save the generated WSDL
document.
2 In the File name field, specify a name for the WSDL document. By default, Developer
assigns the document the name serviceName.wsdl.
3 Click Save. The WSDL generator generates the WSDL document. Developer then
displays a message that lists the WSDL document file and the directory in which it
stored the file.
4 Click OK.
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Connecting to Servicenet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Introduction
This chapter provides information about using webMethods Developer with webMethods
Servicenet to register, bind to, and browse for Web services.
Requirements
To use Developer to register, bind to, and browse Web services in Servicenet, you must
have the following:
webMethods Developer 6.5, Service Pack 1
Note: Developer 6.5 without Service Pack 1 is only compatible with webMethods Fabric
Release 1.0.2.
Connecting to Servicenet
To use Developer to view, register, or bind to a Web service in Servicenet, you must first
connect to Servicenet (specifically, to the Servicenet registry).
Note: You can connect to only one Servicenet registry at a time, which means you can only
open one Servicenet session at a time from Developer. If you open a new Servicenet
session while already connected to a Servicenet registry, Developer automatically closes
the existing session before opening a new one.
To connect to Servicenet
1 Start Developer.
2 Open a Servicenet session by selecting SessionOpen Servicenet.
Select... To...
Subnet locator port Connect to the Servicenet registry via the subnet port
configured for the registry. The subnet locator broadcasts a
User Datagram Protocol (UDP) ping out to the subnet to locate
the Servicenet registry using the port you enter in this field.
Developer then binds to the registry using that port. Use this
method to connect to a Servicenet running on your Intranet.
WAN locator URL Connect to the URL of a Servicenet registry running in your
wide area network (WAN).
4 Enter the Servicenet registry location in the Subnet locator port or WAN locator URL field.
5 Click OK. The Servicenet tab lists all of the Web services in the Servicenet registry to
which you are connected.
Important! If you want to reduce the number of services displayed in the Servicenet tab, try
defining a filter. See “Applying a Filter to Servicenet” on page 72 for instructions.
Servicenet tab
Note: When you select a Web service in the Servicenet tab, the Properties panel displays the
properties of the Web service you selected, but the editor (the middle area of the
Developer window between the Navigation and the Properties panels) does not change. It
still displays details for the service selected in the Navigation panel. This is because Web
service details and logic for a Servicenet service cannot be modified using Developer.
For more information about concrete and virtual Web services, see the webMethods
Servicenet User’s Guide.
Servicenet Toolbar
The following buttons on the Servicenet tab are shortcuts to frequently-used commands.
Use this
button... To...
Connect to a Servicenet session while working in Developer.
Equivalent to Session > Open Servicenet.
Disconnect from a Servicenet session while working in Developer.
Equivalent to Session > Close Servicenet.
Refresh the display of Web services. Equivalent to Session > Refresh
Servicenet.
Use this
button... To...
Create an expression that filters the contents of the Servicenet tab
based on the value of a Web service property. Equivalent to Session
> Set Servicenet Filter.
Remove the filter from the contents of the Servicenet tab and
display all the registered Web services. Equivalent to Session >
Clear Servicenet Filter.
Property Description
Property Description
Note: After an IS service has been registered in Servicenet, the registered Web service must
be deleted from the Servicenet registry before it can be replaced with an updated version
of the IS service. For more information, see “Updating a Service that is Registered in
Servicenet” on page 71.
Stage Description
2 Specify the protocol and transport mechanism for the Web service consumers
to use to communicate with the Web service.
3 Specify the input signature for the Web service. (SOAP Message protocol only)
The input signature for the service must consist of only a single top-level field.
4 Specify the output signature for the Web service. (SOAP Message protocol only)
The output signature for the service must consist of only a single top-level field.
Tip! If you specified the actual DNS name or IP address of the Integration Server when you
logged on to Developer, you can register a service simply by dragging it directly from the
Navigation panel to the Servicenet tab. The service will be registered in Servicenet with the
following characteristics:
SOAP-RPC as the protocol with the RPC directive.
1 From the Servicenet tab, open a session on the Servicenet in which you want to register
a service.
2 In the Navigation panel, select the service you want to register in Servicenet.
3 On the Tools menu, click Register in Servicenet. Developer opens the Register IS service
‘servicename’ in Servicenet dialog box.
Register IS service ‘servicename’ in Servicenet dialog box
4 In the Host field, select the host machine on which the Web service will reside at
production time. By default, this field specifies the machine on which the current
Integration Server resides.
Important! If this field contains localhost, change the value to the actual name or IP
address of the machine on which the service resides (that is, the name of the machine
on which the Integration Server to which Developer is connected resides). Otherwise,
when a client on a different machine tries to invoke the service, the client will look on
its own machine for the service. To prevent this problem, always log on to Developer
using the actual DNS name or IP address of the Integration Server.
5 In the Port field, select the number of the port you want to use to accept requests to
invoke the service from Web service consumers. By default, this field specifies the
port you used to connect to the current Integration Server.
routed to the Integration Server’s default SOAP RPC processor, select rpc. If you want
to use a custom RPC processor that is registered on your Integration Server, select its
directive.
For SOAP-MSG. From the Directive list, select the directive for the SOAP processor that
you want to use to receive, process, and send SOAP messages that invoke the target
service. If you want to use the default processor, select default.
Note: The Directive list displays all registered SOAP processors on the Integration
Server to which you are currently connected. If you plan to move the service to a
production Integration Server, make sure the directive you select corresponds to a
SOAP processor that is registered on the production server as well. For information
about creating and registering your own SOAP processor, see the SOAP Developer’s
Guide.
Stage 3 To describe the input signature for the Web service (SOAP Message protocol only)
You can describe the input signature for the Web service using an IS document type or
using an element declaration from an XML Schema.
1 Next to the Input field on the Register IS service dialog box, click . Developer opens
the Select Input/Output Constraint dialog box.
3 Identify the IS document type you want to use to describe the input signature. You
can either type the fully qualified name of the IS document type in the Name field or
click the IS document type in the Folder box.
Note: The signature must consist of a single top-level field. Servicenet expects Web
services using the SOAP Message protocol to use the “wrapped” Document Literal
binding style. For an example, see “Service Requirements When Registering into
Servicenet” on page 33.
4 Click OK. Developer closes the dialog box and displays the fully qualified name of the
IS document type in the Input field on the Register IS service dialog box.
1 Next to the Input field, click . Developer opens the Select Input/Output Constraint
dialog box.
2 Under Choose Constraint Type, select Schema Component.
3 In the text field, after http://, type the Web location and name of the XML Schema that
contains the element declaration you want to use to describe the input signature.
Important! The XML Schema you identify must be located on the Web and must be
accessible to consumers of the WSDL.
4 Click Load. Developer groups the element declarations in the XML Schema under the
ELEMENTS heading. Expand the heading to view the global element declarations in
the XML Schema.
5 Select the global element declaration that you want to use to represent the input
signature.
6 Click OK. Developer closes the dialog box and displays the name of the selected
element declaration in the Input box on the Register IS service dialog box.
You can describe the output signature for the Web service using an IS document type
or using an element declaration from an XML Schema. See “To describe the input
signature for the Web service (SOAP Message protocol only)” above for instructions.
1 In the Target Namespace box, specify the target namespace for the Web service.
By default, the Target Namespace box displays http://host/ as the target namespace,
where host is the name of the server you are currently logged on to. If you want to
specify a different namespace, type the URI for that namespace in the box.
Important! If this field contains localhost, change the value to the actual name or IP
address of the machine on which the service resides (that is, the name of the machine
on which the Integration Server to which Developer is connected resides). Otherwise,
when a client on a different machine tries to invoke the service, the client will look on
its own machine for the service. To prevent this problem, always log on to Developer
using the actual DNS name or IP address of the Integration Server.
Note: If Developer cannot display the service you just registered in the Servicenet tab
because of the filter setting, it will display a message stating so. To see the service in
the list, clear the filter by selecting SessionClear Servicenet Filter or by clicking on
the Servicenet tab.
Important! If you drag and drop an updated IS service into the Servicenet tab without first
deleting the original version from the Servicenet tab, two identical icons with different
properties will be displayed for the same service in the Servicenet tab. Delete both icons
and re-register the updated version of the IS service.
1 Click on the Servicenet tab to open a session. Specify the Servicenet from which
you want to remove a service.
2 In the Servicenet tab, select the service you want to remove, right click, and select
Remove from Servicenet.
Note: You cannot delete a virtual Web service; Remove from Servicenet will be disabled.
Important! If you are unable to connect to Servicenet using a subnet locator, your Servicenet
and Developer components could be on different subnets. Subnet locators can only
connect components within the same subnet of your network. In this case, you must use a
WAN locator URL to connect to Servicenet, rather than a Subnet locator port.
1 Select Set Servicenet Filter from the Session menu, or click on the Servicenet tab.
2 In the Filter Servicenet dialog box, if you want to create an expression that filters the
contents of the Servicenet tab based on the value of a Web service property, do the
following:
a Select the Filter on Properties check box.
b In the Property list, select the Web service property that you want to use in the
filter.
If you want Developer to examine all the Web service properties for the
specified text, select any.
If you want to use a custom metadata property with the filter, type the name
of the metadata tag in the Property list.
Note: Filtering on the since property is not recommended, since the timestamp is
displayed in a format based on your Developer locale. You can only filter with the
since property after you convert the timestamp to the number of milliseconds
since the epoch.
Select... To...
d In the Search text field, type the text that you want to use as filter criteria.
Developer compares the value of the selected property with the search text you
specify.
3 If you want the Servicenet tab to hide Web services that are offline, clear the Show offline
services check box. Offline services are Web services that did not respond the last time
Servicenet attempted to contact them.
4 Click Apply to apply the filter.
If you click Apply, the Filter Servicenet dialog box remains open. Click OK if you want to
apply the filter and close the Filter Servicenet dialog box.
Notes:
Developer continues to apply the specified filter until you explicitly clear the filter.
Developer saves the filter across Developer and Servicenet sessions.
When the button on the Servicenet tab is active, it indicates that Developer is using
a filter to limit the displayed Web services.
If you register a service that does not meet the criteria specified in the currently
applied filter, Developer does not display the newly registered Web service in the
Servicenet tab.
Developer applies each filter that you create to the entire contents of Servicenet. For
example, if you apply two filters in succession, Developer clears the first filter before
applying the second filter. Developer does not apply the second filter to the results of
the first filter.
To clear a filter
Select Clear Servicenet Filter from the Session menu, or click on the Servicenet tab, if it
is enabled.
Developer removes the filter and displays all the registered Web services in the
Servicenet.
Note: You cannot bind to an offline service; the online property for the Web service
must be true in order to create a Web service connector. If the Web service you select is
not online, Developer will not allow you to bind to it; drag-and-drop operations will
not be completed and the Create Web service connector option will be disabled.
6 Click Finish. Developer locates the WSDL for the Web service, generates the Web
service connector and its supporting Integration Server elements (folders, document
types, and schemas), and saves the connector and elements to the folder you specified.
For more information about the elements that Developer creates, see “Supporting
Elements” on page 18.
Tip! There are three ways to create a Web service connector in Developer from a Web
service in Servicenet:
On the File menu, click New, and follow all the steps described in the procedure above.
Select the Web service in the Servicenet tab that you want to bind to, right-click it and
select Create Web service connector. Since you have already selected the Web service,
you only have to select your source folder to create the connector.
Simply drag the Web service that you want to bind to from the Servicenet tab to the
location in the Navigation panel where you want to save the Web service connector.
Element Description
<definitions> Contains the elements that describe a Web service.
<types> Contains the type definitions that describe the data that is received
and sent by the Web service. The <types> element can reference
entire XML Schemas and can contain simple type definitions,
complex type definitions, and element declarations. The type
definitions and element declarations help define the input and
output parameters for the Web service. WSDL uses XML Schema as
its native type system.
<message> Specifies the data that is received and sent by the Web service. A
<message> element describes a set of input parameters or a set of
output parameters. Each <message> element can contain one or
more <part> elements. A <part> element associates a piece of data
with a name and a type definition or element declaration. The type
definition or element declaration referenced by the <part> element
can be defined, declared, or referenced in the <types> element.
<operation> Specifies the messages that are received and sent by the Web service.
Within the <operation> element, the <input> element identifies the
message whose parts specify the input parameters to the Web
service while the <output> element identifies the message whose
parts specify the output parameters of the Web service. Essentially,
the operation specifies the signature for the Web service. An
<operation> element is declared within a <portType> element.
<portType> Defines a named set of operations. The <portType> element
associates a port type name with a set of operations. A <portType>
element can contain multiple operations.
<binding> Specifies the protocol and message format to use to access the
operations in a port type. Each <binding> element can specify only
one protocol for a port type; however, a WSDL document can define
more than one binding for a single port type. A WSDL document
should include one <binding> element for each protocol that it
supports.
Element Description
<port> Associates a binding with a network address. Together, the binding
and network address specify how to invoke a Web service. Each port
can specify only one network address for a binding; however,
multiple ports can be defined for a single Web service. Port elements
are defined within the <service> element.
<service> Groups ports that can be used to call Web services. A <service>
element can contain many ports.
transport://host:port/soap/directive
For WSDL documents that specify HTTP-POST or HTTP-GET as the protocol, the
location attribute in the <address> element is used with the location attribute in the
<operation> element to specify the URL used to call the service. For WSDL documents
that specify HTTP-POST and HTTP-GET as the protocol, the location attribute in the
<address> element has this format, where directive is almost always invoke:
transport://host:port/directive
The location attribute in the <operation> element specifies the fully qualified path
name of the service on the webMethods Integration Server and has this format:
folder.subfolder/service
<xsd:complexType name="__AuthenticateUserInput">
<xsd:sequence>
<xsd:element name="userName" nillable="true" type="xsd:string"/>
<xsd:element name="password" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="__AuthenticateUserOutput">
<xsd:sequence>
<xsd:element name="isValid" nillable="true" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>
</wsdl:types>
<wsdl:message name="AuthenticateUserOutput">
<wsdl:part name="isValid" type="xsd:boolean"/>
</wsdl:message>
</wsdl:definitions>
Message Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Message Display
When you generate a WSDL document or create a Web service connector from a WSDL
document, Developer displays a message that indicates whether the process completed
successfully.
If the process completed successfully but warnings occurred, Developer displays a
message to that effect. If the process did not complete successfully, Developer displays a
message that says errors occurred.
When you click Details on the message dialog box, Developer provides information similar
to the information in the message dialog box shown below.
WSDL elements
that caused the
error or warning.
Note: When generating a Web service connector, Developer might generate some of the
flow steps in the Web service connector or some of the supporting IS elements (IS
document types, folders, or IS schemas) before it encounters errors or warnings. The
generated elements appear in the Navigation panel.
[ISC.0077.9014] Document to XSD error: Field fieldName cannot be represented in XML Schema. The
field name does not conform to the XML NCName definition.
Cause: The Developer determined that the IS document type you are using to generate a
WSDL document contains field names that do not conform to the XML NCName
definition.
Response: To resolve this error, rename the fields to conform to the Qname lexical rules
specified in http://www.w3.org/TR/REC-xml-names/#NT-QName and the XML
namespace and local naming conventions specified in http://www.w3.org/TR/REC-xml-
names/#NT-NCName.
[ISC.0082.9106] Complex type <typeName> is recursive. webMethods Integration Server does not
support creating a document type from an XSD with a recursive complex type.
Cause: The XML Schema contains a recursive complex type definition. The Integration
Server does not support generating a document type from an IS schema containing a
recursive complex type. This error only occurs when you generate an IS document type
from an XML Schema.
Response: Do not try to generate a document type from a schema containing a recursive
complex type.
[ISS.0092.9032] Error: Input signature cannot be used to generate WSDL using URL Encoded format.
Field {0} cannot be represented in XML Schema. The field name does not conform to the XML NCName
definition.
Cause: A top-level IS document type field or XML Schema element in the input signature
used to generate a WSDL document is named *body or contains the characters *, @, or :.
These characters represent XML Schema components (mixed content, attributes, and XML
namespace prefixes) that are not applicable to URL encoded parameters.
When URL encoded is specified as the input format for the HTTP POST or HTTP GET
protocols, field names used in the input signature must conform to the QName lexical
rules specified in http://www.w3.org/TR/REC-xml-names/#NT-QName and the XML
namespace and local naming conventions specified rules specified in
http://www.w3.org/TR/REC-xml-names/#NT-NCName.
[ISS.0092.9033] Error: Input signature cannot be used to generate WSDL using URL Encoded format.
Fields cannot have XML Namespace values.
Cause: The input signature used to generate a WSDL document contains fields that are
associated with an XML namespace. Fields must not be associated with an XML
namespace when you select either of the following:
HTTP GET as the protocol
HTTP POST as the protocol and URL encoded as the input format
[ISS.0092.9039] Error: URL encoding does not support input variables other than strings and string
lists.
Cause: The input parameters declared on the Input/Output tab contain a variable that is not a
String or a String list. When URL encoded is specified as the input format for the HTTP
POST or HTTP GET protocols, Integration Server uses the input parameters declared on
the Input/Output tab of the service to construct the input message for the WSDL document.
For the URL encoded input format, the input signature can contain only String and String
list variables. The input signature should not contain document, document list, Objects,
Object lists, or String table variables because these variables cannot be represented in
name=value pairs in the HTTP request.
[ISC.0124.9001] Document to XSD warning: For interoperability reasons, the <any> type is not used in
SOAP RPC WSDL. Document {0} will be defined as closed in the XSD.
Cause: The IS document type you are using to generate a WSDL document contains
variables of type Document or Document list. These variables are open (that is, their Allow
unspecified fields property is set to True).
Response: To resolve this warning, set the Allow unspecified fields property in the Constraints
category of the Properties panel to False. Then, regenerate the WSDL document.
[ISC.0124.9002] Document to XSD error: Document {0} cannot be represented in XML Schema. This
document contains a *body field constrained by a simple type and fields that would be represented as
elements in the XSD. XSD could describe this document if the simple type constraint was removed or
the non-attribute fields were deleted.
Cause: The IS document type you are using to generate a WSDL document contains a field
named *body that is constrained by a simple type. The IS document type also contains
fields that are mapped as elements (not attributes) in the XSD. This combination cannot be
mapped in an XSD.
In a mixed content environment, the Integration Server can only map complex type
definitions of simple content (that is, an IS document type containing attributes and a
*body variable with or without a simple type constraint) or complex type definitions of
complex content (that is, an IS document type containing attributes and/or elements and a
*body variable that is not constrained).
Remove the *body variable’s simple type constraint. First, click the browse button
next to the Content type property on the variable’s Properties panel. Then, select No
Constraints Specified from the Content Type list on the resulting Properties dialog box.
[ISC.0124.9003] Document to XSD error: Referenced document type {0} does not exist.
Cause: The IS document type you are using to generate a WSDL document contains a
reference to a nonexistent document type.
Response: To resolve this error, restore the nonexistent document type or remove the
reference to it.
[ISC.0124.9004] Document to XSD error: Field {0} is a String table. String tables cannot be represented
in XML Schema.
Cause: The IS document type you are using to generate a WSDL document contains String
table fields. XML Schema does not support multi-dimensional arrays.
Response: To resolve this error, remove the String table field from the IS document type or
select a different IS document type.
[ISC.0124.9005] Document to XSD error: Field {0} cannot be represented in XML Schema. The field
name contains a prefix but an XML Namespace property is not assigned to the field.
Cause: The IS document type you are using to generate a WSDL document contains a top-
level field whose name includes a prefix (that is, the name is in the format
prefix:localName). However, this field is not associated with an XML namespace.
Important! Some protocols require the use of a prefix. Before removing the prefix, check
the service signature’s input and output requirements as documented for each
protocol in this guide.
[ISC.0124.9006] Document to XSD error: Field {0} cannot be represented in XML Schema. The field
name does not conform to the XML NCName definition.
Cause: The IS document type you are using to generate a WSDL document contains field
names that do not conform to the XML NCName definition.
Response: To resolve this error, rename the fields to conform to the QName lexical rules
specified in http://www.w3.org/TR/REC-xml-names/#NT-QName and the XML
namespace and local naming conventions specified in http://www.w3.org/TR/REC-xml-
names/#NT-NCName.
[ISC.0124.9007] Document to XSD error: Document {0} cannot be represented in XML Schema. The
document contains multiple *body fields.
Cause: The IS document type or XML Schema element declaration you are using to
generate a WSDL document contains more than one field named *body at the same level.
Response: To resolve this error, remove or rename the duplicate *body fields.
[ISC.0124.9008] Document to XSD error: Document {0} cannot be represented in XML Schema. The
document contains multiple attributes of the same name at the same level.
Cause: The IS document type or XML Schema element declaration you are using to
generate a WSDL document contains attributes at the same level with the same name.
Response: To resolve this error, remove or rename the duplicate attributes.
[ISC.0124.9009] Document to XSD error: Field {0} cannot be represented in XML Schema. Attributes
cannot have dimension greater than 0.
Cause: The IS document type or XML Schema element declaration you are using to
generate a WSDL document contains array or table type attributes. XML Schema does not
support multi-dimensional attributes.
Response: To resolve this error, remove the attribute from the IS document type or redefine
its type to String.
[ISC.0124.9011] Document to XSD error: Simple type {0} does not exist.
Cause: The IS document type you are using to generate a WSDL document contains a
reference to a nonexistent simple type that has been applied to a variable as a content type
constraint.
Response: To resolve this error, do one of the following:
Restore the nonexistent simple type by generating a schema on the server that defines
the missing type. To do so, you can either create a schema from an XSD or enable or
import a package that contains a schema with the missing type.
Remove the reference to the missing type. First, click the browse button next to the
Content type property on the variable’s Properties panel. Then, select No Constraints
Specified from the Content Type list on the resulting Properties dialog box.
[ISS.0092.9002] Warning: Document does not contain service element, no ports were generated for
any Web Service Connector.
Cause: The WSDL document does not contain a <service> element, and therefore does
not contain any <port> elements. (A <service> element is a collection of <port>
elements.)
Developer generates the Web service connector, but the Web service connector will not
specify any flow MAP steps for setting the port information. In the Web service connector,
the BRANCH on '/_port' step contains a child port MAP step for each unique <port>
associated with the <operation>. The BRANCH on '/_port' step will not contain child port
MAP steps. The Web service connector cannot execute successfully without port
information because the port information specifies the network address for invoking the
Web Service.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. (In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.)
[ISS.0092.9004] Error: SOAP binding does not contain transport value, binding was not created.
Cause: In the WSDL document, the <soap:binding> element contains a transport
attribute but no value is specified for it. The transport value indicates which transport of
SOAP the binding uses. It is required for a SOAP binding and its value must be
http://schemas.xmlsoap.org/soap/http.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.
[ISS.0092.9005] Error: SOAP binding has an unsupported transport value, binding was not created.
Cause: In the WSDL document, the transport attribute in the <soap:binding> element
specifies an unsupported SOAP transport. Developer can generate a binding for a SOAP
binding only if the transport value is http://schemas.xmlsoap.org/soap/http.
webMethods Developer generates the Web service connector, but the Web service
connector does not contain a SEQUENCE step that corresponds to this binding. In the
Web service connector, the BRANCH on '/binding' step contains a child SEQUENCE step
for each unique <binding> associated with an <operation>.
[ISS.0092.9006] Error: SOAP binding does not contain a transport attribute, binding was not created.
Cause: In the WSDL document, the <soap:binding> element does not contain a transport
attribute. The transport value indicates which transport of SOAP the binding uses. It is
required for a SOAP binding. The transport attribute value must be
http://schemas.xmlsoap.org/soap/http.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.
[ISS.0092.9007] Error: SOAP binding has an unrecognized style value, binding was not created.
Cause: In the WSDL document, the <soap:binding> element specifies a value other than
rpc or document for the style attribute.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.
[ISS.0092.9009] Error: HTTP binding does not contain required verb attribute, binding was not created.
Cause: In the WSDL document, the <http:binding> element does not contain the verb
attribute. The value of the verb attribute must be GET or POST.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.
[ISS.0092.9010] Error: HTTP binding has an unsupported verb attribute, binding was not created.
Cause: In the WSDL document, the <http:binding> element specifies a verb attribute
value other than GET or POST.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. (In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.)
[ISS.0092.9011] Error: Mime binding style is unsupported, binding was not created.
Cause: The WSDL document specifies a MIME binding style for the entire <binding>.
webMethods Developer only supports the MIME binding style to describe the inputs and
outputs of an HTTP binding. webMethods Developer cannot generate a binding when the
MIME binding style is specified outside of the HTTP binding context.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. (In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique
<binding> associated with an <operation>.)
[ISS.0092.9013] Warning: The operation's binding does not have any ports, no ports were generated
for the Web Service Connector.
Cause: Developer cannot find a <port> element that corresponds to a particular
<binding> element. A <port> element specifies a network address or endpoint for a
binding.
Developer generates the Web service connector, but does not generate any MAP steps for
setting the binding and address information. In a Web service connector, the BRANCH on
'/_port' step contains a child portName MAP step for each <port> associated with the
<operation>. When this warning occurs, the BRANCH on '/_port' step contains no child
portName MAP steps.
[ISS.0092.9014] Warning: The operation does not have any valid ports, no ports were generated for the
Web Service Connector.
Cause: The WSDL document does not contain any valid <port> elements for an
<operation>. The WSDL document might not contain any <port> elements or a <port>
element might reference a non-existent <binding> element. (A <binding> element
associates a protocol with an <operation>.)
Developer generates the Web service connector, but does not generate any portName MAP
steps for setting the binding and address information. In a Web service connector, the
BRANCH on '/_port' step contains a child portName MAP step for each <port> associated
with the <operation>. When this warning occurs, the BRANCH on '/_port' step contains
no child portName MAP steps.
[ISS.0092.9015] Warning: Port does not have a valid binding type, port was not generated.
Cause: The WSDL document contains a <port> element that does not contain the binding
attribute.
Developer generates the Web service connector, but does not generate a MAP step for this
port. In a Web service connector, the BRANCH on '/_port' step contains a child portName
MAP step for each <port> associated with the <operation>. The portName MAP step sets
the binding and address information for a port.
[ISS.0092.9016] Warning: Port does not have a location value, port was not generated.
Cause: Within the <port> element, the <address> element does not specify a value for the
location attribute. The location attribute specifies the network address or endpoint for
the service.
Developer generates a Web service connector, but without the network address,
webMethods Developer cannot generate a MAP step for this port. In a Web service
connector, the BRANCH on '/_port' step contains a child portName MAP step for each
<port> associated with the <operation>. The portName MAP step sets the binding and
address information for a port.
[ISS.0092.9017] Warning: Port does not have required address element, port was not generated.
Cause: The selected WSDL document does not contain an <address> element within the
specified <port> element. The <address> element carries an attribute that specifies the
location or network address for of the Web service.
Developer generates a Web service connector, but does not generate a MAP step for this
port. The portName MAP step sets the binding and address information for a port. Without
the <address> element, Developer cannot set the address information and therefore
cannot generate a MAP step.
[ISS.0092.9018] Warning: Port does not have required location attribute, port was not generated.
Cause: Within the <port> element, the <address> element does not carry the location
attribute. The location attribute specifies the network address for the service.
Developer generates a Web service connector, but does not generate a MAP step for this
port. The portName MAP step sets the binding and address information for a port. Without
the location attribute, Developer cannot set the address information, and therefore
cannot generate a MAP step.
[ISS.0092.9019] Warning: Port does not have a location value, port was not generated.
Cause: Within the <port> element, the <address> element does not specify a value for the
location attribute. The location attribute specifies the network address or endpoint for
the service.
Developer generates a Web service connector, but without the network address,
Developer cannot generate a MAP step for this port. The portName MAP step set the
binding and address information for a port. In a Web service connector, the BRANCH on
'/_port' step contains a child portName MAP step for each <port> associated with the
<operation>.
[ISS.0092.9020] Error: Operation is not referenced by any binding, Web Service Connector was not
created.
Cause: The WSDL document does not specify a <binding> element for the <operation>.
Each <operation> within a <portType> element needs to correspond to an <operation>
element within a <binding> element. Without a binding, the WSDL document does not
provide any information about how to invoke the Web service.
Developer does not generate a Web service connector for the <operation>.
[ISS.0092.9021] Error: Input and Output messages missing, invalid operation, Web Service Connector
was not created.
Cause: In the WSDL document, the <operation> element within a <portType> element
does not declare an input message or an output message. For Developer to generate a Web
service connector for the <operation>, the <operation> element must contain at least
one <input> element and at least one <output> element.
Developer does not generate a Web service connector for the <operation>.
[ISS.0092.9022] Error: Input message missing, Notification operations not supported. Web Service
Connector was not created.
Cause: In the WSDL document, the <operation> element does not declare an input
message, but it does declare an output message. In other words, the <operation> element
does not contain a child <input> element, but does contain a child <output> element.
This structure corresponds to the grammar for a notification operation. Developer does
not generate Web service connectors for notification operations.
[ISS.0092.9023] Error: Output message precedes Input message, Solicit Response operations not
supported. Web Service Connector was not created.
Cause: In the WSDL document, the <operation> element declares an <output> element
(output message) before the <input> element (input message). This describes a solicit-
response operation. Developer does not generate Web service connectors for solicit-
response operations.
[ISS.0092.9024] Error: HTTP binding has mime multipart Input. Multipart Input is not supported.
Binding was not generated.
Cause: The <binding> element specifies a multi-part MIME binding for the operation.
webMethods Developer does not support this type of binding.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique binding
associated with an operation.
[ISS.0092.9026] Error: HTTP Binding input is of an unknown type. Binding was not generated.
Cause: The input binding specifies an unknown binding type. When the protocol is HTTP
POST, the <mime:content> element for the input binding must specify text/xml,
[ISS.0092.9027] Error: HTTP Binding output mime parts are missing. Binding was not generated
completely.
Cause: The <binding> element specifies MIME binding for the output message, but the
output binding does not specify a message part for the <mime:content> element or the
output binding is missing <mime:part> elements.
Developer generates the Web service connector and generates a SEQUENCE step that
corresponds to this binding. (In the Web service connector, the BRANCH on '/binding'
step contains a child SEQUENCE step for each unique binding associated with an
operation.) However, Developer does not generate a complete binding because the output
binding in the WSDL document does not provide the part name information that
Developer needs to link the service results to variables in the pipeline. Specifically, the
Web service connector does not contain the BRANCH on '/numParts' step for this binding.
[ISS.0092.9028] Error: HTTP Binding output mime part is missing its type. Binding was not generated
completely.
Cause: The <binding> element specifies MIME binding for the output message, but the
<mime:content> element for the output binding does not specify a value for the type
attribute. The type attribute specifies the MIME type.
Developer generates the Web service connector and generates a SEQUENCE step that
corresponds to this binding. (In the Web service connector, the BRANCH on '/binding'
step contains a child SEQUENCE step for each unique binding associated with an
operation.) However, Developer does not generate a complete binding because the output
binding in the WSDL document does not provide the part name information that
Developer needs to link the service results to variables in the pipeline. Specifically, in the
Web service connector, the BRANCH on '/loopCount' step does not have a child
SEQUENCE step for linking the output message part to the pipeline.
[ISS.0092.9029] Warning: Generated Document Type, {IS document type name}, already exists in
namespace.
The IS document type that Developer generated for the input or output message already
exists in the server namespace. Developer will not generate a duplicate IS document type.
[ISS.0092.9030] Error: Input does not have a valid message reference, Web Service Connector was not
created.
Cause: Within the <operation> element, the message attribute for the <input> element
does not reference a <message> element within the WSDL. Developer cannot find the
message specified by the message attribute, or the message attribute does not have a
value. Developer does not generate a Web service connector for the <operation>.
[ISS.0092.9031] Error: Output does not have a valid message reference, Web Service Connector was
not created.
Cause: Within the <operation> element, the message attribute for the <output> element
does not reference a <message> element within the WSDL. Developer cannot find the
message specified by the message attribute or the message attribute does not have a value.
Developer does not generate a Web service connector for the <operation>.
[ISS.0092.9032] Error: Invalid schema definition for Input signature. Web Service Connector was not
created.
Cause: The XML Schema definition that contains element declarations or type definitions
for the <part> elements in the input message is invalid. Alternatively, the XML Schema
definition does not contain the element declarations or type definitions referenced by the
<part> elements. Developer does not generate a Web service connector for the
<operation>.
Note: This error message is usually accompanied by specific IS schema generation errors.
For more information about errors that occur when generating an IS schema from an XML
Schema, see the webMethods Developer User’s Guide.
[ISS.0092.9033] Error: Invalid schema definition for Output signature. Web Service Connector was not
created.
Cause: The XML Schema definition that contains element declarations or type definitions
for the <part> elements in the output message is invalid. Alternatively, the XML Schema
definition does not contain the element declarations or type definitions referenced by the
<part> elements. Developer does not generate a Web service connector for the
<operation>.
Note: This error message is usually accompanied by specific IS schema generation errors.
For more information about errors that occur when generating an IS schema from an XML
Schema, see the webMethods Developer User’s Guide.
[ISS.0092.9034] Warning: Found port with an invalid binding reference, the port was not generated.
Cause: In the WSDL document, a <port> element contains a binding attribute that
references a <binding> that does not exist within the WSDL document. Developer cannot
find the <binding> element specified by the binding attribute.
Developer generates the Web service connector, but does not generate a MAP step for this
port. The portName MAP steps set the binding and address information for a port. In a
Web service connector, the BRANCH on '/_port' step contains a child portName MAP step
for each <port> associated with the <operation>.
[ISS.0092.9036] Error: Could not process document. Found binding with an invalid PortType
reference, no Web Service Connectors were created.
Cause: In a <binding> element, the type attribute specifies a <portType> that does not
exist in the WSDL document. Developer does not generate a Web service connector.
[ISS.0092.9037] Error: HTTP Binding input type could not be found. Binding was not generated.
Cause: Developer cannot determine the input MIME type for the HTTP binding.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. (In the Web service
connector, the BRANCH on '/binding' step contains a child SEQUENCE step for each
unique binding associated with an operation.)
[ISS.0092.9038] Error: Unknown binding style was found, binding was not created.
Cause: The <binding> element specifies a protocol other than SOAP, HTTP, or MIME.
Developer generates the Web service connector, but the Web service connector does not
contain a SEQUENCE step that corresponds to this binding. (In the Web service connector,
the BRANCH on '/binding' step contains a child SEQUENCE step for each unique binding
associated with an operation.)
[ISS.0092.9040] Error: PortType name is zero length, Web Service Connector was not created.
Cause: In the WSDL document, the <portType> element carries the name attribute, but the
name attribute does not have a value. Developer does not generate a Web service
connector.
[ISS.0092.9041] Error: Operation name is zero length, Web Service Connector was not created.
Cause: In the WSDL document, the <operation> element carries the name attribute, but
the name attribute does not have a value. Developer does not generate a Web service
connector.
Index
B G
binding element, in WSDL document 78 Generate WSDL command 22
binding to a Web service 75 generating WSDL documents
describing service signature 34
C HTTP GET protocol 44
concrete services 62, 75 HTTP POST protocol 44
connecting to Servicenet 59 process overview 10
conventions used in this document 5 SOAP Message protocol 32
creating SOAP RPC protocol 22
Web service connectors 16, 75
WSDL documents H
describing service signature 34 HTTP GET protocol
HTTP GET protocol 44 input and output signature requirements 45
HTTP POST protocol 44 service requirements for generating WSDL documents 44
process overview 10 specifying for WSDL documents 44
SOAP Message protocol 32 text/xml restrictions 45
SOAP RPC protocol 22 URL encoded restrictions 44, 48
using Servicenet 65 HTTP POST protocol
input and output signature requirements 45
D service requirements for generating WSDL documents 44
default SOAP processor, using as directive for WSDL document specifying for WSDL documents 44
22, 32 text/xml restrictions 45
definitions element, in WSDL document 78 URL encoded restrictions 44, 48
docType folder, for Web service connector 18
documentation I
additional 5 icons, representing Web services 62
conventions used 5
input signature
feedback 5
describing (SOAP only) 68
E describing for WSDL documents 23, 34, 45
describing with IS document type 68
elements, in a WSDL document 78
describing with XML schema 69
errors
HTTP GET requirements 45
Web service connector generation 89
HTTP POST requirements 45
WSDL document generation 85
SOAP Message requirements 34
SOAP RPC requirements 23
F
IS document type, describing input signature 68
filtering
removing filters from Servicenet 74
Web services in Servicenet 72
L S
local name, definition of 12 service element, in WSDL document 79
Servicenet
M binding to a service 75
managed services 75 clearing a filter 74
message element, in WSDL document 78 closing a session 60
messages related to Web services 84 connecting to 59
creating a filter 72
creating a WSDL document 65
N
definition of 58
namespace disconnecting from 60
definition of 12
displaying Web services 61
explicit name 12
filtering 72
implicit name 12 finding Web services in 72
in WSDL documents 79
generating a Web service connector 75
universal name 12
hiding services 72
opening a session 59
O refreshing 60
opening a Servicenet session 59 registering a Web service 65
operation element, in WSDL document 78 removing a service 72
optional variables for validation 26, 39, 51 requirements 59
output signature specifying a protocol for Web service 67
describing (SOAP only) 69 toolbar 62
describing for WSDL documents 23, 34, 45 updating a service 71
HTTP GET requirements 45 viewing in Developer 61
HTTP POST requirements 45 Web service icons 62
SOAP Message requirements 34 Web service properties 63
SOAP RPC requirements 23 Servicenet tab
icons 62
P shortcuts 62
part element, in WSDL document 78 services
port element, in WSDL document 79 generating WSDL documents for 10
portType element, in WSDL document 78 HTTP GET requirements 44
prefix 11 HTTP POST requirements 44
program code conventions in this document 5 signature requirements 10
SOAP Message requirements 32
R SOAP RPC requirements 22
shortcuts on the Servicenet tab 62
registering a Web service in Servicenet 65
SOA (Services Oriented Architecture)
making changes to a registered Web service 71
managing Web services in 58
removing a Web service from Servicenet 72
X
XML namespace
definition of 11
prefix 11
XML schema, using to describe input signature 69