Tämä luku sisältää teknistä asiaa siirtotiedostoista, ja on suunnattu siirtotiedostoja muodostaville henkilöille.
Siirtotiedostojen rakenne
Siirtotiedostot ovat ASCII-muotoisia tiedostoja, jossa kukin tietue on omalla rivillään. Tiedot on eroteltu toisistaan puolipisteellä (;) ja rivi päättyy rivinvaihtoon. Tiedosto voidaan muodostaa esimerkiksi Excel-ohjelmasta tallentamalla tiedot CSV-muotoon (CSV (Comma Delimited) (*.csv)). Tiedostomuoto ja merkistöasetukset tulee olla Windows (CR LF) + UTF-8.
Esimerkki siirtotiedostosta:
DATA:CUSTOMER
Asiakkaiden siirtotiedosto
TYYPPI0;NUMERO;LAJI;NIMI1;LOSOITE;OSOITE
TYYPPI1;NUMERO;JUOKSU;LAJI;NIMI;SPOSTI
0;100;0;Xor;PL 94;65101 VAASA
1;100;1;0;Yhteyshenkilö;[email protected]
Tiedoston alussa on ohjerivi (esim. #DATA:CUSTOMER) tai kommenttirivejä. Ohjerivi kertoo ohjelmalle, minkä tyyppisestä siirtotiedostosta on kysymys. Toisin kuin Visma Nova -ohjelmien sisäisessä tiedonluvussa, ohjerivit ovat pakollisia. Ohje- ja kommenttirivit alkavat aina #-merkillä.
Seuraavaksi tiedostossa on tietueiden kenttänimet. Tällaiset rivit alkavat aina TYYPPIx –merkkijonolla, jossa x on tyypin numero. Esimerkissä on kaksi tietuetyyppiä, joista toinen on 0 (tyyppi0) ja toinen 1 (tyyppi1). Nämä tyyppi-rivit ovat pakollisia jokaisessa siirtotiedostossa, vaikka tietyn tyyppisiä tietorivejä ei siirtotiedostoissa olisikaan.
Varsinainen siirrettävää tietoa sisältävät tietuerivi alkaa aina tyyppinumerolla. Rivin alussa oleva ensimmäinen numero kertoo rivin/tietueen tyypin ja samalla myös sen, mitä tietoja rivillä on.
Käsiteltävät tiedot
Automatisoitu tiedonsiirto käsittelee asiakas-, varasto- ja myyntitilaustietoja. Siirtotiedostojen ohjerivit ovat:
Tieto
Ohjerivi
Asiakastiedot
DATA:CUSTOMER
Varastotiedot
DATA:PRODUCT
Myyntitilaustiedot
DATA:SALES ORDER
Tietuekuvaukset löytyvät Tiedonsiirtorajapinta (WSR)-käsikirjasta.
Huomaa, että ohjerivi on pakollinen käytettäessä tiedonlukuohjelmaa.
Tietojen vienti -toiminto kirjoittaa kaikki vietäviksi valitsemasi tiedot yhteen tiedostoon. Samassa tiedostossa voi siis olla asiakas-, varasto- ja myyntitilaustietoja. Tietojen tuonti -toiminto purkaa tiedoston useiksi eri tiedostoiksi ohjerivien perusteella.