{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This section describes the main functionalities in the VSS Communication Framework: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification Triggers","type":"text","marks":[{"type":"link","attrs":{"href":"https://proaxia-prod-doc.atlassian.net/wiki/spaces/V5/pages/1944681894/Functions#Notification-Triggers"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task Processing","type":"text","marks":[{"type":"link","attrs":{"href":"https://proaxia-prod-doc.atlassian.net/wiki/spaces/V5/pages/1944681894/Functions#Task-Processing"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dynamic Parameters","type":"text","marks":[{"type":"link","attrs":{"href":"https://proaxia-prod-doc.atlassian.net/wiki/spaces/V5/pages/1944681894/Functions#Dynamic-Parameters"}}]},{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Imagine the following user stories:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":451,"id":"e4a50a15-ab54-4c70-b560-f9c319c2f074","collection":"contentId-1944681894","type":"file","height":264}}]},{"type":"paragraph","content":[{"text":"You can achieve the above user stories with the communication framework. The framework is very flexible to design your communication structure according to your business needs.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Notification Triggers","type":"text"}]},{"type":"paragraph","content":[{"text":"A transaction to define condition of the notification to be triggered. Notifications can be triggered from various VSS applications by mapping it to the Communication Event ID.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Transaction code: /DBE/CF_NOTIF_TRG, or:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the SAP Easy Access screen, choose “Logistics > Logistics Execution > Vehicle Sales and Service > Communication Framework > Process Definition > Notification Triggers”.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":453,"id":"bb18c49d-be33-4819-87c6-5a690c0971d2","collection":"contentId-1944681894","type":"file","height":225}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"The following is required before setting up the notification trigger:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sender type is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recipient type is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification channel is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Communication event ID is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification ID is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification template is assigned to notification ID in customizing.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Functionalities","type":"text"}]},{"type":"paragraph","content":[{"text":"In this transaction, you can set up the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Trigger detail","type":"text","marks":[{"type":"strong"}]},{"text":": In this step, you assign the communication event ID that will trigger the notification. You also define the business object type and source object type. Maintain the communication group if you want to restrict the notification for specific organization or sales area.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define pre-checks","type":"text","marks":[{"type":"strong"}]},{"text":": Pre-checks is used to define mandatory steps or pre-requisites before attempting to trigger necessary notification or task. The framework delivers sets of pre-checks that can be used to define the notification condition.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define notification to be sent","type":"text","marks":[{"type":"strong"}]},{"text":": In this step, you choose the notification ID to be used for the notification trigger. Notification ID is assigned to the notification template in customizing. You can define simple or complex notification content. For example, in case of sending email notification, the content of the notification can be complex. It can have specific layout or contain parameters from data objects. You can achieve this by creating your email template using standard SAP Email Template function in transaction code SE80. You can design the email content in HTML format and assign parameters that you have defined in framework customizing. You then assign this email template ID to the notification ID in the framework customizing. In case of simple notification content, for example, sent a request to service advisor to verify a service order. You can achieve this by using the FIORI push notification. Also in this step, you can define the notification priority, include attachment to the notification, define navigation target when the notification is clicked, define the target recipient, define validity of the notification, define context, and define sender.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Refer to “VSS 4.0 Communication Framework Cookbook” for explanation on how to use the notification trigger functionality.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Possible business case","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Trigger notification from VSS event","type":"text"}]},{"type":"paragraph","content":[{"text":"Example scenario: Trigger a notification to service advisor when a service order is created.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d34d008e-17c6-4da5-8fc2-e859bc857f16"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Requirement","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[229.0]},"content":[{"type":"paragraph","content":[{"text":"Condition","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[299.0]},"content":[{"type":"paragraph","content":[{"text":"What is required?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification when a service order is created","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[229.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VSS event ORD_NEW","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Map VSS event with communication event ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the communication event ID as notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification only to service advisor in my sales area","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[229.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Communication group","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the communication group in notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification only for order type 2000","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[229.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pre-check ID = CompareValueEQ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Order type 2000","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define pre-checks to filter only order type 2000","type":"text"}]}]}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send an email as the notification and I have specific email template","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[229.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification ID","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prepare the email template in SE80","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Assign the email template ID to notification ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the notification ID in notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification to all service advisors","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[229.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recipient type = RO (Role)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Service advisor role","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification channel = EMA (Email)","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a role for service advisor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Assign users to the role","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the role in the recipient field in notification trigger and select notification channel EMA","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Trigger notification from VSS Time Clocking event","type":"text"}]},{"type":"paragraph","content":[{"text":"Example scenario: Trigger a notification to service advisor when technician starts working on a job.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"92696b24-772f-4584-a0da-0cec47bfe419"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"Requirement","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"Condition","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#4c9aff","rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"What is required?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification when I start working on a job","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time clocking event type 40","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Map time clocking event type with communication event ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the communication event ID as notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification only to service advisor in my sales area","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Communication group","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the communication group in notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification only for order type 2000 and 2001","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pre-check ID = CompareValueIN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Order type [2000, 2001]","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define pre-checks to filter only order type 2000 and 2001","type":"text"}]}]}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send a FIORI push notification with simple text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification ID","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Maintain the notification content in notification ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the notification ID in notification trigger","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"I want to send notification to a specific SAP user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recipient type = US (SAP User)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification channel = FNT (FIORI Notification)","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the SAP User ID in the recipient field in notification trigger and select notification channel FNT","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Task Processing","type":"text"}]},{"type":"paragraph","content":[{"text":"A transaction to define processing steps for task. Steps of processes can be defined to be executed one after another and while processing the steps, task attributes can be updated, task action or event can be executed, and notification can be sent to target recipient.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Transaction code: /DBE/CF_TASK_TRX, or:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the SAP Easy Access screen, choose Logistics > Logistics Execution > Vehicle Sales and Service > Communication Framework Process Definition > Task Processing.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"The following is required before setting up the task processing steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sender type is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recipient type is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification channel is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Communication event ID is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification ID is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Notification template is assigned to notification ID in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task ID is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task status and task action is configured in customizing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task center layout and settings is completed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Functionalities","type":"text"}]},{"type":"paragraph","content":[{"text":"Task ID is defined in customizing. You can define as many task IDs as needed per business requirement. Each task ID should represent a dedicated business process, for example: service order processing, additional job processing or sales order processing. You can assign business objects, communication group, navigation target and UI icons for each task ID.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":453,"id":"ec391ac8-b3de-48db-a78f-a80d15fa0ece","collection":"contentId-1944681894","type":"file","height":54}}]},{"type":"paragraph","content":[{"text":"Once the task ID has been configured, you can create processing steps to each task ID.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":453,"id":"c7fb1adb-1c51-4f04-a68e-22b812d5edfe","collection":"contentId-1944681894","type":"file","height":51}}]},{"type":"paragraph","content":[{"text":"Imagine the scenario of a service order processing and you would like to monitor the lifecycle of the service order. You can create process steps that create or update task, update task attributes, execution task actions, update task priority and trigger notifications.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":453,"id":"4f335c99-ffa4-474b-803f-5aece76b52de","collection":"contentId-1944681894","type":"file","height":140}}]},{"type":"paragraph","content":[{"text":"From the example above, you define steps: Order created > Order released > Work started and so on. Each step can be executed by the communication event which is mapped with the VSS event. The steps can also be executed by the task actions which is triggered by the responsible assignee from the task center. You can assign task statuses to each process steps and monitor the status as the task progresses. “Final” step indicator can also be assigned to indicate that the processing of this service order is completed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to “VSS 4.0 Communication Framework Cookbook” for explanation on how to use the notification trigger functionality.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dynamic Parameters","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Essentials","type":"text"}]},{"type":"paragraph","content":[{"text":"Process design in Communication Framework in general involves definition of the trigger, starting conditions and actions to be performed. Actions are executed for the trigger when all starting conditions are met. In the process definition you have to cover particular business requirement, but you abstract from a specific business document, department, or organization. For example: when you define notification, that needs to be sent as a result of an event, in most cases the recipient (or recipients) is not known in advance and can only be determined depending on specific context (document, order or type of the event). In other words, Task (process) definition in Communication Framework acts as a template, that is applied for specific business object (document) when specific trigger occurs.","type":"text"}]},{"type":"paragraph","content":[{"text":"To address this requirement, most of the parameters that make up process definition in Communication Framework can be specified as ","type":"text"},{"text":"dynamic parameters","type":"text","marks":[{"type":"em"}]},{"text":". It means, that their values are not saved as constants, but refer to variables, that are calculated on demand only when the process is triggered in the runtime. Such variables can point to simple globally available static value, to source business object attribute, current context value but can also form quite complex calculations using predefined or customer-defined functions. Of course, constant values are also supported.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic parameters can be used in notification customizing, notification trigger definition and task transaction definition. To check, whether given field value can be entered as dynamic parameter, please refer to Performance Assistant (F1 help) for the field in SAP-GUI. For example:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":585,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":289,"alt":"image-20240918-105957.png","id":"dadb790b-7cdc-4358-ae40-be05ca156f30","collection":"contentId-1944681894","type":"file","height":106}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Definition","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Dynamic Parameter type","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic parameters can be used in multiple ways. Here is the detailed description of all types of usage.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Constant value","type":"text"}]},{"type":"paragraph","content":[{"text":"Character-like constants (string literals) must be entered in quotes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Numeric-like constants can be entered directly, using internal format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Date and time can be provided as a string, using internal format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Strings:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"'A001'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"'Long description'","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Numbers:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"123","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"99.78","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"-5","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Date:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"'20230123'","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"'081500'","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Reference to global variable","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic parameter can refer to any global variable. It means any variable, that is accessible globally from the ABAP scope in the Communication Framework runtime. It can be for example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reference to system field (ABAP SYST structure).","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Predefined variable provided by the Communication Framework (refer to documentation for list of all available variables). ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reference to any static attribute of any global class.","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o In that case class name is specified as attribute and class attribute is specified as subattribute.","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"[-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"System fields:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"sy-uname","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"sy-tcode","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"sy-datum","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Predefined variables:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"task_priority-low","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Static attributes of any global class:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o ","type":"text"},{"text":"cl_abap_char_utilities-cr_lf","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Reference to predefined objects of the framework","type":"text"}]},{"type":"paragraph","content":[{"text":"Source business object in the scope of task instance or notification. In this case you can access any attribute supported by the object provider (refer to BAdI for source object provider and check list of objects delivered by the framework).","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$source|$src|$s-[-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Communication task instance. Here you can access any attribute available from task instance header detail structure. Additionally, there are some special attributes supported (refer to the description of task special attributes).","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$task|$tsk|$t-[-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Current trigger context. You can access value of any context field by parameter name. The result can be single value or a list (in case of parameter with multiple values).","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$context|$ctx|$c-","type":"text"}]},{"type":"paragraph","content":[{"text":"All of the above objects (source business object, task instance, context) beside simple attribute access, support also function calls. It includes build-in functions (provided by the standard Communication Framework engine implementation) and customer defined functions, provided by dedicated BAdI implementations. For details on function definition please refer to ","type":"text"},{"text":"function calling","type":"text","marks":[{"type":"em"}]},{"text":" chapter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$task|$tsk|$t-$[(, , ...)][-[-…]]\n\n$source|$src|$s-$[(, , ...)][-[-…]]\n\n$context|$ctx|$c-$get|$cnt[(, , ...)][-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-ms_vbak_com-vbeln","type":"text","marks":[{"type":"code"}]},{"text":" – in case of VSS Order as source object, this gets field ‘vbeln’ of attribute ‘ms_vbak_com’ of VSS Order instance; check ","type":"text"},{"text":"attribute nesting","type":"text","marks":[{"type":"em"}]},{"text":" chapter below for more details; list of all available attributes can be found in documentation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$tsk-duedate","type":"text","marks":[{"type":"code"}]},{"text":" – gets attribute ‘duedate’ of communication task instance; for list of all available attributes of task instance, please refer to documentation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$tsk-$property('VEHICLE_NO')","type":"text","marks":[{"type":"code"}]},{"text":" – calls built-in function ‘PROPERTY’ of the task instance, passing ‘VEHICLE_NO’ as function parameter$","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ctx-reference_no","type":"text","marks":[{"type":"code"}]},{"text":" – gets value of parameter ‘REFERENCE_NO’ from current trigger context.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$ctx-@attachment","type":"text","marks":[{"type":"code"}]},{"text":" – gets value of parameter ‘@ATTACHMENT’ from current trigger context; if there was more than one context params with the same name, the result of this dynamic parameter will be list of strings, containing all values found.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$ctx-$cnt('JOBNR')","type":"text","marks":[{"type":"code"}]},{"text":" – gets number of occurrences of field with name ‘JOBNR’ in the context.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Function call","type":"text"}]},{"type":"paragraph","content":[{"text":"Communication Framework supports framework-predefined built-in functions and customer-defined functions as well. Function in general is a part of logic, that is executed on demand and should return single result value based on input parameters.","type":"text"}]},{"type":"paragraph","content":[{"text":"Function can take zero, one or more importing parameters. Each parameter can be any type. Function must return one single returning value. Returning value can be any type. Parameters to functions can be provided in parentheses, comma separated. Parameters are referenced by their order (so parameter name plays no role from function call perspective).","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to chapter ","type":"text"},{"text":"function calling","type":"text","marks":[{"type":"em"}]},{"text":" for more details.","type":"text"}]},{"type":"paragraph","content":[{"text":"Function can be provided as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Global function (framework-predefined or customer defined),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source object function (framework-predefined or customer defined),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task instance function.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Global predefined functions are provided by Communication Framework. You can check the list of all available functions in documentation. Such functions are called using syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$function|$fnc|$f-[(, , ...)]","type":"text"}]},{"type":"paragraph","content":[{"text":"Global customer-defined function indicates each compatible, publicly available class method. Compatible means, that interface of the method must conform to function requirement. Publicly available means public static method. This way any public static method of global class, with compatible interface, can be used as function in Communication Framework dynamic parameter. It can be SAP-delivered or customer-defined class. Functions of this type are called using following syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$function|$fnc|$f--[(, , ...)]","type":"text"}]},{"type":"paragraph","content":[{"text":"Source object functions are functions offered by source object provider implementation. Customer can define his own function both in predefined source object and in customer-defined objects by implementing corresponding source object provider BAdI. Source object functions are called using following syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$source|$src|$s-$[(, , ...)]","type":"text"}]},{"type":"paragraph","content":[{"text":"Task instance functions are functions offered by Communication Task instance implementation. List of all available functions can be found in documentation. Such functions are called using following syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$task|$tsk|$t-$[(, , ...)]","type":"text"}]},{"type":"paragraph","content":[{"text":"Context functions are functions offered by Communication Task context. List of all available functions can be found in documentation. Such functions are called using following syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$context|$ctx|$c-$[(, , ...)]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$fnc-username(sy-uname)","type":"text","marks":[{"type":"code"}]},{"text":" – calls built-in global function ‘USERNAME’, providing sy-uname as input parameter.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$fnc-zcl_util-read_text('HEADER', 'Z001', $src-detail-vbeln)","type":"text","marks":[{"type":"code"}]},{"text":" – calls static method ‘READ_TEXT’ of global class ‘ZCL_UTIL’, providing 3 parameters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-$get_field_job('000001', 'DESCR1')","type":"text","marks":[{"type":"code"}]},{"text":" – calls built-in function ‘GET_FIELD_JOB’ of VSS Order source object provider, passing 2 parameters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$task-$actor_key('RES')","type":"text","marks":[{"type":"code"}]},{"text":" – calls built-in task function ‘ACTOR_KEY’ with one parameter.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$ctx-$get($src-zzname)","type":"text","marks":[{"type":"code"}]},{"text":" – calls built-in context function ‘GET’ with parameter read from source object field ZZNAME.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Dynamic date","type":"text"}]},{"type":"paragraph","content":[{"text":"Communication Framework provides Dynamic Date Processor (DDP), that can be used to dynamically create date value. To use DDP, you must declare specific DDP operator together with parameters (optional). As result, single date value (of internal type DATS) is generated. List of all available DDP operators can be found in documentation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic date utilizes function call denotation for definition and parameter passing. It can be defined using following syntax:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$date|$d-[(, )]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$date-month_end(6) – gets end of June of the current year.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$d-week_begin – gets begin of the current week.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Case sensitivity","type":"text"}]},{"type":"paragraph","content":[{"text":"All references in dynamic parameter are case-insensitive, except of string literals. It means that ","type":"text"},{"text":"$ctx‑reference_no works","type":"text","marks":[{"type":"code"}]},{"text":" the same as ","type":"text"},{"text":"$CTX‑REFERENCE_NO","type":"text","marks":[{"type":"code"}]},{"text":". But ","type":"text"},{"text":"$tsk‑$property('VIN')","type":"text","marks":[{"type":"code"}]},{"text":" is not the same as ","type":"text"},{"text":"$tsk‑$property('Vin')","type":"text","marks":[{"type":"code"}]},{"text":" although internal implementation of the corresponding function (like built-in function ","type":"text"},{"text":"property","type":"text","marks":[{"type":"code"}]},{"text":" for Task instance) can ignore case for input parameters.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Error handling","type":"text"}]},{"type":"paragraph","content":[{"text":"If dynamic parameter refers to non-existing attribute, non-existing context parameter or not existing or invalid function, it simply returns no value. No error is raised in this case and task/notification processing is not aborted. It depends on the usage, whether no value gives reasonable result or not.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attribute nesting","type":"text"}]},{"type":"paragraph","content":[{"text":"You can access nested attributes of the variable. Variable must be flat structure - accessing internal table lines is not supported. Sub-attributes must be separated by hyphen '-'. Any level of nesting is supported.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"task_priority-high","type":"text","marks":[{"type":"code"}]},{"text":" – refers to component ","type":"text"},{"text":"high","type":"text","marks":[{"type":"code"}]},{"text":" of predefined, global constant ","type":"text"},{"text":"task_priority","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cl_global_class-header-field","type":"text","marks":[{"type":"code"}]},{"text":" – refers to field ","type":"text"},{"text":"field","type":"text","marks":[{"type":"code"}]},{"text":" of structure ","type":"text"},{"text":"header","type":"text","marks":[{"type":"code"}]},{"text":", which is static attribute of global class ","type":"text"},{"text":"cl_global_class","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$source-detail-customer-name1","type":"text","marks":[{"type":"code"}]},{"text":" – gets ","type":"text"},{"text":"detail","type":"text","marks":[{"type":"code"}]},{"text":" attribute of the source business object, then accesses component ","type":"text"},{"text":"customer","type":"text","marks":[{"type":"code"}]},{"text":" of the ","type":"text"},{"text":"detail","type":"text","marks":[{"type":"code"}]},{"text":" attribute and finally reads field ","type":"text"},{"text":"name1","type":"text","marks":[{"type":"code"}]},{"text":" of ","type":"text"},{"text":"customer","type":"text","marks":[{"type":"code"}]},{"text":" component; both ","type":"text"},{"text":"detail","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"customer","type":"text","marks":[{"type":"code"}]},{"text":" must be structure-type components.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Calculations","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic parameter supports simple calculation: addition/concatenation. You can define value as combination (summary) of more than one component. Each component must be valid value in terms of dynamic parameter. Components must be separated by '+' sign.","type":"text"}]},{"type":"paragraph","content":[{"text":"Depending on the resulting type of the components, the calculation can be concatenation (for character-like components) or addition (for numbers, dates, etc).","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sy-datum + 2","type":"text","marks":[{"type":"code"}]},{"text":" results in date equal to two days after today,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'PFCG_ROLE_A_' + $src-detail-plant + '_ABC'","type":"text","marks":[{"type":"code"}]},{"text":" assuming ","type":"text"},{"text":"$src-detail-plant","type":"text","marks":[{"type":"code"}]},{"text":" contains value ‘0001’, the result is decoded into string 'PFCG_ROLE_A_0001_ABC'.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Function calls","type":"text"}]},{"type":"paragraph","content":[{"text":"Dynamic parameters support not only access to static variables but allow also function execution. Functions in terms of dynamic parameter can be provided in following ways:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Predefined (built-in) Communication Framework function,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Customer-defined function (including any compatible method of the global class),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Function defined by source object implementation.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Functions are specified in dynamic parameter using special syntax. It looks similar to simple variable access but supports additionally input parameters. Parameters can be provided to function by putting them as comma-separated list in parentheses ‘()’. If function does not require any parameter, or you don’t want to pass any parameter as they are optional, the parentheses can be omitted. Parameter values are passed to the function by their sequence. You can skip parameter only if it is not obligatory and there is no other parameter that must be provided after it. Each parameter must be valid value in terms of dynamic parameter. It means that parameter can be specified as constant, reference to variable or even another function call.","type":"text"}]},{"type":"paragraph","content":[{"text":"New functions can be implemented in two ways:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As class method,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As source object function (via source-object provider implementation).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As task instance function (via CMF Task BAdI implementation).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Any class method is function-compatible when following conditions are met:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is accessible in the context of the execution. This is always true for public static method of the global class.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It has zero or more importing parameters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It has exactly one returning parameter.","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o In general, type of the return parameter is not restricted, but it should be the type that can be used as dynamic parameter value. It includes any primitive type, structure type or table type.","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$func|$fnc|$f--[(param1, param2, …)][-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$fnc-zcl_utils-get_user_name(sy-uname)","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Calls method ","type":"text"},{"text":"get_user_name","type":"text","marks":[{"type":"code"}]},{"text":" of class ","type":"text"},{"text":"zcl_utils","type":"text","marks":[{"type":"code"}]},{"text":", providing current username as first input parameter.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is also possible for customers to define functions that work as built-in functions in source object or Task instance. In that case, function call is passed to the source object via source object provider implementation (refer to BAdI for source object provider) or Task instance (refer to BAdI for CMF Task processing). With that approach, customers can add new functions to standard/already existing source objects or define functions for own source object implementation. During function execution, system passes function name together with parameter values into corresponding method of the BAdI implementation:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For business source object","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o BAdI: /DBE/CF_SRCOB_PROVIDER","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Method: /DBE/IF_CF_ENH_SRCOB_PROVIDER~GET_ATTRIBUTE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Task instance","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o BAdI: /DBE/CF_TASK","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Method: /DBE/IF_CF_ENH_TASK~GET_FIELD","type":"text"}]},{"type":"paragraph","content":[{"text":"Internal logic of the method is fully responsible for providing correct result for the call, based on input parameters.","type":"text"}]},{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"codeBlock","content":[{"text":"$source|$src|$s-$[(param1, param2, …)][-[-…]]\n\n$task|$tsk|$t-$[(param1, param2, …)][-[-…]]","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-$partner_name('WE', true)","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Call function ","type":"text"},{"text":"partner_name","type":"text","marks":[{"type":"code"}]},{"text":" of current source object providing ‘","type":"text"},{"text":"WE","type":"text","marks":[{"type":"code"}]},{"text":"’ and ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" as input parameter.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Technically method GET_ATTRIBUTE of BAdI /DBE/CF_SRCOB_PROVIDER is called in this case with following input:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"IS_SOURCE_ID -> contains identification of the current source business object,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"IV_ATTRIB -> is set to value ‘","type":"text"},{"text":"$partner_name","type":"text","marks":[{"type":"code"}]},{"text":"’,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"IT_PARAMS -> contains value ‘","type":"text"},{"text":"WE","type":"text","marks":[{"type":"code"}]},{"text":"’ in first line and value ‘","type":"text"},{"text":"X","type":"text","marks":[{"type":"code"}]},{"text":"’ (internal representation of ABAP ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" value) in second line.","type":"text"}]},{"type":"paragraph","content":[{"text":"The BAdI implementation must then provide valid value as result of the call.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Predefined attributes, functions, DDP operators","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Global attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"TRIGGER","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Information about current event/action trigger","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: /DBE/CF_STR_ITRIGGER_DATA (DDIC structure)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"TRUE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constant value ","type":"text"},{"text":"abap_true","type":"text","marks":[{"type":"em"}]},{"text":" (‘X’)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: ABAP_BOOL","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"FALSE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constant value ","type":"text"},{"text":"abap_false","type":"text","marks":[{"type":"em"}]},{"text":" (‘ ‘)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: ABAP_BOOL","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"UNDEFINED","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constant value ","type":"text"},{"text":"abap_undefined","type":"text","marks":[{"type":"em"}]},{"text":" (‘-‘)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: ABAP_BOOL","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"INITIAL","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initial value (empty string)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: String","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DATE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constants for date","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: DATS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Components","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MIN (equal to 00-00-0000)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MAX (equal to 31-12-9999)","type":"text"}]},{"type":"paragraph","content":[{"text":"TIME","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constants for time","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: TIMS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Components:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MIN (equal to 00:00:00)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MAX (equal to 23:59:59)","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTIF_PRIORITY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constants for notification priority","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: CHAR(1)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Components:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o NOT_SPECIFIED","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o LOW","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MEDIUM","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o HIGH","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o CRITICAL","type":"text"}]},{"type":"paragraph","content":[{"text":"TASK_PRIORITY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Constants for Task priority","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: CHAR(1)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Components:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o NOT_SPECIFIED","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o LOW","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o MEDIUM","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o HIGH","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o CRITICAL","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" – equivalent for ‘X’","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"trigger-event_id","type":"text","marks":[{"type":"code"}]},{"text":"– ID of the Communication Framework event currently processing","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"trigger-task_action","type":"text","marks":[{"type":"code"}]},{"text":" – ID of the Task Action in case processing was triggered by action","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"notif_priority-high","type":"text","marks":[{"type":"code"}]},{"text":" – constant for high notification priority high (‘","type":"text"},{"text":"3","type":"text","marks":[{"type":"code"}]},{"text":"’).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Predefined functions","type":"text"}]},{"type":"paragraph","content":[{"text":"COUNT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns number of lines for table-type variable and 1 on case of any other not empty variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable [any]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Number","type":"text"}]},{"type":"paragraph","content":[{"text":"LENGTH","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns text length for character-like variable and 0 for any other variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable [any]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Number","type":"text"}]},{"type":"paragraph","content":[{"text":"USERNAME","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns long name of the SAP user provided as input parameter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o SAP user ID [character-like]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o String","type":"text"}]},{"type":"paragraph","content":[{"text":"CUSTOMER_NAME","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns customer name for customer number. GDPR conditions are considered.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Customer number [KUNNR]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o String","type":"text"}]},{"type":"paragraph","content":[{"text":"DAYS_SINCE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Calculates number of days that passed from specific date. If provided date is from the future, result is negative.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Date [DATS]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Number","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Returns output presentation of variable passed as input parameter.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable [any]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o String","type":"text"}]},{"type":"paragraph","content":[{"text":"FORMAT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Formats text based on template and up to 9 parameters. Template variable must be defined as: &n, where n is variable number.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Template [character-like]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 1 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 2 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 3 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 4 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 5 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 6 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 7 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 8 [any, optional]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Variable 9 [any, optional]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o String","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"Examples","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$fnc-count($task-@attachment)","type":"text","marks":[{"type":"code"}]},{"text":" – returns number of task attachments; refer to task instance special attribute ","type":"text"},{"text":"@attachment","type":"text","marks":[{"type":"code"}]},{"text":" for details","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$fnc-username($src-header_detail-ernam)","type":"text","marks":[{"type":"code"}]},{"text":" – returns name of the source object creator (assuming source object provides creator username in field ","type":"text"},{"text":"ERNAM","type":"text","marks":[{"type":"code"}]},{"text":" of ","type":"text"},{"text":"HEADER_DETAIL","type":"text","marks":[{"type":"code"}]},{"text":" attribute","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$f-days_since($src-header_detail-erdat)","type":"text","marks":[{"type":"code"}]},{"text":" – returns number of days since the source document creation.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Source objects","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"VSS Order","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Object ID","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Class: BO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: BUS2400","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"HEADER","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to MS_VBAK_COM attribute of the VSS Order instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type: DDIC structure /DBE/VBAK_COM","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"HEADER_DB","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to MS_VBAK_DB attribute of the VSS Order instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type: DDIC structure /DBE/VBAK_COM","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DIALOG_CONTROL","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to MS_DIALOG_CONTROL of the VSS Order instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type: DDIC structure /DBE/OE_DIALOG_CONTROL","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Built-in functions","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"GET_JOB","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the Job data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Job number [character-like | number]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: DDIC structure /DBE/JOB_COM","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"GET_JOB_FIELD","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the single Job field value","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Job number [character-like | number]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Field name [character-like]","type":"text"}]},{"type":"paragraph","content":[{"text":"Result type: any","type":"text"}]},{"type":"paragraph","content":[{"text":"GET_ITEM","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the Item data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Item number [character-like | number]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: DDIC structure /DBE/VBAP_COM","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"GET_ITEM_FIELD","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the single Item field value","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Item number [character-like | number]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Field name [character-like]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: any","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"GET_DPR","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access to the DPR document data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o DPR document number [character-like (BELNR_D)]","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: DDIC structure /DBE/ORD_DPR_LIST","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"GET_PARTNER_INFO","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Get data for the partner of the given role. If there are more than one partner for the role, only first one is selected.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Partner function [CHAR 2 (PARVW)]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"optional, default: ‘AG’","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: DDIC structure /DBE/ORD_PARTNER_S","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"GET_PARTNER_NAME","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Get name of the partner in given role. If there are more than one partner for the role, only first one is selected. Takes GDPR rules into account.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Partner function [CHAR 2 (PARVW)]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"optional, default: ‘AG’","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"o Use manual address data [boolean]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":2}}],"content":[{"text":"Optional, default: ","type":"text"},{"text":"false","type":"text","marks":[{"type":"em"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result type: string","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"Examples","type":"text","marks":[{"type":"underline"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-ms_vbak_com-vbeln","type":"text","marks":[{"type":"code"}]},{"text":" – for VSS Order as source object: return VSS Order number (field ","type":"text"},{"text":"VBELN","type":"text","marks":[{"type":"code"}]},{"text":" of attribute ","type":"text"},{"text":"MS_VBAK_COM","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-$get_field_job($ctx-/dbe/jobnr, 'DESCR1'","type":"text","marks":[{"type":"code"}]},{"text":") – for VSS Order as source object: return value of field ","type":"text"},{"text":"DESCR1","type":"text","marks":[{"type":"code"}]},{"text":" of Job with number provided by context parameter ","type":"text"},{"text":"/DBE/JOBNR","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-$get_item($ctx-/dbe/posnr)-zmeng","type":"text","marks":[{"type":"code"}]},{"text":" – for VSS Order as source object: return value of the field ","type":"text"},{"text":"ZMENG","type":"text","marks":[{"type":"code"}]},{"text":" (quantity) for order item number equal to context field ","type":"text"},{"text":"/DBE/POSNR","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$src-$get_partner_name('AG', true)","type":"text","marks":[{"type":"code"}]},{"text":" – for VSS Order as source object: returns Sold-To-Party name; when manual address has been entered in the order, it takes name from order document, not customer master data.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SRS Order","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Object ID","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Class: BO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: /DBME/WORD","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Any field from DDIC structure /DBME/WMA_STR_ORDH_DATA.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"VSS Vehicle","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Object ID","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Class: BO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: /DBE/VEHI","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Any field from DDIC structure VLCVEHICLE.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"DPF Transaction","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Object ID","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Class: OT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: /DBE/DP_TRANSACTION","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Any field from DDIC structure /DBE/DP_STR_PYMNT_TR_DETAIL.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Task instance","type":"text"}]},{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"In general, all simple fields of structure /DBE/CF_STR_INS_TASK_BASE are available as Task instance attributes. It means, that any customer-enhancement fields added to that structure will become available as well. Below is the list of most important standard Task instance attributes.","type":"text"}]},{"type":"paragraph","content":[{"text":"TASK_ID","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 30 (/DBE/CF_TASK_ID)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"TASK_KEY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Key properties formatted into one field","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 70","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"STATUS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Current status","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 10 (/DBE/CF_TASK_STATUS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"STATUS_PR","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Previous status","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 10 (/DBE/CF_TASK_STATUS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"STATUS_TS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time of the status change (timestamp)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 15 (TZNTSTMPS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"HISTRY_TS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time of history change (timestamp)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 15 (TZNTSTMPS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"SRCOB_CL","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source object class","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 2 (/DBE/CF_SRCOB_CLASS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"SRCOB_TYPE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source object type","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 30 (/DBE/CF_SRCOB_TYPE)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"SRCOB_KEY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source object key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 70","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"SRCOB_EXTID","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source object external key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 50","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"PRIORITY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task priority (priority code)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 1 (/DBE/CF_TASK_PRIORITY)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DUEDATE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Due date (date)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 8 (DATS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"XREATM_TS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expected reaction time (timestamp)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 15 (TZNTSTMPS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CREATED_AT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time of the task creation (timestamp)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 15 (TZNTSTMPS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CHANGED_AT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time of the task update (timestamp)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 15 (TZNTSTMPS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CLOSED","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Task closed indicator (Boolean)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 1(XFELD)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CREATED_BY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Username of the task creator","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 12 (UBNAME)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CHANGED_BY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Username of the task last processor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 12 (UBNAME)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"PROGRESS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Progress value (percentage number)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 3.0","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"ITS_OBJTID","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Internal Task Instance UID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 32","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"ITSUID","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Internal Task Instance UID (url-formatted)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 32","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"STATUS_CT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time elapsed from the status change (in seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 10","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"HISTRY_CT","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Time elapsed from the previous history update (in seconds)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): DEC 10","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"INITIATED_BY","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initiator of the last task update (encoded recipient ID)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 82","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"XREATM_DATE","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expected reaction time (date part)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 8 (DATS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"XREATM_TIME","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expected reaction time (time part)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 6 (TIMS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"XREATM_EXC","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expected reaction time has exceeded (Boolean)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data type (internal): CHAR 1(XFELD)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Special attributes","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"There are also special attributes predefined by the framework, that are used for access to some Task instance information, that is not available directly as simple attribute. It includes access to texts, attachments and Task properties. Special attributes are indicated by ‘@’ at the beginning of the name.","type":"text"}]},{"type":"paragraph","content":[{"text":"@TEXT","type":"text"}]},{"type":"paragraph","content":[{"text":"@T","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return text element information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Usage syntax:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"$task|$tsk|$t-@text|@t[-[-[-

Browser not supported