Creating a SOAP Service

Use the New Service wizard to create a new SOAP service. Before beginining, verify that you have completed all of the setup.

Note

The default naming of target namespaces for services result in 2 occurrences of a colon :. When a SOAP service is created to wrap another service, the service URL replaces the : tokens with ~3A to keep the URL address valid.

To create a SOAP service:

Open the New Service wizard. Select File|New|Service from the menu bar.
Select SOAP Service from the Service Selection page, and click Next.
Select the project that will use this service, and create a new service file. Name the file with a unique and descriptive name, and click Next.

Define the Service Information, and click Next.

Service Information

Field	Description
Name	Edit the file name. The wizard automatically enters a file name that is the same name as the service file in the Sybase project. Note Sybase WorkSpace does not support the use of the # character in a service file name.
Category	Enter a new category, or select an existing category from the drop-down list. Note If you plan to create multiple services, it is recommended that you group services into meaningful categories.
Description	Provide an internal description, such as an explanation of how and where this service is used. You can also add notes for other developers who may be implement this service.

Define service endpoint. Choose from the following:

Define the endpoint now.

Select Yes and click Next.
Name the endpoint and click Next.

Specify the connection properties for the WSDL file. Choose from the following, and click Next.

Note

See About WSDL Documents for information on restrictions for externally sourced WSDL files.

WSDL File page

Field	Description
Reference from Workspace	Browse the active project for the WSDL file location. Note The WSDL file must have been imported into your project in your Workspace in order to use this option.
Specify the endpoint properties and press Enter to enable the Next button	Choose from the following: Browse to a local file in the active project. Note The WSDL file must have been imported to your project in order to use this option. Browse the UDDI Registry to retrieve a URL, or enter a URL address that specifies the WSDL file location.
Security	Choose from the following: If the URL where the WSDL is located requires authentication, enter a WSDL user name and password. If invocation of the services defined in the associated WSDL document requires authentication, enter a Service user name and password. Because these credentials are required for access to this service at runtime, you must specify them at this time as part of the service definition.
Validate WSDL	Verify that the WSDL file is valid before continuing.
Service Address	Complete the following: Verify that the Service Name based on the WSDL document is correct. Verify that the Port Name based on the WSDL document is correct.

Select the operations to expose, and click Next.
Review the service details in the Summary page.
To edit a value, click Back.
Click Finish to complete the service.
The service file appears in the WorkSpace Navigator and the SOAP service editor opens.

Define the endpoint at a later time.
1. Select No and click Next.
2. Review the service details in the Summary page.
  To edit a value, click Back.
3. Click Finish to complete the service.
  The service file appears in the WorkSpace Navigator and the SOAP service editor opens.
  Note
  If the SOAP Service editor requires some time to open or if a marker in the Problems view indicates that the SOAP service endpoint is not accessible, verify that the URL in your WSDL file is validate. If not valid, delete and rebuild the service.

Naming Conventions