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
For at kunne få tilsendt indsendelsesdata til jeres SFTP-server, så skal der hos Erhvervsstyrelsen åbnes op i firewallen, og du skal derfor sende IP-adresse og portnummer til blanketmotor@erst.dk, hvorefter vi bestiller de nødvendige åbninger
Her kan du også få oplyst de IP-adresser som Blanketmotoren sender data fra, såfremt de skal whitelistes på jeres side af forbindelsen
Filstruktur
Der uploades en række filer til SFTP serveren i en flad filstruktur. Disse filer uploades efter den følgende rækkefølge:
Den generede XML-fil for indsendelsen - Denne har navnet /<indsendelsens hash>.xml
Den generede pdf-fil for indsendelsen - Denne har navnet /<indsendelsens hash>.pdf
Hver vedhæftet fil. Hver vedhæftet fil er navngivet efter følgende mønster:
/<indsendelsens hash>-<vedhæftning a hash>.bin
/<indsendelsens hash>-<vedhæftning b hash>.bin
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:
/92145f2f2c68eb4901fd4df24761808f458eacbf.xml
/92145f2f2c68eb4901fd4df24761808f458eacbf.pdf
/92145f2f2c68eb4901fd4df24761808f458eacbf-245fb671fda2a11aff8578bddd772ed67bb76166.bin
/92145f2f2c68eb4901fd4df24761808f458eacbf-16663395fb8bda57c270fee5006fb70b2b5058f7.bin
/92145f2f2c68eb4901fd4df24761808f458eacbf-182ee96b80ab0a1ac98470d2a6f1e0e117efa2d6.bin
/92145f2f2c68eb4901fd4df24761808f458eacbf.klar_til_processering
I det efterfølgende afsnit ses et eksempel på, hvordan bilag skal aflæses og matches op mod indsendelsens XML.
Bilag og 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:
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)