Customer-Defined Tab Page for Work Item Display

The work item display covers three tab pages (Basic Data, Activities, and Available Objects) as standard. You can add another, individual tab page, which is displayed as the first tab page when you call the work item display.

You can define an individual tab page for an activity, a document generation or a user decision in a workflow definition. This additional tab page only appears when work items that represent this step are displayed.

This additional tab page can be used for the following purposes, among others:

• You can display important information from the current process, which does not appear as standard in the work item display.

• You can make functions required frequently by a recipient more accessible by placing them directly on the tab page.

• You can give the work item display an individual "look and feel" in keeping with the company.

Every activity, document generation and user decision can have its own customer-defined tab page in the work item display. In some cases, it can be useful to assign the same additional tab page to all activities, document generations and user decisions in a certain business process.

The function group SWL0, screen 0100 is available as a programming example for a customer and process-specific tab page in module pool SAPLSWL0. This example shows the import data for the object Vacation Request and illustrates the three functions Set Approval for Resubmission, Add Attachment, and Display Request. This tab page is only suitable for an activity with an object of the type FORMABSENC in the container.

To test the functionality of the customer-defined tab page, proceed as follows:

1. Define a workflow that processes a notification of absence and contains, for example, a task for the method approve of the object type FORMABSENC (notification of absence).

2. When you define the activity for this task, specify the module pool SAPLSWL0 in the Program Name field and the screen 0100 in the Screen Number field in the area Step-Specific Tab Page for Work Item Display on the tab page Work Item Display.

3. Start the workflow. The work item of the approval step contains the additional tab page in the work item display.

You must have knowledge of programming screens. For more information, see Screen Painter.

To define your own tab page, you create a module pool with a screen as a subscreen in the customer namespace.

The main screen (and the other tab pages) of the work item display are contained in an SAP module pool. Communication between the main screen and your tab page has been purposely restricted and can be easily implemented using a collection of macros. Insert the include <widisp> in the top include of your module pool in order to use these macros:

            include <widisp>.
         

You can use the following macro instructions:

• SWL_WIDISP_GET_INIT:

  Getting the Initial Screen Run

• SWL_WIDISP_SET_TITLE:

  Setting the Title on the Tab Page Index

• SWL_WIDISP_GET_WI_ID:

  Getting the ID of the Current Work Item

• SWL_WIDISP_GET_OKCODE:

  Getting the Selected Function Code

• SWL_USER_WIDISP_SET_OKCODE:

  Setting a Function Code

• SWL_WIDISP_CLEAR_OKCODE:

  Deleting a Function Code

• SWL_WIDISP_SET_DIRTY:

  Setting a "Dirty Flag"

• SWL_WIDISP_GET_DIRTY:

  Getting a "Dirty Flag"

You usually want to offer data or functions on your tab page, which refer to the objects that are also referenced in the container of the work item. You can use the function module SAP_WAPI_GET_OBJECTS from the SAP WAPI interface to establish the objects associated with the work item. For examples of how to use this function module, see Importing the Leading Object.