PlusPort - Visma YouServe Learning API

[#1]

Dit document beschrijft de ‘PlusPort - Visma Raet Learning API’-connector. Een koppeling gebaseerd op de Visma Raet Learning API.

Onderstaande velden gebruikt Plusport in haar connector.

attribute	HR Core Business	HR Core Online
personId	Technical id of the employee in HRCB	P01001 - Persoonsnummer
personCode	7014 - Uniek Persoonlijk ID (UPI) (If it is not filled in then the Medewerkercode - 22)	P01001 - Persoonsnummer
Initials	25 - Voorletters	P00303 - Voorletters
KnowAs	165 - Roepnaam	P01003 - Roepnaam
lastName	524 - Opgemaakte naam aanhef Note: This field is combination of the last name and the last name prefix	P01008 - Samengestelde naam
lastNamePrefix		P01009 - Samengestelde naam-voorvoegsels
gender	36 - Geslacht (Male, Female, other values will shown as Not Known)	P00330 - Geslacht (Male, Female, other values will shown as Not Known)
birthDate	35 - geboortedatum	35 - geboortedatum
UserUID	10523564 - PING ID	Ping ID directly from the portal
emailAddresses	Business : 7212 - E-mailadres	Business: P01035 - E-mail adres werk
emailAddresses	Prive: 7213 - E-mailadres Prive	Prive: P01034 - E-mail adres prive
street	391 – straat	P01014 straatnaam
houseNumber	392 - Huisnummer	P01016 Huisnummer
houseNumberAdditional	393 - Huisnummer toevoeging	P01018 Huisnummer toev
postalCode	394 - Postcode	P01020 Postcode
city	395 - Woonplaats	P01022 Plaatsnaam
Telephone number	Business : 7374 - Telefoonnummer intern	Business :P01037 - Telefoonnr werk
hireDate	39 - Datum indienst	P00322 - Datum in dienst
dischargeDate	10520479 - Geplande laatste datum indienst	P00830 - Datum uit dienst
jobProfile	97 – functie	P01107 - Primaire functie
costCenter	53 - Kostenplaats
organizationUnit	6000 - Organisatorische eenheid	P01106 - Hierarchische org. eenheid
shortName	548 - code OE	ShortName
fullName	549 - Naam OE	FullName
parentOrgUnit	technical id of the parent Org unit	technical id of the parent Org unit
Rolecode		P01062 - Rol
managerId	7137 - manager	Personcode van de bij de OE vastgelegde 'MGR' (vanuit Rolcode P01062)

Waarvan deze velden voor Plusport verplicht zijn:

attribute	HR Core Business	HR Core Online
personId	Technical id of the employee in HRCB	P01001 - Persoonsnummer
KnowAs	165 - Roepnaam	P01003 - Roepnaam
lastName	524 - Opgemaakte naam aanhef This field is combination of the last name and the last name prefix	P01008 - Samengestelde naam
UserUID	10523564 - PING ID	Ping ID directly from the portal
emailAddresses	Business : 7212 - E-mailadres	Business: P01035 - E-mail adres werk
organizationUnit	6000 - Organisatorische eenheid	P01106 - Hierarchische org. eenheid

Wanneer bij een medewerker de waarde op 1 van bovenstaande velden ontbreekt zal Plusport de gehele medewerker niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker.

Iedere ochtend kan Plusport een e-mail versturen met de foutmeldingen die de dag daarvoor zijn opgetreden. Als er een fout is opgetreden, kan de klant via de mail op een reset knop klikken om een nieuwe poging te proberen. Na 5 pogingen doet Plusport geen nieuwe poging meer om de gebruiker te verwerken. 

Nieuwe medewerkers die zijn opgevoerd in HRCore worden na een synchronisatie zichtbaar in Plusport. Als bij een bestaande medewerker een waarde in HRCore is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in Plusport vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in Plusport.

Plusport verwerkt 1 manager per organisatorische eenheid, de eerste die zij tegenkomen in de data. 

Medewerkers met een uitdienstdatum worden tot 90 dagen na hun uitdienstdatum nog gesynchroniseerd.

Plusport synchroniseert 4 keer per dag de gegevens, zij doen dat iedere keer voor alle medewerkers. 

Filtermogelijkheden voor HR Core Business-klanten

Vanuit HR Core Business kunnen ‘bedrijven’ worden uitgesloten van de connector. Het gaat dan om de bedrijf-omschrijvingen zoals ze zijn ingericht in HRCore, zichtbaar via de knop 'Zoek bedrijf': 

Het veld ‘type medewerker’ (7393) is de tweede filter-mogelijkheid.  

Als een filter later wordt toegevoegd of uitgebreid dan verwijdert Plusport niet de medewerkers die al in Plusport staan.

Filtermogelijkheden voor HRCore Online-klanten

Vanuit HRCore Online kunnen medewerkers uitgesloten worden op basis van het veld ‘Soort Arbeidsrelatie’ (P01102).

Als een filter later wordt toegevoegd of uitgebreid dan verwijdert Plusport niet de medewerkers die al in Plusport staan.

UserUID

Dit is het Youforce-nummer wat wordt gebruikt voor het inloggen en wat voor Plusport verplicht is om de medewerker in te laden. Oftewel zonder UserUID zal Plusport de medewerker niet aanmaken. De UserUID is iets anders dan het Youforce R-nummer, het is een unieke code (string) die Youforce genereert.

UserUID voor HR Core Business-klanten

Om er voor te zorgen dat er binnen Youforce een UserUID voor een medewerker wordt aangemaakt moet

De ‘Raet Koppeling’ naar Youforce vanuit HRCore zijn geactiveerd en de ‘Raet Koppeling’ naar Ping id zodat de medewerker een Youforce-account heeft. Het ‘nieuwe inloggen’ hoeft niet geactiveerd te zijn mag natuurlijk wel.

UserUID voor HRCore Online-klanten

Om er voor te zorgen dat er binnen Youforce een UserUID voor een medewerker wordt aangemaakt moet de gegevensuitwisseling tussen HRCore Online en Youforce geactiveerd zijn zodat de medewerker ook een Youforce-account heeft. 

Daarnaast moet gebruik worden gemaakt van het ‘Nieuwe inloggen’. 

Waardenlijsten voor HRCoreBusiness-klanten, bijvoorbeeld Functie

Velden met een code en een omschrijving, Functie als voorbeeld, dienen ingericht te zijn op het niveau klant. Eventueel ingerichte waardenlijsten op een lager niveau worden niet ondersteund.