AFAS

AFAS Software is een belangrijke leverancier van ERP- en HRM-software, die op grote schaal wordt gebruikt voor het beheer van organisatorische processen en personeelsgegevens. Meer informatie vindt u hier: https://www.afas.com/

De Identum eADM-integratie voor AFAS is een kant-en-klare oplossing die is ontworpen om het levenscyclusbeheer van digitale identiteiten te automatiseren. Door AFAS rechtstreeks aan Identum eADM te koppelen, importeert het systeem gegevens over werknemers, functies en de hiërarchie binnen de organisatie. Dit zorgt ervoor dat gebruikersaccounts in Active Directory, Azure AD en andere doelsystemen automatisch worden aangemaakt, bijgewerkt en uitgeschakeld op basis van de gezaghebbende HR-gegevens in AFAS.

Dit document bevat technische instructies voor het integreren van het AFAS Human Resource Management (HRM)-systeem met het eADM-platform van Identum. Het behandelt de eerste installatie, het importeren van gegevens en de configuratie voor het terugschrijven van gegevens naar AFAS.

Vereisten

Neem contact op met uw AFAS-supportmedewerker om de API-gegevens voor uw AFAS-instantie op te vragen. U moet het volgende opvragen:

URL voor het importeren van gebruikersgegevens: het eindpunt voor het importeren van gebruikersgegevens.
URL voor het importeren van hiërarchische gegevens: het eindpunt voor het importeren van hiërarchische gegevens.
Writeback Data URL: Het eindpunt voor het terugschrijven van gebruikersgegevens.
SecretKey: Een unieke sleutel voor authenticatie.

Stuur dit door naar uw Identum-partner, zodat zij kunnen beginnen met het instellen van het importeren van gebruikers- en hiërarchiegegevens uit AFAS.

Terugschrijven van gebruikersgegevens

eADM kan worden geconfigureerd om e-mailadressen van gebruikers terug te schrijven naar AFAS. Dit wordt doorgaans gebruikt om AFAS bij te werken met het e-mailadres van nieuwe medewerkers zodra Identum eADM dit heeft gegenereerd in AD, Entra ID of Google Workspace.

Bijlage: Nederlandse naamgevingsconventies

De AFAS-integratie biedt verschillende attributen om Nederlandse namen correct te verwerken, met name voorvoegsels en partnernamen. De volgende attributen worden geïmporteerd uit AFAS en worden toegewezen aan aangepaste attributen in Identum eADM.

eADM aangepast kenmerk	Beschrijving	AFAS-codes
uitbreidingAttribuut1	Burgerlijke staat: De burgerlijke staat van de gebruiker.	`$GH` (Getrouwd); `$GP` (Geregistreerd partnerschap); `$GS` (Gescheiden); `$0G` (Ongehuwd); `$TR` (Overige); `$WE` (Weduwe/weduwnaar).
uitbreidingsattribuut2	Achternaam partner: De achternaam van de partner van de gebruiker.	N.V.T.
uitbreidingAttribuut3	Naamgebruik: Code die bepaalt welke achternaam moet worden weergegeven.	`$0` (Geboortenaam); `$1` (Geboortenaam van partner + Geboortenaam); `$2` (Geboortenaam van partner); `$3` (Geboortenaam + geboortenaam van partner).
uitbreidingAttribuut4	Voorvoegsel (geboortenaam): Het voorvoegsel van de achternaam van de gebruiker (bijvoorbeeld 'van der').	N.V.T.
uitbreidingsattribuut5	Voorvoegsel (achternaam partner): Het voorvoegsel van de achternaam van de partner.	N.V.T.
Achternaam	Achternaam (geboorte): De achternaam van de gebruiker bij geboorte.	N.V.T.

Typische regels voor weergavenaam

De DisplayName moet altijd worden gegenereerd, inclusief eventuele voorvoegsels.
Het voorvoegsel mag geen invloed hebben op het alfabetisch sorteren.
Als Naamgebruik 1 of 3 is, moeten de naamdelen met een koppelteken worden verbonden.

Om een duurzaam beheer te garanderen, raden we aan om geboortnamen te gebruiken voor gebruikersnamen en e-mailadressen (UPN). Deze aanpak vereenvoudigt het beheer en zorgt voor technische stabiliteit in geval van naamswijzigingen.

Opmerking: In Nederland is het gebruikelijk om een 'roepnaam' te hebben. Bij de integratie wordt doorgaans de officiële voornaam gebruikt.

4. AI-samenvatting

Dit document beschrijft de technische configuratie voor de kant-en-klare integratie tussen Identum eADM en AFAS HRM. Het begeleidt beheerders bij het verkrijgen van API-inloggegevens, het instellen van gegevensimport voor HR- en hiërarchische gegevens en het configureren van e-mail-writeback-functionaliteit. De gids beschrijft ook specifieke attribuuttoewijzingen en regels voor het omgaan met Nederlandse naamgevingsconventies om een nauwkeurige identiteitssynchronisatie tussen systemen te garanderen.