Bestandsoverdrachtproces via CSV

Bestandsoverdrachtproces (Client ↔ FunderMaps) (NL)

Stap 1. Opzetten van een standalone PC met virtuele machine
Op een standalone PC wordt tijdelijk een virtuele machine ingericht.

Stap 2. Kopie van de FunderMaps-database
Voorafgaand aan de overdracht wordt een kopie van de relevante FunderMaps-database geladen op de virtuele machine.

Stap 3. Bestandsoverdracht vanuit de client
Een .csv-bestand wordt door de client aangeboden of opgehaald via een tweeweg-bestandsoverdracht (2-way file transfer), en klaargezet voor verwerking.

Stap 4. Aanvullen van de .csv met FunderMaps-data
De aangeleverde .csv wordt verrijkt met gegevens uit de FunderMaps-database, zoals risicoclassificaties, funderingstypes en andere relevante kenmerken.

Stap 5. Upload van het verrijkte bestand & verwijdering van de VM
Het verrijkte .csv-bestand wordt teruggestuurd naar de client. Aansluitend wordt de virtuele machine verwijderd.

File Transfer Process (Client ↔ FunderMaps) (ENG)

Step 1. Setup of a standalone PC with virtual machine
A virtual machine is temporarily set up on a standalone PC.

Step 2. Copy of the FunderMaps database
Before the transfer, a copy of the relevant FunderMaps database is loaded onto the virtual machine.

Step 3. File transfer from the client
A .csv file is provided or retrieved by the client via a two-way file transfer, and prepared for processing.

Step 4. Enrichment of the .csv file with FunderMaps data
The provided .csv is enriched with data from the FunderMaps database, such as risk classifications, foundation types, and other relevant attributes.

Step 5. Upload of the enriched file & removal of the VM
The enriched .csv file is returned to the client. Afterwards, the virtual machine is deleted.

Flowchart Transfer Proces

<img src="https://github.com/user-attachments/assets/378822a7-6e7c-4719-869d-c6aa420e18d4" alt="flowchart_filetransfer" width="500"/>

Aanvulling middels SDK

Aangeleverde bestanden kunnen buiten de webservice om worden aangevuld met de resultaten van de webservice.

Bestanden worden aangeleverd in de projectmap op Office365, volgens het volgende format:

import_organisatie_kwartaal_jaar_datum

Voorbeeld: import_<klantnaam>_Q4_2024_01122024

Output in DigitalOcean wordt opgeslagen volgens het volgende format:

export_organisatie_kwartaal_jaar_datum

Voorbeeld: export_<klantnaam>_Q4_2024_02122024

CSV voorbereiding

De CSV-bestanden zijn bedoeld om grote hoeveelheden panden in FunderMaps te laden, zodat de webservice deze lijst kan aanvullen. Volg onderstaande richtlijnen om ervoor te zorgen dat de gegevens correct worden geïmporteerd en verwerkt.

• Strings trimmen: Alle strings moeten worden getrimd om spaties te verwijderen. TRIM is niet voldoende. Alle spaties moeten worden verwijderd, met uitzondering van opmerkingen en straatnamen. Een postcode moet bijvoorbeeld als 1234AB worden ingevoerd.
• Gehele getallen trimmen: Alle gehele getallen moeten worden getrimd om spaties te verwijderen. TRIM is hiervoor voldoende.
• Huisnummers en toevoegingen: Huisnummers en hun toevoeging moeten in kleine letters worden ingevoerd. Voorbeeld: 106a.
• BAG-id's als strings: BAG-id's zijn geen gehele getallen, maar strings.
• Lengte van BAG-id's: Elke BAG-id moet 16 tekens lang zijn. Als een BAG-id 15 tekens heeft, ontbreekt er een voorloopnul.
• Prefixes voor BAG-id's:
  • Voorzie BAG pand-id van de prefix NL.IMBAG.PAND.
  • Voorzie BAG nummeraanduiding-id van de prefix NL.IMBAG.NUMMERAANDUIDING.

Door deze richtlijnen te volgen, zorgt u ervoor dat de gegevens consistent en correct zijn voor verdere verwerking door de FunderMaps webservice.

Inhoud

Deze pagina bevat momenteel beperkte inhoud.