# Events nach der Erstellung eines Core-Belegs (DXP Document) ## Zielgruppe Diese Dokumentation richtet sich an Drittanbieter-Entwickler, die den Lebenszyklus des Core-Belegs **`DXP Document`** erweitern möchten – insbesondere an den Punkten, an denen: - Status / „Nächster Prozessschritt“ bewertet wird, - `JSON Raw` / `JSON Processed` aktualisiert wird, - Standardbelege erzeugt werden (z. B. Einkaufsbelege), - Attachments übertragen werden. ## Einordnung: Core-Beleg-Erstellung vs. Weiterverarbeitung ### 1) Core-Beleg wird angelegt (`AddDocument`) Die Anlage eines `DXP Document` erfolgt in **`DXP Document Mgt.`** über `AddDocument(...)`: - Status wird auf **Imported** gesetzt. - `JSON Raw` wird (falls vorhanden) in ein BLOB-Feld geschrieben. ### 2) Danach: Transfer/Verknüpfung und Verarbeitung Typische nächste Schritte (abhängig vom App-Flow): - Verknüpfung mit einem Quellbeleg (z. B. SQUEEZE Header) über `UpdateDocumentAfterTransfer(...)` - Erzeugung eines Standardbelegs und Schreiben des `JSON Processed` über `UpdateDocument(...)` Die meisten Erweiterungspunkte liegen daher **nicht direkt beim Insert**, sondern im Update-/Processing-Flow. ## Event-Matrix (Kurzüberblick)
BereichEventZeitpunktSteuerungTypische Use-Cases
`DXP Document Mgt.`[`OnAfterSetLinkedToRecIdOnBeforeModify`](https://docs.squeeze.one/link/940#bkmrk-onaftersetlinkedtore)in `UpdateDocumentAfterTransfer(...)` vor `Modify(true)`–Zusatzinfos setzen, sobald `Linked-to Record Id` steht
`DXP Document Mgt.`[`OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep`](https://docs.squeeze.one/link/940#bkmrk-onbeforegetdocumento)früh in `UpdateDocument(...)` vor `Document.Get(DocNo)``IsHandled`Status/NextStep überschreiben, Processing übernehmen
`DXP Document Mgt.`[`OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep`](https://docs.squeeze.one/link/940#bkmrk-onaftergetdocumenton)in `UpdateDocument(...)` nach `Get(...)` vor Standardbeleg-Erzeugung`Handled`abhängig vom Dokument entscheiden, JSON/Status anpassen
`DXP Document Mgt.`[`OnAfterUpdateRawJson`](https://docs.squeeze.one/link/940#bkmrk-onafterupdaterawjson)nach Schreiben von `JSON Raw` in `UpdateRawJsonJson(...)`–Raw JSON normalisieren/zusätzliche Ableitungen
`DXP Document Mgt.`[`OnAfterWriteProcessedJsonToBlob`](https://docs.squeeze.one/link/940#bkmrk-onafterwriteprocesse)nach Schreiben von `JSON Processed` in `UpdateStatusAndProcessedJson(...)`–Processed JSON finalisieren, Tokens ergänzen
`DXP Document Mgt.`[`OnBeforeTransferCoreAttachmentsToStandardDocument`](https://docs.squeeze.one/link/940#bkmrk-onbeforetransfercore)vor Attachment-Transfer`IsHandled`Transfer ersetzen/selektiv steuern
`DXP Document Transfer Mgt.`[`OnBeforeExitProcessedJsonDocHeader`](https://docs.squeeze.one/link/940#bkmrk-onbeforeexitprocesse)beim Erzeugen von Header-JSON (vor `exit(JObject)`)–Standard-Tokens ergänzen/normalisieren
`DXP Document Transfer Mgt.`[`OnBeforeExitProcessedJsonDocLine`](https://docs.squeeze.one/link/940#bkmrk-onbeforeexitprocesse-0)beim Erzeugen von Line-JSON (vor `exit(JObject)`)–Line-Tokens ergänzen/normalisieren
`DXP Document Transfer Mgt.`[`OnAfterCreatePurchaseHeader`](https://docs.squeeze.one/link/940#bkmrk-onaftercreatepurchas)nach Anlage/Validierung des Purchase Headers–Header-Felder ergänzen, Post-Processing
`DXP Document Transfer Mgt.`[`OnBeforeInsertPurchaseLine`](https://docs.squeeze.one/link/940#bkmrk-onbeforeinsertpurcha)vor Insert einer Purchase Line–Purchase Line anpassen (z. B. Kontierung, Typ/No)
`DXP Document Transfer Mgt.`[`OnAfterInsertPurchaseLineOnBeforeAddDimensions`](https://docs.squeeze.one/link/940#bkmrk-onafterinsertpurchas)nach Insert, vor Dimensionen–Dimensions/Additional-Info vorbereiten
`DXP Document Transfer Mgt.`[`OnAfterOnBeforeAddLineDimensions`](https://docs.squeeze.one/link/940#bkmrk-onafteronbeforeaddli)bei Receipt-Lines: vor Dimensionen des zu aktualisierenden Lines–Update-Fälle (Receipt) anpassen
`DXP Document Transfer Mgt.`[`OnAfterProcessAdditionalInformation`](https://docs.squeeze.one/link/940#bkmrk-onafterprocessadditi)nach Transfer zusätzlicher Informationen–Add-on-Felder pro Ziel-RecordRef ergänzen
`DXP Document Transfer Mgt.`[`OnAfterCreatePurchaseDoc`](https://docs.squeeze.one/link/940#bkmrk-onaftercreatepurchas-0)nach kompletter Erstellung des Purchase Dokuments–finaler Hook (Logging, Folgeaktionen)
--- ## Events in `DXP Document Mgt.` (Core-Lebenszyklus) ### `OnAfterSetLinkedToRecIdOnBeforeModify` Wird in `UpdateDocumentAfterTransfer(...)` ausgelöst – nachdem Status/`Linked-to Record Id` gesetzt wurden, aber **bevor** das `DXP Document` gespeichert wird. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterSetLinkedToRecIdOnBeforeModify(var Document: Record "DXP Document") ``` Use-Cases: - Zusatzinformationen am Core-Beleg setzen, sobald er auf einen Quellbeleg verlinkt ist - eigene Logging-/Audit-Informationen ergänzen ### `OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep` Wird in `UpdateDocument(...)` als **frühester Hook** aufgerufen – noch bevor das `DXP Document` per `Get(DocNo)` geladen wird. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep( DocNo: Code[20]; var Status: Enum "DXP Document Status"; var NextStep: Enum "DXP Next Process Step"; JObject: JsonObject; var IsHandled: Boolean) ``` Use-Cases: - Status/NextStep vorab überschreiben (z. B. „Individuelle Verarbeitung“) - komplette Verarbeitung übernehmen (`IsHandled := true`) ### `OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep` Wird in `UpdateDocument(...)` nach `Document.Get(DocNo)` ausgelöst, bevor Standardbelege erzeugt werden. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep( var Document: Record "DXP Document"; NewStatus: Enum "DXP Document Status"; NextStep: Enum "DXP Next process step"; var ProcessedJSONObj: JsonObject; var Handled: Boolean) ``` Use-Cases: - abhängig vom aktuellen Core-Dokument entscheiden, ob Processing übernommen werden soll - Anpassungen am `ProcessedJSONObj` vor der weiteren Verarbeitung ### `OnAfterUpdateRawJson` Wird in `UpdateRawJsonJson(...)` nach dem Schreiben von `JSON Raw` ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterUpdateRawJson(var Document: Record "DXP Document"; var RawJSONObj: JsonObject) ``` Use-Cases: - Validierungs-/Normalisierungsschritte auf `RawJSONObj` - zusätzliche Datenextraktion direkt nach Raw-Update ### `OnAfterWriteProcessedJsonToBlob` Wird in `UpdateStatusAndProcessedJson(...)` ausgelöst, nachdem `JSON Processed` in das BLOB geschrieben wurde. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterWriteProcessedJsonToBlob(var Document: Record "DXP Document"; var ProcessedJSONObj: JsonObject) ``` Use-Cases: - zusätzliche Tokens ergänzen - Datenstruktur finalisieren, bevor nachgelagerte Prozesse darauf zugreifen ### `OnBeforeTransferCoreAttachmentsToStandardDocument` Wird in `TransferCoreAttachmentsToStandardDocument(...)` vor dem Transfer ausgelöst. Über `IsHandled` kann die Standardlogik ersetzt werden. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnBeforeTransferCoreAttachmentsToStandardDocument(Document: Record "DXP Document"; var IsHandled: Boolean) ``` Use-Cases: - Attachment-Transfer komplett übernehmen (z. B. andere Ablage/Benennung) - Transfer selektiv einschränken --- ## Events in `DXP Document Transfer Mgt.` (Standardbelege aus `JSON Processed`) Diese Codeunit ist relevant, sobald aus `JSON Processed` Standardbelege (z. B. Einkaufsbelege) erzeugt werden. ### `OnBeforeExitProcessedJsonDocHeader` Wird in `CreateDocHeaderJson(...)` unmittelbar vor `exit(JObject)` ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnBeforeExitProcessedJsonDocHeader(var JObject: JsonObject) ``` Use-Cases: - zusätzliche Standard-Tokens ergänzen - Token-Werte normalisieren (z. B. Typ-/Textdarstellung) ### `OnBeforeExitProcessedJsonDocLine` Wird in `CreateDocLineJson(...)` unmittelbar vor `exit(JObject)` ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnBeforeExitProcessedJsonDocLine(var JObject: JsonObject) ``` Use-Cases: - Line-Tokens ergänzen/normalisieren ### `OnAfterCreatePurchaseHeader` Wird nach Anlage/Validierung des Purchase Headers ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterCreatePurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header") ``` Use-Cases: - zusätzliche Felder am `Purchase Header` setzen (z. B. eigene Referenzen) - Post-Processing/Logging ### `OnBeforeInsertPurchaseLine` Wird unmittelbar vor dem Insert einer Purchase Line ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnBeforeInsertPurchaseLine(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line") ``` Use-Cases: - Purchase Line anpassen (z. B. Kontierung, Typ/No) ### `OnAfterInsertPurchaseLineOnBeforeAddDimensions` Wird nach Insert der Purchase Line, aber vor Dimensions-Validierung ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterInsertPurchaseLineOnBeforeAddDimensions(var JObjectLine: JsonObject; PurchaseLine: Record "Purchase Line") ``` Use-Cases: - Dimensions/Additional-Info vorbereiten ### `OnAfterOnBeforeAddLineDimensions` Wird im Receipt-Line-Update-Fall ausgelöst, bevor Dimensionen für die zu aktualisierende Purchase Line gesetzt werden. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterOnBeforeAddLineDimensions(var JObjectLine: JsonObject; PurchaseLineToUpdate: Record "Purchase Line") ``` Use-Cases: - Update-Fälle (Receipt) anpassen ### `OnAfterProcessAdditionalInformation` Wird nach dem Transfer zusätzlicher Informationen (`ProcessAdditionalInformation`) ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterProcessAdditionalInformation(var RecRef: RecordRef; SourceJsonObject: JsonObject) ``` Use-Cases: - Add-on Felder für unterschiedliche Zieltabellen (Header/Line) ergänzen ### `OnAfterCreatePurchaseDoc` Wird nach kompletter Erstellung des Purchase Dokuments ausgelöst. Signatur: ```al [IntegrationEvent(false, false)] local procedure OnAfterCreatePurchaseDoc(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header") ``` Use-Cases: - finaler Hook (Post-Processing, Logging, Folgeaktionen) --- ## Minimalbeispiel: Status/NextStep in Richtung „Individuelle Verarbeitung“ beeinflussen Beispiel: Vor dem Standard-Processing `Status` auf „Custom Processing“ setzen: ```al codeunit 50101 "My Core Document Hooks" { [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Mgt.", 'OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep', '', false, false)] local procedure OnBeforeGetDoc( DocNo: Code[20]; var Status: Enum "DXP Document Status"; var NextStep: Enum "DXP Next Process Step"; JObject: JsonObject; var IsHandled: Boolean) begin Status := Status::"Custom Processing"; // NextStep optional anpassen end; } ``` \[Best Practice\] Nutze `IsHandled := true` nur, wenn du die Standardlogik vollständig ersetzt – sonst kann es zu inkonsistenten Status-/JSON-Zuständen kommen.