ANVEDI Integration

codeunit ANVEDI Integration zawiera wszystkie publiczne wywołania API do modułu EDI, być może będziesz chciał zadzwonić z własnego kodu. Wszystkie funkcje w tej codeunit mają być używane, jeśli chcesz bezpośrednio rozpocząć akcję EDI za pomocą kodu.

Koncepcje ogólne

W tej części omówimy najpierw podstawowe pojęcia, które powinny być zrozumiałe, aby móc zapoznać się z przykładami kodu.

Transakcje z użytkownikami

Anveo EDI Connect posiada koncepcję nazywaną „transakcje użytkownika”, która może obejmować wiele transakcji w bazie danych i zbierać wiele błędów. Większość działań w Anveo EDI Connect będzie wymagała otwartej transakcji użytkownika, aby je uruchomić. Możesz rozpocząć transakcję z użytkownikiem, dzwoniąc:

// 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);

Wywołanie do END_USER_TRANSACTION pozwala na pokazanie błędów, przerwanie bieżącej transakcji w bazie danych lub otrzymanie wartości zwrotnej, niezależnie od tego, czy wystąpił błąd. Omówimy to szczegółowo później.

BEGIN_USER_TRANSACTION

Rozpoczyna transakcję z nowym użytkownikiem. Należy pamiętać, że połączenia w module EDI integrujesz tylko w punktach, w których może odbywać się KOMITET. W wielu przypadkach moduł dokonuje wszystkich zmian w bazie danych przed wykonaniem logiki EDI. Rozważ również zwykłe zaznaczenie danych i użycie zadania w tle do wykonania logiki EDI.

Podany tekst jest pokazywany użytkownikowi, jeśli zostanie otwarte okno dialogowe oczekujące, ponieważ proces ten wymaga czasu.

BEGIN_USER_TRANSACTION(Text : Text[1024])

Zawsze należy zakończyć połączenie do BEGIN_USER_TRANSACTION z połączeniem do END_USER_TRANSACTION.

SHOWDIALOGS

Funkcja ta może być używana do ukrywania dowolnych okien dialogowych EDI.

SHOWDIALOGS(ShowDialogs : Boolean)

Parametr ten określa, czy okna dialogowe są wyświetlane, czy nie. Wywołanie tej funkcji musi znajdować się wewnątrz transakcji użytkownika. Zwykle funkcja ta jest wywoływana bezpośrednio po BEGIN_USER_TRANSACTION.

ISPROCESSING

Funkcja ta zwraca, czy użytkownik znajduje się w obrębie wykonania mapping. Możesz sprawdzić tę wartość podczas sprawdzania poprawności działania wyzwalaczy, na przykład, aby uzyskać inne zachowanie podczas przetwarzania procesów EDI. Wartości tej można również używać do wyświetlania dialogów wejściowych tylko wtedy, gdy nie przetwarza się EDI.

END_USER_TRANSACTION

Funkcja ta spowoduje zakończenie transakcji użytkownika.

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

Praca z transakcjami biznesowymi

RUN_BUSINESSTRANSACTION_JOB

Wykonuje zadanie zbierania danych określonego typu transakcji biznesowej. To musi być wywołane z wnętrza transakcji użytkownika.

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

Rozpoczyna nową transakcję biznesową dla danego kodu i identyfikatora zapisu.

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

RUN_BT_BATCH_JOB

Wykonuje zadanie odbioru partii o określonej nazwie. To musi być wywołane z wnętrza transakcji użytkownika.

RUN_BT_BATCH_JOB(BatchCode : Code[20])

Działania

Czasami chcesz utworzyć przycisk na stronie, aby rozpocząć proces EDI, lub chcesz go zintegrować, na przykład, z procesem wydania. W tym przypadku można uruchomić prawie wszystkie akcje modułu z kodu. Proszę pamiętać, że procesy EDI powinny być zazwyczaj zautomatyzowane i prowadzone w tle. Tak więc przed dodaniem akcji w kodzie, rozważ możliwość pracy w tle jako alternatywę.

Wykonaj EDI Mapping

Aby uruchomić EDI Mapping będziemy musieli rozpocząć transakcję użytkownika. Następnie możemy chcieć przekazać dane do mapping. Możemy wtedy uruchomić mapping i sprawdzić wynik po zakończeniu transakcji użytkownika. Szczegółowy opis poleceń znajduje się po przykładzie kodu.

// 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

Resetuje wszystkie istniejące zapisane widoki tabeli. Musi być wywołany z wnętrza transakcji użytkownika.

RESET_TABLEVIEWS()

SET_TABLEVIEW

Przechowuje widok tabeli pod określoną nazwą. Musi być wywołany z wnętrza transakcji użytkownika.

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

GET_TABLEVIEW

