To call a method from a Windows Communication Foundation (WCF) service, do the
following.
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
- In AgilePoint Envision, open a process template.
- Navigate to the Web Services stencil.
- On the Web Services stencil, drag the
WCF (Windows Communication Foundation) AgileShape, and drop it on the process template.
- To view the entire list of properties, in the Design Tasks pane, click Show Properties.
- On the Configure field, click the Ellipses button.
Instructions
- On the WCF Service Configuration Window, in the Service URL
field, enter the URL of your WCF Service, and click the connect
button.
- Complete the following fields to set up your web method call:
| Field Name |
Definition |
Bindings
|
- Definition:
- Specifies the data binding you want to use.
The binding defines the communication details required to
connect to the WCF endpoint.
- Allowed Values:
- WSHttpBinding
- NetTcpBinding
- BasicHttpBinding
- Default Value:
- None
|
Endpoints
|
- Definition:
- Specifies the WCF service endpoint you want to connect.
Endpoints provide access to the WCF service data.
- Allowed Values:
- A list of Endpoints populated from the WSDL file of the WCF service.
- Default Value:
- None
- Example:
- NetTcpBinding_IWCFWorkflowService
|
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 WCF service URL or custom attribute.
- Default Value:
- None
- Custom Attributes:
- No
- Example:
- http://CSC-NINE:7002/AgilePointServer/Workflow
|
- If you want to map the outbound data for the WCF service call to your
process schema, on the Request tab, complete the following field.
| Field Name |
Definition |
Request Mapping
|
- Definition:
- Specifies whether the request is mapped to the WCF service schema. This is
required only if the request is passing values to the web method via 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
|
- If you want to map inbound data retrieved from the WCF 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:
- Maps the data returned from a WCF service call to your process 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}
|
- Complete any additional configuration for this AgileShape according to your
requirements:
