Releases Youforce Portaal

New Developer portal documentation on the community Why We want to improve the developer experience and improve the way we can update documentation on APIs. This is why we started to move the developer portal to the community. At this time all documentation can be found in the community and everyone with access to this environment can request access to the developer section. How Please go to: https://community.raet.com/developers/ Developer portal documentation updated (IAM (users)) Why Although we are moving the developer portal to the community, we also want the existing developers portal to be up to date. One of the sections missing was the documentation about the users end-point within the IAM domain. This documentation is now added and available in the portal. How Please go to: https://developers.raet.com  Improvements Error response on spike-arrest and quota Why When hitting the spike-arrest or quota on the API up until now the response was a generic 500 response. It was unclear for you what was going on. We have improved this and when hitting these limits you will now get a proper 429 error response. Improved error response on 501 error Why The 501 error was not following our standards, we now improved the response body based our standards. Publishing Date : 2/25/2020

New IAM API (users) documentation on the developer portal Why We released the IAM API in the previous release. The general documentation was already available on the developer portal. The part that missing was how the users end-point could be used. This new section in the developer portal describes this and allows a developer to find the necessary documentation. In the near future the section IAM API and IAM API(users) will be merged into one section. How Please visit https://developers.raet.com, on this page to go to the section API library and here you will find the section IAM API (users).  Improved Extended time out on HR Core business base API Why Using the HR Core business base API we see that the use cases are growing and with it, the size and complexity of the requests are increasing. We now updated the time out to make sure that these calls can be supported and do not result in a time out for the user. How Within the service gateway, we control the settings for each API and here we increased the time out to 2 minutes Your action There is no action necessary, this time out is automatically updated for all users Publishing Date : 1/28/2020

Dit document bevat een beschrijving van nieuwe functionaliteiten en verbeteringen in deze release. De wijzigingen komen deels voort uit meldingen van onze klanten. Waar het relevant is, verwijzen wij met een nummer naar ons interne systeem waarin wij meldingen van klanten (change …..) registreren. New Youforce Medical Leave Management (MLM) API Why In order to support Medical Leave Management integrations we have created a new product the public API. How The end-point will be available under: https://api.raet.com/yfo/mlm/... Your action In order to start consuming this end-point as a customer of HR Core Business Global you need to request the MLM product to your API with a ticket in 4Me Youforce National Identifiers (NID) API Why In order to support applications that need the National Identifiers we have created a new product for the public API. How The end-point will be available under: https://api.raet.com/yfo/nid/... Your action In order to start consuming this end-point as a customer of HR Core Business Global you need to request the MLM product to your API with a ticket in 4Me Identity and Access Management (IAM) documentation on the developer portal Why The new API for IAM is available and in order to consume it the documentation is now on the developer portal How Go to the developer portal (https://developers.raet.com) and go to the section API Library, here you will find the IAM documentation Modified and improved New cost center for Jumbo added Apigee made a change in the way they handle URL encoding and decoding. This forced us to update a specific solution where we filter, based on specific parameters. This bug was fixed earlier in a hotfix and we deployed a new solution last release. During the release we noticed a problem which is now fixed. In this release we will deploy the improvements Publishing Date : 12/20/2019

General These release notes are for API developers only. Bug fixes APIs People and Organization API: In a multi page call the tag for the next link was called next Delta. With this release, we prevent the renaming of the tag and it will be next link. Proxies public_yfo-authentication_oauth-provider-jwt-r2: The authentication proxy was containing a bug regarding special characters. In this release, the problem is fixed and the proxy is updated. Publishing Date : 10/25/2019

Gewijzigd en verbeterd Aanpassingen van IBU Server-componenten Waarom We voeren deze aanpassingen door om de stabiliteit van IBU (Zenden en ontvangen) te verbeteren. Hoe In deze release worden diverse IBU Server-componenten bijgewerkt. Daarom is IBU Server tijdens de release niet beschikbaar op 1 oktober tussen18:00 en 0:00. Bestandsuitwisseling via Zenden en ontvangen en de IBU Client in zelfstandige modus (Standalone) zal gedurende dit onderhoud ook niet mogelijk zijn. Als u kritieke bestandsuitwisselingen hebt gepland gedurende deze periode, raden we u aan deze opnieuw in te plannen. Neem contact op met uw beheerder. Impact op IBU Standalone Als uw organisatie een planner gebruikt om bestanden automatisch te uploaden naar,of te downloaden van, de Youforce-server met IBU Client in zelfstandige modus, moet u het volgende rekening houden: Bestandsuitwisseling via IBU Standalone zal gedurende de onderhoudsperiode niet mogelijk zijn. De bestanden die op de client of de server staan worden na het onderhoud verwerkt op basis van de eerste automatisch ingeplande start. Als IBU Standalone verbinding maakt met IBU Server tijdens de onderhoudsperiode, worden foutmeldingen gegenereerd en vastgelegd. Afhankelijk van uw lokale configuratie kunnen ook e-mails worden verzonden naar de beheerder van uw organisatie. Dergelijke foutmeldingen zijn normaal en kunnen worden genegeerd. Als IBU Server offline gaat tijdens het verwerken van een bestandsuitwisseling, kan die uitwisseling mislukken. In dat geval wordt ook een foutmelding gegenereerd en vastgelegd. Soms is het nodig om het betreffende bestand achteraf handmatig te verzenden of te ontvangen. Als het bestand niet meer op de serverlijst staat, kunt u contact opnemen met de Service Desk van Raet om het bestand terug te zetten. Als u bovenstaande fouten/meldingen wil voorkomen, moet u uw lokale planner voor IBU Standalone uitschakelen gedurende de onderhoudsperiode. Uw ICT-medewerker kan dit regelen, maar u kunt ook contact opnemen met uw Raet-consultant. Uw actie Indien nodig: activeer uw standalone Zend en Ontvang sessie(s). Publishing Date : 9/24/2019

Changed and Improved Modifications to IBU Server components Why We have made several changes to improve the stability of IBU (Send and Receive) How Several IBU Server components will be updated. IBU Server will not be available on October 1st, from 18:00 to 0:00 (CET). File exchange in Send & Receive and the IBU client executable in standalone mode cannot be used during the maintenance interval either. If you have planned critical file exchanges during this period, we advise you to reschedule these activities. Please contact your administrator. Impact for IBU Standalone If your organization uses a scheduler to automatically upload files to or download files from the Youforce server using IBU client in standalone mode, you should pay special attention to the following. File exchange with IBU standalone will not work during the maintenance interval. IBU standalone will start processing files left on the client or server after the maintenance has ended, on the first automatically scheduled start afterward. If IBU standalone tries to connect to IBU server during the maintenance interval, error messages will be generated and logged. Depending on your local configuration, e-mails may also be sent to your organization's administrator. Such error messages are normal and can be ignored. If IBU server goes down in the middle of processing a file exchange, the transfer may fail. In this case, an appropriate error message will also be logged. In some cases, it might be necessary to send or receive the corresponding file manually afterward. If the requested file has disappeared from the server list, you may contact the Raet Service Desk to have it restored. If your organization would rather prevent the above-mentioned errors, you are advised to switch off your local scheduler for IBU standalone during the maintenance interval. Your IT professional can take care of this, or you may contact your Visma | Raet consultant. Publishing Date : 9/24/2019

Notifications Advance notice of transition to technical protocol TLS 1.2 Why Through this adaptation Visma | Raet takes a step towards an even safer and more reliable Youforce as of 30 November 2019. As of that date, Visma | Raet will stop supporting TLS 1.0 and TLS 1.1 for all products. Transport Layer Security (TLS) is the technical protocol that takes care of an important function in the browser: encryption of data traffic between your computer and our servers. Currently, there are three prevalent TLS protocols: 1.0, 1.1 and 1.2. For now, our products support all three versions. The use of TLS 1.2 entails the application of the latest and safest encryption techniques. Visma | Raet will disable the older and less safe protocols (TLS 1.0 and TLS 1.1) for its products. How Some old browsers do not support TLS 1.2. These can no longer be used to connect to Youforce as they do not use the corresponding TLS 1.2 protocol. You will have to use a newer browser. Links to and interfaces with Youforce that connect using TLS 1.0 or TLS 1.1 will also no longer function after the transition to TLS 1.2. Your action Ensure that the links you manage yourself support TLS 1.2 prior to the specified date. As of 30 November 2019, all Visma | Raet products and outbound interfaces (IBU) will only support TLS 1.2. Functional Enhancements ONS-Connector - Remove Inroostering validation Why Until now, the ONS-Connector has delivered the error message 220 Inroostering not found if one of the sections below was not in the HR Core Beaufort Interface export. There are customers who do not use the contract and cluster (team) data in the ONS-Connector. This means that the sections mentioned below no longer have to be present in the HR Core Beaufort Interface export. How This validation is removed in ONS-Connector. Note If you do not want to fill the contract and cluster data in the ONS-Connector with the corresponding data in HR Core Beaufort, remove all sections listed below from the HR Core Beaufort Interface section set. If you want to fill the contract and cluster data in ONS-Connector with the corresponding data in HR Core Beaufort, ensure that all data below are part of the HR Core Beaufort Interface section set.   BO4 Code Description P01121 Operationele org. eenheid P01125 Ingang inzet P01126 Einde inzet P01102 Soort arbeidsrelatie P01109 Uren per week P01119 Max. uren per week P01124 Uren per inzet   Publishing Date : 6/25/2019

Mededelingen Vooraankondiging overgang naar het technische protocol TLS 1.2 Waarom Met deze aanpassing zet Visma | Raet - per 30 november 2019 - een stap richting een nog veiliger en betrouwbaarder Youforce. Per die datum gaat Visma | Raet dan ook stoppen met de ondersteuning van TLS 1.0 en TLS 1.1 op alle producten. De Transport Layer Security - afgekort TLS - is het technische protocol dat in de browser zorgt voor een belangrijke functie: het versleutelen van het dataverkeer tussen uw computer en onze servers. Op dit moment zijn er drie gangbare TLS protocollen: 1.0, 1.1 en 1.2. Onze producten ondersteunen nu nog alle drie versies. Het gebruik van TLS 1.2 betekent de toepassing van de nieuwste en meest veilige versleuteltechnieken. Visma | Raet gaat de oudere en minder veilige protocollen (TLS 1.0 en 1.1) uitschakelen op zijn producten. Hoe Een aantal oude browsers heeft geen ondersteuning voor TLS 1.2. Die browsers kunnen dus niet meer verbinden met Youforce omdat ze niet met het overeenkomstige TLS 1.2 protocol werken. U moet in dit geval gebruik maken van een nieuwere browser. Ook koppelingen en interfaces met Youforce, die connectie via TLS 1.0 of 1.1 maken, werken niet meer na onze overstap naar TLS 1.2. Uw actie Zorg ervoor dat de koppelingen die u in eigen beheer hebt, vóór de aangegeven datum TLS 1.2 ondersteunen. Alle Visma | Raet producten en outbound interfaces (IBU) ondersteunen vanaf 30 november 2019 alleen TLS 1.2. Functionele verbeteringen ONS-Connector - Validatie voor Inroostering verwijderd Waarom De ONS-Connector leverde de storingsmelding 220 Inroostering not found als een van de beneden genoemde secties niet aanwezig was in de HR Core Beaufort Interface export. Sommige klanten willen niet dat gegevens met betrekking tot de cluster en het contract worden toegevoegd aan de ONS-Connector. Dit betekent dat in die gevallen de genoemde secties niet meer aanwezig hoeven te zijn in de HR Core Beaufort Interface export. Hoe De validatie is verwijderd uit de ONS-Connector. Note Als u de contract en cluster data in ONS niet wilt vullen met de overeenkomstige data van HR Core Beaufort, verwijder dan alle genoemde secties uit de HR Core Beaufort Interface section set. Als u de contract en cluster data in ONS wél wilt vullen met de overeenkomstige data van HR Core Beaufort, zorg er dan voor dat alle genoemde secties aanwezig zijn in de HR Core Beaufort Interface section set.   BO4-code Beschrijving P01121 Operationele org. eenheid P01125 Ingang inzet P01126 Einde inzet P01102 Soort arbeidsrelatie P01109 Uren per week P01119 Max. uren per week P01124 Uren per inzet   Publishing Date : 6/25/2019

This document describes the new functionality and improvements introduced by this release. Some of these changes have been inspired by messages and reports from customers. Where relevant, we have included a number in the section title to refer to the identification of the message (change .....) in question in our system. General information This document contains important additional information for the Youforce portal – IBU server release on Thursday, March 7 th , 2019. Changed and Improved Modifications to IBU Server components Why We have made several improvements to increase the stability and performance of IBU (Send and Receive) How Several IBU Server components will be updated. IBU Server will not be available on March 7th, from 18:00 to 0:00 (CET) during required maintenance to install the updates. File exchange in Send & Receive and the IBU client executable in standalone mode cannot be used during the maintenance interval either. If you have planned critical file exchanges during this period, we advise you to reschedule these activities. Please contact your administrator. Impact for IBU Standalone If your organization uses a scheduler to automatically upload files to or download files from the Youforce server using IBU client in standalone mode, you should pay special attention to the following. File exchange with IBU standalone will not work during the maintenance interval. IBU standalone will start processing files left on the client or server after the maintenance has ended, on the first automatically scheduled start afterwards. If IBU standalone tries to connect to IBU server during the maintenance interval, error messages will be generated and logged. Depending on your local configuration, e-mails may also be sent to your organization's administrator. Such error messages are normal and can be ignored. If IBU server goes down in the middle of processing a file exchange, the transfer may fail. In this case an appropriate error message will also be logged. In some cases it might be necessary to send or receive the corresponding file manually afterwards. If the requested file has disappeared from the server list, you may contact the Raet Service Desk to have it restored. If your organization would rather prevent the above-mentioned errors, you are advised to switch off your local scheduler for IBU standalone during the maintenance interval. Your IT professional can take care of this, or you may contact your Raet consultant. Send and Receive - New IBU manual and IBU client version 3.9.4 available. Why We have also released a new version of IBU client to improve stability and performance. How This new version 3.9.4 of IBU client has been available since February 15. You need this software to exchange files with the Youforce application Send & Receive. You can download the new version via the news publication on Youforce Portal (see News or Publications | Youforce). Even if you are already working with another version of IBU, we strongly advise you to replace it with version 3.9.4 on every device where older versions are installed. Version 3.9.4 is the most stable version. Most reports about incorrectly exchanged files are caused by the use of older IBU versions. A new IBU manual is also available. All previous manuals are now bundled into one manual. Here you will find all information about the installation, use and configuration of Send and Receive. As of this publication all previous editions of the Send and Receive manual have been invalidated. An English manual is also available now. The new manual is available in Youforce | Publications | Youforce (Newsitem: Send & Receive - New IBU version and manual) Publishing Date : 2/22/2019

Dit document bevat een beschrijving van nieuwe functionaliteiten en verbeteringen in deze release. De wijzigingen komen deels voort uit meldingen van onze klanten. Waar het relevant is, verwijzen wij met een nummer naar ons interne systeem waarin wij meldingen van klanten (change …..) registreren. Algemene informatie Dit document bevat belangrijke extra informatie over de Youforce Portal release op donderdag 7 maart 2019. Gewijzigd en verbeterd Wijzigingen in de IBU-serveronderdelen Waarom We hebben een aantal verbeteringen aangebracht voor meer stabiliteit en betere prestaties van IBU (Zenden en Ontvangen) Hoe Verschillende IBU-serveronderdelen worden bijgewerkt. De IBU-server is hierdoor op 7 maart tussen 18:00 en 00:00 uur niet beschikbaar. Tijdens deze periode wordt het vereiste onderhoud voor de installatie van de updates uitgevoerd. Bestandsuitwisseling in Zenden en Ontvangen en de IBU-client die wordt uitgevoerd in de zelfstandige modus kunnen tijdens deze periode ook niet worden gebruikt. U kunt tijdens deze periode beter geen kritieke bestandsuitwisseling doen. Neem contact op met uw beheerder. Gevolgen voor de standalone modus van de IBU-client Als uw organisatie gebruikmaakt van een scheduler voor het automatisch uploaden van bestanden naar of het downloaden van bestanden van de Youforce-server via de IBU-client in de zelfstandige modus, moet u rekening houden met het volgende. Bestandsuitwisseling met de standalone modus van de IBU-client werkt niet tijdens de onderhoudsperiode. De verwerking van bestanden die nog op de client of de server staan na de onderhoudsperiode wordt gestart tijdens de eerstvolgende automatisch geplande verwerking. Als de zelfstandige modus van de IBU-client tijdens de onderhoudsperiode verbinding probeert te maken met de IBU-server, worden er foutmeldingen gegenereerd en gelogd. Afhankelijk van de lokale configuratie worden er mogelijk ook e-mailberichten verzonden naar de beheerder van uw organisatie. Dergelijke foutmeldingen zijn normaal en kunnen worden genegeerd. Wanneer de IBU-server tijdens de verwerking van bestandsuitwisseling uitvalt, mislukt de overdracht mogelijk. In dit geval wordt ook de bijbehorende foutmelding gelogd. In sommige gevallen moet het betreffende bestand naderhand handmatig worden verzonden of ontvangen. Wanneer het aangevraagde bestand uit de serverlijst is verdwenen, moet u contact opnemen met Raet Service Center om het bestand te herstellen. Als uw organisatie bovenstaande fouten liever wil voorkomen, kunt u de lokale scheduler voor de standalone modus van de IBU-client het best uitschakelen tijdens de onderhoudsperiode. Uw Youforce beheerder kan hiervoor zorgen of u kunt zelf contact opnemen met een Raet-adviseur. Zenden en ontvangen - Nieuwe IBU-handleiding en IBU-client versie 3.9.4 beschikbaar. Waarom We hebben ook een nieuwe versie van de IBU-client uitgebracht om de stabiliteit en prestaties te verbeteren. Hoe De nieuwe versie van de IBU-client (3.9.4) is sinds 15 februari beschikbaar. U hebt deze software nodig om bestanden uit te wisselen met de Youforce-applicatie Zenden en ontvangen. U kunt de nieuwe versie downloaden via de nieuwspublicatie op Youforce Portal (zie Nieuws of Publicaties). Ook als u al werkt met een andere versie van de IBU-client, raden we u aan deze te vervangen door versie 3.9.4 op elk apparaat waarop een oudere versie is geïnstalleerd. Versie 3.9.4 is de meest stabiele versie. De meeste rapporten over onjuist uitgewisselde bestanden worden veroorzaakt door het gebruik van een oudere IBU-versie. Bovendien is er een nieuwe IBU-handleiding beschikbaar. Alle vorige handleidingen zijn nu gebundeld in één handleiding. Hierin vindt u alle informatie over de installatie, het gebruik en de configuratie van Zenden en ontvangen. Vanaf deze publicatie zijn alle eerdere edities van de handleiding voor Zenden en ontvangen ongeldig. Er is bovendien een Engelstalige handleiding beschikbaar. U vindt de nieuwe handleiding in Publicaties Youforce | Youforce - Productinformatie | Algemene informatie. Publishing Date : 2/22/2019

