SAP Workflow Development Guidelines

This document captures the OneList v6.5 SAP Workflow Development guidelines to ensure that the SAP workflows developed in the system are compatible with OneList Approvals.

Retrieving Approval Task Data

When OneList picks up new or changed work items in the system, it calls the method GET_OBJECT_DETAILS of the scenario’s implementation class to retrieve the workflow and document information to be sent to OneList.

OneList adapter supports the following data retrieval options:

Workflow Container

Business Objects (BO) attached into the workflow

Class Object attached into the workflow

Approval Task (Dialog Task)

For dialog task actions, all task action types are compatible with OneList SAP Adapters. However, it is advised to use Decision Task as this enables a single point of processing logic which is in the workflow.

Dialog Task Action options:

1. Decision Task – preferred option for task actions. This will enable single point of logic in actioning the work item and the document.

2. All other action types – This is compatible with OneList but the logic to action the work item and the document will need to be coded inside the OneList Adapter’s EXECUTE_ACTION method. In the workflow logic, it is advised to create a method/api where the action logic (approve, reject) will be performed which the workflow can use. This method/api can then be used by OneList as well when actioning the task. This ensures that only single logic of action is used between the workflow and OneList.

Approver Comments

During approver’s action, he/she may add a comment. When developing an approver comment functionality in the workflow, it is advised to use the store it as attachment text into the task by calling the Function Module SAP_WAPI_ATTACHMENT_ADD. This will insert the approver comments as attachment text:

The comment can be read by calling the Function Module SAP_WAPI_GET_ATTACHMENTS and then followed by Function Module SO_DOCUMENT_READ_API1.

Approver Attachments

Attachment files may also be stored into the work item as attachments binary. Function Module SAP_WAPI_ATTACHMENT_ADD can be used for attaching files into the work item.

Supporting Documents

Aside from the workflow attachments (attachment made during approval of the approver), OneList can also retrieve the attachment files from the document e.g. Attachments in a Purchase Oder document. OneList supports multiple areas where the attachments are stored. Most common is in Generic Object Services (GOS). There were some case where attachments are stored in BDS which can also be retrieved in OneList.

In summary, below are the supporting document sources:

OneList Approval Supported Functionalities

OneList Transactions