Releases Youforce API & bestandsuitwisseling

Bij het inrichten van een nieuwe connectie voor een bepaald systeem, wordt vaak in overleg met de consultant een autorisatie filter voor de connectie geconfigureerd. Dit autorisatie filter zorgt ervoor dat alleen relevante medewerkers in de connectie worden opgenomen. Dit maakt het mogelijk om in een MLM-systeem uitsluitend de eigen medewerkers te betrekken. Echter dit autorisatie filter werd niet toegepast op het endpoint voor RoleAssignment. Daardoor waren voor een extern systeem alle rollen en personeelsnummers toegankelijk. Hoewel dit alleen de personeelsnummers betrof, waren dit desondanks records die door een extern systeem zouden moeten worden uitgefilterd. Om het integratieproces te stroomlijnen, wordt nu ook het autorisatie filter toegepast op het RoleAssignment endpoint.

Het endpoint Job profiel is uitgebreid met de volgende velden: De velden zijn beschikbaar in alle API met het endpoint Job Profile. De data van de velden is afkomstig van het scherm Functie uit Beaufort.  

Het endpoint JobProfile is uitgebreid met de volgende velden:   type costUnit costType  Deze velden komen overeen met de HR Core Beaufort velden functie type, kostendrager en kostensoort.       Deze velden zijn beschikbaar in alle API's waar het endpoint jobProfile beschikbaar is.

De afgelopen periode zijn de volgende verbeteringen in de API's doorgevoerd:   Extensions API uitgebreid met endpoints voor de Basic API Vanaf nu is het ook mogelijk om de Youforce Extension API te gebruiken in combinatie met de Basic API.   De nieuwe endpoint zijn: GET ..extensions/v1.0/basic/persons  GET ..extensions/v1.0/basic/employments Deze endpoints zijn enkel te gebruik in combinatie met de Basic API. Zie voor meer Eigen rubrieken met de Extensions API    Recruitment API uitgebreid met endpoint voor aannemen medewerker De recruitment API is uitgebreid met een endpoint voor het aannemen van een nieuwe medewerker. Binnen dit proces wordt onderscheid gemaakt tussen het aannemen van een nieuwe medewerker en het creëren van een nieuw dienstverband voor een bestaande medewerker.   Om dit proces te ondersteunen, is er ook een endpoint ontwikkeld waarmee u kunt controleren of een persoon al in de Beaufort-omgeving bestaat.   Het endpoint "Search person" stelt u in staat om te zoeken op verschillende velden, zoals voornaam, geboortenaam, geboortedatum en geboorteplaats. Ten minste één van deze zoekvelden is verplicht. Dit endpoint geeft maximaal 10 resultaten terug.   Op basis van het resultaat van dit endpoint kan het recruitment systeem bepalen of er sprake is van een een geheel nieuwe medewerker of enkel van een nieuw dienstverband bij een bestaande medewerker. Het recruitment systeem kan vervolgens één van de volgende endpoints starten: POST hires: Hiermee wordt een workflow voor het aannemen van een nieuwe medewerker in HR Self Service gestart, waarbij de gegevens vanuit de API als standaardwaarden worden overgenomen. POST Contract: Hiermee wordt een workflow voor het creëren van een nieuw dienstverband in HR Self Service gestart, waarbij de gegevens vanuit de API als standaardwaarden worden overgenomen. Tevens is een endpoint toegevoegd waarmee contractwijzigen kunnen worden doorgegeven. Dit is bijvoorbeeld relevant bij interne sollicitaties.  Het endpoint is:   POST contract/adjustments: Hiermee wordt een workflow voor het wijzigen van een bestaand dienstverband in HR Self Service gestart, waarbij de gegevens uit de API als standaardwaarden worden overgenomen. Consultancy De recruitment API biedt diverse mogelijkheden om de API nader te configureren. Deze mogelijkheden kunnen tijdens de implementatie door onze consultants toegelicht worden.   Status De API is op dit moment nog Controlled Available.  Zodra de eerste integraties zijn ontwikkeld zullen we u hier nader over informeren.      

De afgelopen periode zijn de volgende verbeteringen in de API's doorgevoerd:   Eerste versie Basic API beschikbaar Er is een eerste versie van de Basic API beschikbaar. Deze API is bedoeld voor systemen die niet onder een van onze standaard domein API's vallen, maar toch  basis HR gegevens nodig hebben. De Basic API bevat een set basisfunctionaliteiten met endpoints die doorgaans voldoende zijn voor integratie met het HR Core-systeem. De Basic API bevat de volgende endpoints: GET Persons  GET Employments GET Organisation Units GET Role Assignments GET Job Profiles   Performance- & stabiliteitsverbeteringen De afgelopen maand zijn er een aantal performance- en stabiliteitverbeteringen doorgevoerd . We hebben de integratie met Beaufort geoptimaliseerd, waardoor mutaties in HR Core Beaufort sneller zichtbaar zijn in de API. Deze prestatieverbetering geldt voor alle endpoint, met uitgezonderd van het employee endpoint.   Het 'employee' endpoint is gebaseerd op een verouderde infrastructuur waardoor verdere prestatieverbetering niet mogelijk is.  Als u problemen ondervindt met het 'employee' endpoint dan raden wij u aan over te stappen op het 'Person' en 'employment' endpoint voor het ophalen van de gegevens.   Tevens is de afgelopen periode de filters from/to voor het ophalen van de gewijzigde records verbeterd. In eerdere release werd nog vaak een record als gewijzigd gemarkeerd, terwijl de gegevens ongewijzigd bleek te zijn. We hebben updateproces verbeterd om te voorkomen dat onnodig veel records als gewijzigd worden gemarkeerd.  Wij verwachten dat dit de belasting op uw systeem zal verminderen, met name voor systemen die werken op basis van gewijzigde records. Deze wijziging geldt voor alle endpoint, uitgezonderd van het employee endpoint   Het employee endpoint Zoals wij al eerder hebben aangegeven wordt het 'employee' endpoint niet verder ontwikkeld, en we raden u aan over te stappen op het 'person' en 'employment' endpoint. Het 'employee' endpoint blijft wel beschikbaar in de huidige vorm, maar verdere prestatieverbeteringen zijn niet mogelijk.   Als u momenteel het 'employee' endpoint gebruikt voor uw integratie, kan het langer duren voordat mutaties uit Beaufort zichtbaar zijn in de API. Mocht dit in uw geval tot problemen leiden, dan adviseren wij u om de integratie om te zetten naar de 'Person' en 'Employment' endpoints. Deze endpoint bevatten dezelfde informatie als het 'employee' endpoint maar kennen dus een betere performance. Uw software leverancier kan u informeren of hun applicatie al gebruikmaakt van deze verbeterde endpoints. Zie ook het eerdere bericht : Vervanging Employee endpoint door Persons en Employee endpoint