General information This document contains important additional information for the Youforce portal – IBU server & ONS Connector release on Thursday, February 7 th , 2019. Technical Improvements in IBU Server Modifications in IBU Server components Why IBU Server components have been updated. IBU Server will not be available on February 7th, from 18:00 to 0:00 (CET), during required maintenance to install the updates. File exchange in Send & Receive and the IBU client executable in standalone mode cannot be used during the maintenance interval either. If you have planned critical file exchanges during this period, you are advised to reschedule these activities. Please contact your administrator. Impact for IBU Standalone If your organization uses a scheduler to automatically upload files to or download files from the Youforce server using IBU client in standalone mode, you should pay special attention to the following. File exchange with IBU standalone will not work during the maintenance interval. IBU standalone will start processing files left on the client or server after the maintenance has ended, on the first automatically scheduled start afterwards. If IBU standalone tries to connect to IBU server during the maintenance interval, error messages will be generated and logged. Depending on your local configuration, e-mails may also be sent to your organization's administrator. Such error messages are normal and can be ignored. If IBU server goes down in the middle of processing a file exchange, the transfer may fail. In this case an appropriate error message will also be logged. In some cases it might be necessary to send or receive the corresponding file manually afterwards. If the requested file has disappeared from the server list, you may contact the Raet Service Desk to have it restored. If your organization would rather prevent the above-mentioned errors, you are advised to switch off your local scheduler for IBU standalone during the maintenance interval. Your IT professional can take care of this, or you may contact your Raet consultant. Publishing Date : 1/31/2019

Algemene informatie Dit document bevat belangrijke extra informatie over de Youforce Portal – Release van IBU-server en ONS-connector op donderdag 7 februari 2019. Technische verbeteringen in IBU-server Wijzigingen in de IBU-server Waarom De IBU-serveronderdelen zijn bijgewerkt. De IBU-server is hierdoor op 7 februari tussen 18:00 en 00:00 uur (CET) niet beschikbaar. Tijdens deze periode wordt het vereiste onderhoud voor de installatie van de updates uitgevoerd. Bestandsuitwisseling in Zenden en Ontvangen en de IBU-client die wordt uitgevoerd in de zelfstandige modus kunnen tijdens deze periode ook niet worden gebruikt. U kunt tijdens deze periode beter geen kritieke bestandsuitwisseling doen. Neem eventueel contact op met uw beheerder. Impact IBU standalone Als uw organisatie gebruik maakt van een scheduler voor het automatisch uploaden van bestanden naar - of het downloaden van bestanden van - de Youforce-server via de IBU-client in de standalone modus, moet u rekening houden met het volgende. Bestandsuitwisseling met de zelfstandige modus van de IBU-client werkt niet tijdens de onderhoudsperiode. De verwerking van bestanden die nog op de client of de server staan na de onderhoudsperiode wordt gestart tijdens de eerstvolgende automatische planning. Als de zelfstandige modus van de IBU-client tijdens de onderhoudsperiode verbinding probeert te maken met de IBU-server, worden er foutmeldingen gegenereerd en gelogd. Afhankelijk van de lokale configuratie worden er mogelijk ook e-mailberichten verzonden naar de beheerder van uw organisatie. Dergelijke foutmeldingen zijn normaal en kunnen worden genegeerd. Wanneer de IBU-server tijdens de verwerking van bestandsuitwisseling uitvalt, mislukt de overdracht mogelijk. In dit geval wordt ook de bijbehorende foutmelding gelogd. In sommige gevallen moet het betreffende bestand naderhand handmatig worden verzonden of ontvangen. Wanneer het aangevraagde bestand uit de serverlijst is verdwenen, moet u contact opnemen met Raet Service Desk om het bestand te herstellen. Als uw organisatie bovenstaande fouten liever wil voorkomen, kunt u de lokale planner voor de zelfstandige modus van de IBU-client het best uitschakelen tijdens de onderhoudsperiode. Uw IT-professional kan hiervoor zorgen of u kunt zelf contact opnemen met een Raet-adviseur. Publishing Date : 1/31/2019