Kontakt

Ansicht
Dokumentation

SRM_RECORD_ADDELEMENT - Element in Container einfügen

SRM_RECORD_ADDELEMENT - Element in Container einfügen

Fill RESBD Structure from EBP Component Structure   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Einfügen eines Elements in eine Akte.

Beispiel

Einfügen anhand eines Ankers

* Fill SP POID table

CLEAR element_sp_poid.

wa_element_sp_poid-NAME  = 'DOC_ID'.

wa_element_sp_poid-VALUE = C_DOC_ID.

APPEND wa_element_sp_poid TO element_sp_poid.

wa_element_sp_poid-NAME  = 'VARIANT'.

wa_element_sp_poid-VALUE = '0'.

APPEND wa_element_sp_poid TO element_sp_poid.

wa_element_sp_poid-NAME  = 'VERSION'.

wa_element_sp_poid-VALUE = '0'.

APPEND wa_element_sp_poid TO element_sp_poid.

* Fill element properties table

CLEAR element_properties.

wa_element_properties-NAME = 'MY_PROPERTY_NAME'.

wa_element_properties-VALUE = 'MY_PROPERTY_VALUE'.

APPEND wa_ element_properties TO element_properties.

* Call the BAPI

CALL FUNCTION 'BAPI_RECORD_ADDELEMENT'

  EXPORTING

    OBJECT_ID                = 'FE55793BA8182177E10000000A1148F5'

    DOCUMENTCLASS            = 'SRM_REC00'

    SPS_ID                   = 'SRM_SPS_DOCUMENT'

    ANCHOR                   = 'MY_ANCHOR'

    DESCRIPTION              = 'My element description'

  IMPORTING

    RETURN                   = bapi_return

  TABLES

    ELEMENT_SP_POID          = element_sp_poid

    ELEMENT_PROPERTIES       = element_properties.

Einfügen anhand eines Modellknoten in einen bestimmten Folder

* Fill SP POID table

CLEAR element_sp_poid.

wa_element_sp_poid-NAME  = 'DOC_ID'.

wa_element_sp_poid-VALUE = C_DOC_ID.

APPEND wa_element_sp_poid TO element_sp_poid.

wa_element_sp_poid-NAME  = 'VARIANT'.

wa_element_sp_poid-VALUE = '0'.

APPEND wa_element_sp_poid TO element_sp_poid.

wa_element_sp_poid-NAME  = 'VERSION'.

wa_element_sp_poid-VALUE = '0'.

APPEND wa_element_sp_poid TO element_sp_poid.

* Insert by ModelId -→ fill corresponding structure of parameterINSERTION_BY_MODELID

wa_insertion_by_modelid-MODEL_ID = '10'. ,,,,"Model ID has to exist in the corresponding record model

wa_insertion_by_modelid-PARENT_NODE_ID ='33'.,,"An existing node in the record for example a folder

* Call the BAPI

CALL FUNCTION 'BAPI_RECORD_ADDELEMENT'

  EXPORTING

    OBJECT_ID                = 'FE55793BA8182177E10000000A1148F5'

    DOCUMENTCLASS            = 'SRM_REC00'

    SPS_ID                   = 'SRM_SPS_DOCUMENT'

    DESCRIPTION              = 'My element description'

   INSERTION_BY_MODELID     = wa_insertion_by_modelid

  IMPORTING

    RETURN                   = bapi_return

  TABLES

    ELEMENT_SP_POID          = element_sp_poid

    ELEMENT_PROPERTIES       = element_properties.

Hinweise

Folgende Voraussetzungen müssen erfüllt sein:

  • Eine Akte muß angelegt worden sein. OBJECTID und DOCUMENTCLASS müssen bekannt sein.
  • Das Aktenmodell muß im Status 'Freigegeben' oder 'Final' sein
  • Die Einfügeposition in der Akte muss durch einen der vier folgenden Parameter bestimmt werden:
  • ANCHOR (Einfügen anhand eines Ankers)

  • INSERTION_BY_ANCHOR (Einfügen anhand eines Ankers, neu, mit erweiterten Optionen)

  • INSERTION_BY_MODELID (Einfügen anhand einer ModelId)

  • INSERTION_BY_REFERENCE_NODE (Einfügen anhand eines in der Akte vorhanden Referenzknotens)

  • Das Einfügen von Elementen, welche im WebDAV-Repository abgelegt sind und deren Base-URL (->Dokumentation zu Records Management) >128 Bytes beträgt, wird nicht unterstützt!

Folgende Berechtigungen werden benötigt:

  • Berechtigung für das Anzeigen von Akteninhalten (Berechtigungsobjekt S_SRMGS_CT)
  • Berechtigung zum Anzeigen von Akteneigenschaften (Berechtigungsobjekt S_SRMGS_PR)
  • Berechtigung zum Anzeigen von Aktenmodellen (Berechtigungsobjekt S_SRMGS_CT)
  • Berechtigung für das Anzeigen von Eigenschaften des Aktenmodells (Berechtigungsobjekt S_SRMGS_PR)
  • Berechtigung für das Erzeugen von Versionen/Varianten von Akten (Berechtigungsobjekt S_SRMGS_VV)
  • Berechtigung zum Ändern von Akteneigenschaften (Berechtigungsobjekt S_SRMGS_PR)
  • Berechtigung zum Anzeigen von Akteneigenschaften (Berechtigungsobjekt S_SRMGS_PR)
  • Berechtigung für das Hinzufügen von Akteninhalten (Berechtigungsobjekt S_SRMGS_CT)

Weiterführende Informationen

Dokumentation des Business Objekttyps Record.





Parameter

ALL_SAME_NAME_ANCHOR
ANCHOR
DESCRIPTION
DOCUMENTCLASS
DOC_CONTEXT
ELEMENT_PROPERTIES
ELEMENT_SP_POID
ELEMENT_TYPE
ELEMENT_VISIBILITY
INSERTION_BY_ANCHOR
INSERTION_BY_MODELID
INSERTION_BY_REFERENCE_NODE
OBJECTID
OMIT_AUTHORITY_CHECK
RETURN
SET_ELEM_DESCR_HARD
SPS_ID
STACKED
STORE_AS_NEW_VERSION

Ausnahmen

ANCHOR_NOT_FOUND
CONTAINER_IS_LOCKED
CONTAINER_NOT_FOUND
INTERNAL_ERROR
MAX_NUMBER_OF_ELEMENTS
NOT_AUTHORIZED
PARAMETER_ERROR
POID_IS_WRONG
RECORD_IS_FROZEN

Funktionsgruppe

SRM_BAPI_RECORD

BAL Application Log Documentation   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 11378 Date: 20240523 Time: 102459     sap01-206 ( 82 ms )