ANVEDI Integration

Die ANVEDI Integration enthält alle öffentlichen API-Aufrufe an das EDI-Modul, die Sie möglicherweise von Ihrem eigenen Code aus aufrufen möchten. Alle Funktionen in dieser Codeunit sollen verwendet werden, wenn Sie direkt eine EDI-Aktion per Code starten wollen.

Allgemeine Konzepte

In diesem Abschnitt werden wir zunächst die Kernbegriffe besprechen, die Sie verstehen sollten, um die Code-Beispiele lesen zu können.

Benutzer-Transaktionen

Anveo EDI Connect hat ein Konzept namens „Benutzertransaktionen“, das mehrere Datenbanktransaktionen umfassen und mehrere Fehler sammeln kann. Die meisten Aktionen in Anveo EDI Connect erfordern eine offene Benutzertransaktion, um sie auszuführen. Sie können eine Benutzertransaktion durch Aufruf starten:

// Start a new user transaction with the description given by TextDescription
ANVEDIIntegration.BEGIN_USER_TRANSACTION(TextDescription);

// Your EDI code

// End the user transaction and show an error list, if there were any
ANVEDIIntegration.END_USER_TRANSACTION(TRUE, FALSE);

Der Aufruf von END_USER_TRANSACTION ermöglicht es Ihnen, entweder Fehler anzuzeigen, die aktuelle Datenbanktransaktion abzubrechen oder einen Rückgabewert zu erhalten, unabhängig davon, ob ein Fehler aufgetreten ist. Wir werden das später im Detail besprechen.

BEGIN_USER_TRANSACTION

Startet eine neue Benutzertransaktion. Bitte beachten Sie, dass Sie Aufrufe nur an den Stellen in das EDI-Modul integrieren, an denen ein COMMIT stattfinden kann. In vielen Fällen wird das Modul alle Datenbankänderungen festschreiben, bevor die EDI-Logik ausgeführt wird. Ziehen Sie auch in Betracht, die Daten nur zu markieren und einen Hintergrundjob zur Ausführung der EDI-Logik zu verwenden.

Der angegebene Text wird dem Benutzer angezeigt, wenn ein Wartedialog geöffnet wird, da der Vorgang Zeit benötigt.

BEGIN_USER_TRANSACTION(Text : Text[1024])

Sie sollten einen Aufruf von BEGIN_USER_TRANSACTION immer mit einem Aufruf von END_USER_TRANSACTION beenden.

SHOWDIALOGS

Mit dieser Funktion können Sie beliebige EDI-Dialoge ausblenden.

SHOWDIALOGS(ShowDialogs : Boolean)

Der Parameter gibt an, ob die Dialoge angezeigt werden oder nicht. Ein Aufruf dieser Funktion muss innerhalb einer Benutzertransaktion erfolgen. Diese Funktion wird normalerweise direkt nach BEGIN_USER_TRANSACTION aufgerufen.

ISPROCESSING

Diese Funktion gibt zurück, ob Sie sich innerhalb einer Mapping befinden. Sie können diesen Wert bei der Validierung von Triggern überprüfen, um z.B. ein anderes Verhalten bei der Verarbeitung von EDI-Prozessen zu erreichen. Sie können diesen Wert auch verwenden, um Eingabedialoge nur dann anzuzeigen, wenn Sie nicht gerade EDI verarbeiten.

END_USER_TRANSACTION

Diese Funktion beendet eine Benutzertransaktion.

END_USER_TRANSACTION(ShowErrorList : Boolean; BreakOnError : Boolean) Success : Boolean

Arbeit mit Geschäftstransaktionen

RUN_BUSINESSTRANSACTION_JOB

Führt den Datenerfassungsauftrag einer bestimmten Geschäftsvorgangsart aus. Diese muss aus einer Benutzertransaktion heraus aufgerufen werden.

RUN_BUSINESSTRANSACTION_JOB(BusinessTransactionTypeCode : Code[20])

// Start a new user transaction with the description given by TextDescription
ANVEDIIntegration.BEGIN_USER_TRANSACTION(TextDescription);

// Collects the data of the Business Transaction Type "INVOICE_OUT" and processes the mappings
ANVEDIIntegration.RUN_BUSINESSTRANSACTION_JOB('INVOICE_OUT');

// End the user transaction and show an error list, if there were any
ANVEDIIntegration.END_USER_TRANSACTION(TRUE, FALSE);

START_BT_WITH_REC

Startet eine neue Geschäftstransaktion für den angegebenen Code und die Datensatz-ID.

START_BT_WITH_REC(BusinessTransactionTypeCode : Code[20];RecID : RecordID)

RUN_BT_BATCH_JOB

Führt den Batch-Sammelauftrag mit dem angegebenen Namen aus. Diese muss aus einer Benutzertransaktion heraus aufgerufen werden.

