Mijn Communities
Help

Van IBU naar File API

door Cristo Amezcua (Bijgewerkt ‎22-07-2022 15:03 door Cristo Amezcua VISMA )

Van IBU naar File API

IBU is een Visma|Raet applicatie die wordt gebruikt om bestanden te downloaden vanuit en/of te uploaden naar Youforce. Deze manier van bestanden up- en downloaden gaan wij moderniseren. Hiervoor hebben wij een aantal redenen. 

  1. Ten eerste zero footprint. IBU.exe (een Visma|Raet-applicatie) moet lokaal door jullie beheerder worden geïnstalleerd. Het lokaal installeren van software past niet meer bij onze, maar vaak ook jullie IT-strategie.
  2. Een API is een moderne en duurzame techniek die nog beter voldoet aan de huidige eisen m.b.t. GDPR en Security. 
  3. Omdat voor de File API geen Youforce-certificaat meer nodig is, is het beheer eenvoudiger en minder foutgevoelig.
  4. En tenslotte is de File API volledig gebouwd voor de cloud en wordt daardoor automatisch geschaald zodra er meer of minder capaciteit nodig is. Dit komt de performance ten goede.

 

IBU wordt op dit moment op twee manieren gebruikt, te weten: 

  • Unattended (StandAlone): automatisch bestanden uitwisselen (vanuit opdrachten en scripts)
  • Interactive (zend en ontvang):een gebruiker download of upload bestanden handmatig vanuit het Youforce-portaal 

In eerste instantie gaan we voor de gebruikers van Beaufort Online de ‘Unattended’-variant’ vervangen door de File API. De vervanging voor de ‘Interactive IBU’ volgt op een later moment. 

 

File API

De nieuwe wijze van bestandsuitwisseling gaat dus via de File API. Er zijn drie mogelijke manieren om dit technisch te regelen. 

Optie 1

De File API download een bestand op jullie server en deelt vervolgens dit bestand met de derde partij. Vergelijkbaar dus met zoals de IBU nu werkt. 

Optie 2

Er is een rechtstreekse connectie tussen de File API en de derde partij. Bestanden worden zonder “tussenstop” op jullie (klant) server uitgewisseld. (Extra afname is nodig en de 3e partij moet een aanpassing doen)

CristoAmezcua_0-1658415500097.png

Optie 3

Data wordt rechtstreeks tussen Youforce en de derde partij uitgewisseld, zonder gebruik te maken van bestanden waarin de data is opgeslagen. Eigenlijk zoals API’s bedoeld zijn. Deze API’s, ook wel Domein APIs genoemd, zijn beschikbaar voor IAM, Opleiding & Ontwikkel en SIVI gerelateerde gegevens.
Let op: het betreft hier een volledig nieuwe werkwijze om data uit te wisselen. Om deze manier van uitwisseling te gebruiken is zowel inspanning van een Youforce consultant als een techneut van de derde partij nodig. (Extra afname is nodig en de 3e partij moet een aanpassing doen)

CristoAmezcua_1-1658415599041.png

 

Tijdlijn HR Core Beaufort gebruikers

We zullen de file API in fases gaan uitleveren. 

CristoAmezcua_2-1658415629500.png

Fase 1

Op dit moment zijn de volgende bestandstypes beschikbaar in de file API voor  HR Core Beaufort Online gebruikers  voor de automatische koppelingen (´unattended'):

  • BINT-bestanden (voor meer informatie klik hier
  • DPIA100 (voor meer informatie klik hier
  • Datafeed (voor meer informatie klik hier
  • Raet Betaalmanager(voor meer informatie klik hier)
  • Aantal Gemal exports (voor meer informatie klik hier

De exacte datum waarop we de ‘Unattended IBU’ (automatische koppeling) van de markt gaan halen is nog niet vastgesteld. Zodra we hier meer informatie over hebben en/of over de planning van ‘Interactive IBU’ (handmatig zenden/ontvangen) zullen wij dit vanzelfsprekend bekend maken. 

De file API heeft op dit moment de status Controlled Available omdat nog niet alle bestandstypes beschikbaar zijn en niet alle klanten er nu gebruik van kunnen maken.

Fase 2 

In de volgende fase zullen wij nieuwe bestandstypes toevoegen waardoor ook de HR Core Beaufort 'on prem' klanten gebruik kunnen gaan maken van de file API. Zodra de planning definitief is laten wij dit via de community weten.

Fase 3

In deze fase zullen wij ook een alternatief gaan leveren voor het zenden / ontvangen via Youforce. 

 

Andere HR Cores

Klanten die gebruiken maken van een andere HR Core (HR Core Education, HR Core Business and PB core Idella) zullen op een later moment geïnformeerd worden over de tijdslijnen die voor hen gaan gelden. Ook hier zullen wij het gefaseerd gaan invoeren, eerste de automatische koppelingen ('Unattend IBU') en dan het handmatig zenden en ontvangen van bestanden.

 

Technisch informatie

De API is gedocumenteerd via developers.youforce.com

https://vr-api-integration.github.io/file-api-documentation/

 

Tevens is er een API sandbox beschikbaar waarmee je dummy bestanden kunt up- en downloaden.  https://vr-api-integration.github.io/file-api-documentation/guides_getting_started.html

 

Plan van aanpak

CristoAmezcua_3-1658415899913.png

Meer informatie nodig of vragen?

Neem contact op met je Customer Success Manager. 

 

7 Opmerkingen
Liesbeth HHL
CONTRIBUTOR **
door Liesbeth HHL

Hoi, is er al meer bekend over de planning van fase 1?

Groet, 

Liesbeth

 

Anonymous
Niet van toepassing
door Anonymous

Wij zijn ook benieuwd naar de planning. Is het al mogelijk om afspraken te plannen voor deze omzetting?

door Wesly van Horssen

@Anonymous @Liesbeth HHL Je kan je vanaf nu aanmelden via een 4ME-formulier, staat hier verder uitgelegd:

 

https://community.visma.com/t5/Nieuws-Youforce-API/Van-IBU-naar-de-File-API-Fase-1-HRCoreOnline-gebruikmakend-van/ba-p/527780

 

Natalja Klavers
CONTRIBUTOR ***
door Natalja Klavers

@Wesly van Horssen , onze ICT vraagt over de uiterste datum van IBU omzetting naar API, wanneer is dat? Kunnen we dat nog in Q1 2023 realiseren?

 

door John Rikmanspoel - Hengelo

@Natalja Klavers 

 

Volgens onze service manager is er nog geen harde deadline, wij pakken het ook op in Q1 2023.

door Wesly van Horssen

@Natalja Klavers Q1 kan ook.

Gerda Woldring
CONTRIBUTOR ***
door Gerda Woldring

@Wesly van Horssen is er al een datum/'tijd indicatie voor fase 2 Beaufort on prem gebruikers ivm met de overstap van de IBU naar File API. Als hier al enigszins zicht op is kan ik onze ICT afdeling inschakelen zodat er tijd gereserveerd kan worden voor de overgang.