Fonction SAP BAPI_SERVICE_CHANGE - BAPI to Change a Service Master Record

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
IM_SERVICE_DATA BAPISRV_ASMD u 324 X General Data for Service, Import
IM_SERVICE_DATAX BAPISRV_ASMDX u 49 X Change Parameter for Service Data, Import
SERVICENUMBER BAPISRV_ASMD-SERVICE C 18 Service Number
TESTRUN BAPIFLAG-BAPIFLAG C 1 X Test Indicator

Paramètre Reférence Type Long. Description
EX_SERVICE_DATA BAPISRV_ASMD u 324 General Data for Service, Export
EX_SERVICE_DATAX BAPISRV_ASMDX u 49 Change Parameter for Service Data, Export

Paramètre Reférence Long. Facultatif Description
EXTENSION_IN BAPIPAREX 990 X Customer's Own Fields (Import Parameters)
EXTENSION_OUT BAPIPAREX 990 X Customer's Own Fields (Export Parameters)
RETURN BAPIRET2 548 Return Parameter(s)
SERVICE_DESCRIPTION BAPISRV_ASMDT 44 Short Texts for Service
SERVICE_LONG_TEXTS BAPISRV_TEXT 138 X Long Texts for Service

Functionality
This Business Application Programming Interface (BAPI) is used in thecomponent External Services Management (MM-SRV).
The BAPI enables you to change service master records.

Notes
Authorization
To be able to change service master records, you need the relevantauthorization.
Authorization objekt Service Master (M_SRV_LS) is checkedfor the activity 02 (Change).
Transfer

  • The service master data is transferred in the parameter
    • IM_SERVICE_DATA.
    • The change parameters are transferred in the parameter
      • IM_SERVICE_DATAX.
      • The short texts are transferred in the table SERVICE_DESCRIPTION

        • .
        • The long texts are transferred in the table SERVICE_LONG_TEXTS.

          • Return messages
          During the entire service master processing, success and error messagesare returned in addition to customers' own messages in the parameterRETURN. Thus, the RETURN table contains information as to whetherinterface data has been processed incorrectly and issues success anderror messages during the creation of service master records.
          Restrictions
          With this BAPI, it is not possible to:
          • Create several service master records at a time. If you want to create
            • several service master records, reinvoke the method before creating eachadditional master record.
            • Create a new service master record on the basis of an already-existing
              • one using the Create with Reference function.
              • Specify the displayable fields in the service master via the field
                • selection in Customizing. The field selection is not taken into account.
                • Create data for classication (configuration).

                  • Customer enhancements
                  The following BAdIs are available for the BAPI BAPI_SERVICE_CHANGE:
                  • Service Master: Modification of BAPI
                    • Interfaces (MMSRV_SM_BAPI_CUST)
                    • Enhancement to Service Master (MMSRV_SM_MAIN)

                    • Notification Create/Change Service Master
                      • Record (MMSRV_SM_NOTIFY)

                      Description
                      The BAPI returns the data of the service master record (except for theshort and long texts) via this structure.

                      Description
                      The BAPI returns the change parameters of the service master record viathis structure.

                      Description
                      This structure contains all the data of a service master record (such asthe service category and the base unit of measure) except for the shortand long texts.
                      Information on the meaning of the individual parameter fields isavailable in the relevant data element documentation in the ABAPDictionary.

                      Description
                      The value of the field determines whether the value from the interfaceor a default value (e.g. from the standard service specifications) isused in the structure IM_SERVICE_DATA. wird.
                      If an 'X' has been set, the value from the interface is used.

                      Description
                      Number of the service master record that is to be changed using theBAPI.

                      Description
                      The parameter serves as a test switch.
                      If the switch is set, the document is not saved.

                      Value range
                      Space = Document is to be saved
                      X = Document is not to be saved

                      Default
                      Space (blank).

                      Description
                      This table enables you to extend the import parameters of the BAPIwithout modification.

                      Description
                      This table enables you to extend the export parameters of the BAPIwithout modification.

                      Description
                      The table contains all messages that are issued during the processing.

                      Description
                      This table contains all the short texts for the service master record tobe created.
                      Short texts can consist of just one line and must be specified with thelanguage and the change indicator (I, U, D).
                      At leas one short text must be created in the original language.

                      Description
                      This table contains all the long texts for the service master record tobe created.
                      Each line must be specified with a language and the change indicator.The change indicator of the first line applies to the whole long text.