Aanroepen van de API in een Post-script

In een cURL- of FME-script gebruik je de API 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 API 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, de bestandsnaam en het betreffende template moet specificeren. De URL van de API is afhankelijk van de welke Gisratio-omgeving je gebruikt. 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://{URL GISRATIO OMGEVING}//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 de 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 zien.

Voor de import van de gegevens van verschillende objecttypen zijn de volgende templates beschikbaar:

De laatste kolom van de bovenstaande tabel verwijst naar voorbeeldbestanden van de gegevens van de objecttypen in CSV-formaat. In het CSV-bestand vermeldt de eerste regel de veldnamen van het objecttype en bestaan de daarop volgende regels uit de veldwaarden van de objecten. Als scheidingsteken tussen de veldnamen en de veldwaarden wordt een puntkomma gebruikt. 

Verwerking van de geïmporteerde data

Voor elke soort gegevens (objecttype) is er een importdefinitie die bepaalt wat er met de geïmporteerde gegevens moet gebeuren.  

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

  Warning
  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.