Työajan vienti/tuonti liittymien ajastus

Johdanto

Liittymien ajastusosiossa on mahdollista automatisoida tietojen tuonti tai vienti ulkoisista järjestelmistä tiettyinä päivinä ja tiettyinä aikoina.

Asetukset ajastuksia varten löytyvät Työaikaosiosta Hallinta > Työyhteisön asetukset > Liittymät > Liittymien ajastus. Ajastukset voi määritellä vain työyhteisön tasolle.

Tarkista myös ohje liittymälle, jota olet ajastamassa. Järjestelmä sisältää todella monia liittymiä, jotka saattavat toimia hieman eri tavalla ja tukea eri ajastusvaihtoehtoja.

Asetukset

Asetuksiin tulisi asettaa liittymä (sekä sääntöjoukko mikäli valittu liittymä tukee tätä), jotka haluat ajastaa. On suositeltavaa että tallennat nämä määritykset ennenkuin alat määrittää varsinaisia aikatauluja.

Jos olet tekemässä muutoksia tuleviin ajoihin, on suositeltavaa että käytät asetuksen historia toimintoa (kalenteri-ikoni) ja varmistat että muutos tulee voimaan vasta halutulla hetkellä.

Ajastus voimassa alkaen on pakollinen kenttä. päivä ja aika voidaan määrittää nykyhetkeen jos aikataulun tulisi olla aktiivinen heti, mutta mahdollistaa myös aikataulun aktivoinnin vasta tulevana ajankohtana. Ajankohta on teknisesti myös mahdollista asettaa menneisyyteen mutta tämä saa aikaan että liittymä suoritetaan myös menneiden päivien osalta (max 3 päivää taaksepäin). Tämä ei ole tavanomainen käyttötapaus. Aikavyöhyke Europe/Helsinki.

Huomaathan, että ajastusten voimassaoloajat tulee tallentaa erikseen asetussivun alaosasta löytyvästä Tallenna-painikkeesta. 

Ajastus voimassa saakka on vaihtoehtoinen kenttä. Jos tämä on tyhjä niin ajastus on toistaiseksi voimassaoleva. Aikavyöhyke Europe/Helsinki

Kuvaus voidaan vapaasti määrittää ajastukselle. Kuvaus näytetään ajastuksien listalla ja auttaa tunnistamaan yksittäiset ajastukset helpommin.

Liittymä on pakollinen kenttä. Tämä määrittää mitä liittymää tulee käyttää kun ajastettu työ suoritetaan.

Poimintasäännöt antaa määrittää sääntöjoukon, mikäli valittu liittymä tukee sääntöjoukon käyttämistä. Osalle liittymistä on pakko määrittää sääntöjoukko. Jos sääntöjoukko on valittu, niin sääntöjoukon asetukset myös määrittävät palvelimen, jonne tiedot viedään tai jolta tiedot tuodaan.

Ajastustapa on joko päivä tai minuuttiajastus. Myös nämä vaihtoehdot riippuvat valitusta liittymästä, sillä osa saattaa tukea vain päivittäistä suoritusta.

Minuuttiajastuksen sääntö on käytössä vain minuuttiajastuksella ja on pakollinen jos ko. ajastustapaa käytetään. Kentän avulla määritetään, kuinka monen minuutin välein suoritus tapahtuu. Suoritusta ei voi määrittää tapahtuvaksi useammin kuin 15 minuutin välein. Taikasauva-ikonia painamalla saa auki työkalun, josta saa valittua valmiita esimerkkejä säännöistä.

Päivittäisen ajastuksen sääntö on käytössä vain päiväajastuksella. Antaa määrittää minä päivinä suoritus tapahtuu. Taikasauva-ikonia painamalla saa auki työkalun jolla voi valita sääntöesimerkkejä listasta.

Päivittäinen aloitusaika on käytössä vain päiväajastuksella ja määrittää kellonajan, jolloin suoritus tapahtuu. Tälle kellonajalle ei ole rajoitteita mutta mikäli on tärkeää että suoritus tapahtuu mahdollisimman lähellä tätä aikaa tulisi välttää aikoja jotka osuvat ennalta määritettyjen huoltoajankohtien päälle tai aikoja jolloin järjestelmä on yleisesti kovan kuormituksen alla. Tiedot huoltoajankohdista löydät täältä. Aikavyöhyke Europe/Helsinki.

Tuonnin/viennin aloituspäivän sääntö ja Tuonnin/viennin lopetuspäivän sääntö kentät määrittävät ajanjakson joka tuodaan tai viedään. Nämä kentät eivät ole käytössä kaikilla liittymillä. Taikasauvaikonia painamalla saat auki työkalun jolla pystyt valitsemaan esimerkkisääntöjä listalta.

Lähetä sähköpostiraportti seuraaviin osoitteisiin  Antaa määrittää sähköpostiosoitteet joihin lähetetään raportti jokaisesta ajastetusta suorituksesta. Voit antaa useamman osoitteen erottelemalla ne pilkulla(,). Suurin osa liittymistä asettaa viedyn/tuodun siirtotiedoston mukaan mailiin. Sähköposti lähetetään, oli suorituksen tulos epäonnistunut tai onnistunut. Huom liittymän tai sääntöjoukon ei ole pakko määrittää palvelinasetuksia ja saat silti sähköpostiraportin.

