Oprettelse af batchjob i Stonebranch

OBS: Før implementering af batchjobs i Stonebranch, skal forudsætninger beskrevet her være opfyldt: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/1814790241

I StonebranchTasks.xml beskriver hvilke task som skal oprettes i Stonebranch. Til hver task, kan man oprette en default eller en miljøspecifik trigger, hvis der ikke er oprettet en miljø specifik trigger benyttes default triggeren.

Eksempel på indhold af StonebranchTasks.xml:

 

<?xml version="1.0" encoding="utf-8"?>
<Tasks>
    <Task>
        <Name>JOBNET-GetCodeListFromBroker</Name>
        <summary>Henter kodelister (Jobcentre og kommuner) fra DFDG, til Jobnets database (AMS_CODELIST?)</summary>
        <command>D:\Data\Program\Jobnet\GetCodeListFromBroker\BL.BatchJob.GetCodeListFromBroker.exe</command>
        <runtimeDir>D:\Data\Program\Jobnet\GetCodeListFromBroker</runtimeDir>
        <parameter></parameter>
        <Trigger>
            <PROD repeat="Daily" at="05:40" server="JOBAPP"/>
            <ST1 repeat="Daily" at="05:40" server="JOBAPP"/>
            <Default repeat="Daily" at="12:00" server="JOBAPP"/>
        </Trigger>
    </Task>
</Tasks>

 Task skal have følgende tags

  • Name skal begynde med systemnave (JOBNET-,DFDG-,VITAS-)

  • Summary Beskrivelse til batchjobbet

  • command exe filen som skal afvikles

  • runtimeDir kataloget batchjobbet skal afvikles fra(skal sættes til kataloget hvor exe ligger)

  • parameter parameter til batchjobbet, tom hvis der ikke er nogle parameter

  • Trigger beskrivelse til afviklings tidspunkt.

En trigger har miljø navn eller Default som tag, en trigger attributter er afhænge af hvilke trigger type(repeat) man oprettet. Man kan oprette følgende trigger typer:

  • ONCE: Afviklingen repeteres efter et minut antal

  • Daily: Afvikles engang om dagen

  • Weekly: Afvikles en gang om ugen

  • Monthly: Afvikles en gang om måneden

Alle triggerne kan have følgende attributter:

  • disable: true = disable, false (eller ikke med) = enable

  • server: navnet på agenten, som afvikler jobbet(Skal være sat).

    • Jobnet skal benytte JOBAPP

    • DFDG skal benytte DFDGAPP

    • Vitas skal benytte VITWEB

Trigger type ONCE har følgende attributter:

  • at: Hvornår på dagen skal jobbet starte (Hvis at ikke er sat, bliver starttidspunkt sat til 00:00)

  • end: Hvornår på dagen skal jobbet slutte (Kan kun sættes hvis at er sat)

  • repetitionIntervalInMinutes: repeteres med antal minutter (Skal være sat)

F.eks.

Et Jobnet job som afvikles hver 10 minut hele døgnet:

<Trigger>
<Default repeat="Once" repetitionIntervalInMinutes="10" server="JOBAPP"/>
</Trigger>

Et Vitas job som afvikles hver 10 minut mellem kl. 7.00 og 18.00

<Trigger>
  <Default repeat="Once" repetitionIntervalInMinutes="10" at="07:00" end="18:00" server="VITWEB"/>
</Trigger>

 

Trigger type Daily har følgende attributter:

  • at: Tidspunkt for at afvikle jobbet (Skal være sat)

F.eks.

Et Jobnet job som afvikles daglig kl 5.40 i Prod og T1, og kl 12.00 i resten af miljøerne.

<Trigger>
  <PROD repeat="Daily" at="05:40" server="JOBAPP"/>
  <ST1 repeat="Daily" at="05:40" server="JOBAPP"/>
  <Default repeat="Daily" at="12:00" server="JOBAPP"/>
</Trigger>

Et Jobnet job som skal afvikles flere gange på en dag fx. afvikles daglig kl 8.00 og 14.00 i PROG og kl. 8.02 og 14.02 i T1 og kl. 12.00 i resten af miljøerne.

<Trigger>
  <PROD repeat="Daily" at="08:00" server="JOBAPP"/>
  <PROD repeat="Daily" at="14:00" server="JOBAPP"/>
  <ST1 repeat="Daily" at="08:02" server="JOBAPP"/>
  <ST1 repeat="Daily" at="14:02" server="JOBAPP"/>
  <Default repeat="Daily" at="12:00" server="JOBAPP"/>
</Trigger>

Trigger type Weekly har følgende attributter:

  • at: Tidspunkt for at afvikle jobbet (Skal være sat)

  • weekdays: Hvilke ugedage skal jobbes afvikles (Skal være sat)

F.eks.

Et DFDG job som afvikles på hverdage kl 3.00:

<Trigger>
  <Default repeat="Weekly" weekdays="monday,tuesday,wednesday,thursday,friday" at="03:00" server="DFDGAPP"/>
</Trigger>

 

Trigger type Monthly har følgende attributter:

  • at: Tidspunkt for at afvikle jobbet (Skal være sat)

  • WeeksOfMonth: Hvilke uge i af måneden skal jobbet afvikles (Skal være sat, 1st, 2nd, 3rd, 4th)

  • DaysOfWeek: Hvilke ugedag skal jobbet afvikles

F.eks.

Et DFDG job som afvikles på 4 lørdag kl. 7.00 i hver måned

<Trigger>
 <Default repeat="Monthly" DaysOfWeek="Saturday" WeeksOfMonth="4th" at="07:00" server="DFDGAPP"/>
</Trigger>