Bulk data-import is op een generieke wijze beschikbaar via een standaard API. Je kunt via deze API vanuit verschillende applicaties voor gegevensoverdracht (data transfer) een groot aantal gegevens in één keer importeren in Gisratio Manager. De API gebruikt voor het versturen van de gegevens naar Gisratio de HTTP POST methode, zodat alle applicaties die deze methode voor gegevensoverdracht ondersteunen kunnen worden gebruikt voor het importeren van gegevens in Gisratio Manager. Voorbeelden van applicaties die je kunt gebruiken zijn FME, Postman of cURL. Deze pagina beschrijft de API en hoe je deze gebruikt voor bulk data-import.

Aanroepen van de API in een Post-script

In een cURL- of FME-script gebruik je de API met URL  'https://stashaomniwesbasewep.azurewebsites.net//omnimap/import' om met de POST methode gegevens naar de server te versturen.  De gegevens worden als CSV-bestand naar Gisratio verzonden. In het script bestaat de POST request uit een location-gedeelte dat de URL van de server bevat, een header-gedeelte waarin je aangeeft dat de gegevens naar Gisratio toe moeten (naar tender Nieuwland) en een form-gedeelte waarin je je gebruikersnaam en de naam van het bestand moet specificeren. Met de template geef je aan om welke soort gegevens het gaat. 

De volgende regels code geven een voorbeeld van een cURL-script dat in een opdrachtpromptvenster kan worden uitgevoerd:

curl --location --request POST 'https://stashaomniwesbasewep.azurewebsites.net//omnimap/import' \

--header 'tenant: NIEUWLAND' \

--header 'organisation_identification: a9fd1a52-edb8-4848-96e9-2741876cc9f1' \

--header 'Authorization: Bearer ' \

--form 'csv=@"/Users/{GEBRUIKERSNAAM}/Documents/Development/{BESTANDSNAAM}.csv"' \

--form 'template_identification="c71e9e59-07e8-4de2-960f-be5a0d5f548a"'

Indien de gegevens die je importeert gekoppeld zijn aan andere gegevens dan dienen die gegevens waarnaar verwezen wordt al in het systeem aanwezig te zijn. Als je bijvoorbeeld de Beheeractiviteiten die je gaat importeren direct al aan de maatregelen wil koppelen, dan zul je ervoor moeten zorgen dat de betreffende maatregelen al in het systeem staan.  

Soort gegevens

Je kunt op de bovenstaande manier CVS-bestanden met de gegevens van de volgende objecttypen naar Gisratio versturen:

• Natuurbescherming-objecten (soorten planten of dieren met een beschermde status)

• Maatregelen

• Werkbronnen

• Beheeractiviteiten

Het soort gegevens wordt in het gegevensoverdracht-script aangegeven met een template_identification. Deze template geeft niet alleen het objecttype door, maar legt ook de gegevensstructuur van het betreffende objecttype vast, dat wil zeggen welke velden er (kunnen) zijn en wat daarvan het datatype is. Het template geeft hiermee aan hoe het CSV-bestand eruit moet komen te zien.

Voor de verschillende import-transacties zijn verschillende templates beschikbaar. Een template maakt een csv file die te importen is. 

Verwerking van de geïmporteerde data

Elke import-transactie heeft een importdefinitie die bepaalt wat er met de geïmporteerde gegevens moet gebeuren.  

• Natuurbescherming-objecten
  De importdefinitie Natuurbescherming-objecten bepaalt dat bij de import altijd eerst de gehele tabel met natuurbeschermingsregels leeg gehaald wordt.

  Bij het importeren van Natuurbescherming-objecten worden alle bestaande attribuutwaarden van deze objecten overschreven!

• Beheeractiviteiten
  Met behulp van de importdefinitie voor Beheeractiviteiten kan de hele planning voor het onderhoud van een beheerobject geïmporteerd worden. Hiervoor moeten wel van te voren de volgende objecten al in het systeem aanwezig zijn: de Beheerobjecten (die via de ArcBridge tool vanuit ArcGIS Pro zijn geïmporteerd), de Maatregelen, de Planning-objecten en de Werkbronnen. Indien alle gegevens van de beheeractiviteit (inclusief de verwijzingen naar de gekoppelde objecten) op de juiste manier in het te importeren CSV-bestand staan geregistreerd,  kun je de beheeractiviteiten importeren. Het systeem zal dan zelf nieuwe werkregels aanmaken.