Managing Attachments in SAP Service and Asset Manager

Objective

After completing this lesson, you will be able to explain the attachments feature in SAP Service and Asset Manager

Abstract Document Management Overview

Overview

SAP Note 2945017 (https://launchpad.support.sap.com/#/notes/2945017) is required for support of GOS document creation using MAIF abstract document management service.

From a user perspective, the SAP back-end document management service option doesn't change the user experience of attaching document from mobile client. To ensure the best user experience, SAP Service and Asset Manager implements abstract document management service using MAIF. The user can view or add attachment from the mobile client the same way, while MAIF abstract document service handles document read/creation to various document management solutions in the back-end.

MAIF Configuration for Abstract Document Service

Abstract Document Switch Framework Configuration within SAP Service and Asset Manager supports the following objects:

Object Type	Description
BUS2007	Maintenance Work Order
BUS2038	Maintenance Notification
BUS0010	Functional Location
EQUI	Equipment
BUS2088	Service Order
BUS2080	Service Notification

Note

For each object type, a single document management service must be used for attachment read/create. Different document management service can be used for different business object type. If multiple document management services are enabled, standard implementation uses a preference order of DMS, BDS, GOS.

Flowchart outlining the process for handling external data in SAP, detailing methods for DMS, GOS, BDS, and other configurations. It includes mandatory back end configurations and optional customizations.

The preceding diagram shows how abstract document management in SAP Service and Asset Manager handles different document management service options.

Note

‘nnnn’ is the SAP Service and Asset Manager release no.

Configuration for DMS

Configuration Object	Settings
oMDO ‘SSAMnnnn_DOCUMENT’	Operation READ Filter ‘DOCUMENT_SWITCH’, ‘DMS’ = true Filter ‘DMS_DOC_TYPE’, maintain filter rules to restrict DMS document types for data distribution. Operation ‘CREATE_MEDIA’ Filter ‘DOCUMENT_SWITCH’, ‘DMS’ = true Filter ‘OBJECT_DOC_TYPE’, maintain filter rule if custom document type, document part, and document version are used. Filter ‘DMS_STATUS_INTERN’, maintain filter rule if custom document status is to be used.
oMDO ‘SSAMnnnn_EQUIPMENT’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘DMS’ must be active. Filter ‘EQUIP_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_LINK_OBJ’, refine filter rule as needed. Filter ‘DMS_DOC_TYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_FUNCLOC’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘DMS’ must be active. Filter ‘FUNCLOC_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_LINK_OBJ’, refine filter rule as needed. Filter ‘DMS_DOC_TYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_WORK_ORDER_GENERIC’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘DMS’ must be active. Filter ‘WORKORDER_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_LINK_OBJ’, refine filter rule as needed. Filter ‘DMS_DOC_TYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_NOTIFICATION’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘DMS’ must be active. Filter ‘NOTIF_ON_DEMAND’, ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_LINK_OBJ’, refine filter rule as needed. Filter ‘DMS_DOC_TYPE’, refine filter rule as needed.

Configuration for GOS

Configuration Object	Settings
oMDO ‘SSAMnnnn_DOCUMENT’	Operation READ: Filter ‘DOCUMENT_SWITCH’, ‘GOS’ = true Operation ‘CREATE_MEDIA’: Filter ‘DOCUMENT_SWITCH’, ‘GOS’ = true Filter ‘EXCL_FILE_EXTENSIONS’, maintain filter rule if certain filter extensions must be prohibited from creation.
oMDO ‘SAMnnnn_EQUIPMENT’		Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘GOS’ must be active. Filter ‘EQUIP_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SAMnnnn_FUNCLOC’		Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘GOS’ must be active. Filter ‘FUNCLOC_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_WORK_ORDER_GENERIC’		Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘GOS’ must be active. Filter ‘WORKORDER_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_NOTIFICATION’		Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘GOS’ must be active. Filter ‘NOTIF_ON_DEMAND’, ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.

Configuration for BDS

Configuration Object	Settings
oMDO ‘SSAMnnnn_DOCUMENT’	Operation READ: Filter ‘DOCUMENT_SWITCH’, ‘BDS’ = true Operation ‘CREATE_MEDIA’: Filter ‘DOCUMENT_SWITCH’, ‘BDS’ = true Filter ‘OBJECT_DOC_TYPE’, maintain filter rule if a custom storage category is to be used.
oMDO ‘SSAMnnnn_EQUIPMENT’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘BDS’ must be active. Filter ‘EQUIP_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_FUNCLOC’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘BDS’ must be active. Filter ‘FUNCLOC_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_WORK_ORDER_GENERIC’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘BDS’ must be active. Filter ‘WORKORDER_ON_DEMAND’, rule with ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.
oMDO ‘SSAMnnnn_NOTIFICATION’	Operation READ Filter ‘ABS_DOC_TYPE’, filter rule for ‘BDS’ must be active. Filter ‘NOTIF_ON_DEMAND’, ‘ABS_DOCUMENT_INFO’ = true Filter ‘DOC_CLASSNAME’, refine filter rule as needed. Filter ‘DOC_CLASSTYPE’, refine filter rule as needed. Filter ‘DOC_GOS_RELTYPE’, refine filter rule as needed.

Configuration for Others:
Through custom configuration, DMS or GOS can be configured to work with external or third-party content repository. In such cases, it is a prerequisite for the back end to be configured to use the external HTTP content server for DMS, SAP Knowledge Provider (KPro) for GOS, or third party content repository.
To support create attachment from SAP Service and Asset Manager using third party content repository, you must implement BAdI /MERP/IF_CORE_OMDO_ABSDOC_BADI~CREATE_OTHER_DOCUMENT. Implementation must match with ABS data model to work with standard SSAM metadata.

Go to Course