| Table of Contents |
|---|
Dataleverancer beskrives som følgende:
...
Teknisk beskrivelse
Dette afsnit indeholder generel information om Serviceplatformens SFTP server, samt en beskrivelse af de to typer filudveksling.
...
Et it-system logger på SFTP serveren ved brug af it-systemets SSH nøgle. Denne SSH nøgle skal genereres, før et it-system kan blive registreret som it-system, der kan anvende SFTP serveren. Serviceplatformen skal kende den offentlige del af SSH nøglen i forbindelse med registrering af it-systemet og muligheden for anvendelse af SFTP.
...
Generering af SSH nøgler
Der findes flere forskellige fremgangsmåder der kan bruges til at generere SSH nøgler. Serviceplatformens SFTP server kræver at SSH nøglerne er generet med OpenSSH. Den følgende metode kan bruges på både Windows, Linux og OSX, givet at OpenSSH er installeret på maskinen.
...
I eksemplet ovenfor findes den private del af nøglen i filen id_rsa i mappen /home/EPM/.ssh/.
...
Mappestruktur
Når et it-system er registret og kan anvende SFTP har it-systemet adgang til to private mapper på SFTP serveren:
...
• OUT: Den udgående mappe, hvor it-systemet uploader de filer, det ønsker at sende til andre it-systemers mapper på SFTP serveren.
...
Upload af filer
Når dit it-system ønsker at sende filer til andre registrerede it-systemer på Serviceplatformen, er der følgende krav i forbindelse med upload af filer til SFTP serveren.
...
- Filer skal uploades til OUT-mappen: Det er kun filer uploadet til OUT-mappen som bliver videresendt til andre it-systemers IN-mapper. Uploades filen fejlagtig til IN-mappen vil den ikke blive behandlet.
- Triggerfil overføres efter endt filupload: Alle filoverførsler hvor it-systemet anvender typen simpel overførsel af filer, skal forsynes med en triggerfil. Filen skal først være færdig uploadet i OUT-mappen før, der skal sendes en triggerfil for filoverførslen. Sendes triggerfilen før endt filupload kan overførslen risikere at blive afvist.
...
Oprydning på SFTP serveren
It-systemer skal regelmæssigt at rydde deres IN- og OUT-mapper på SFTP serveren. Det gøres ved at slette filer der er færdigbehandlede.
...
It-systemer skal tilgå Serviceplatformens SFTP server via dens offentlige IP adresse.
Miljø | IP adresse / port |
|---|---|
| For produktionsmiljøet er denne: | xx.xx.xx.xx / 22 |
| For exttest er denne: | xx.xx.xx.xx / 22 |
Simpel overførsel af filer
...
For at give overblik over de forskellige trin, som indgår i udveksling af en fil ved typen simpel overførsel af fil, kan følgende brugseksempel konsulteres.
...
Brugseksempel
Dette brugseksempel dækker følgende scenarie: It-systemet med SFTP brugernavnet DemoAfsender ønsker at afsende filen info.txt til it-systemet DemoModtager.
...
1. Upload af fil samt triggerfil: Afsendersystemet uploader filen info.txt til dets OUT-mappe på SFTP serveren sammen med triggerfilen info.trigger, der har indholdet vist nedenfor. Bemærk at ”Sender” feltet skal udfyldes med SFTP brugernavnet på afsendersystemet.
<FileDescriptor> <FileName>info.txt</FileName> <SizeInBytes>18</SizeInBytes> <Sender>DemoAfsender</Sender> <SendersFileId>67e072ec-2db2-4c38-aeb1-a71c135ce566</SendersFileId> <Recipients>DemoModtager</Recipients> </FileDescriptor> <FileContentDescriptor> </FileContentDescriptor></ns2:Trigger> |
2. Teknisk kvittering uploades til afsendersystemet: Triggerfilen valideres af Serviceplatformen og en teknisk kvittering uploades til afsendersystemets IN-mappe. Hvis triggerfilen er valid ”låses” filen info.txt i afsendersystemets mappe, så den ikke kan ændres efter valideringen af triggerfilen er foretaget. I praksis sker ”låsningen” ved, at afsendersystemets skriverettigheder til filen fjernes. Efter valideringen af triggerfilen slettes den fra afsendersystemets IN-mappe.
Den tekniske kvittering vil have som udgangspunkt have filnavnet info.receipt, altså filnavnet på filen, der sendes, postfixet med ”.receipt”. Det skal dog bemærkes at hvis en teknisk kvittering med dette navn allerede ligger i afsendersystemets IN-mappe vil den tekniske kvittering få navnet info.receipt<TIMESTAMP>, hvor <TIMESTAMP> i praksis vil være erstattet af et timestamp i millisekunder for hvornår den tekniske kvittering er genereret. I dette scenarie vil den tekniske kvittering have følgende indhold:
<FileTransferUUID>eb04e6e2-a4ae-468f-bdfd-8b676c720935</FileTransferUUID> <SendersFileId>67e072ec-2db2-4c38-aeb1-a71c135ce566</SendersFileId> <Receipt> <Message>SUCCESS</Message> </Receipt></ns2:TechnicalReceipt> |
3. Filen overføres til modtagersystemet sammen med en metadata fil: Filen info.txt overføres fra afsendersystemets OUT-mappe til modtagersystemets IN-mappe. Ved samme proces uploades der en metadata fil til modtagersystemets IN-mappe. Metadata filen vil have filnavnet info.txt.metadata og have følgende indhold:
<FileTransferUUID>eb04e6e2-a4ae-468f-bdfd-8b676c720935</FileTransferUUID> <FileDescriptor> <FileName>info.txt</FileName> <SizeInBytes>18</SizeInBytes> <Sender>DemoAfsender</Sender> <SendersFileId>67e072ec-2db2-4c38-aeb1-a71c135ce566</SendersFileId> <Recipients>DemoModtager</Recipients> </FileDescriptor> <FileContentDescriptor> </FileContentDescriptor></ns2:FileMetadata> |
4. Modtagersystemet tjekker dets IN-mappe og finder filen: Modtagersystemet vil ved simpel overførsel af filer ikke modtage nogen notifikation om, at filen er blevet overført til dets IN-mappe. Det er derfor selv ansvarlig for at opdage, at en fil er blevet overført til det. Modtagersystemet kan bl.a. gøre dette ved periodisk at downloade alle filer fra dets IN-mappe.
Dataformater i filerne
Hermed input til indhold af data-filer:
Emne | Værdi |
|---|---|
Tegnsæt | UTF-8 |
Feltseparator | ¤ |
Recordseparator | CRLF |
Feltlængde | variabelt |
Numeriske felter | Fortegn er foranstillet Decimalpunkt er komma Null repræsenteres som ”” (ikke 0) |
Tekstfelter | Tekst omstillet af " ‑ eks "tekst" Null repræsenteres som "" (ingen space) |
Datofelter | aaaa‑mm‑dd (år-måned-dag) Null repræsenteres som TABTAB |
Tidsstempel | Hvis der er tidsstempel dvs klokkeslæt med datoen, bruges følgende w3 standard: http://www.w3.org/TR/NOTE-datetime.
aaaa‑mm‑ddTtt:mm:ssTZD (foretrækkes; TZD = tidszone) aaaa‑mm‑ddTtt:mm:ss.sssTZD (.sss = decimaler på sekunderne, 3 decimaler) Eksempel: 2008-01-01T17:30:00+01:00 |
Derudover er der kommunenumre, som tidligere har været 4 cifre med foranstillet nul, hvis kommunenummeret er på 3 cifre. I den fremtidige verden anvendes kommunernes cvr-numre som identifikation.
...
Sidst er der også et kontrol-element med følgende informationer:
Start | Længde | Format | Indhold |
|---|---|---|---|
1 | 15 | N | Antal record i dataudtræksfil |
16 | 10 | A | Kørselsdato for udtræk (aaaa-mm-dd) |
26 | 10 | A | Udtræksperiode, start (aaaa-mm-dd) |
36 | 10 | A | Udtræksperiode, slut (aaaa-mm-dd) |
Det har tidligere været håndteret som selvstændige kontrol-filer, men kan måske også håndteres som header i datafil.
...