SAP Attachments & SAP Attachments ArchiveLink

SAP Attachments provides a drop-in solution for viewing and downloading files attached to SAP documents. Drop the SAP Document Viewer onto a Lightning Record Page, set the Business Object that corresponds to the Salesforce object and the field where the SAP ID is stored. Supports reading attachments from the Generic Object Services (GOS) and Business Document Service (BDS). If you would like to add support for reading attachments from ArchiveLink (AL) file stores, please install the SAP Attachments ArchiveLink as well.

Installation

1. Navigate to the Component Library in the Overcast App. Filter by SAP-integrated Customer 360 under Collections.
    
2. Search for SAP Sales Attachments component and activate it by selecting the blue Activate. (Once activated, the panel will appear green). If you would like to use ArchiveLink, please activate SAP Attachments ArchiveLink as well after activating SAP Sales Attachments.
   
    
3. Choose the connection string for your Backend System and click Activate.
   
    
4. Navigate to the Monitoring Tab and check the Status. A green circle indicates that the component is successfully activated and is ready to use. If you see a red circle indicating an error, navigate to the ID (eg. 00001) and see Detailed Log for information regarding error. Go to Monitoring pages for more information.
   

Custom Network Configuration

 Your Overcast configuration may require a dedicated or custom Overcast File Service URL configured in Salesforce. 
When advised, add the custom URL to Salesforce Remote Site Settings and Trusted URLs.  

Display the component 

1. Go to Account record page. Navigate to Setup and select Edit Page to open Lightning Application Builder.
   
    
2. From Left pane, drag and drop the Overcast Document Viewer onto the page. Fill out the right pane as following and click Save, and then Activate.
   SAP Attachments Definition: SAP Attachments
   SAP Business Object:  KNA1 (Fill out the SAP Business Object that the record represents)
   Salesforce ID Reference Field: overcast__SAP_BP_Number__c (The Salesforce field for this object that holds the SAP ID for the SAP Business Object)
   Select Use GOS, Use BDS or ArchiveLink.
   Use GOS: Display any documents from Generic Object Services linked to this record. 
   Use BDS: Display any documents from Business Document Store linked to this record. 
   Use ArchiveLink: Display any documents from ArchiveLink linked to this record. Requires SAP Attachments ArchiveLink to be activated as well as SAP Attachments. 
   
    
3. If this is your first component to install, you will see Page Layout Activation page. Select Assign as Organization Default. Click Next and then Save. The component is now displayed on the Account record page.

Functionality

1. Go back to the Account record page. SAP Attachments linked to this record are displayed. Click the name of the file.
   
    
2. The attached file will be opened. 
   

Troubleshooting

NetworkError when attempting to fetch resource

This error will appear when the Trusted URLs (CSP) are not configured correctly for the Overcast File Service URL.

IO Exception: Unauthorized endpoint

This error will appear when the Remote Site Setting is not configured correctly for the Overcast File Service URL.

Missing File Link response from Real-time Service.

This error will appear when you have used a custom real-time scenario Apex class to modify the SAP Attachments behavior, but you have not copied the ovcProperties property of the response from Overcast to the custom class's ovcProperties property. 
If you are setting it, check that the line where ovcProperties is set is actually executed.

Check that the base class of the Overcast real-time scenario Apex class is as expected.