Endpoint Addresses

For web services, endpoints get published to a specific address.

https://<ServerName>:<Port>/< ServerInstanceName >/<NamespaceName>/<ContainerName>/<ServiceDisplayName>/<InterfaceName>

The preferred endpoints use HTTPS Port 1, which is configured to 8202 by default. To access these endpoints, configure TLS/SSL and provide a user name and password with each request.

FieldPropertyDescription
ServerNameUser-defined

Specifies the name of the computer that has the server running the main application server.

PortUser-defined

Specifies the port used to access the web service. This default port is 8202. However, this port can be changed using the Configure Server tool at Advanced Configuration > Service Ports > HTTPS Port 1.

ServerInstanceName User-defined

Specifies the server name. The default name is SOAServer. However, this name can be changed using the Configure Server tool.

NamespaceNameSystem-defined

Specifies the custom service provider, which is part of the service provider's product option file. The namespace is configured when this product option file is created using the Proficy Packager tool.

ContainerNameSystem-defined

Specifies the custom service provider, which is part of the service provider's product option file. The container name is configured when this product option file is created using the Proficy Packager tool.

ServiceDisplayNameSystem-defined

Specifies the custom service provider, which is part of the service provider's product option file. The service display name is defined in the service provider source code.

InterfaceNameSystem-defined

Specifies the custom service provider, which is part of the service provider's product option file. The interface name is the service contract name defined in the service provider source code.

Metadata Endpoint

Each service also provides a metadata endpoint for accessing service metadata, and the WSDL file can be accessed using that endpoint. The metadata endpoint address is on the first interface when the interfaces are in alphabetical order by the full interface name. For system interfaces, this is typically IBrowse.

For example, to access the IWorkflowWebService WSDL file, use the following address:

https://<ServerName>:8202/SOAServer/SOAProject/Workflow/Workflow/IBrowse?wsdl