Odzyskuje zapisany filtr. Musi być wywołany z wnętrza transakcji użytkownika.

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

RUN

Uruchomić jeden lub więcej mappingu EDI. Musi być wywołany z wnętrza transakcji użytkownika.

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

Inne działania

RECEIVE_ALL

Niedopracowana funkcja. Należy unikać wywoływania funkcji ogólnej i wywołać jedną z bardziej szczegółowych funkcji poniżej.

Odbiera wszystkie kanały komunikacyjne. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

RECEIVE_FOLDER

Otrzymuje dane z określonego folderu transmisyjnego lub folderów. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

RECEIVE_COMMUNICATIONCHANNEL

Otrzymuje dane z określonego kanału komunikacyjnego. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

SEND_ALL

Niedopracowana funkcja. Należy unikać wywoływania funkcji ogólnej i wywołać jedną z bardziej szczegółowych funkcji poniżej.

Wysyła wszystkie kanały komunikacyjne. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

SEND_FOLDER

Wysyła otwarte transmisje określonego folderu transmisji. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

SEND_COMMUNICATIONCHANNEL

Wysyła otwarte transmisje określonego kanału komunikacyjnego. Funkcja ta musi być wywołana z wnętrza transakcji użytkownika.

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

PROCESS

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

Ustawianie Odbiorcy / Nadawcy

SET_COMMUNICATION_CHANNEL

Ustawia kanał komunikacji dla następującego połączenia mapping wewnątrz transakcji użytkownika.

SET_COMMUNICATION_CHANNEL(ChannelCode : Code[20])

SET_RECEIVER_PARTNER

Ustawia partnera odbiorczego na następujące połączenie mapping wewnątrz transakcji użytkownika.

SET_RECEIVER_PARTNER(ReceiverPartner : Code[20])

SET_RECEIVER_IDENTIFICATION

Ustawia identyfikację odbiorcy dla następującego połączenia mapping wewnątrz transakcji użytkownika.

SET_RECEIVER_IDENTIFICATION(Identification : Text[64])

SET_SENDER_PARTNER

Ustawia partnera nadawcy na następujące połączenie mapping wewnątrz transakcji użytkownika.

SET_SENDER_PARTNER(PartnerCode : Code[20])

SET_SENDER_IDENTIFICATION

Ustawia identyfikację nadawcy dla następującego połączenia mapping wewnątrz transakcji użytkownika.

SET_SENDER_IDENTIFICATION(Identification : Text[64])

Logowanie i obsługa błędów

Poniższe funkcje mogą być wywoływane tylko w czasie trwania mapping. Funkcje te są przeznaczone do wykorzystania w niestandardowych systemach obsługi błędów z kodu.

LogError

Zapisuje komunikat o błędzie.

LogError(ErrorMessage : Text[1024])

LogWarning

Zapisuje ostrzeżenie.

LogWarning(WarningMessage : Text[1024])

LogInformation

Informacje z dzienników.

LogInformation(InformationMessage : Text[1024])

LogDocumentError

Rejestruje błąd należący do dokumentu EDI. Istnieje bardziej uniwersalna funkcja o nazwie LogRecIDErrorWithCode.

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

LogDocumentWarning

Rejestruje ostrzeżenie należące do dokumentu EDI. Istnieje bardziej uniwersalna funkcja o nazwie LogRecIDWarningWithCode.

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

LogDocumentInformation

Rejestruje informacje należące do dokumentu EDI. Istnieje bardziej uniwersalna funkcja o nazwie LogRecIDInformationWithCode.

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

LogDocumentLineError

Rejestruje błąd należący do linii dokumentów EDI. Istnieje bardziej ogólna funkcja o nazwie LogRecIDErrorWithCode.

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

LogDocumentLineWarning

Rejestruje ostrzeżenie należące do wiersza dokumentów EDI. Istnieje bardziej ogólna funkcja o nazwie LogRecIDWarningWithCode.

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

LogDocumentLineInformation

Rejestruje informacje należące do EDI Document Line. Istnieje bardziej ogólna funkcja o nazwie LogRecIDInformationWithCode.

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

LogErrorWithCode

Rejestruje błąd za pomocą dodatkowego kodu błędu.

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

LogWarningWithCode

Rejestruje ostrzeżenie z dodatkowym kodem błędu.

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

LogInformationWithCode

Rejestruje informacje z dodatkowym kodem błędu.

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

LogRecIDErrorWithCode

Zapisuje komunikat o błędzie, który powinien należeć do konkretnego rekordu.

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

LogRecIDWarningWithCode

Zapisuje ostrzeżenie, które powinno należeć do zapisu.

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

LogRecIDInformationWithCode

Zapisuje informacje, które powinny należeć do zapisu.

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