Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

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 kan de versie aangepast worden zodat je weet

  • 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

  • locations/loccomplex

  • locations/locterrain

  • locations/locbuildingpart

  • locations/locfloor

  • locations/locapartment

  • locations/locroom

  • locations/locarea

  • locations/locworkspace

  • locations/loclayer

  • asset

  • myp/myptask

  • myp/mypactivity

  • roomtype

  • costtype

  • requests/requestrevision

  • requests/requestticket

  • condition

* = 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:

    {
        "sourcefield": "XXX",
        "field": "XXX",
        "unique": false/true,
        "mask": "",
        "overwrite": false/true,
        "relation": "",
        "fieldtype": 1,
        "relationfield": "XXX",
        "relationfilter": "XXX",
        "filter": "XXX",
        "defaultvalue": "XXX",
        "optional": false/true
    },

2 =

3 =

4 =

5 =

6 =

7 =

8 =

9 =

10 =

11 =

12 =

13 =

Voorbeelden van JSON opmaak:

Fieldtype 1: Tekst veld

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

Fieldtype 2: Nummer veld

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

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

Vervolgens Confluence bijwerken

Naming conventions!

  • No labels