Sorry!
This article has not been translated yet.
Sääntöjoukolle voidaan määritellä asetukset, joiden perusteella niistä muodostetaan automaattisesti siirtotiedosto vietäväksi määritettyyn palveluun. Sääntöjoukon tulokset on mahdollista viedä tiedostosiirtona SFTP-palvelimelle tai joidenkin liittymien kohdalla myös Web Service rajapintakutsulla. Jos erillinen palveluntarjoaja tukee jotain näistä siirtotavoista voidaan liittymän tiedot välittää suoraan palveluntarjoajalle sen sijaan, että käyttäjä lataa erikseen siirtotiedoston ja vie sen kohdejärjestelmään. Ajastetut siirrot käynnistetään klo 0:05.
Viennin asetukset tulee määritellä työyhteisötasolle.
Viennin tiedostomuoto tulee määritellä, muutoin siirtoa ei aloiteta.
Asetukset
Tietojen lähettäminen Web service rajapintakutsulla
Tämä vaihtoehto on käytettävissä vain osalla liittymistä. Tarkista liittymäkohtaisesta ohjeesta tarkemmat tiedot tämän käyttöön.
Tietojen lähettäminen SFTP-tiedostosiirrolla
Palvelu siirtää sääntöjoukon poimintasääntöjen mukaisen tuloksen määritettyyn SFTP kansioon.
Katso SFTP tiedonsiirron määrityksistä yleiset ohjeet liittyen palvelimen osoitteeseen, käyttäjätunnukseen, autentikointiin (public key tai salasana) sekä minkälainen polkurakenne palvelimella tulisi olla.
Vientitiedoston nimi: Vaihtoehtoinen. Mikäli tätä ei ole määritetty käytetään valitun tiedostomuodon/palvelun oletuskäytäntöä tiedostonimen muodostukseen. Mikäli tiedostonimi määritetään kannattaa seuraavat asiat huomioida:
- Nimen tulee sisältää myös tiedostopääte. On suositeltavaa että käytät samaa kuin mitä viennin tiedostomuoto oikeastikin käyttäisi (esim. '.csv' tai '.xml')
- On vahvasti suositeltavaa että tiedoston nimi sisältää aikaleiman. Asetuskenttään voidaan lisätä seuraavat paikkamerkinnät, jotka järjestelmä korvaa ajohetken aikaleimalla
- [vvvvkkpphhmmss] korvautuu esim. 20230101043059
- [vvvvkkpphhmm] korvautuu esim. 2023010430
- [vvvvkkpp] korvautuu esim. 20230101
- Nimeen on hyvä lisätä jotain lähdetietoja esim. sääntöjoukon nimi jolloin tiedostopalvelimella näkee nimen perusteella mitä kautta siirtotiedosto on muodostunut.
Vientitiedoston jakaminen osiin
Tämän osion avulla voit määrittää, että suoritus luo enemmän kuin yhden tiedoston ja säännöt, joiden mukaan tiedot jaetaan eri tiedostoihin. Tietojen jakamisen voi toteuttaa esim. henkilön kustannuspaikan tai henkilön maksuryhmän perusteella. Lue lisää täältä.
Viennin aikavälin säännöt
Viennin aikavälin sääntöön kirjoitetaan se periaate, milloin aineisto muodostuu. Esimerkiksi viennin aikavälin sääntönä voi olla '4 day', joka tarkoittaa, että sääntöjoukko viedään jokaisen kuukauden 4. päivä. Kentässä voidaan myös käyttää päivämääriä kuten muodossa YYYY-MM-DD, esimerkiksi 2020-10-09. Tällöin aineisto muodostetaan vuonna 2020 lokakuun yhdeksäs päivä. Säännön muoto '4 weekday' on myös mahdollinen ja tarkoittaa kuukauden neljättä arkipäivää, mutta arkipyhiä ei huomioida eli jos kuukauden neljännelle arkipäivälle osuu pyhäpäivä, ajetaan aineisto ko. päivänä pyhäpäivästä huolimatta.
Mikäli aineisto halutaan muodostaa tiettyinä päivämäärinä, jotka eivät noudata yhtä selkeää kaavaa, voidaan tämä toteuttaa määrittämällä poikkeusasetuksiin arvoksi 'now' ja säännöksi pilkulla eroteltuna halutut päivämäärät. Kun listaan päivitetään uudet päivämäärät, voidaan vanhat aina tällöin poistaa jotta päivämäärien ylläpitäminen pysyy mahdollisimman selkeänä, eli jo menneitä päivämääriä ei tarvitse säännöissä säilyttää. Jos halutaan säilyttää tieto päivämääristä, voidaan voimassa alkaen ja voimassa saakka päivämäärät asettaa esim. 1.1. ja 31.12 vuosittain.
Vietävän jakson päivämäärät määritellään kentissä 'käsiteltävän jakson alkupäivän sääntö' ja 'käsiteltävän jakson loppupäivän sääntö'. Kenttiin voidaan myös määrittää tarkkoja päivämääriä muodossa YYYY-MM-DD. Vietävän jakson alkupäivän sääntönä voi olla esimerkiksi 'first day of last month' ja vietävän jakson loppupäivän sääntönä 'last day of last month'. Jos jakson halutaan olevan aina tietyn kuukauden alusta tietyn kuukauden loppuun nykyisenä vuotena, alkupäivän sääntönä voi olla esimerkiksi 'first day of January' ja 'last day of February'.
Ajastettujen vientien tarkastelu
Sääntöjoukon muodostamisen tulos näytetään palvelulokissa. Palveluloki näyttää onnistuneet sekä epäonnistuneet sääntöjoukon tulosten muodostamiset. Onnistuneessa sääntöjoukon tulosten muodostamisessa näytetään muodostunut sisältö ja epäonnistuneesta muodostamisesta näytetään syy ajon epäonnistumiseen. Esimerkiksi virheellinen määrittely viennin aikavälin säännössä näkyy palvelulokissa epäonnistumisen syynä.