Import a remote WSDL from your server or repository. Keep your local copy in synch with it.
A
service reference
is a project-based catalog of external WSDL services. You can import external services to a project, while still maintaining a connection to the external location. A service reference is treated as the original location, but resolved locally.
Using a service reference lets you maintain your local copy of WSDL and schema while maintaining an awareness of changes being made to the original files. This technique allows you to decide how best to handle updates within your local copy.
By importing a service reference, you can:
Compare the local WSDL file with the original source.
Update from the original source by manually editing your local copy if the changes do not adversely affect the processes that import the WSDL file.
Use the WSDL just as you use a WSDL imported into the WSDL folder.
To import a locally-connected copy of an external WSDL:
Right-mouse click on the
Service Reference
folder in your orchestration project and select
Import
.
Paste in the URL of a WSDL file that is on your network server, intranet, or Internet.
Associate imported services with a
Service Group
folder. A
Service Group
folder contains the imported service and all of its imports, such as WSDL and XSD files. The suggested service group name indicates the location and name of the original WSDL. When you select
Finish
on the
Import
dialog, you will see the service group within the
Service References
folder.
Enable the checkbox for Format file after import to make the XML more readable. The import wizard tries to indent child elements and create line breaks.
To compare a Service Reference with its Original Source
:
To compare a local WSDL file with its original source, right-mouse click on the
Service Group
folder and select
Compare with > Import Source
. If the files are not in sync, a WSDL file appears in a
Compare
window. Click on the file to view the differences between the local and the original copies. You can only view the differences. Editing is not allowed.
Tips on Using Service References:
If the original file is updated with new or changed port types or schema changes, and you edit your local copy to match the original, a process importing the WSDL will contain errors
If the original file becomes unavailable, you should copy the WSDL or schema into your project and then change the import location to point to the project location. This avoids the potentially long waits for remote validation to occur. You change the import location in the Properties view of the import. Imports are listed in the Outline view.
For details on setting timeout values for WSDL validation, see