ANVEDI Job Handler

Microsoft Dynamics 365 Business Central posiada system planowania zadań, który pozwala na uruchamianie codeunits w określonych godzinach. Anveo EDI Connect oferuje dedykowaną codeunit, z której można korzystać. codeunit ma identyfikator 5327312 i nazywa się ANVEDI Job Handler.

Ta codeunit oferuje różne zadania i może być kontrolowana przez ciąg parametrów. Ciąg ten podlega prostym zasadom, a my pokażemy przykłady dla każdej z dostępnych akcji. Ogólna składnia tego parametru jest następująca:

ACTION_NAME(Parameter1=Value1, Parameter2=Value2)

Istnieją dwa parametry, które są dostępne dla większości zadań, z wyjątkiem transakcji biznesowych:

Często używane akcje

W większości przypadków będziesz chciał użyć jednej z poniższych akcji:

Konserwacja

Anveo EDI Conect ma wbudowaną funkcję ponawiania prób w przypadku tymczasowych problemów, takich jak nieosiągalny serwer. Można ustawić interwał ponawiania próby itp. w mapowaniach i kanałach komunikacji, ale konieczne będzie utworzenie zadania do ich obsługi. Aby skonfigurować takie zadanie, wybierz naszą codeunit obsługi zadań w kolejce zadań (ANVEDI Job Handler, ID 5327312) i ustaw ciąg parametrów na MAINTENANCE(). Obecnie nie ma opcji konfiguracji.

Zaplanuj zadanie tak, aby działało regularnie bez zakłócania innych procesów EDI. W zależności od wersji Dynamics, można użyć kategorii kolejki jopb, aby uruchomić tylko jedno zadanie w kategorii na raz. Jeśli nie ma nic do zrobienia, praca zakończy się niemal natychmiast.

Odbieranie danych

Ta akcja spowoduje odebranie danych dla określonego kanału komunikacyjnego lub folderu.

RECEIVE(Channel=MY_COMM_CHANNEL, ProcessFollowing=True)

Konieczne będzie określenie jednego z następujących parametrów:

Uruchom mapping

Często, jeśli chcesz wyeksportować dane, zaczynasz od zadania transakcji biznesowych lub NAV mapping. Ale system planowania może uruchomić dowolny rodzaj mapping.

RUN(ProjectFilter=TEST, FormatFilter=NAV, CodeFilter=EXPORT_JOB, ProcessFollowing=True)

RUN(ProjectFilter=TEST, FormatFilter=NAV, CodeFilter=*, MultipleAllowed=True, ProcessFollowing=True)

Dozwolone parametry to:

Zbieranie danych o transakcjach biznesowych

Jeśli masz typ transakcji biznesowej z gromadzeniem danych, możesz użyć następującego ciągu parametrów:

BT_COLLECT(Code=MY_BT_TYPE)

Jest tylko jeden parametr:

Konserwacja

Jeśli chcesz korzystać z funkcji automatycznego ponawiania mapowań lub kanałów komunikacyjnych, musisz skonfigurować proste zadanie konserwacyjne. Ta praca jest naprawdę szybka, gdy nie ma nic do zrobienia i może być wykonywana dość często. Należy pamiętać, że zadanie musi być uruchamiane co najmniej tak często, jak często mają być ponawiane akcje.

MAINTENANCE()

Zadanie nie ma parametrów.

Działania zaawansowane

Poniższe akcje są bardziej wyspecjalizowane i nie są używane zbyt często.

Przetwarzanie wsadowe danych transakcji biznesowych

BT_BATCH(Batch=MY_BATCH_CODE)

Zbieranie i przetwarzanie wsadowe danych transakcji biznesowych

Jest to połączenie BT_COLLECT i BT_BATCH.

BT_COLLECT_BATCH(Code=MY_BT_TYPE, Batch=MY_BATCH_CODE)

Otwarte kolejki przetwarzania

Jeśli postprocessing nie jest uruchamiany automatycznie, można skonfigurować zadania do uruchamiania określonych otwartych akcji.

PROCESS(ProcessQueueView=WHERE(Project Code=FILTER(MY_PROJECT)))

Można użyć parametrów ProcessQueueView i ProcessFollowing.

Wysyłanie otwartych transmisji

Zazwyczaj wysyłanie danych odbywa się po wykonaniu mapping. Jeśli jednak chcesz wysyłać otwarte pliki w określonym czasie, możesz użyć zadania.

SEND(Channel=MY_CHANNEL)

Uruchom wywołanie zwrotne kodu niestandardowego

Do uruchamiania niestandardowego kodu można użyć codeunit obsługi zadań.

Można określić dowolną liczbę parametrów. Zalecamy użycie parametru Name w celu określenia identyfikatora wywołania zwrotnego. Dostęp do parametrów można uzyskać z codeunit ANVEDI Callback. W codeunit ANVEDI Callback w funkcji CallbackRegistration można reagować na zdarzenie OnJobCallback, implementując następujący blok CASE:

CallbackSupport.OnJobCallback(ParameterDictionary):
  BEGIN
    IF NOT ParameterDictionary.GETBYKEY('NAME', Tmp) THEN
      ERROR(Text001);

    Name := Tmp;
    CASE UPPERCASE(Name) OF
      'Example':
        BEGIN
          IF NOT ParameterDictionary.GETBYKEY('MYPARAM1', Tmp) THEN
            ERROR(Text001);
         MyParam1 := tmp;

         IF NOT ParameterDictionary.GETBYKEY('MYPARAM2', Tmp) THEN
           ERROR(Text001);
         MyParam2 := tmp;

        // Do something with the parameters MyParam1 and MyParam2
     END;
  ELSE
    ERROR(Text002, Name);
  END;
END;

Należy pamiętać, że nazwy parametrów są konwertowane na wielkie litery w zmiennej ParameterDictionary. Do wywołania zwrotnego można użyć następującego ciągu parametrów w kolejce zadań:

CALLBACK(Name=Example, MyParam1=Hello, MyParam2=World)