Import template maken

Wanneer je een data wilt importeren maar er geen geschikte template beschikbaar is is er de mogelijkheid om een eigen template op te zetten.

Om een werkende template te maken is het belangrijk dat je deze voldoet aan alle voorwaarden zodat de software de import juist verwerkt. Een import template kan worden toegevoegd door in de FE te gaan naar :

Gegevensbeheer > Importeren > Toevoegen

Bij het maken van een import template vraagt de software om 5 velden in te vullen:

Code = Short_label van de template ( Let op! max 10 tekens)
Omschrijving = Omschrijving van de import template ( bijv. “Gebreken importeren met custom velden” )
Model* = Resource model waar de gegevens naartoe naar geüpload worden
Versie = versienummer van de template, bij wijziging of updates kan je dit nummer laten oplopen om bij te houden welke versie het is.
Definitie* = JSON format van het importbestand waardoor de software de data juist kan vertalen naar de velden in HUMBLE

* = Wordt nader toegelicht op deze pagina

Model:

Bij het veld Model dien je een het juiste resource model te selecteren zodat HUMBLE weet waar de gegevens naartoe moeten. De software zal alleen data importeren als het resource model bekend is in de “whitelist”.

Hieronder een overzicht van alle resource models die momenteel in de whitelist beschikbaar* zijn:

locations/locbuilding = Gebouw model
locations/loccomplex = Complex model
locations/locterrain = Terrein model
locations/locbuildingpart = Bouwdeel model
locations/locfloor = Verdieping model
locations/locapartment = Appartement model
locations/locroom = Ruimte model
locations/locarea = Gebied model
locations/locworkspace = Werkplek model
locations/loclayer =
asset = Element model
myp/myptask = MJOP activiteiten model
myp/mypactivity = Kostenkengetallen model
roomtype =
costtype =
requests/requestrevision = Revisietekeningen model
requests/requestticket = Meldingen model
condition = Gebreken model

* = Indien je een resource model nodig hebt die niet in de whitelist staat kan dit aangevraagd worden bij de lead developer.

JSON Format Uitleg:

In de import template is het noodzakelijk om voor elke kolom, kolom specifieke informatie mee te geven.

In onderstaande overzicht is te zien hoe dit “kolom specifieke” gedeelte eruit ziet:

        {
            "defaultvalue": "[Standaard waarde indien in import-waarde leeg is]",
            "field": "[naam van dataveld in HUMBLE]",
            "fieldtype": [keuze uit fieldtype 1,2,3,4,5],
            "filter": "filter om records uit de export gefilterd worden, o.b.v. celinhoud (bv. "is_new=1", om alleen nieuwe records in te lezen)",
            "mask": "format van de import data zodat het juist wordt geimporteerd is van toepassing bij decimaalscheidingstekens,datum/tijd velden",
            "optional": [keuze uit true/false om aan te geven of dit veld verplicht is in de import],
            "overwrite": [keuze uit true/false om aan te geven over je een waarde wilt overschrijven],
            "relation": "relatietabel om de software de juiste ID op te laten halen bij fieldtype 5",
            "relationfield": "kolom van de relatietabel waarin de software de import waarde moet opzoeken",
            "relationfilter": "filter dat eventueel van toepassing moet zijn bij het opzoeken van de juiste ID",
            "sourcefield": "[Kolomnaam in excel template]",
            "unique": [keuze uit true/false om aan te geven of het veld uniek moet zijn in heel HUMBLE] 
        },

LET OP: Bij updaten van records moet je altijd een unique kolom hebben, ook als je update vanuit ID (die uniek is)

Voorbeelden van JSON opmaak:

Fieldtype 1: Tekst veld

        {
            "defaultvalue": "",
            "field": "email",
            "fieldtype": 1,
            "filter": "",
            "mask": ",",
            "optional": true,
            "overwrite": false,
            "relation": "",
            "relationfield": "",
            "relationfilter": "",
            "sourcefield": "E-mailadres",
            "unique": false
        },

Fieldtype 2: Nummer veld

        {
            "defaultvalue": "",
            "field": "surface_area",
            "fieldtype": 2,
            "filter": "",
            "mask": ",",
            "optional": true,
            "overwrite": true,
            "relation": "",
            "relationfield": "",
            "relationfilter": "",
            "sourcefield": "Oppervlakte",
            "unique": false
        },

Fieldtype 3: datum/tijd veld

Fieldtype 5: Relatie veld