WebService Configuration Window - Request Tab

Configures the request settings for a web service method call using the WSE AgileShape.



Navigation

  1. In AgilePoint Envision, open a process template.
  2. Navigate to the Web Services stencil.
  3. On the Web Services stencil, drag the WSE (Web Service Extension) AgileShape, and drop it on the process template.
  4. To view the entire list of properties, in the Design Tasks pane, click Show Properties.
  5. On the Configure field, click the Ellipses button.

Field Definitions

Field Name Definition

Select the URL of the web service

Definition:
Specifies the URL of your web service.
Allowed Values:
A valid web service URL.
Default Value:
None
Custom Attributes:
No

uddi

Opens the Following Window:
Web Service Explorer Window
Purpose of this Window:
Finds and selects a web service using the Universal Description Discovery and Integration (UDDI) standard.

Select the WSDL file

Definition:
Determines whether to use a WSDL file to access the web service method.
Allowed Values:
  • Deselected - Specifies to use the URL of your web service.
  • Selected - Specifies to use the WSDL file to access your web service method.

    Use the Ellipses button to browse the WSDL file. Once you select the WSDL file, the correct values are populated in the fields, such as web service method names.

Default Value:
Deselected

Connect

Function:
Retrieves the list of methods and the endpoint URL for the specified web service.

WebMethod

Definition:
Specifies the name of the method you want to call.
Allowed Values:
A valid web method name defined in the specified WCF or web service.
Default Value:
None
Example:
StartProcInst

Endpoint Url

Definition:
Specifies the URL of the endpoint of the web service or WCF service you want to connect.
Allowed Values:
A valid endpoint URL.
Default Value:
None

However, once a web service is connected, the endpoint URL is populated, if it is defined in the WSDL file.

Custom Attributes:
No

Request Mapping

Definition:
Maps the web service request to the AgilePoint process schema. This is required only if the request is passing values to the web method as parameters as data that comes from the process model schema.
Allowed Values:
Click the Ellipses button to open the Schema Mapper Window.

Use this window to map the request to your process schema.

Default Value:
None

Custom Headers

Definition:
Specifies the custom headers required for the web service.

Custom headers contain application-specific information in the SOAP header. Custom headers are mostly used to provide security information, such as authentication credentials.

Allowed Values:
Read only - A message is displayed if the custom headers are set for the web service.

Use the Ellipses button to display the custom headers set for the web service.

Example:
Custom Header Value
WSClietInfo.AppName AgilePoint Envision
WSClietInfo.UserName Ap13\Administrator
WSClietInfo.Locale en-us

Add Other Soap Headers

Definition:
Determines whether other SOAP headers are to be added.
Allowed Values:
  • Deselected - Other SOAP headers are not added.
  • Selected - Other SOAP headers are added.

    When you select the option, the text box becomes available allowing you to specify the required SOAP headers.

Default Value:
Selected

Common Configuration Tasks