RUN_BT_BATCH_JOB(BatchCode : Code[20])

Aktionen

Manchmal möchten Sie auf einer Seite eine Schaltfläche zum Starten eines EDI-Prozesses erstellen oder Sie möchten diese z.B. in den Freigabeprozess integrieren. Für diese Fälle können Sie fast alle Aktionen des Moduls aus dem Code heraus ausführen. Bitte beachten Sie, dass EDI-Prozesse in der Regel automatisiert sein und im Hintergrund laufen sollten. Bevor Sie also Aktionen im Code hinzufügen, sollten Sie die Möglichkeit eines Hintergrundjobs als Alternative in Betracht ziehen.

EDI Mapping ausführen

Um ein EDI Mapping auszuführen, müssen wir eine Benutzertransaktion starten. Danach möchten wir vielleicht Daten an das Mapping weitergeben. Wir können dann das Mapping ausführen und das Ergebnis überprüfen, wenn wir die Benutzertransaktion beenden. Die detaillierte Beschreibung der Befehle finden Sie nach dem Codebeispiel.

// Start a new user transaction with the description given by TextDescription
ANVEDIIntegration.BEGIN_USER_TRANSACTION(TextDescription);

// Reset any existing table views
ANVEDIIntegration.RESET_TABLEVIEWS();

// Copy sales invoice header from Rec to a local variable
SalesInvoiceHeader := Rec;
// Filter the local variable to the current record
SalesInvoiceHeader.SETRECFILTER;
// Store the filter to the record under the name INVOICE
ANVEDIIntegration.SET_TABLEVIEW('INVOICE', SalesInvoiceHeader.GETVIEW(FALSE));

// Run the mapping EXAMPLE, NAV, INVOICE. You can access the invoice header, by adding the table and setting the filter to a named table view and enter INVOICE as the name. In general, you can pass as many filters as you need to the mapping.
ANVEDIIntegration.RUN('EXAMPLE', 'NAV', 'INVOICE', FALSE, TRUE, '');

// End the user transaction and show an error list, if there were any
ANVEDIIntegration.END_USER_TRANSACTION(TRUE, FALSE);

RESET_TABLEVIEWS

Setzt alle vorhandenen gespeicherten Tabellenansichten zurück. Muss aus einer Benutzertransaktion heraus aufgerufen werden.

RESET_TABLEVIEWS()

SET_TABLEVIEW

Speichert eine Tabellenansicht unter einem angegebenen Namen. Muss aus einer Benutzertransaktion heraus aufgerufen werden.

SET_TABLEVIEW(FilterName : Code[30];FilterText : Text[1024])

GET_TABLEVIEW

Ruft einen gespeicherten Filter ab. Muss aus einer Benutzertransaktion heraus aufgerufen werden.

GET_TABLEVIEW(FilterName : Code[30]) : Text[1024]

RUN

Führen Sie eine oder mehrere EDI-Abbildungen aus. Muss aus einer Benutzertransaktion heraus aufgerufen werden.