Viivästyneet tai ajamatta jääneet suoritukset

Joissain tapauksissa voi esiintyä viivästyksiä ennenkuin järjestelmä alkaa suorittamaan ajastettua liittymää esim. huoltoajankohdat. Jos liittymä viivästyy, mutta on edelleen päivällä, jolle se oli määritetty ajettavaksi, suoritus pysyy tilassa "Jonossa" ja tulee lopulta suoritetuksi.

Jos liittymää ei voida aloittaa samana päivänä pidentyneiden huoltotoimenpiteiden takia, suoritus näytetään historia taulussa epäonistuneena. Työ voidaan manuaalisesti suorittaa uudestaan, mutta tällöin tulisi varmistaa että se on kyseisen liittymän kohdalla turvallista. Osa liittymistä saattaa siirtää kaikki tiedot joka suorituskerralla ja osa liittymistä vain aiemman siirron jälkeiset tapahtumat, missä on myös tärkeää että suoritukset tapahtuvat oikeassa järjestyksessä. Lue kohdasta "Ajastuksien aloittaminen tai uudelleen aloittaminen manuaalisesti" lisää tästä.

Samanaikaisesti suoritettavat liittymät

Saman liittymän suorittaminen useampaan kertaan samanaikaisesti voi tuottaa odottamattomia seurauksia. esim. samojen tiedostojen luku/kirjoitus SFTP-palvelimella. Jos samassa asiakasympäristössä yritetään ajaa samaa liittymätyyppiä samanaikaisesti niin järjestelmä odottaa että toinen niistä valmistuu ennenkuin seuraavaa aletaan suorittaa. 

Erilliset liittymät, jotka käyttävät samaa tiedostopalvelinta, tulisi määrittää niin etteivät ne aiheuta ristiriitoja keskenään. Esim. Jos liittymä lukee tiedostoja SFTP-palvelimelta ja toinen kirjoittaa tiedostoja samalle SFTP-palvelimelle, niin on suositeltavaa että ne käyttävät eri hakemistoja palvelimella. Eri aloitusaikoihin ei kannata luottaa sillä toisen suorituksen aloitus saattaa viivästyä kuten oli kuvattu kohdassa "Viivästyneet tai ajamatta jääneet suoritukset"

Ajastettujen suoritusien historia ja tila

Avatussa ajastusosiossa on historiataulu, joka näyttää kaikki aiemmat ajastuksen suoritukset ja kaikki käynnissä olevat työt sekä mahdolliset asetusvirheet, jotka aikataulussa tai liittymässä on havaittu.

Suorita nyt -nappi sallii manuaalisesti suorittaa ajastetun liittymän (lue kohta "Ajastuksien aloittaminen tai uudelleen aloittaminen manuaalisesti")

Taulu näyttää milloin valittu ajastus suoritettiin ja oliko sen tulos onnistunut vai epäonnistunut. Useimpien liittymien kohdalla myös viennin/tuonnin siirtotiedosto on saatavilla.

The "Tila" column shows the following job states:

• "Ajastettu" - Represents an upcoming job that is scheduled to run at a particular time (see the scheduled column).
• "Jonossa" - The job will start as soon as possible. The delay can be caused due to ongoing maintenance windows, multiple jobs from the same integration all starting at once, or an excessive number of jobs all scheduled to start at the same time.
• "Käynnissä" - The job is running now.
• "Peruutettu" - The job was cancelled and won't run at the scheduled time, this does not affect other future schedules.
• "Päättynyt" - The job has finished running and the log is now available.
• "Aloitusaika umpeutunut" - For whatever reason we were unable to run the job at the time it was scheduled to run, if we cannot run it after a certain amount of time we deem it no longer safe to do and flag the job with this status.
• "Aika loppui" - The job took longer than 6 hours to run so it has likely errored and we have flagged it as such. In the event it is still running and is taking a really long time, the status and log will eventually be corrected.

Kaikkien automaattisesti suoritettujen liittymien tilan näet myös palvelulokista (lue lisää siitä täältä)

Ajastuksien aloittaminen tai uudelleen aloittaminen manuaalisesti

Kun ajastus on määritetty ja tallennettu se tullaan suorittamaan ajastusasetuksien mukaan automaattisesti, mutta joissain tapauksissa voi olla tarpeen manuaalisesti suorittaa ajastus. Tätä varten on joitakin tärkeitä ohjeita:

• Suorita nyt -Nappi historia toiminnoissa  suorittaa ajastuksen niin kuin se olisi ajastettu tapahtuvaksi nykyhetkellä, jolloin myös asetukset poimitaan sen mukaan, tarkoittaen esimerkiksi että jos liittymä on asetettu poimimaan kahden aiemman päivän tapahtumat, manuaalinen suoritus saattaisi poimia eri ajanjakson kuin automaattiset suoritukset.
• Suorita uudestaan -nappi näytetään kun tarkastelet tiettyä aikataulun suoritusta historia taulussa. Tässä on joitain eroavaisuuksia verrattuna suorita nyt -nappiin. Työ suoritetaan alkuperäisen aikataulun mukaisesti. Tuontiliittymän tapauksessa toiminto myös käyttää samaa tiedostoa, jos sellainen ladattiin aiemman suorituksen aikana. Viennissä tiedosto muodostetaan samalla tavalla.