Starting Workflows or Tasks from Message Long Texts 

Use

Workflows or tasks can be started from message long texts.

If there are appropriate (target) elements in the workflow container or task container, the system passes the following data to the started workflow or started work item:

Container element

Data type reference

Explanation

ARBGB

T100-ARBGB

Message ID
(application area, for example 'WO')

MSGNR

T100-MSGNR

Message number (for example '430')

MSGTY

SYST-MSGTY

Message type ('E', 'A', 'S', etc.)

MSGV1

SYST-MSGV1

Message variable 1

MSGV2

SYST-MSGV2

Message variable 2

MSGV3

SYST-MSGV3

Message variable 3

MSGV4

SYST-MSGV4

Message variable 4

TEXT

T100-TEXT

Message text in which the variables (&) are not replaced

MESSAGE

Without type, that is C(255)

Message text in which the variables are replaced

This data is available in the container of the task started and can be used to control the process flow.

An application document is incomplete. The application communicates this via a message.

The Start workflow function is available to the user in the dialog box with the message long text. They can use it to start the linked workflow that will help solve the problem.

Features

You are supported in the functions described below by a Workflow Wizard. Choose Tools ® Business Workflow ® Development ® Definition Tools ® Wizards ® Create "Call Workflow From Message" .

How do you link a message to a workflow?

To implement this functionality, you enter the assignment between task and message in table T100W . Maintenance of this table is client-specific.

If the error message long text is displayed and a T100W assignment maintained, a function is displayed with which the relevant task can be executed.

A message can be linked to all possible task types (WS, WF, T, TS).

It is important that the container elements described above have been added to the container concerned (workflow container or task container). Otherwise, the information from the message cannot be evaluated in a meaningful way in the task started.

Workflow definition details

When defining a task that is to be started from a message long text, you create the elements specified above in the container. At runtime, the system then fills the container elements with the relevant values from the message.

The object reference to the application object to which the error refers, is not directly available via the message variables as a rule.

If the message variables are to contain the values of object key fields, the object reference must first be created within the workflow from these key fields. To do this, you must provide an appropriate instance-independent method with import parameters as shown in the following example (object method Build ):

BEGIN_METHOD BUILD CHANGING CONTAINER.
  DATA: KEYFIELD LIKE....
  SWC_GET_ELEMENT CONTAINER 'MSGV1' KEYFIELD.
  SWC_SET_OBJECTKEY KEYFIELD.
END_METHOD.