RUN(ProjectFilter : Text[250];FormatFilter : Text[250];CodeFilter : Text[250];MultipleAllowed : Boolean;ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

Andere Aktionen

RECEIVE_ALL

Veraltete Funktion. Sie sollten es vermeiden, die allgemeine Funktion aufzurufen, und eine der spezifischeren Funktionen unten aufrufen.

Empfängt alle Kommunikationskanäle. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

RECEIVE_ALL(ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

RECEIVE_FOLDER

Empfängt die Daten aus dem angegebenen Übertragungsordner oder den Ordnern. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

RECEIVE_FOLDER(TransmissionFolderCodeFilter : Text[250];ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

RECEIVE_COMMUNICATIONCHANNEL

Empfängt Daten von dem angegebenen Kommunikationskanal. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

RECEIVE_COMMUNICATIONCHANNEL(CommunicationChannelCodeFilter : Text[250];ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

SEND_ALL

Veraltete Funktion. Sie sollten es vermeiden, die allgemeine Funktion aufzurufen, und eine der spezifischeren Funktionen unten aufrufen.

Sendet alle Kommunikationskanäle. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

SEND_ALL(ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

SEND_FOLDER

Sendet offene Übertragungen des angegebenen Übertragungsordners. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

SEND_FOLDER(TransmissionFolderCodeFilter : Text[250];ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

SEND_COMMUNICATIONCHANNEL

Sendet offene Übertragungen des angegebenen Kommunikationskanals. Diese Funktion muss aus einer Benutzertransaktion heraus aufgerufen werden.

SEND_COMMUNICATIONCHANNEL(CommunicationChannelCodeFilter : Text[250];ProcessFollowing : Boolean;ProcessingQueueView : Text[250])

PROCESS

PROCESS(ProcessFollowing : Boolean;ProcessingQueueView : Text[250];UserTransactionFilter : Boolean)

Einstellung des Empfängers / Absenders

SET_COMMUNICATION_CHANNEL

Setzt den Kommunikationskanal für den folgenden Mapping innerhalb der Benutzertransaktion.

SET_COMMUNICATION_CHANNEL(ChannelCode : Code[20])

SET_RECEIVER_PARTNER

Setzt den Empfängerpartner für den folgenden Mapping innerhalb der Benutzertransaktion.

SET_RECEIVER_PARTNER(ReceiverPartner : Code[20])

SET_RECEIVER_IDENTIFICATION

Setzt die Empfänger-Identifikation für den folgenden Mapping innerhalb der Benutzertransaktion.

SET_RECEIVER_IDENTIFICATION(Identification : Text[64])

SET_SENDER_PARTNER

Setzt den Senderpartner für den folgenden Mapping innerhalb der Benutzertransaktion.

SET_SENDER_PARTNER(PartnerCode : Code[20])

SET_SENDER_IDENTIFICATION

Setzt die Absenderkennung für den folgenden Mapping innerhalb der Benutzertransaktion.

SET_SENDER_IDENTIFICATION(Identification : Text[64])

Protokollierung und Fehlerbehandlung

Die folgenden Funktionen können nur während eines laufenden Mapping aufgerufen werden. Diese Funktionen sind für benutzerdefinierte Fehlerbehandlungen aus dem Code heraus gedacht.

LogError

Protokolliert eine Fehlermeldung.

LogError(ErrorMessage : Text[1024])

LogWarning

Protokolliert eine Warnung.

LogWarning(WarningMessage : Text[1024])

LogInformation

Protokolliert Informationen.

LogInformation(InformationMessage : Text[1024])

LogDocumentError

Protokolliert einen Fehler, der zu einem EDI-Dokument gehört. Es gibt eine universellere Funktion namens LogRecIDErrorWithCode.

LogDocumentError(ErrorMessage : Text[1024];EDIDocument : Record "EDI Document")

LogDocumentWarning

Protokolliert eine Warnung, die zu einem EDI-Dokument gehört. Es gibt eine universellere Funktion namens LogRecIDWarningWithCode.

LogDocumentWarning(WarningMessage : Text[1024];EDIDocument : Record "EDI Document")

LogDocumentInformation

Protokolliert eine Information, die zu einem EDI-Dokument gehört. Es gibt eine universellere Funktion namens LogRecIDInformationWithCode.

LogDocumentInformation(InformationMessage : Text[1024];EDIDocument : Record "EDI Document")

LogDocumentLineError

Protokolliert einen Fehler, der zu einer EDI-Belegzeile gehört. Es gibt eine allgemeinere Funktion namens LogRecIDErrorWithCode.

LogDocumentLineError(ErrorMessage : Text[1024];EDIDocumentLine : Record "EDI Document Line")

LogDocumentLineWarning

Protokolliert eine Warnung, die zu einer EDI-Dokumentenzeile gehört. Es gibt eine allgemeinere Funktion namens LogRecIDWarningWithCode.

LogDocumentLineWarning(WarningMessage : Text[1024];EDIDocumentLine : Record "EDI Document Line")

LogDocumentLineInformation

Protokolliert eine Information, die zu einer EDI-Dokumentenzeile gehört. Es gibt eine allgemeinere Funktion namens LogRecIDInformationWithCode.

LogDocumentLineInformation(InformationMessage : Text[1024];EDIDocumentLine : Record "EDI Document Line")

LogErrorWithCode

Protokolliert einen Fehler mit einem zusätzlichen Fehlercode.

LogErrorWithCode(ContinueExecution : Boolean;ErrorMessage : Text[1024];Code : Code[20])

LogWarningWithCode

Protokolliert eine Warnung mit einem zusätzlichen Fehlercode.

LogWarningWithCode(WarningMessage : Text[1024];Code : Code[20])

LogInformationWithCode

Protokolliert eine Information mit einem zusätzlichen Fehlercode.

LogInformationWithCode(InformationMessage : Text[1024];Code : Code[20])

LogRecIDErrorWithCode

Protokolliert eine Fehlermeldung, die zu einem bestimmten Datensatz gehören sollte.

LogRecIDErrorWithCode(ContinueExecution : Boolean;ErrorMessage : Text[1024];RecID : RecordID;Code : Code[20];IsUserAcceptable : Boolean)

LogRecIDWarningWithCode

Protokolliert eine Warnung, die zu einem Datensatz gehören sollte.

LogRecIDWarningWithCode(WarningMessage : Text[1024];RecID : RecordID;Code : Code[20])

LogRecIDInformationWithCode

Protokolliert eine Information, die zu einem Datensatz gehören sollte.

LogRecIDInformationWithCode(InformationMessage : Text[1024];RecID : RecordID;Code : Code[20])