Calling a Method from a Web Service Extension

Prerequisites

• A valid Web Service — for example a live, valid WSDL file.

Good to Know

• In some cases, the type of the object instance returned by a web method may need to implement the IConvertible interface in order for the web method to be used with the Web Service 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.

Instructions

1. To select your web service, do one of the following.
   • To use a web service url:
     1. On the WebService Configuration Window, click Select the URL of the Webservice.
     2. In Select the URL of the Webservice field, enter the URL for your web service, and click the connect button.
   • To use a WSDL file:
     1. Click Select the WSDL file.
     2. On Select the WSDL file field, click the Ellipses button.
     3. Select your WSDL file.
     4. Click the connect button.
2. In the WebMethod list, select your web method.
3. If you want to map the outbound data for the web service call to your process schema, on the Request tab, complete the following field.

   Field Name	Definition
   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

4. If you want to map inbound data retrieved from the web service call to your process, click the Response tab, and then do one of the following:
   • To map the response to your AgilePoint schema, complete the following field.

     Field Name	Definition
     Map Response to AgilePoint Schema	Definition: Determines whether the web service response is mapped to the AgilePoint schema. Allowed Values: Click the Ellipses button to open the Schema Mapper Window. Use this window to map the response to your process schema. Default Value: None

   • To map the response to a custom attribute, complete the following field.

     Field Name	Definition
     Store the response in Custom Attribute	Definition: Specifies the name of the custom attribute that is used to store the response to a method call. The call may be to a web service, Web Service Extension, WCF service, or web application, depending upon the context. Allowed Values: A custom attribute. Default Value: None Custom Attributes: Yes Example: ${GroupMembers}

5. Complete any additional configuration for this AgileShape according to your requirements:
   • Web Service Extension (WSE)
   • WebService Configuration Window - Request Tab
   • WebService Configuration Window - Response Tab
   • WebService Configuration Window - Security Tab
   • AgilePart - Common Setup