Beschreibung

Weist einem Datensatz (BC-Beleg) eine Dokumenten ID (Barcode) zu.

Wenn PrintECMDocumentIDLabel = true wird ein Etikett/Leitbeleg ausgedruckt.

Wenn ECMDocumentID  (Barcode)  leer, wird die  ECMDocumentID  (Barcode)  aus der Nummerserie erzeugt.

[Zusätzlich können über ECM Document Journal Line weitere Parameter übergeben werden.]


Syntax

AL
[ErrorCode:= ] AssignECMDocID(var TempECMJnlLine: Record "ECM Document Journal Line"; var ECMDocDef: Record "ECM Document Definition"; MainRecordVariant: Variant; var ECMDocumentID: Code[36]; PrintECMDocumentIDLabel: Boolean; ShowMessage: Boolean; CommitChanges: Boolean)


Parameters

Variable: TempECMJnlLine

Typ: Record "ECM Document Journal Line" temporär

Wird als Datenobjekt ("Container") verwendet, um Daten an eine Funktion zu übergeben, für alle Felder, die in den Dokumentposten gefüllt werden müssen. Standardmäßig werden die Dokumentposten mit Hilfe des MainRecord und der Dokumentdefinition gefüllt.

Optional können z.B.  "Externe Belegnummer" , "Dokumentenkategorie" und weiter Felder in den Datenkontainer übergeben werden.


Variable: ECMDocDef

Typ: Record "ECM Document Definition"

ECM Dokumentendefinition für den Datensatz. Die richtige Dokumentdefinition für den Datensatz wird mit der API-Funktion FindDocDefByRRef gesucht.

Dem Datensatz der Dokumentdefinition können bei Bedarf abweichende Werte übergeben werden z.B. "Dokumentenkategorie".


MainRecordVariant

Typ: Variant

MainRecord (Datensatz) wird in die ECM Warteschlange eingetragen und für die Verarbeitung der Metadaten benötigt.

Tipp: Der MainRecord kann als Record, RecordID oder RecordRef übergeben werden.


Variable: BarCode

Typ: Code

Hier kann ein spezifischer Barcode übergeben werden (z.B. Belegnummer). Ist dieses Feld leer, so wird eine Barcode aus der Nummernserie aus der ECM Branchenmatrix gezogen.


[Optional] ShowMessage

Typ: Boolean

Legen Sie diesen Parameter auf true fest, wenn Sie eine Message anzeigen wollen.


[Optional] CommitChanges

Typ: Boolean

Legen Sie diesen Parameter auf true fest, wenn Sie nach dem Freigeben ein Commit setzen wollen.



Rückgabewert:

ErrorCode

Typ: Integer

ErrorCode = 0, wenn der Vorgang erfolgreich war.

Mit der Funktion ShowMessage können die ErrorCodes angezeigt werden und mit der Funktion WriteLog können diese mitprotokolliert werden.




Bemerkungen:

Die Funktion erstellt einen Eintrag im Abwarten.-Buch.-Blatt, der eine Verknüpfung zwischen dem Papierbeleg (z.B. Lieferschein) und dem Business Central-Datensatz (Lieferschein) darstellt. Die Dokument ID sollte nach Möglichkeit eine eindeutige Nummer im System sein. Doc ID wird in der Regel als Barcodeschriftart dargestellt. Sie kann eine Nummer aus einer Nummernserie oder frei erstellt sein.


Beispiel: