Jobs
Diversen > Jobs

Met behulp van jobs kunnen volautomatisch gegevens worden geïmporteerd in King of geëxporteerd uit King. Orderdocumenten kunnen automatisch worden afgedrukt, of een XSL-transformatie kan worden uitgevoerd.

In King stel je de job(s) eenmalig samen. Het programma KingJob.exe kan de job(s) vervolgens automatisch uitvoeren.

 

Klik op de knop Toevoegen om een job aan te maken, of op Wijzigen om een job aan te passen. Het programma Job-gegevens opent.

Let op: aan de job wordt de gebruiker gekoppeld, die de job heeft aangemaakt. Tip: maak een aparte gebruiker aan, bijv. Jobs, en gebruik deze gebruikerscode om Jobs aan te maken. De door een job uitgevoerde acties zijn dan achteraf gemakkelijk in de administratie te traceren.

 

Met de knop Uitvoeren kan de job handmatig worden gestart. Klik op Verwijderen om een job definitief te verwijderen.

KingJob.exe

  • KingJob.exe werkt onafhankelijk van King.

  • Wanneer je dit programma met de juiste parameters in een scheduler of batch-bestand opneemt, kunnen volautomatisch gegevens worden geëxporteerd, geïmporteerd en/of kan een XSL-transformatie worden uitgevoerd.

  • Het programma KingJob.exe staat in de programmatuur-directory van King.

Bij het starten van KingJob.exe kunnen de volgende parameters worden opgegeven:

  • EA <administratiecode>, de code van de administratie waarin de job staat die moet worden uitgevoerd (verplicht).

  • JOB <job-nummer>, het volgnummer van de job die moet worden uitgevoerd (verplicht).

  • JOBVD <dd-mm-jjjj>, gebruik deze parameter om een andere datum mee te geven. Zonder deze parameter wordt de systeemdatum van King gebruikt. Je kunt deze parameter gebruiken als je bijvoorbeeld journaalposten wilt inlezen in een vorig boekjaar.

  • RUN, zónder deze parameter wordt programma Job-Runner wel geopend, maar moet je zelf nog op de knop Uitvoeren klikken en na afloop het programma handmatig sluiten. Dus als je de job geheel automatisch wilt uitvoeren, moet je de parameter RUN meegeven. Het programma wordt dan na afloop ook weer automatisch afgesloten.

  • LA , de opstartparameter LA maakt een logboek 'Job_<administratiecode>.log' aan en breidt deze steeds verder uit.

  • LN, de opstartparameter LN maakt een logboek 'Job_<administratiecode>_<datum-tijd>.log' aan per job. Is inbegrepen in de parameter LEA.

  • LEA [e-mailadres], met de opstartparameter LEA wordt het logbestand van deze job per e-mail verzonden naar het adres dat daarachter is ingevoegd.

    Voorbeeld: 'KingJob.exe EA Demoart LEA info@kingsoftware.nl'

    • LEV hiermee wordt ook het e-mailadres van de afzender meegegeven. Voorbeeld: 'KingJob.exe EA Demoart LEA info@kingsoftware.nl LEV info@kingsoftware.nl'

      De parameter LEV werkt alleen in combinatie met LEA.

      Indien parameter LEV niet wordt meegegeven wordt voor LEV hetzelfde mailadres gebruikt dat bij parameter LEA is meegegeven.

    • LEF hiermee wordt het logbestand alleen verzonden als er fouten tijdens het proces zijn opgetreden.

      Voorbeeld: 'KingJob.exe EA Demoart LEA info@kingsoftware.nl LEF'

      De parameter LEF werkt alleen in combinatie met LEA

Bijvoorbeeld:

c:\King\KingJob.exe EA DemoArt JOB 12 RUN JOBVD 02-07-2014 LN LEA systeembeheer@mijnbedrijf.nl LEV jobs@mijnbedrijf.nl LEF

 

Is de job volledig en succesvol uitgevoerd, dan resulteert dat in 'errorlevel=0'.

De overige errorlevels:

1=Fout (Voorbeeld: een nieuwe order XML inlezen zonder debiteurgegevens)

2=Waarschuwing (Voorbeeld: een nieuw artikel inlezen waarvan de EAN al voorkomt bij een ander artikel)

3=Kritieke fout (Voorbeeld: connectie met database-server wordt verbroken. De foutmelding wordt getoond en indien opgestart met RUN parameter ook weer automatisch gesloten)

Voorbeeld van een batch-bestand dat KingJob.exe aanroept en het resultaat teruggeeft: 

echo off
c:\king\KingJob.exe EA DemoArt JOB 12 RUN
if errorlevel 3 goto KritiekeFout
if errorlevel 2 goto Waarschuwing
if errorlevel 1 goto Fout
:Goed
echo Verwerking job gelukt!
goto Eind
:Waarschuwing
echo Verwerking job gelukt, maar er is een waarschuwing!
goto Eind

:Fout
echo Verwerking job mislukt!
goto Eind

:KritiekeFout
echo Verwerking job mislukt (Kritieke fout)!

:Eind

 

Tip: het is mogelijk om bestanden uit een bepaalde map in te lezen (dus met verschillende bestandsnamen), door gebruik te maken van een batch-bestand. Kijk voor meer informatie bij Meer bestanden in map importeren door KingJob.

 

Lukt het opstarten van KingJob.exe niet, dan wordt daarvan een aantekening gemaakt in het Logboek. Mogelijke oorzaken zijn:

  • de parameters zijn niet juist (administratiecode is niet correct, of het opgegeven job-nummer komt in die administratie niet voor).

  • de optie King Jobs komt niet voor in de licentie van de betreffende King-administratie.

  • de administratie is niet van hetzelfde release-nummer als het programma KingJob.exe.

  • de job is aangemaakt door een gebruiker die op dit moment geen rechten meer heeft in deze administratie, en/of (met de optie Rechten per gebruiker) niet meer beschikt over het recht Jobs.

Naar Job-gegevens

 

Koppelingspictogram voor conceptenZie ook