How to simulate a connector (V5.5)
When you use an Integrator shape in a flow, you cannot test the flow completely until the Integrator has an external working system to connect to.
In such cases, when the external system has not yet been configured, you can use a Connector Simulator to enable the testing of flows that contain Integrator shapes. The Connector Simulator is an activity that returns values to the flow, as though they came from the actual external source. Connector Simulators can be set up for any connector type.
You can simulate the following connector types:
In the example below, a home insurance policy application uses a SOAP connector to retrieve an applicant's previous claim history. The applicant's Social Security Number (SSN) is sent to the service, and any corresponding claims are returned.
To simulate a connector:
- Locate the connector you would like to simulate using the Integration Slice. Click the Simulations link.
The Connect Simulator window appears.
- Select an existing activity, or click the Open icon to create a simulation activity that will set the static properties to be used for the simulation. In this case, the simulation is called ClaimSim.
Note: To ease setup of the connector simulation, create the simulation activity in the same class as the Connect rule.
- The connector class (InsCorp-FW-PA-Int-ClaimService in this example) contains a page property (getClaims_getClaimsreturn) which contains a page list property (claimItems). This page list property contains the properties that will be set using the connector simulator. In this example, the simulation activity is appending a set of hard-coded values to the ClaimItems pagelist.
In the simulation activity specify the location of the properties to be simulated as the Step Page, .getClaims_getClaimsReturn.claimItems(<APPEND>) in this example. Use the Property-Set Method.
- In the Connector Simulator window, select the User Session option for the ClaimSim simulator. Click Apply Changes. The simulator is now active for the logged-in user. (Alternatively, you could select Global to enable the activity for all users). You can define multiple simulation activities. A User Session simulation will override a Global simulation.
- When the process is run, in place of retrieved values from an external system, the values set in the simulation activity are set in the clipboard.
To disable a simulation:
- From the Tools menu, select Tools > Integration > Ignore Connector Simulation to temporarily disable all simulations, or Tools > Integration > Clear Connector Simulation to remove all simulators. To enable an ignored simulation, click Ignore Connector Simulation again to deselect it.
- Alternatively, you can disable a connector from the Connector Simulator window. Click either Clear Local or Clear Global to clear the Global or User Session radio button. With no option selected, the simulator is disabled.