Consuming the GPActionDiscoveryWSIL Web Service 

 

The GPActionDiscoveryWSIL service is a collection of active and deprecated GP actions available on an application server, for which the WSIL document is dynamically generated upon request. Each service element in the WSIL contains a name and description of the action, as well as a valid URL, used to generate a WSDL document for it.

The WSIL contains information only for actions for which the user has permissions.

WSIL Generation

To retrieve the WSIL document you should enter the following URL in a browser window:

http://<host>:<port>/gpcore/GPActionDiscoveryWSIL

Replace <host> with the host name of where your application server resides, and <port> with the server’s port for HTTP communications.

http://localhost:53000/gpcore/GPActionDiscoveryWSIL 

WSDL Generation

To generate the WSDL document for a specific service (GP action), choose an action and use the corresponding URL from the WSIL listing:

http://<host>:<port>/gpcore/GPExecuteActionWSDL/aidX/averY?wsdl

Replace <host> with the host name of where your application server resides, and <port> with the server’s port for HTTP communications. X stands for action ID and Y stands for action version.

The WSDL document is generated from a preliminary defined WSDL template in which the input and output parameters are replaced with the ones from the specified action template.

CompleteAction Operation

Once the WSDL document is generated, you can see details about a specific service residing on the application server. All operations available for the service are listed in the WSDL together with their input and output parameters.

The Web service operation for step completion is CompleteAction.

It has the following parameters:

Technical Name	Description
Input Parameters
ProcessInstanceID	The unique ID of the process instance, to which the action belongs. You can retrieve the process instance ID from the list of running processes in NetWeaver Administrator → System Management → Monitoring → Guided Procedures → Process Instances.
ActivityInstanceID	The unique ID of the action that needs to be performed by the Web service. You can retrieve the action (task) ID from the process URL if you start the GP outside the portal: http://<host>:<port>/webdynpro/dispatcher/ sap.com/caf~eu~gp~ui~rtwc/WorkCenterRunTime
StepOutputData	The structure encapsulating the output parameters from the previous process step.
Processor	The processor of the action.
InsertNewUsers	New users that can are inserted in addition to the ones already assigned to the process.
ResultStateNames	The names of the result states (if any) received from the previous step of the process. Result states are available only if no exception is raised.
ProcessExceptionName	The name of the process exception raised (if any) during the previous step of the process. If a process exception is raised no result states are available in ResultStateNames.
TechExceptionMessage	The technical exception message (if any) that is used to raise an exception caused in the previous process step. If TechExceptionMessage is passed as an input parameter, no values are available for ProcessExceptionName and ResultStateNames.
Output Parameters
Return_Parameter	The CompleteAction operation returns as an output parameter a structure with the output parameters of the action itself.

 

GP design time provides the means for WSIL, WSDL generation and the execution of the operations listed above through its Web service callable object. Therefore, you can consume the Web service even if you do not know specific service details.

See Completing a Step Using Web Services.