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 TypeDescription

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.

Log in to track your progress & complete quizzes

Learning

SAP FacebookSAP YoutubeSAP LinkedIn