Versions Compared

Old Version 1

changes.mady.by.user Blanketmotorens Produktteam

Saved on

compared with

New Version Current

changes.mady.by.user Blanketmotorens Produktteam

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Note

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:

  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. Hvis der er valgt at medtage kvittering, så har denne navnet /<indsendelsens hash>-kvittering.pdf

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

Fil 5 (<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 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:

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)