Ansicht
Dokumentation

SDOK_PHIO_CREATE - Anlegen eines physischen Dokuments

Vendor Master (General Section)   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein erzeugt ein physisches Dokument von einer bestimmten Dokumentklasse.

Die Dokumentklasse des neuen Dokuments wird beim Aufruf angegeben. Die ID des Dokuments kann als DCE-kompatible GUID optional vorgegeben werden und wird ansonsten vom KPro vergeben.
Dem neuen physischen Dokument können Attribute mitgegeben werden. Falls die Dokumentklasse Mußattribute besitzt, kann das Dokument nur angelegt werden, wenn alle Mußattribute an der Schnittstelle angegeben sind oder sich aus Attributen der Dokumentklasse vererben.
Zudem können Beziehungen von und zu weiteren Dokumenten erzeugt werden. Damit kann insbesondere bereits beim Anlegen des physischen Dokuments der Bezug zu seinem logischen Dokument geknüpft werden. Dabei kann die GUID einer Beziehung ebenfalls optional DCE-kompatibel vorgegeben werden und wird, falls das entsprechende Feld der Struktur beim Aufruf nicht belegt wird, vom KPro vergeben und beim Return des Funktionsbausteines zurückgegeben. Wenn eine Beziehung nicht angelegt werden kann (vgl. SDOK_RELA_CREATE), wird die Exception BAD_RELATION ausgelöst.
Wird das Dokument aus einem anderen physischen Dokument abgeleitet, so wird statt SDOK_PHIO_CREATE häufig einer der Bausteine SDOK_PHIO_CREATE_WITH_MODEL, SDOK_PHIO_CREATE_AS_COPY oder SDOK_PHIO_CREATE_NEW_VERSION verwendet werden.
Nach erfolgreichem SDOK_PHIO_CREATE befindet sich das neue Dokument im Status "initial".

Beispiel

Hinweise

Die Dokumentklasse ist nur aus Kompatibilitätsgründen optional. Da keine sinnvolle Default-Dokumentklasse vorgegeben werden kann, führt ein Aufruf ohne Dokumentklasse zu einer Ausnahme.
Die ID des Dokuments oder einer Beziehung trägt keine Semantik und wird normalerweise vom SAP Knowledge Provider vergeben. Nur in Situationen, in denen die ID von einer Anwendung bereits vor Anlegen des Dokuments im KPro benötigt wird, kann eine Vergabe der ID durch die Anwendung sinnvoll sein. Es muß dann aber sichergestellt sein, daß sie DCE-kompatibel erzeugt wird und als 32-stellige Hexziffernfolge übergeben wird, um Kollisionen mit anderen Dokumenten des KPro auszuschließen.

Vom KPro generierte Attributeinträge werden in der Tabelle PROPERTIES nicht als Exportparameter bereitgestellt. Sie müssen bei Bedarf mit "PropertiesGet" gelesen werden.

Weiterführende Informationen

Parameter

CLIENT
FROM_RELATIONS
OBJECT_CLASS
OBJECT_ID
OBJECT_UNIQUE_ID
PROPERTIES
TO_RELATIONS
X_ENQUEUE
X_SUPPRESS_PARTNER_CHECK

Ausnahmen

BAD_CLASS
BAD_PROPERTIES
BAD_RELATIONS
DUPLICATE_OBJECT_ID
ENQUEUE_FAILURE
EXCEPTION_IN_EXIT
MIMETYPE_NOT_ALLOWED
MISSING_CLASS
MISSING_PROPERTIES
NOT_AUTHORIZED

Funktionsgruppe

SDCL

PERFORM Short Reference   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3171 Date: 20240523 Time: 133944     sap01-206 ( 74 ms )