Analyzing the Runtime Version of a Process Template (SAP Library

Analyzing the Runtime Version of a Process Template

Use

A GP process template can be executed at runtime by the Business Workflow engine. To enable this, the system generates a runtime version for the Business Workflow (BWF) from the process template definition during the deployment phase.

You can display and analyze this runtime version. This can be helpful when errors occur, for example, when a process template cannot be executed.

You have the following options:

· Display the BWF runtime version either in XML or graphically

¡ You can save the XML output as a file, which you then pass on to SAP Support for further analysis.

¡ If you choose to display the runtime version graphically, this is done so in the Workflow Builder.

· Display dependent objects

For a detailed analysis, you can navigate to the dependent objects of the BWF runtime version, for example, to the associated Workflow task, the process roles or the generated classes.

· Repeat deployment

You can repeat the deployment of a BWF runtime version. This may be necessary, for example, if authorization problems lead to errors or if objects need to be recreated after a cleanup.

Prerequisites

The role SAP_BC_BMT_WFM_GP_ADMIN has been assigned to you.

Display the Runtime Version

1. In the user menu, choose Guided Procedures ® Guided Procedures (transaction SWF_GP). First, a selection screen is displayed.

Selection Screen

2. Before you start, you can use this selection screen to restrict the number of deployment runs displayed in the following overview. The following tables describe the individual areas of this selection screen.

Selection by Deployment Properties

Selection parameter	Description / column in overview
Selection Time Period	You can choose between the following criteria: · No restriction · Today · Last 7 days · Last 31 days · Any Date The Selection Time Period parameter refers to the Deploy Time column in the overview.
Users	The Users parameter refers to the User column in the overview. By default, this column is not displayed in the overview.
Sucessful Deployments	The Successful Deployments parameter refers to the Deploy Status column in the overview.
Deployments with Errors	The Deployments with Errors parameter refers to the Deploy Status column in the overview.

The following area concerns the properties of the process templates.

Selection by Guided Procedures Properties

Selection parameter	Description / column in overview
Category	The Category parameter refers to the Category column in the overview.
Name	The Name parameter refers to the Technical Name of Process Template column in the overview.

The following area concerns the properties of the runtime version of the process template for the Business Workflow.

Selection by Workflow Properties

Selection parameter	Description / column in overview
Workflow Task	The Workflow Task parameter refers to the Task column in the overview.

3. Choose Execute to exit the selection screen and go back to the overview.

Overview of Deployment Runs

For each BWF runtime version, this transaction displays the following information:

· Identification data of the process template, such as Name, ID, Category and Version.

· Task: during processing by the Workflow Engine, the runtime version of the process template is represented by a Workflow task. You do not normally need to know the number of the task. However, you can use the number to search for a task, for example.

· Deploy result:

¡ 0: The runtime version was created without errors.

¡ Not equal to 0: Errors occurred. If you repeat the deployment, you can see more detailed error messages.

4. To display the dependent objects, double-click a BWF runtime version or choose This graphic is explained in the accompanying text with the quick info Dependent Objects.

5. To display the XML representation, select the BWF runtime version or choose This graphic is explained in the accompanying text with the quick info Display XML.

6. To display the process template definition, select the BWF runtime version and click This graphic is explained in the accompanying text with the quick info Start Workflow Builder.

The process template definition is displayed in the Workflow Builder. You cannot make any changes to the process template definition in the Process Builder.

Repeat Deployment

...

1. To update a BWF runtime version with a deploy result not equal to 0, choose This graphic is explained in the accompanying text with the quick info Repeat Deployment.

The screen Deployment of <Name> appears.

2. Choose Deployment.

You can display the following types of messages:

¡ S: Success message after a step has been created.

¡ I: Information message, for example about default settings used.

¡ W: Warning message, which indicates logical errors and problems.

¡ E: Failure message, which stops a functional runtime version from being created.

3. To export the XML representation as a file, click This graphic is explained in the accompanying text with the quick info Save Document.

4. To display the definition for the current runtime version in the Workflow Builder, choose This graphic is explained in the accompanying text with the quick info Start Workflow Builder (see also: Workflow Builder).