Object Type WF_TASK (SAP Library - BC - SAP Business Workflow

Object Type WF_TASK

Use

The object type WF_TASK provides methods for finding and assigning agents for steps in the workflow. An object of the type WF_TASK is a task specified with type (two characters) and number (eight digits).

Features

Method AllAgentsOfTaskGetAndDispatch

The method AllAgentsOfTaskGetAndDispatch ( Determine all agents and select) enables you to select recipients for the work item of a step. The task referenced in the step is an import parameter of the method.

The method determines a list of all possible agents for the task, if it is not a general task. The agent of the method can make their choice from this list. This selection list is an export parameter of the method.

The method requests a recipient list from the agent of the method for a general task. This list can be made up of user names or Office names. Distribution lists can also be entered.

Since the system only searches for distribution lists if it was not able to find a name, you must ensure that you only use distribution lists whose names are not also used as Office names.

Parameters of method AllAgentsOfTaskGetAndDispatch

The parameters of the method AllAgentsOfTaskGetAndDispatch are listed and explained in the table below.

Parameter	Type	Explanation
Weg_ID	Import	Evaluation path Positions and users should be the result of the evaluation.
Act_Org_Obj	Import	Starting point of the evaluation Any organizational object can be specified here.
Task_ID	Import	Task ID Two-character task type and eight-digit number. The possible agents of this task are used in a comparison.
SelectMultiple	Import	Indicator: Multiple selection allowed If the indicator is set, the result of the selection is returned in the multiline element SelectedObjectList . Otherwise the result is returned in the single-line element SelectedObject .
SelectedObject	Export	Selected agent The agent is identified by the two-character abbreviation and eight-digit number or twelve-character user name.
SelectedObjectList	Export	List of selected agents The agents in the list are identified by the two-character abbreviation and eight-digit number or twelve-character user name.

When the method is used in a task, container elements with the same names as the method parameters are created in the task container and the relevant binding is defined from/to the task container as standard.

If it is not necessary to compare the agents determined using the evaluation path with the possible agents of the single-step task, the evaluation path can be set so that only the possible agents are determined.

Use the same task as in Task_ID as Act_Org_Obj .

Use the evaluation path SAP_TAGT as Weg_ID .

Method Dispatch

The method Dispatch ( Display and select agents) enables agents to be selected from a list. The list must be passed to the method as an import parameter.

Process flow when executing the method Dispatch

The method receives a list of agents as import parameter. These agents can be organizational units, jobs, positions and users.

This list is compared with the possible agents of the task for which the agents are to be established.

The list then contains only the agents who are both possible agents and included in the result of the evaluation path.

The comparison only works if the evaluation path only returns positions and users.

This (reduced) list is offered to the agent of the method so that they can make a choice of agents.

The result of the evaluation is made available as export parameter of the method.

Parameters of method Dispatch

The parameters of the method Dispatch ( Display and select agents) are listed and explained in the table below.

Parameter	Type	Description
ObjectList	Import	List of agents as input for reconciliation The agents in the list are identified by the two-character abbreviation and eight-digit number or twelve-character user name.
Task_ID	Import	Task ID Two-character task type and eight-digit number. The possible agents of this task are used for reconciliation.
SelectMultiple	Import	Indicator: Multiple selection allowed If the indicator is set, the result of the selection is returned in the multiline container element SelectedObjectList , otherwise the result is returned in the single-line element SelectedObject .
SelectedObject	Export	Recipient The agent is identified by the two-character abbreviation and eight-digit number or twelve-character user name.
SelectedObjectList	Export	List of recipients The agents in the list are identified by the two-character abbreviation and eight-digit number or twelve-character user name.

The method Dispatch is called internally by the method GetListAndDispatch .

Method Resolve

The method Resolve resolves a list of organizational objects consisting of two-character type and eight-digit number by evaluating the organizational plan up to user level. The resolved list is returned sorted alphabetically, with any duplicates being omitted.

Parameters of method Resolve

Parameter	Type	Description
ObjectList	Import	List of organizational objects The objects in the list are identified by the two-character abbreviations and eight-digit number or twelve-character user name.
ResolvedObjectList	Export	List of user names The objects in the list are identified by the two-character abbreviation "US" and the twelve-character user name.

Method ResolveAndDispatch

The method ResolveAndDispatch connects the methods Resolve and Dispatch and processes the following steps:

A list of organizational objects consisting of two-character type and eight-digit number is resolved up to user level by evaluating an organizational plan.

This list is passed to the selection dialog.

The selection in dialog constitutes the return value of the method.

It is not the organizational objects stored in the task definition that are offered for selection in the selection dialog, but the users connected with these organizational objects.

You should use the virtual attribute AllAgentsOfTask to read the task definition and use it as an import parameter for the method.

Parameters of method ResolveAndDispatch

Parameter	Type	Description
ObjectList	Import	List of organizational objects that are offered for selection, resolved to user level. The objects in the list are identified by the two-character abbreviations and eight-digit number or twelve-character user name.
Title	Import	Title of the dialog box for agent selection.
SelectMultiple	Import	Indicator: Multiple selection allowed If the indicator is set, the result of the selection is returned in the multiline container element ResolvedSelectedObjectList . Otherwise the result is returned in the single-line element ResolvedSelectedObject .
ResolvedSelectedObject	Export	Selected agent The agent is identified by the two-character abbreviation "US" and twelve-character user name (cf. import parameter "SelectMultiple").
ResolvedSelectedObjectList	Export	Selected agents The agents in the list are identified by the two-character abbreviation "US" and twelve-character user name (cf. import parameter "SelectMultiple").

Method AllAgtsOfTskGetDispatchResolve

The method AllAgtsOfTskGetDispatchResolve executes the methods AllAgentsOfTaskGetAndDispatch and Resolve in succession, meaning that the recipients returned are all user names.

It is possible to restrict the organizational objects offered for selection and deactivate multiple selection within this list. However, a multiline container element is always returned irrespective of the status of multiple selection.

Parameters of method AllAgtsOfTskGetDispatchResolve

Parameter	Type	Description
SelectMultiple	Import	Indicator: Multiple selection allowed Multiple selection refers to selection in dialog. The return value of the method is always a multiline container element.
Title	Import	Title of the dialog box for agent selection.
AllowedAgentTypes	Import	List of the Organizational Management types that can be selected at all, for example "O" for "organizational unit".
SelectedObjectList	Export	List of selected recipients The users in the list are identified by the two-character abbreviation "US" and the twelve-character user name.

Attribute AgentsOfTask

The (multiline) virtual attribute provides all possible agents of the task by reading the task definition.