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:
* = 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": "Hiermee kunnen 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 data data zodat het juist wordt geimporteerd van toepassing bij decimaalscheidingstekens,datum/tijd velden", "optional": [true/false], "overwrite": [true/false], "relation": "relatietabel waarbij de software de juiste ID vandaan moet halen bij fieldtype 5", "relationfield": "kolom van de relatietabel waarbij de software de import waarde moet opzoeken", "relationfilter": "filter dat eventueel van toepassing op de tabelkolom waarbij de software in mag zoeken", "sourcefield": "[Kolomnaam in excel template]", "unique": [true/false] },
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
{ "defaultvalue": "", "field": "lastmaintenance_date", "fieldtype": 3, "filter": "", "mask": "[d-m-Y/d-m-Y H:i:s]", "optional": true, "overwrite": true, "relation": "", "relationfield": "", "relationfilter": "", "sourcefield": "LaatsteOnderhoud", "unique": false },
Fieldtype 5: Relatie veld
{ "defaultvalue": "", "field": "test_met_lijst", "fieldtype": 5, "filter": "", "mask": "", "optional": true, "overwrite": true, "relation": "sys_content_items", "relationfield": "label_nl_NL", "relationfilter": "contenttype_id = '62'", "sourcefield": "Testmetlijst", "unique": false },