SFTP endepunkt

Vælges SFTP som endepunkt, så skal der angives adressen på SFTP-serveren, samt brugernavn og password til at logge på serveren, hvorefter Blanketmotoren vil placere følgende filer på serveren for hver enkel indsendelse

• Indsendelsens data som XML

• Indsendelsens data som PDF

• Eventuelle bilag

• En tom dummyfil til at signalere, at overførslen er færdig

Filstruktur

Der uploades en række filer til SFTP serveren i en flad filstruktur. Disse filer uploades efter den følgende rækkefølge:

1. Den generede XML-fil for indsendelsen - Denne har navnet /<indsendelsens hash>.xml

2. Den generede pdf-fil for indsendelsen - Denne har navnet /<indsendelsens hash>.pdf

3. Hver vedhæftet fil. Hver vedhæftet fil er navngivet efter følgende mønster:

   1. /<indsendelsens hash>-<vedhæftning a hash>.bin

   2. /<indsendelsens hash>-<vedhæftning b hash>.bin

4. En tom fil. Denne har navnet /<indsendelsens hash>.klar_til_processering

Fil 4 (<indsendelsen hash>.klar_til_processering) bruges til at markere, at alle filer er blevet uploadet til serveren. Dette indikeres ved, at denne fil først oprettes og uploades, når alle de ovenstående filer er blevet uploadet. Hermed sikres det, at myndigheden først begynder på at processere, når alle dokumenter har fuldendt deres uploads.

Det er på nuværende tidspunkt kun denne filstruktur, som kan benyttes i endepunktet, men udviklingsteamet er klar til at udvikle flere. Dette kan for eksempel være en hierarkisk struktur. 

Filstrukturen for de ovenstående eksempel vil se ud som følgende:

1. /92145f2f2c68eb4901fd4df24761808f458eacbf.xml

2. /92145f2f2c68eb4901fd4df24761808f458eacbf.pdf

3.  

   1. /92145f2f2c68eb4901fd4df24761808f458eacbf-245fb671fda2a11aff8578bddd772ed67bb76166.bin

   2. /92145f2f2c68eb4901fd4df24761808f458eacbf-16663395fb8bda57c270fee5006fb70b2b5058f7.bin

   3. /92145f2f2c68eb4901fd4df24761808f458eacbf-182ee96b80ab0a1ac98470d2a6f1e0e117efa2d6.bin

4. /92145f2f2c68eb4901fd4df24761808f458eacbf.klar_til_processering

I det efterfølgende afsnit ses et eksempel på, hvordan filerne skal aflæses og matches op mod indsendelsens XML.

Indsendt XML-Struktur

I det følgende betragtes et eksempel, hvor en blanket med tre vedhæftede filer indsendes til en SFTP-server. Ved indsendelsen uploades en række filer til serveren; disse filer kædes sammen i en XML-struktur, som er vist herunder. De forskellige elementer er markeret med farver, som fremhæver strukturen.

Hvert element i XML-strukturen får tildelt et unikt hash, der bruges til at identificere elementet. For blanketten og indsendelsen er der givet følgende hashes (unikke hases for dette eksempel er fremhævet med fed skrift):

• Blanketten: 2c9bf647f7c8c6874daa428b84d074d4a27e7b63 (gul)

• Indsendelsen: 92145f2f2c68eb4901fd4df24761808f458eacbf (grøn)

Der er vedhæftet tre filtyper i indsendelsen (pdf, docx og jpeg). Disse indeholder de følgende egenskaber:

pdf

• filename: 5mbrng.pdf (magenta) - Dette angiver vedhæftningens oprindelige filnavn

• mediatype: application/pdf - Her er vedhæftningens mimetype sat; denne svarer ofte til filendelsen

• size: 5242880 - Dette er filstørrelsen i bytes

• Unikt hash: 245fb671fda2a11aff8578bddd772ed67bb76166 (cyan)

docx

• filename: Mail-til-endepunkter.docx (magenta) - Dette angiver vedhæftningens oprindelige filnavn

• mediatype: application/vnd.openxmlformats-officedocument.wordprocessingml.document - Her er vedhæftningens mimetype sat; denne svarer ofte til filtypenavnet

• size: 18240 - Dette er filstørrelsen i bytes

• Unikt hash: 16663395fb8bda57c270fee5006fb70b2b5058f7 (cyan)

jpeg

• filename: kitty.jpg (magenta) - Dette angiver vedhæftningens oprindelige filnavn

• mediatype: image/jpeg - Her er vedhæftningens mimetype sat; denne svarer ofte til filendelsen

• size: 16099 - Dette er filstørrelsen i bytes

• Unikt hash: 182ee96b80ab0a1ac98470d2a6f1e0e117efa2d6 (cyan)