Filoverføring Spesifikasjon av filformater Transaksjonsspesifikasjon
Side 2 Filoverføring - versjon 9.93.0 Spesifikasjon av filformater Innholdsfortegnelse Filoverføring... 3 Import av filer fra eksternt system... 3 Funksjonalitet... 3 Filformater... 4 Desimalskilletegn... 5 APPENDIX... 5 Record beskrivelse... 5 Format: CSV... 5 Format: Xml fil... 6 Validering: Xsd skjema... 6 Format: Posisjonsnotasjon... 7
Side 3 Filoverføring Import av filer fra eksternt system Transer fra eksternt system kan importeres til registreringsbildet til en lønnsperiode i maritech lønn. Dette har vært mulig lenge, men fra 9.93.00 er det gjort visse forandringer i rutinen for import. Funksjonsbeskrivelse følger i dette dokumentet. Merk: Dokumentet beskriver lønnsregistreringer, ikke reiseregninger. For reiseregninger benytt formatet Lexi (ikke beskrevet her). Funksjonalitet Data som skal importeres til oppgitt klient, år og periode, leses nå inn i samme skjermbilde uavhengig av format. En leser inn data ved å velge en fil vha knappen Hent fil. Følgende dialog vises: Dersom du har importert en fil tidligere, vil filnavnet til denne filen ligge øverst i listen over valgbare formater, og katalogen denne lå i vil være oppstartskatalog for dialogen. Valg av en fil vil avstedkomme en import, og dersom det foreligger transer, og det ikke er feil på dem, gjøres knappen Oppdater lønnsdata tilgjengelig.
Side 4 Feilsituasjoner: Ved innlesning vil transer med feil markeres, og tilbakemelding gis til bruker før oppdatering av data til perioden. Det er ikke alltid det er mulig å kontrollere alle varianter av feil ved innlesning, men ved formatfeil vil en melding av denne typen vises: Som følge av at innlesning kan være helt eller delvis suksessfull, men det ligger feil i skjermbildet uten at importprogrammet har oppdaget det, sjekkes data ved oppdatering, og tilbakemelding blir gitt da også om noe er galt med dataene. Linjer med feil markeres med row selected, noe som fører til at de er blå i skjermbildet. I tillegg får en rapport med oversikt over linjer med feil i. verdier programmet oppfatter som merkelige, men ikke feil, rapporteres også Filformater Det finnes 4 definerte filformater ABTIDINT.DAT posisjonsnotasjon i tekstfil MWTIDINT.TXT tab separert tekstfil WINTID.TXT samme som mwtidint.txt *.XML fil definert ift xsd/følger maritech xml definisjon Ved innlesning av filer med filnavnene oppgitt, leses disse med designere rutiner for disse filformatene. Dersom filene heter noe annet, vil det bli opplyst om at maritech lønn ikke kjenner filnavnet, men vil forsøke å lese filen likevel. Er filen konform med en av de oppgitte formatene, leses filen vha rutiner for disse, hvis ikke sjekkes filene for følgende: Tekstfiler leses som kolonneseparerte, Separator: "," ";" ASCII verdi 9 - Horizontal Tab Antallet kolonner har betydning for innlesningslogikk, Antall kolonner:
Side 5 Dersom 13: alt leses som det står Dersom 11: alt leses som det står, men tolkes som at sats og beløp mangler, så dette kalkuleres av programmet. Dersom 6: kolonnene antaes å være Klientnr,Ar,PeriodeNr,AnsattNr,LonnArtNr,Antall. Sats og beløp legges inn av programmet. De andre kolonnene fylles inn med null verdier. Alle andre verdier avstedkommer feil ved innlesning Xmlfiler leses inn direkte, og er enten feil eller riktige. Desimalskilletegn Vær oppmerksom på at å bruke komma som kolonneskilletegn OG desimalskilletegn gjør at data leses feil. Benytt punktum som desimalskilletegn i denne situasjonen ved CSV, ellers komma. For xml benyttes punktum for desimalskilletegn. APPENDIX Record beskrivelse record name record type verdibeskrankning beskrivelse påkrevet klientnr double 1-999 Må stemme med aktiv klient ja ar int 4 siffer Må stemme med aktivt år ja periodenr int heltall Må stemme med aktiv ja periode ansattnr int heltall Må stemme med ansattnr ja som finnes i maritech lønn lonnartnr int 1-599, 599-999 Må stemme med LT-art som ja finnes i maritech lønn, verdi fra 1-599 er lønnarter avdelingnr int heltall Må finnes hvis oppgitt berernr int heltall Må finnes hvis oppgitt prosjektnr int heltall Må finnes hvis oppgitt underprosjektnr int heltall Må finnes hvis oppgitt fasenr int heltall Må finnes hvis oppgitt antall decimal desimaltall Kan være null eller 0, men må ja oppgies sats decimal desimaltall belop decimal desimaltall Format: CSV Tekstfil separert med tab, semikolon eller komma oppgitt rekkefølge er foretrukket rekkefølge. Ikke ha med linje for kolonnenavn.
Side 6 Kolonnene inneholder verdier for disse klonnnene, antall og kolonnenavn: 13 - Klientnr,Ar,PeriodeNr,AnsattNr,LonnArtNr,AvdelingNr,BererNr,ProsjektNr,Underprosjektnr,F asenr,antall,sats,belop 11 - Klientnr,Ar,PeriodeNr,AnsattNr,LonnArtNr,AvdelingNr,BererNr,ProsjektNr,Underprosjektnr,F asenr,antall 6 - Klientnr,Ar,PeriodeNr,AnsattNr,LonnArtNr,Antall Format: Xml fil Alle element må være med, selv om de ikke inneholder verdi. <dsl_mwtidint_external> <dsl_mwtidint_external_row> <klientnr>300</klientnr> <ar>2011</ar> <periodenr>19</periodenr> <ansattnr>19</ansattnr> <lonnartnr>12</lonnartnr> <avdelingnr>99</avdelingnr> <berernr>400</berernr> <prosjektnr>0</prosjektnr> <underprosjektnr>0</underprosjektnr> <fasenr>0</fasenr> <antall>33.50</antall> <sats>0</sats> <belop>0</belop> </dsl_mwtidint_external_row> <dsl_mwtidint_external_row> <klientnr>300</klientnr> <ar>2011</ar> <periodenr>19</periodenr> <ansattnr>17</ansattnr> <lonnartnr>45</lonnartnr> <avdelingnr>99</avdelingnr> <berernr>600</berernr> <prosjektnr>0</prosjektnr> <underprosjektnr>0</underprosjektnr> <fasenr>0</fasenr> <antall>4.50</antall> <sats>5.00</sats> <belop>22.50</belop> </dsl_mwtidint_external_row> </dsl_mwtidint_external> Validering: Xsd skjema Skjema ikke tilgjengelig pt. Se eksempelfil xml og record beskrivelse. Tilse at punktum er brukt og ikke komma for desimalskilletegn(dersom komma er brukt som desimalskilletegn i xmlfilen, tolkes komma som tusen skilletegn, og ikke som desimaltegn). Alle tag er må være med, men AvdelingNr,BererNr,ProsjektNr,Underprosjektnr,Fasenr kan mangle verdier.
Side 7 Format: Posisjonsnotasjon Vennligst ikke bruk dette formatet.