ANVEDI Job Handler

Microsoft Dynamics NAV 2015 heeft een taakplanningssysteem waarmee je codeunits op bepaalde tijden kunt uitvoeren. Anveo EDI Connect biedt een speciale codeunit die kan worden gebruikt. De codeunit heeft ID 5327312 en heet ANVEDI Job Handler.

Deze codeunit biedt verschillende opdrachten en kan worden geregeld met de parameter string. Deze string volgt eenvoudige regels en we zullen je voorbeelden laten zien voor elk van de beschikbare acties. De algemene syntaxis van deze parameter is:

ACTION_NAME(Parameter1=Value1, Parameter2=Value2)

Er zijn twee parameters beschikbaar voor de meeste taken, behalve voor Bedrijfstransacties:

Veelgebruikte acties

Meestal zul je een van de volgende acties willen gebruiken:

Onderhoud

Anveo EDI Conect heeft een ingebouwde functie voor opnieuw proberen bij tijdelijke problemen, zoals een onbereikbare server. Je kunt het herhalingsinterval instellen, enz. in mappings en communicatiekanalen, maar je moet een taak maken om ze af te handelen. Om een dergelijke taak te configureren, selecteert u onze codeunit voor de taakafhandeling in de taakwachtrij (ANVEDI Job Handler, ID 5327312) en stelt u de parameterstring in op MAINTENANCE(). Op dit moment zijn er geen configuratieopties.

Plan de taak zo dat deze regelmatig wordt uitgevoerd zonder andere EDI-processen te verstoren. Afhankelijk van uw versie van Dynamics, kunt u de categorie jopb wachtrij gebruiken om slechts één taak in een categorie tegelijk uit te voeren. Als er niets te doen is, is de klus bijna meteen geklaard.

Gegevens ontvangen

Deze actie ontvangt gegevens voor een opgegeven communicatiekanaal of map.

RECEIVE(Channel=MY_COMM_CHANNEL, ProcessFollowing=True)

Je moet een van de volgende parameters opgeven:

Een mapping uitvoeren

Als je gegevens wilt exporteren, begin je vaak met een zakelijke transactieopdracht of een NAV mapping. Maar het planningssysteem kan elke soort mapping uitvoeren.

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

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

De toegestane parameters zijn:

Gegevens over zakelijke transacties verzamelen

Als je een bedrijfstransactietype met gegevensverzameling hebt, kun je de volgende parameterreeks gebruiken:

BT_COLLECT(Code=MY_BT_TYPE)

Er is maar één parameter:

Onderhoud

Als je de automatische herhalingsfunctie van de toewijzingen of communicatiekanalen wilt gebruiken, moet je een eenvoudige onderhoudstaak instellen. Deze functie is echt snel als er niets te doen is en kan vrij vaak worden uitgevoerd. Houd er rekening mee dat de taak minstens zo vaak moet worden uitgevoerd als je acties opnieuw wilt proberen.

MAINTENANCE()

De opdracht heeft geen parameters.

Geavanceerde acties

De volgende acties zijn meer gespecialiseerd en worden niet zo vaak gebruikt.

Batchverwerking Bedrijfstransactiegegevens

BT_BATCH(Batch=MY_BATCH_CODE)

Zakelijke transactiegegevens verzamelen en batchgewijs verwerken

Dit is een combinatie van BT_COLLECT en BT_BATCH.

BT_COLLECT_BATCH(Code=MY_BT_TYPE, Batch=MY_BATCH_CODE)

Verwerken Open verwerkingswachtrijen

Als je nabewerkingen niet automatisch uitvoert, kun je taken instellen om bepaalde open acties uit te voeren.

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

Je kunt de parameters ProcessQueueView en ProcessFollowing gebruiken.

Open transmissies verzenden

Gewoonlijk wordt het verzenden van gegevens uitgevoerd als een vervolgstap op de mapping. Als je echter geopende bestanden op een bepaald tijdstip wilt verzenden, kun je een taak gebruiken.

SEND(Channel=MY_CHANNEL)

Aangepaste code terugbellen

Je kunt de job handler codeunit gebruiken om je aangepaste code uit te voeren.

Je kunt zoveel parameters opgeven als je nodig hebt. We raden aan een parameter Name te gebruiken om een callback identifier te specificeren. Je hebt toegang tot de parameters vanuit de codeunit ANVEDI Callback. In codeunit ANVEDI Callback kun je in de functie CallbackRegistration reageren op de gebeurtenis OnJobCallback door het volgende CASE-blok te implementeren:

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;

Merk op dat de parameternamen worden geconverteerd naar hoofdletters in de variabele ParameterDictionary. Je kunt de volgende parameterstring in de Taakwachtrij gebruiken om de callback aan te roepen:

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