Palvelun konfigurointi

TaskRunner -palvelu konfiguroidaan käyttämällä asennuskansiosta löytyvää FuturaPlan.TaskRunner.exe.config -tiedostostoa.

Sovellusloki

TaskRunner, triggerit ja tapahtumat kirjoittamat sovelluslokia toiminnastaan ja mahdollisista virheistä. Jos jokin ei tunnu toimivan halutulla tavalla, kannattaa tarkistaa sovellusloki. Oletuksena loki tallennetaan polkuun C:\ProgramData\DB-Manager\FuturaPlan.TaskRunner\Logs\FuturaPlan.TaskRunner.log , mutta polku on muokattavissa FuturaPlan.TaskRunner.exe.config -tiedostosta kohdasta loggingConfiguration.listeners.add.fileName.

Suoritustaajuus

Suorituskertojen väli on oletuksena 30 sekuntia. Arvokin on muokattavissa FuturaPlan.TaskRunner.exe.config -tiedostosta kohdasta appSettings.PollIntervalInSeconds.

Tehtävien konfigurointi

TaskRunner -palvelun konfigurointi tapahtuu asennuskansiosta löytyvän TaskCollection.xml -tiedoston avulla. Tiedostossa voi olla määriteltynä useita tehtäviä (Task), joissa jokaisella on 0-N triggeriä (Trigger) ja 0-N tapahtumaa (Action).

Osalle tapahtumista on mahdollista antaa parametrina triggerin palauttama objekti, joka sisältää esimerkiksi listan tilausten tunnisteista, jotka ovat vaihtaneet tilaansa. Tapahtuma tarvitsee tätä tietoa, jotta toiminto osataan kohdistaa oikeille tilauksille. Mikäli triggereitä ei ole määritelty, tapahtumat suoritetaan jokaisella suorituskerralla (katso kohta suoritustaajuus yllä). Kaikki tehtävän sisältämät trigger-ehdot pitää toteutua (AND), jotta listatut tapahtumat suoritetaan. Mikäli halutaan suorittaa tapahtuma silloin, kuin yksi monesta trigger-ehdosta toteutuu (OR), täytyy kokonaisuus kirjoittaa useammaksi tehtäväksi, jotka suorittavat saman tapahtuman eri triggerehdolla.

Alla on esimerkki TaskCollection.xml:n sisällöstä ja syntaksista.

<?xml version="1.0"?>
<TaskCollection xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Name>TaskRunner esimerkkikonfiguraatio</Name>
  <Tasks>
    <Task>
      <Triggers>
       <Trigger>
          <Name>FuturaPlan.TaskRunner.Triggers.Basic.TransactionStateTrigger</Name>
          <Params>
		    <Param Key="TimestampFileName">C:\DBManager\TaskRunner\StateTrigger1.txt</Param>
		    <Param Key="TriggerStateName">Tilaus</Param>
          </Params>
        </Trigger>
	  </Triggers>
      <Actions>
        <Action>
          <Name>FuturaPlan.TaskRunner.Actions.Basic.PrintReport.PrintReportAction</Name>
          <Params>
            <Param Key="FilePath">C:\DBManager\TaskRunner</Param>
            <Param Key="FileFormat">Excel</Param>
            <Param Key="ReportName">Raportti 1</Param>
          </Params>
        </Action>
        <Action>
          <Name>FuturaPlan.TaskRunner.Actions.Basic.TransactionStateAction</Name>
          <Params>
            <Param Key="ActionStateName">Valmis lähetettäväksi</Param>
          </Params>
        </Action>
      </Actions>
    </Task>
  </Tasks>
</TaskCollection>
  • Ei nimikkeitä