ANVEDI Job Handler

Microsoft Dynamics NAV 2017 verfügt über ein Job Scheduling System, mit dem Sie Codeunits zu bestimmten Zeiten ausführen können. Anveo EDI Connect bietet eine spezielle Codeunit an, die verwendet werden kann. Die Codeunit hat die ID 5327312 und heißt ANVEDI Job Handler.

Diese Codeunit bietet verschiedene Aufgaben und kann über den Parameter string gesteuert werden. Diese Zeichenfolge folgt einfachen Regeln und wir zeigen Ihnen Beispiele für jede der verfügbaren Aktionen. Die allgemeine Syntax für diesen Parameter lautet:

ACTION_NAME(Parameter1=Value1, Parameter2=Value2)

Es gibt zwei Parameter, die für die meisten Aufträge zur Verfügung stehen, außer für Geschäftsvorgänge:

Häufig verwendete Aktionen

In den meisten Fällen werden Sie eine der folgenden Aktionen durchführen wollen:

Wartung

Anveo EDI Conect verfügt über eine integrierte Wiederholungsfunktion für vorübergehende Probleme, wie z. B. einen nicht erreichbaren Server. Sie können das Wiederholungsintervall usw. festlegen. in Mappings und Kommunikationskanälen, aber Sie müssen einen Auftrag erstellen, um sie zu verarbeiten. Um einen solchen Job zu konfigurieren, wählen Sie unsere Codeunit in der Job-Warteschlange (ANVEDI Job Handler, ID 5327312) und setzen den Parameterstring auf MAINTENANCE(). Zurzeit gibt es keine Konfigurationsmöglichkeiten.

Planen Sie den Auftrag so, dass er regelmäßig ausgeführt wird, ohne andere EDI-Prozesse zu beeinträchtigen. Abhängig von Ihrer Dynamics-Version können Sie die Kategorie jopb-Warteschlange verwenden, um jeweils nur einen Auftrag in einer Kategorie auszuführen. Wenn es nichts zu tun gibt, wird die Arbeit fast sofort beendet.

Empfangen von Daten

Diese Aktion empfängt Daten für einen bestimmten Kommunikationskanal oder Ordner.

RECEIVE(Channel=MY_COMM_CHANNEL, ProcessFollowing=True)

Sie müssen einen der folgenden Parameter angeben:

Führen Sie eine Mapping

Wenn Sie Daten exportieren möchten, beginnen Sie häufig entweder mit einem Geschäftsvorfall oder einem NAV Mapping. Aber das Planungssystem kann jede Art von Mapping durchführen.

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

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

Die zulässigen Parameter sind:

Sammeln von Geschäftsvorgangsdaten

Wenn Sie eine Geschäftsvorgangsart mit Datenerfassung haben, können Sie den folgenden Parameterstring verwenden:

BT_COLLECT(Code=MY_BT_TYPE)

Es gibt nur einen Parameter:

Wartung

Wenn Sie die automatische Wiederholungsfunktion der Mappings oder Kommunikationskanäle nutzen möchten, müssen Sie einen einfachen Wartungsjob einrichten. Dieser Job ist wirklich schnell, wenn es nichts zu tun gibt, und kann recht häufig ausgeführt werden. Bitte beachten Sie, dass der Auftrag mindestens so oft ausgeführt werden muss, wie Sie Aktionen wiederholen möchten.

MAINTENANCE()

Der Auftrag hat keine Parameter.

Erweiterte Aktionen

Die folgenden Aktionen sind etwas spezieller und werden nicht so häufig verwendet.

Stapelverarbeitung von Geschäftsvorgangsdaten

BT_BATCH(Batch=MY_BATCH_CODE)

Erfassung und Stapelverarbeitung von Geschäftsvorgangsdaten

Dies ist eine Kombination aus BT_COLLECT und BT_BATCH.

BT_COLLECT_BATCH(Code=MY_BT_TYPE, Batch=MY_BATCH_CODE)

Offene Verarbeitungswarteschlangen verarbeiten

Wenn Sie Nachbearbeitungen nicht automatisch durchführen, können Sie Aufträge zur Ausführung bestimmter offener Aktionen einrichten.

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

Sie können die Parameter ProcessQueueView und ProcessFollowing verwenden.

Offene Übertragungen senden

Das Senden von Daten erfolgt in der Regel im Anschluss an die Mapping. Wenn Sie jedoch offene Dateien zu einem bestimmten Zeitpunkt versenden wollen, können Sie einen Auftrag verwenden.

SEND(Channel=MY_CHANNEL)

Benutzerdefinierten Code ausführen Callback

Sie können die Codeunit verwenden, um Ihren eigenen Code auszuführen.

Sie können so viele Parameter angeben, wie Sie benötigen. Es wird empfohlen, einen Parameter Name zu verwenden, um einen Rückrufbezeichner anzugeben. Sie können auf die Parameter über die Codeunit ANVEDI Callback zugreifen. In der Codeunit ANVEDI Callback in der Funktion CallbackRegistration können Sie auf das Ereignis OnJobCallback reagieren, indem Sie den folgenden CASE-Block implementieren:

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;

Bitte beachten Sie, dass die Parameternamen in der Variablen ParameterDictionary in Großbuchstaben umgewandelt werden. Sie können den folgenden Parameterstring in der Auftragswarteschlange verwenden, um den Callback aufzurufen:

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