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 excel niet gevuld]",
"field": "[naam van dataveld in HUMBLE]",
"fieldtype": [keuze uit 1/2/3/4/5],
"filter": "",
"mask": ",",
"optional": [true/false],
"overwrite": [true/false],
"relation": "",
"relationfield": "",
"relationfilter": ",
"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",
"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
},
Definitie:
Om de data goed te importeren is het noodzakelijk om aan te geven hoe de informatie verwerkt moet worden, dit wordt gedaan in een JSON format.
De JSON bestaat uit een algemeen en een kolom specifiek gedeelte.
Algemeen:
Bij het importeren dient in het
Resource uitzoeken bv. myp/MypTask
Resource aan whitelist toevoegen voor organisatie. LET OP; zonder hoofdletters in whitelist tabel anders werkt het niet, dus; myp/myptask.
Overwrite op true zetten indien specifiek niet.
Zelfde volgorde aanhouden in CSV import template, als in json
Naming conventions!