Vie henkilöt - JSON-tietomuoto

Henkilötietoja voidaan viedä Neptonista ulkoiseen järjestelmään. Tämä artikkeli kuvaa henkilötietojen viennin kentät, joita voidaan sisällyttää vietäessä tiedot JSON-tietomuodossa. Yksityiskohtainen kuvaus henkilötietojen viennistä löytyy täältä.

Kentät JSON-muotoisessa henkilöviennin tiedostossa

Tietomuodon yksityiskohdat

• Character encoding of the exported file is always UTF-8 (a Unicode encoding).
• Vientitiedoston merkistökoodaus on aina UTF-8 (yleinen Unicode-merkistökoodaus).
• Rivinvaihto on Windowsin vakiorivinvaihto (CR+LF 0x0D 0x0A).
• JSON-tietomuodossa henkilötiedot viedään henkilöolioiden taulukkona.
• Jokainen henkilöoolio vastaa yhtä henkilöä.
• Henkilöolio koostuu nimi–arvo-pareista, joissa kukin nimi vastaa kentän nimeä ja arvo on yhden tai useamman arvo-olion taulukko.

• Kukin arvo-olio koostuu kolmesta nimi–arvo-parista:

  Nimi	Arvo
  Valid from	null (= määrittelemätön) tai ensimmäinen päiväys, jolloin arvo on tai oli voimassa, muodossa "VVVV-KK-PP"
  Valid to	null (= määrittelemätön) tai viimeinen päiväys, jolloin arvo on tai oli voimassa, muodossa "VVVV-KK-PP"
  Value	Desimaaliluku tai totuusarvo (true/false) ilman lainausmerkkejä tai mikä tahansa muu arvo lainausmerkeissä (")

• Jos kenttä ei ole käytössä tai sille ei ole määritelty arvoa, kenttä ei ole mukana tiedostossa lainkaan.
• Nepton-tunniste (kentän nimi NeptonPersonGUID), Ulkoinen tunniste 1 (External identifier 1), käyttäjätunnus (Username) ja henkilönumero (Employee number) ovat kaikki henkilön yksilöiviä kenttiä ja niitä voidaan käyttää henkilön tunnistamiseen. Suosittelemme Nepton-tunnisteen käyttämistä, koska se ei varmuudella muutu. Muilla näistä tunnisteista lukuunottamatta kenttää "Ulkoinen tunniste 1", on aina arvo vientiaineistossa.
• Päivämääräkentät käyttävät muotoa "VVVV-KK-PP" (vuosi, kuukausi ja päivä väliviivoin (-) eroteltuina, lainausmerkein ympäröityinä).
• Mahdolliset päivämäärä ja aika -tyyppiset lisätietokentät käyttävät muotoa "VVVV-KK-PP TT:MM:SS" (vuosi, kuukausi ja päivä eroteltuina väliviivoin (-), välilyönti, tunnit, minuutit ja sekunnit eroteltuina kaksoispistein (:), lainausmerkein ympäröityinä).
• Desimaaliluvut käyttävät pistettä (.) desimaalierottimena, kun desimaaliosa ei ole nolla. Muutoin arvo on vain kokonaisluku. Negatiivisissa luvuissa on viiva alussa (-).
• UUID-kentät esitetään merkkijonoina, jotka koostuvat 32 heksadesimaalimerkistä eroteltuina neljällä väliviivalla: 8 merkkiä - 4 merkkiä - 4 merkkiä - 4 merkkiä - 12 merkkiä. Kirjainmerkit ovat isokirjaimisia. Koodi ympäröidään lainausmerkein (").

• Mitkä tahansa muut arvot kuin true (tosi), false (epätosi), null (määrittelemätön) tai desimaaliluvut ympäröidään aina lainausmerkein ("). Tietyt merkit korvataan takakenoviivalla (\) alkavilla merkkiyhdistelmillä:

  Korvaava merkkijono	Alkuperäinen merkki
  \"	"
  \\	\
  \/	/
  \b	askelpalautin (backspace)
  \f	sivunvaihto (form feed)
  \r	paluu rivin alkuun (carriage return)
  \n	rivinvaihto (line feed)
  \u heksadesimaalikoodi	mikä tahansa Unicode-merkki, joka ei ole sallitulla arvovälillä 0x0020 - 0x10FFFF esitetään \u-alukkeella ja vähintään 4-merkkisenä heksadesimaalikoodina

Esimerkkitiedosto

[
	{
		"Email": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "email@compa.ny"
			}
		],
		"Last name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Last"
			}
		],
		"First name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "First"
			}
		],
		"Username": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "First Last"
			}
		],
		"Street address": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Street address 1"
			}
		],
		"Postcode": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "01234"
			}
		],
		"Phone number": [
			{
				"Valid from": null,
				"Valid to": "2022-10-28",
				"Value": "019581928"
			},
			{
				"Valid from": "2022-10-29",
				"Valid to": null,
				"Value": "08855150015"
			}
		],
		"City": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "City"
			}
		],
		"Employee number": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "1"
			}
		],
		"Personal identity code": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "111111-111C"
			}
		],
		"Employment start date": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "2022-11-01"
			}
		],
		"Full name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Last, First"
			}
		],
		"Role": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Employee"
			}
		],
		"User account enabled": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": true
			}
		],
		"Service usage language": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "en-GB"
			}
		],
		"Weekly hours MIN": [
			{
				"Valid from": null,
				"Valid to": "2022-11-15",
				"Value": 40
			},
			{
				"Valid from": "2022-11-16",
				"Valid to": null,
				"Value": 37.55
			}
		],
		"Weekly hours MAX": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": 40
			}
		],
		"Work time percentage": [
			{
				"Valid from": "2022-12-01",
				"Valid to": null,
				"Value": 50
			}
		],
		"Worktime roles": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Omien sekä alaisten tietojen muokkausoikeus"
			}
		],
		"NeptonPersonGUID": "37F7EAFE-046F-ED11-81FD-A0510B65B142",
		"AdditionalDecimal": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": 4.5
			}
		],
		"External identifier 1": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "12345"
			}
		],
		"AdditionalDateTime": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "2022-11-20 12:20:00"
			}
		]
	},
	{
		"Last name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Account"
			}
		],
		"First name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Disabled"
			}
		],
		"Username": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Disabled Account"
			}
		],
		"Full name": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Account, Disabled"
			}
		],
		"Role": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Employee"
			}
		],
		"User account enabled": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": false
			}
		],
		"Service usage language": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "fi-FI"
			}
		],
		"Worktime roles": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "Omien sekä alaisten tietojen muokkausoikeus"
			}
		],
		"NeptonPersonGUID": "FA1A79A9-126F-ED11-81FD-A0511B65B142"
		"External identifier 1": [
			{
				"Valid from": null,
				"Valid to": null,
				"Value": "123456"
			}
		],
	}
]