The output management control is a “reusable component”, which means that it can be used as a building block, also for SAP Fiori Elements. The control allows the user to manage the output process of a business document (such as sales orders or billing documents, for example). It gives the user the possibility to evaluate the output history for a specific business document – including the state of an output process – and offers interaction on those.
When triggered by the business application, the output control collects and validates all output parameters, creates the output documents, and outputs them. The possible output parameters handled include what to output, for whom, when, and through which medium.
A simple use case is: You choose to e-mail an output document to your customer based on an available form template. The system records the date the output was created and indicates that the output has been sent.
- The table title shows the title Output Details (Number of Items). For example: Output Details (4)
- The table toolbar shows actions as text buttons and the table personalization icon button.
- The table items display the status and different parameters of the output items:
Status: The status can be In preparation, To be output, Pending, Complete, or Error.
Dispatch Time: The dispatch time can be set to Immediately or Scheduled.
Output Type: For example, a billing document or a sales order.
Channel: Possible channels are printer, email, and XML. The application development team decides which ones are offered. Depending on the channel, the Output Details offer specific information.
Recipient: The recipient can be a business partner or a technical system, for example. If the channel is set to Email, the Output Details popover allows the user to add and edit specific persons to the To, CC, and BCC input fields.
Form Language and Form Template: Shows which language and template is used.
Preview: Is always offered as PDF.
The Output Details link within the table will open a popover to show more details of the output item. The popover is only be used for the channel Email and Print. It shows the following additional fields which can be changed in edit mode:
Behavior and Interaction
Table toolbar actions
- Send Output triggers the output process according to the dispatch time.
- Resend triggers the output again in case an error occurred. A copy is created for successful documents you wish to output again.
- Set to Completed generally happens automatically, but you can also manually set the status to complete if the output is obsolete.
- Show Application Log shows the processing protocol.
Table row actions
- The PDF icon allows the user to preview the document as a PDF.
Actions are enabled or disabled dynamically depending on the status of the output item. The following table explains how the status of output items proceeds and determines the actions that you can perform:
|Status of Output||Possible Actions|
|In preparation||This is the status after creating an output document until the output process is triggered automatically or manually via the action Send Output.||Send Output, Edit|
|To be output||Indicates that the output item is ready to be output. Only visible if the dispatch time is set to Scheduled. If the dispatch time is set to Immediately, the jobs starts to run and the status is not visible to the end user (to short).||Editable – Only the dispatch time, Show Application Log|
|Pending||The output has been triggered, but is not yet complete (for example, the output is still in the print queue or the email server didn’t respond yet).||Set to Complete, Show Application Log|
|Error||An error occurred during the output process.||Resend, Set to Complete, Show Application Log|
|Completed||The output item has been fully processed.||Resend, Show Application Log|
Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.