for ECC and S/4
Box - Implementation Guide

Box - Message Output

22min

1. Message Output Description 

Message Output in SAP allows users to generate and distribute documents from SAP to various output channels. With docuflow, these generated documents can be routed to your Box environment for storage and distribution.

Key benefits include:

  1. Centralized document storage in Box
  2. Secure distribution with Box's permission settings
  3. Seamless integration with SAP processes
  4. Support for multiple output formats
  5. Audit trail and compliance features
  6. Reduced manual effort through automation

Example use cases:

  • Distributing invoices, shipping notifications, and order confirmations to customers, partners, and suppliers via Box

2. Content Server vs ECM 

When storing Message Output documents, there are two options: 

  1. Content Server 
  2. ECM Server 

Content Server 

Content Server is a communication specification defined by SAP that uses HTTPS to communicate with the docuflow middleware. docuflow is an SAP Content Server certified application. 

Document image


ECM Server 

ECM Server is a communication specification based on SAP’s RFC socket protocol called JCo (Java Connector). The ECM server unlocks remote function calls and docuflow provides an API within SAP to leverage this technology, allowing enhanced functionality over standard Content Server. 

While we are only discussing Outbound communications, ECM with JCo does allow for bi-directional communication between docuflow and SAP, Inbound and Outbound.  

[Architecture Diagram] 

 

Content Server Considerations: 

Pros:  

  • HTTPS protocol – routes well over the public internet and can be used with stateful packet inspection firewalls 
  • Does not require docuflow transports to be deployed in SAP 
  • There will be no modifications to print program required 

Cons: 

  • Does not inherently allow for custom metadata to be sent during upload to Box  unless call back is used. See Call Back Guide below.
  • See the below section on custom metadata
  • Does not inherently get dynamic routing unless call back is used 
  • No Dynamic folder creation unless call back is used 

 

ECM Considerations: 

 Pros:  

  • Custom metadata can be sent real-time 
  • Real-time dynamic routing 
  • Real-time dynamic folder creation 

Cons: 

  • RFC protocol requires non-standard ports to be opened 
  • Modification to Z version of print program required 

3. Metadata 

Optional Business Metadata can be set in Box using fields in Metadata Templates. This metadata includes any values from SAP that go beyond the mandatory system metadata required by docuflow.

Optional Business Metadata is particularly valuable when you want to:

  • Allow end-users to access SAP-linked documents directly in the Box interface, especially through search
  • Enable any Box processes that require or benefit from SAP business metadata, such as:
    • Triggering a Box Relay workflow
    • Setting or updating a Box Shield retention policy
    • Allowing other business systems (e.g., Salesforce) to access or link to documents stored by SAP
    • Facilitating Box Governance

The method of applying Optional Business Metadata to Box depends on the Message Output approach: ECM or Content Server.

  • ECM: ECM natively supports setting a Box Metadata Template and its values when creating the document in Box in real-time or synchronously.
  • Content Server: Due to the SAP specification, Content Server does not allow Optional Business Metadata to be set during document creation in Box. Instead, this must be done through a docuflow technology called a 'callback'.

Callback: 

Call backs utilize the ECM connectivity and update the document metadata once the SAP Content Server store/create operation has been completed. This means there are additional API calls/time required to update the document with business metadata. 



Document image


Optional Business Metadata Considerations: 

Pros:  

  • Can enable metadata bases searches and search result filtering for users accessing content within Box 
  • Enables the ability to do inbound rules when using ECM connectivity  [Link to the Inbound guide document for Box] 

Cons: 

  • Content Server does not inherently allow for custom metadata to be sent during upload to Box. This then requires an ECM call to back populate the Business Metadata which adds additional transaction time and Box API calls 

 

4. Dynamic Location Routing 

Dynamic Location Routing Dynamic Location Routing is a feature that allows documents to be automatically stored in different Box folders based on associated SAP data when the document is transferred from SAP to Box.

