To be able to use all the features AppTester provides, some configuration changes are required on the IBM BPM environment(s) used with AppTester.
AppTester relies on the REST capabilities that BPM offers to execute services. By default, BPM only allows Ajax Services and Human Services to be executed via REST.
In order to be able to execute all types of services via REST, from IBM BPM version 8.5.7 onwards, a configuration change is needed.
NOTE: To read more about this configuration option, please read the following IBM Knowledge Center article:
This article applies to IBM BPM version 8.5.7.
Steps to Perform
There are two key changes that are required, these are detailed in the following sub-section
Enable Execution of BPM Services via REST
To enable the execution of BPM services via REST, add the following section to the 100Custom.xml file of your BPM environment.
<server> <portal merge="mergeChildren"> <startservice-valid-services> <valid-service-entry>Ajax Service</valid-service-entry> <valid-service-entry>Human Service</valid-service-entry> <valid-service-entry>General System Service</valid-service-entry> </startservice-valid-services> </portal> </server>
The following list includes all existing services and values that are accepted within the valid-service-entry flag in the 100Custom.xml file:
- Regular Service
- Ajax Service
- Human Service
- Integration Service
- Installation Service
- General System Service
- SCA Service
- Case Manager Integration Service
- Undercover Agent Pass-through Service
Enable Non Exposed Human Services to Start
In order to create Test Records on Human Services that are not exposed, a further change is required to the 100Custom.xml file. This means that you do not have to expose each and every Human Service.
Add the following section to the 100Custom.xml:
<server> <rest> <compatibility-ignore-exposed-to-for-human-service merge="replace">true</compatibility-ignore-exposed-to-for-human-service> </rest> </server>
NOTE: More information about the 100Custom.xml file can be found in the following IBM Knowledge Center article: