Versions Compared

Version Old Version 4 New Version Current
Changes made by

Mike Zuydendorp (Unlicensed)

Martijn van Westerlaak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

  • 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 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

...

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

Expand
titleBeschikbare models die momenteel gebruikt kunnen worden om op te importeren.

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

...

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

Code Block
breakoutModefull-width
        {
            "sourcefielddefaultvalue": "XXX",[Standaard waarde indien in import-waarde leeg is]",
            "field": "XXX[naam van dataveld in HUMBLE]",
            "uniquefieldtype": false/true, [keuze uit fieldtype 1,2,3,4,5],
            "maskfilter": "filter om records uit de export gefilterd worden, o.b.v. celinhoud (bv. "is_new=1", om alleen nieuwe records in te lezen)",
            "overwritemask": false/true, "format van de import data zodat het juist wordt geimporteerd is van toepassing bij decimaalscheidingstekens,datum/tijd velden",
            "relationoptional": ""[keuze uit true/false om aan te geven of dit veld verplicht is in de import],
            "fieldtypeoverwrite": 1, [keuze uit true/false om aan te geven over je een waarde wilt overschrijven],
            "relationfieldrelation": "XXX",relatietabel om de software de juiste ID op te laten halen bij fieldtype 5",
            "relationfilterrelationfield": "XXX",kolom van de relatietabel waarin de software de import waarde moet opzoeken",
            "filterrelationfilter": "XXX",filter dat eventueel van toepassing moet zijn bij het opzoeken van de juiste ID",
            "defaultvaluesourcefield": "XXX[Kolomnaam in excel template]",
            "optionalunique": false/true[keuze uit true/false om aan te geven of het veld uniek moet zijn in heel HUMBLE] 
        },

2 =

3 =

4 =

5 =

6 =

7 =

8 =

9 =

10 =

11 =

12 =

13 =

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

Code Block
        {
            "sourcefielddefaultvalue": "E-mailadres",
            "field": "email",
            "uniquefieldtype": false1,
            "maskfilter": "",
            "overwritemask": true",",
            "relationoptional": ""true,
            "fieldtypeoverwrite": 1false,
            "relationfieldrelation": "",
            "relationfilterrelationfield": "",
            "filterrelationfilter": "",
            "defaultvaluesourcefield": "E-mailadres",
            "optionalunique": false
        },

Fieldtype 2: Nummer veld

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

Fieldtype 3: datum/tijd veld

Code Block
	{
		"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
	},

...

Code Block
    {
        "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

...