Een CSV-bestand uploaden

Laatst bijgewerkt: 2022-04-29 14:25

Er zijn 3 manieren om CSV bestanden met data te uploaden in HD4DP v1:

  • Handmatig
    • In de HD4DP applicatie
    • In de specifieke mappen op de server (provisioning)
  • Automatisch
    • in de specifieke mappen op de server (fasttrack)

Het bestand mag maximaal 6 MB groot zijn.

Bij gebruik van de handmatige upload via de applicatie of door bestanden op de server te zetten (provisioning), moeten de registraties nog steeds handmatig worden ingediend.

Bij gebruik van de fasttrack methode gebeurt de indiening automatisch.

Handmatig in de HD4DP applicatie

De datakunnen worden geüpload volgens dezelfde aanpak als voor de stabiele data.

Meer informatie is te vinden in het artikel 'CSV downloaden en uploaden voor stabiele data'.

Handmatig in de applicatiesmappen

HD4DP maakt het mogelijk om bestanden te importeren uit de mappen die door de toepassing worden gebruikt.

Sla het aangemaakte CSV-bestand op in de juiste register-map van uw organisatie of suborganisatie. De mappen van de sub-organistaties zijn te vinden in de submappen van de hoofdorganisatie.

Bij het uploaden van een CSV wordt voor elke record gecontroleerd of een corresponderende record al beschikbaar is in de applicatie. De controle op overeenkomstige data is gebaseerd op de unieke id. Indien een record reeds in de applicatie beschikbaar is, vindt een samenvoeging plaats tussen het bestaande record en het nieuwe CSV. In geval van conflicten worden de waarden van het nieuwe CSV ingevoerd.

De geüploade registraties worden automatisch geüpload in de HD4DP applicatie.

Zij moeten handmatig worden gevalideerd en in de aanvraag worden opgenomen

Automatisch in de applicatiesmappen

Het doel van de CSV fasttrack is het automatisch verzenden van volledige geldige CSV-bestanden naar healthdata zonder menselijke tussenkomst. Bij het gebruik van de CSV fasttrack moet rekening worden gehouden met de volgende onderwerpen. HD4DP maakt het mogelijk om bestanden automatisch te importeren uit speciale mappen. Maak op de server waar HD4DP is geïnstalleerd een nieuwe map aan naast de mappen voor provisioning en stabiele data.

Nadat u de fasttrack map heeft aangemaakt, moet u de locatie van de speciale map in HD4DP configureren door de configuratie parameter "FAST_TRACK_DIRECTORY" aan te passen in het admin-configuratie panel.

Submappen die bijdragen tot de organisatie en gegevensverzamelingen, worden automatisch aangemaakt volgens een specifieke mappenstructuur.

In deze video wordt een meer diepgaande uitleg gegeven over het opzetten van de fasttrack:

Wanneer een CSV-bestand in de map van een gegevensverzameling wordt geplaatst, kunnen verschillende acties plaatsvinden:

  • Indien het bestand niet kon worden gemanipuleerd (b.v. een ongeldige CSV of een gegevensverzameling die nog niet is gestart) wordt het bestand verplaatst naar ARCHIVE_ERROR
  • Indien het bestand met succes werd gelezen maar slechts gedeeltelijk geldig was, zal het bestand dienovereenkomstig worden opgesplitst.
    • b.v.: regel1 is geldig, regel2 genegeerd wegens dubbel record, regel3 bevat een fout
      • een CSV-bestand met regel1 zal in SUCCESS worden geplaatst
      • een CSV-bestand met regel2 zal in IGNORE worden geplaatst
      • een CSV-bestand met regel3 wordt in ERROR geplaatst en er wordt een extra kolom toegevoegd die verklaart waarom de CSV's een fout opleverden.
      • de originele CSV wordt verplaatst naar het ARCHIVE
  • Indien het bestand met succes is gelezen en gevalideerd, wordt het volledig verplaatst naar zowel de SUCCESS map als de ARCHIVE map.

Vertaald met https://www.deepl.com/Translator. Heeft u een fout opgemerkt? Neem dan contact met ons op via https://docs.healthdata.be/nl/contact