Versions Compared

Version Old Version 7 New Version 8
Changes made by

Jorn Hagen

Jarno Scholten

Saved on

Key

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

...

Als een medewerker nog niet bestaat in Transplan, dan wordt via stamdata een nieuwe medewerker toegevoegd in Transplan.

Bij een nieuwe medewerker moeten een aantal velden verplicht ingevuld worden. Dat zijn o.a. Planafdeling, functie en werkgever.

Bepaling planafdeling, functie en werkgever

Bij het toevoegen van de medewerker wordt in AFAS voor een medewerker opgevraagd welke Organisatorische Eenheid, Functie en Werkgever de medewerker is gekoppeld. Hiervoor wordt connector Transplan - Employee org units aangeroepen. Het resultaat ziet er als volgt uit:

...

Met behulp van OrgUnit wordt bepaald of er in Transplan een planafdeling bekend is met deze code. Als die er is, dan wordt deze planafdeling aan de nieuwe medewerker gekoppeld. Als de planafdeling niet bekend is, dan wordt teruggevallen op een default planafdeling uit de configuratie (zie hieronder).

Met behulp van veld Dienstbetrekking wordt bepaald of er een mapping (FunctionsMapping) in de configuratie aanwezig is. Als er geen mapping gevonden kan worden, dan wordt teruggevallen op de default functie uit de configuratie.

Met behulp van EmployerId wordt uit de configuratie bepaald welke werkgever er gekoppeld moet worden aan de medewerker. Mocht er in de configuratie geen waarde gevonden worden, dan wordt teruggevallen op de default employer uit de configuratie.

Bij het toevoegen worden een aantal standaard waarden ingevuld. Dat zijn de volgende:

...

Bovenstaande zijn via configuratie aan te passen. Zie https://rgbplus.atlassian.net/wiki/spaces/TRAN/pages/4237262850/Medewerkers+synchroniseren+tussen+AFAS+en+Transplan#Configuratie

AFAS connectoren

Om de OE eenheid en de medewerkers te synchroniseren moet het AFAS token rechten hebben op een aantal connectoren in AFAS. Hieronder een lijst met connectoren die beschikbaar moeten zijn.

Naam

Omschrijving

Transplan_Medewerker_stamgegevens (GetConnector)

Deze connector wordt gebruikt om de gewijzigde medewerkers op te halen uit AFAS en te synchroniseren in Transplan.

Transplan - Employee org units (GetConnector)

Deze connector wordt gebruikt om de OE eenheid op te vragen waar een medewerker is aan gekoppeld.

KnEmployee (UpdateConnector)

Deze connector wordt gebruikt om de OE eenheid in AFAS te wijzigen voor een medewerker als de planafdeling in Transplan wordt gewijzigd.

Systeem instellingen

Voor deze service zijn de volgende systeeminstellingen geïntroduceerd:

...

Naam

Omschrijving

ApiEndpoint

Het AFAS endpoint om aan te roepen. Zie Keepass.

ApiToken

Het token om de requests naar de AFAS API uit te voeren. Zie Keepass voor het token.

EmployeeOrgUnitConnector

De connectornaam om de OE eenheid bij te werken. Deze is standaard Transplan_EmployeeUnits_.

FilterEmployeeIdExpression

Deze expressie wordt gebruikt om te filteren bij het ophalen van medewerker OE eenheid. Zie https://rgbplus.atlassian.net/wiki/spaces/TRAN/pages/4237262850/Medewerkers+synchroniseren+tussen+AFAS+en+Transplan#Filter-ophalen-medewerker-t.b.v.-OE-eenheid voor een korte uitleg over dit filter.

Standaard:
filterfieldids=EmployeeId&filtervalues={0}&take={1}&skip={2}

FilterModifiedEmployeeExpression

Deze expressie wordt gebruikt als filter om de gewijzigde medewerkers uit AFAS op te halen. Zie https://rgbplus.atlassian.net/wiki/spaces/TRAN/pages/4237262850/Medewerkers+synchroniseren+tussen+AFAS+en+Transplan#Filter-ophalen-gewijzigde-medewerkers-uit-AFAS voor een korte uitleg over dit filter.

Standaard:
filterfieldids=Gewijzigd_op&filtervalues={0}&operatortypes=2&take={1}&skip={2}

ModifiedEmployeeConnector

De connectornaam om de gewijzigde medewerkers uit AFAS op te vragen.
Standaard is dat Transplan_Medewerker_stamgegevens

ExcludeFunctionName

Uitgesloten functienaam. Voor medewerkers met deze functie wordt de OE eenheid niet bijgewerkt. Standaard gevuld met Kantoor.

TakeItemsPerRequest

Hoeveel items per request worden opgevraagd. Standaard is dat 100 items per keer.

DefaultDepartmentIdNewEmployee

Standaard planafdeling ID voor nieuwe medewerkers. Standaard staat die op 1.

DefaultFunctionIdNewEmployee

Standaard functie ID voor nieuwe medewerkers. Standaard staat die op 1.

DefaultEmployerIdNewEmployee

Standaard werkgever ID voor nieuwe medewerkers. Standaard staat die op 1.

EmployersMapping

Dit is een key-value configuratie met daarin de werkgever ID uit AFAS als key en de ID van de werkgever uit Transplan als Value.

FunctionsMapping

Dit is een key-value configuratie met daarin de waarde Dienstbetrekking uit AFAS als Key en de ID van de functie uit Transplan als Value.

Voorbeeld configuratie

Expand
titleVoorbeeld configuratie
Code Block
languagejson
{
	"ApiEndpoint": "https://98504.resttest.afas.online/ProfitRestServices/connectors/",
	"ApiToken": "<token><version>1</version><data></data></token>",
	"EmployeeOrgUnitConnector": "Transplan_EmployeeOrgUnits_",
	"FilterEmployeeIdExpression": "filterfieldids=EmployeeId&filtervalues={0}&take={1}&skip={2}",
	"FilterModifiedEmployeeExpression": "?filterfieldids=Gewijzigd_op&filtervalues={0}&operatortypes=2&take={1}&skip={2}",
	"ModifiedEmployeeConnector": "Transplan_Medewerker_stamgegevens",
	"ExcludedFunctionName": "Kantoor",
	"TakeItemsPerRequest": 100,
	"StatusIdNewEmployee": 2,
	"DefaultDepartmentIdNewEmployee": 1,
	"DefaultFunctionIdNewEmployee": 1,
	"DefaultEmployerIdNewEmployee": 1,
	"EmployerMappings": {
		"01": 1
	},
	"FunctionsMapping": {
		"Kantoor": 11,
		"Chauffeurs": 6
	}
}

Filter ophalen medewerker t.b.v. OE eenheid

...