Profiel updaten met SSO

Gepubliceerd op: 28 mei, 2024
Bewerkt op: 29 januari, 2026

Eformity.net beschikt over de mogelijkheid om het medewerkerprofiel van een gebruiker tijdens het inloggen te vullen met gegevens van de authenticatievoorziening. Dit garandeert dat een gebruiker altijd minimaal één medewerkerprofiel heeft om mee te werken.

Vereisten

Single Sign-on wordt gebruikt voor het inloggen (op basis van AD, ADFS of SAML).
De medewerkersdatabase moet ingesteld zijn als 'Persoonlijke database' zodat de records van een bepaalde gebruiker zijn.
Het systeem moet weten wat de medewerkersdatabase is (in te stellen via de e-mailinstellingen).
Optioneel, maar wenselijk: de medewerkersdatabase bevat een veld 'IsDefault' van het type 'Boolean' zodat het systeem weet welk record up-to-date gehouden moet worden.

Stap 1: Medewerkersdatabase instellen bij e-mailinstellingen

Als je gebruikmaakt van de e-mailhandtekeningfunctionaliteit van eformity.net, staat dit waarschijnlijk al goed ingesteld. Als dit niet het geval is, kun je deze stap niet overslaan. Log in met je persoonlijke gegevens op jouwbedrijfsnaam.eformity.net.

Stap 1.1.: Navigeer naar 'Mijn abonnement'

Klik eerst op het tandwielpictogram om naar het 'Mijn abonnement' gedeelte te gaan. In de onderstaande afbeelding is dit pictogram omcirkeld.

Er verschijnt nu een nieuw element aan de rechterkant van de pagina. Klik in dit nieuwe element op 'Mijn abonnement' om het abonnementsgedeelte te openen.

Stap 1.2.: Het bewerken van de e-mailinstellingen

In het 'Mijn abonnement' gedeelte kun je de e-mailinstellingen bewerken. Klik hiervoor op 'E-mail instellingen' in het menu.

Een nieuwe pagina opent. Klik op de knop 'Bewerken' in het e-mailinstellingen overzicht. Vul bij 'Tabel voor werknemers' de juiste tabel in.

Stap 2: Mappings instellen

Om de juiste gegevens in de correcte medewerkervelden te krijgen, moeten mappings aangemaakt worden. Met deze mappings kun je per veld aangeven hoe deze gevuld moeten worden.

Stap 2.1.: Navigeer naar 'Systeembeheer'

Log in op de webomgeving van eformity en navigeer naar het 'Systeembeheer' gedeelte door te klikken op het hamburger-menu pictogram.

Een nieuw element opent aan de linkerkant van de pagina. Klik op de tegel met de titel 'Systeembeheer' om het systeembeheer gedeelte te openen.

Stap 2.2.: Identiteitsprovider selecteren

Klik op 'Identiteitsproviders' in het menu om het overzicht van de verschillende identiteitsproviders te openen. Selecteer de juiste provider door erop te klikken.

Klik in het nieuwe element op de blauwe knop 'Bewerken' in het 'Mappings' gedeelte. Dit is in de onderstaande afbeelding omcirkeld.

Om de mappings toe te voegen klik je in het nieuwe element op de knop 'Toevoegen'. Dit is in de onderstaande afbeelding omcirkeld.

Je kunt nu een mapping toevoegen door op de knop 'Toevoegen' te klikken. Er zijn meerdere typen mappings. In onderstaande tabel staan de beschikbare opties:

Modifier	Description	Example	Notes
(geen)	Kopieert de waarde uit de inkomende SSO-claims/properties op basis van naam.	FirstName http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname	Als de first name niet bestaat in de SSO-data, wordt er niets teruggegeven.
=	Evalueert de expressie en gebruikt het resultaat.	=properties[""Email""] =datasources.lookup(""dxorganization"", ""displayname"", properties.getproperty(""Company/Company""), ""Id"", ""aae7e7b3-e3d4-4202-af61-6a692b780651"")	Als de berekening faalt, is het resultaat leeg. Berekeningen kunnen gebruikmaken van properties, roles en datasources. Niet-tekstuele resultaten moeten worden geconverteerd naar tekst (value.ToString()).
+	Past de mapping alleen toe wanneer het record nieuw is. Bestaat het record al, dan wordt de waarde niet gemapt.	+Email +https://schemas.xmlsoap.org/ws/2005/05/identity/claims/mobilephone/MobilePhone	Deze mapping wordt alleen toegepast bij het aanmaken van een nieuw record. Voor bestaande records wordt deze genegeerd.
[culture]	Schrijft naar de cultuur-specifieke versie van het record voor die cultuur.	[nl]JobTitle [en]JobTitle	De cultuur wordt bepaald door wat tussen [ en ] staat. Alles na ] is de daadwerkelijke expressie.
?	Map alleen als het veld van het record momenteel leeg is.	?LastName ?https://schemas.xmlsoap.org/ws/2005/05/identity/claims/homephone/Telephone	Als het veld al een waarde heeft, wordt de mapping overgeslagen.
!	Als de geëvalueerde waarde leeg is, wordt het veld leeggemaakt. Is de waarde niet leeg, dan wordt normaal gemapt.	!MiddleName !http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname	Als de geëvalueerde waarde leeg is en het veld al leeg is, verandert er niets. Is de waarde niet leeg, dan werkt dit als een normale mapping.
	Modifiers kunnen ook met elkaar worden gecombineerd.	[nl]?JobTitle	De volgorde van modifiers moet als volgt zijn: + [culture] ? ! = expression

Onderstaand nog meer voorbeelden van expressies in mappings:

De basis van expressies in mappings

Gegevens aan elkaar koppelen kan met of zonder tussenkomst van een scheidingsteken, bijvoorbeeld een spatie.

Twee gegevens direct aan elkaar koppelen:

=Properties.GetProperty("givenName") + Properties.GetProperty("sn")

Twee gegevens aan elkaar koppelen met een spatie er tussen:

=String.Join(Properties.GetProperty("givenName"), Properties.GetProperty("sn"), " ")

Gegevens formatteren

Je kunt formattering toepassen op gegevens die worden overgezet. De twee mogelijke formatteringen zijn:

Letters scheiden met tussenliggende punten;
Alleen tekst voor streep gebruiken.

Vertaalt waarde 'ABC' naar 'A.B.C':

=String.FormatOperation(0, Properties.GetProperty("initials"))

Vertaalt de waarde 'naam1 - naam2' naar 'naam1':

=String.FormatOperation(1, Properties.GetProperty("sn"))

Gegevens in een andere database opzoeken

Niet alle gegevens staan in dezelfde database. De afdeling van de medewerker kan bijv. een verwijzing naar de afdelingen database zijn. Voor een dergelijke verwijzing moet de key van de afdeling worden opgehaald o.b.v. de waarde van het attribuut.

Haalt het 'Id' van de afdeling op uit de database 'Department' door deze op te zoeken o.b.v. het veld 'Description' met de waarde van het attribuut 'department'.

=Datasources.Lookup("Department", "Description", Properties.GetProperty("department"), "Id")

Stap 3: Functionaliteit aan zetten

De laatste stap is het inschakelen van de functionaliteit om profielen bij te werken met SSO. Dit doe je weer in de webomgeving van eformity. Klik op het hamburger-menu pictogram.