This capability enables organizations to create rules and logic that determine the storage location of documents based on specific SAP attributes or metadata. By leveraging Dynamic Location Routing, companies can:

  • Automatically categorize and file documents according to business-specific criteria
  • Ensure consistent and organized storage of documents across various departments or processes
  • Simplify document management and improve information accessibility

Here are a couple of examples to illustrate how Dynamic Location Routing can be used:

Example1: Routing based on code: Documents attached to Sales Orders within a Sales Organzization with code 1000, go to Box location 1000: SAPDocs->Sales Orders->1000 Documents attached to Sales Orders within a Sales Organzization with code 2000, go to Box folder 2000 : SAPDocs->Sales Orders->2000

Example2: Internal vs. External documents: SAP information, such as ArchiveLink document type, classification, or vendor number, can be used to automatically classify documents as either internal or external and route them to the appropriate Box folders.

External documents, intended for vendor access, are stored in a Box folder that the specific vendor can view. Internal documents, meant for internal use only, are stored in a separate Box folder inaccessible to vendors, even if the document is related to a specific vendor.

This automated categorization and routing process, based on SAP metadata, helps organizations maintain better control over document access and ensures that information is shared appropriately.

5. Custom Folders 

Folders are essential in Box, as all documents must be stored within them. The user account that creates the top-level folder becomes the owner of all subfolders and documents beneath it. To avoid individual ownership, use a managed user account for creating the top-level folder.

Best practices suggest:

  • A single user should own fewer than 20 million documents in a Box tenant.
  • Each folder should contain no more than 15,000 documents.

For large document volumes, consider implementing a folder structure. Content Server for Box natively supports folder hashing to manage the 15,000-document limit per folder. It has a setting for the maximum number of documents per folder and automatically creates new folders when the threshold is reached.

Custom Folder Considerations: 

Pros:

  • Ensures the 15,000-document limit per folder in Box is managed when using ECM (Content Server natively creates a folder hash to handle this).
  • Enables the implementation of business logic for folders, such as creating a new Box folder for each new Work Order in Plant Maintenance.
  • Allows ECM to link folders to SAP business objects instead of individual documents, which is useful for scenarios involving large batches of documents that need to be easily linked to SAP Business Objects.

Cons:

  • Content Server's specification does not inherently support the creation of custom folders. However, docuflow automatically manages document and folder threshold limits.

6. Viewing Options 

When accessing SAP content that is stored and linked to Box, users have three options for viewing the documents:

  • SAP Viewer: The document is downloaded to the user’s computer and the SAP viewer will display the document  [SAP Viewer Screenshot] 
  • Box Authenticated URL Link: A Box Viewing URL is returned to the user who must then authenticate to Box to view the document. The document is viewed in the Box web based viewer.
  • Box Short Lived (Unauthenticated) URL Link: A short lived URL is generated and returned to the user. The user does not need to authenticate to Box to view the item. The document is viewed in the Box web based viewer  [Box Viewer Screenshot] 

Each of the above options has pros and cons listed below: 

SAP Viewer Considerations: 

Pros: 

  • SAP Viewer allows notes to be attached to documents  [Screenshot of notes] 

Cons: 

  • SAP Viewer has limited file type support 
  • SAP Viewer must be maintained on the user’s desktop (IT overhead) 
  • The document is downloaded to the local computer before viewing 

Box Authenticated URL Link Considerations: 

Pros: 

  • Box Viewer has a wide range of file type support 
  • Box Viewer is web based and runs in the browser 
  • The SAP viewer does not have to be installed or maintained 
  • The document does not need to be downloaded to the local computer before viewing 

Cons: 

  • The user must have access rights to the document 

Box Short Lived (Unauthenticated) URL Link Considerations: 

Pros: 

  • Box Viewer has a wide range of file type support 
  • Box Viewer is web based and runs in the browser 
  • The SAP viewer does not have to be installed or maintained 
  • The document does not need to be downloaded to the local computer before viewing 
  • The user does not need access rights to the document, SAP controls access 

Cons:

  • The short-lived, unauthenticated URLs generated for viewing documents may pose a security risk if the URLs are shared or intercepted, as they grant temporary access to the document without requiring authentication.