Beaufortimporter

Inleiding

Dit document beschrijft de BeaufortImporter koppeling. Er wordt toegelicht wat de koppeling doet en wat nodig is om de koppeling te laten werken. Daarnaast wordt een overzicht gegeven van welke controles er worden uitgevoerd en welke gegevens geïmporteerd worden.

Wat houdt de koppeling in?

Met de BeaufortImporter koppeling kan men medewerker- en contractgegevens die door het programma Beaufort in XML formaat zijn geëxporteerd, importeren in SDB ECD.

De gebruiker dient de te importeren bestanden in een aangewezen map te plaatsen, zodat de koppeling, die middels een job in SDB ECD wordt aangetrapt, deze kan oppakken om te verwerken.

Er zijn twee varianten van export bestanden die door Beaufort kunnen worden aangemaakt, de zogenoemde werknemerBasisActueel en werknemerPeriodiekActueel bestanden.

Met een werknemerBasisActueel bestand worden alle gegevens behorende tot een medewerker in bulk geëxporteerd. Deze bestanden kunnen erg groot worden en dienen gebruikt te worden om tot een eerste initiële vulling te komen in SDB ECD.

Met een werknemerPeriodiekActueel bestand worden (hoofdzakelijk) alleen de gewijzigde gegevens doorgegeven. Deze bestanden zijn een stuk kleiner en dienen gebruikt te worden om de gegevens in SDB ECD up-to-date te houden.

De job

Om Beaufort bestanden te importeren dient men een SDB ECD job aan te maken. Hiervoor klikt men op “Jobs” boven in de menubalk zodat de “Jobs” pagina wordt geopend. In die pagina klikt men op de knop nieuw zodat het “Job Details” venster wordt geopend. In dat venster kiest men uit de “Jobs” keuzelijst de optie “BeaufortImporter”. Als parameter voor deze job geeft men dan het pad op waar naar de te importeren bestanden wordt gezocht. Vervolgens slaat men de job op en wacht men tot deze wordt uitgevoerd.

Nadat de job is uitgevoerd kan men de logging van de job bekijken. Daar kan men zien welke medewerkers / contracten zijn uitgevallen en met welke reden. Er wordt geen uitval bestand aangemaakt. Indien men een uitgevallen medewerker opnieuw wil inlezen, zal men eerst de oorzaak van de uitval moeten herstellen en dan een nieuw importbestand aanbieden om te importeren.

Wat moet er gebeuren om de koppeling te laten werken

Nadat de bestanden zijn gegenereerd vanuit Beaufort en ze in de aangewezen map zijn geplaats, kan de koppeling ze oppakken. Wanneer de koppeling door een job word opgestart, worden er een aantal controles uitgevoerd voordat er daadwerkelijk begonnen wordt met het verwerken van de bestanden.

De vertaaltabel

De koppeling maakt gebruik van een vertaaltabel waarmee de gegevens uit Beaufort eerst vertaald worden voordat ze in SDB ECD worden geplaatst. Deze tabel zal handmatig via de SQL management studio gevuld moeten worden, want er is geen beheerpagina voor aanwezig in SDB ECD. De eerste controle die uitgevoerd wordt is op die vertaaltabel, die de naam T_BeaufortCodetab heeft.

Er wordt gekeken of de waarden waar de Beaufort gegevens naar vertaald worden, ook daadwerkelijk in SDB ECD zijn ingericht. Daarnaast word ook gecontroleerd of er dubbele vertalingen voorkomen. Als de controle niet slaagt wordt de import afgebroken en ziet men dat terug in de logging van de job.

Het import-pad

Vervolgens wordt gecontroleerd of het opgegeven import-pad waar de bestanden in worden geplaatst, ook daadwerkelijk bestaat en bereikbaar is.

Dit is het pad dat men bij het aanmaken van de job in de job-pagina invult. Er een wordt standaard pad ingevuld dat door de parameter BeaufortInterfaceImportPad wordt bepaald. Indien dat pad niet bestaat of niet bereikbaar is vanwege ontoereikende rechten voor de koppeling, dan wordt de import afgebroken en ziet men dat terug in de logging van de job.

Het XSD pad

Dit is het pad wat gebruikt wordt om het XSD bestand te benaderen, waarmee de import bestanden gevalideerd worden. Indien de koppeling het bestand bint.xsd niet in dat pad kan vinden wordt de import afgebroken en ziet men dat terug in logging van de job.

Welke gegevens moeten door Beaufort worden geëxporteerd

Onderstaand wordt beschreven in welke hiërarchie de koppeling de gegevens verwacht. Beaufort zal dus zodanig ingericht moeten zijn zodat de gegevens ook op de verwachte locaties in de XML structuur worden aangeboden. Om niet telkens het volledige XML pad aan te moeten geven, worden relatieve paden gebruikt die relatief zijn aan bericht.werknemers.werknemer (voor persoons gegevens) en bericht.werknemers.werknemer.dienstverbanden.dienstverband (voor contract gegevens).

Medewerkersnummer en contractnummer

Het medewerkersnummer en het contractnummer zijn twee sleutelvelden en zijn derhalve essentieel. Het is noodzakelijk dat ze in het exportbestand aanwezig zijn op de locaties persoon.identificatiePS.persNr (medewerkersnummer) en dienstverband.identificatieDV.dvVlgnr (contractnummer). Indien 1 van beide niet uit het exportbestand afgeleid kan worden, wordt de medewerker niet geïmporteerd en wordt er melding van gedaan in de job logging.

Vertaalde velden

Velden kunnen worden vertaald middels een vertaaltabel. Indien voor zo’n veld geen geldige vertaling gevonden kan worden, dan wordt de medewerker niet geïmporteerd en wordt er melding van gegeven in de job logging.

De velden die vertaald worden zijn als volgt:

Geslacht

In Beaufort is dit: persoon.kenmerken.naamRegistratie.geslacht

De vertaalcode is: Geslacht

Schrijfwijze van de naam

In Beaufort is dit: persoon.kenmerken.naamOverig.gebruikAchternaam

De vertaalcode is: Schrijfwijze

Landcode

In Beaufort is dit: persoon.woonAdres.landCode

De vertaalcode is: Land

Organisatorische Eenheid

In Beaufort is dit: arbeidsRelatie.orgEenheid

De vertaalcode is: OrgEenheid

Functie

In Beaufort is dit: arbeidsRelatie.functiePrimair

De vertaalcode is: Functie

Soort contract

In Beaufort is dit: arbeidsRelatie.soortArbeidsrelatie

De vertaalcode is: Soortcontract

Deskundigheid

In Beaufort is dit: aanvullendDV.rubriekcode=“QIC002”

De vertaalcode is: Deskundigheid

CAO

In Beaufort is dit: salarisRegeling.algemeenDV.ArbeidsvoorwaardengroepCAO

De vertaalcode is: CAO

Medewerker gegevens (deze gegevens worden opgeslagen in T_Medewerker)

BSN

In Beaufort is dit: persoon.kenmerken.algemeenPS.burgerServiceNr

In SDB ECD is dit: T_Medewerker.ndBSN

Telefoonnummer werk

In Beaufort is dit: persoon.contactGegevens.werk.telefoonNrWerk

In SDB ECD is dit: T_Medewerker.ndTel1

Telefoonnummer mobiel

In Beaufort is dit: persoon.contactGegevens.overig.mobielNr

In SDB ECD is dit: T_Medewerker.ndTel2

Telefoonnummer privé

In Beaufort is dit: persoon.woonAdres.telefoonNr

In SDB ECD is dit: T_Medewerker.ndTel3

E-Mail 1

In Beaufort is dit: persoon.contactGegevens.werk.emailAdresWerk

In SDB ECD is dit: T_Medewerker.sdEmail

E-Mail 2

In Beaufort is dit: persoon.contactGegevens.prive.emailAdresPrive

In SDB ECD is dit: T_Medewerker.sdEmail2

Geboortenaam

In Beaufort is dit: persoon.kenmerken.naamRegistratie.geboortenaam

In SDB ECD is dit: T_Medewerker.sdGebNaam

Voorvoegsels van de geboortenaam

In Beaufort is dit: persoon.kenmerken.naamRegistratie.voorvoegsels

In SDB ECD is dit: T_Medewerker.sdVvGebNaam

Voorletters

In Beaufort is dit: persoon.kenmerken.naamRegistratie.voorletters

In SDB ECD is dit: T_Medewerker.sdInit

Geboortedatum

In Beaufort is dit: persoon.kenmerken.naamRegistratie.datumGeboorte

In SDB ECD is dit: T_Medewerker.ddGebDatum

Roepnaam

In Beaufort is dit: persoon.kenmerken.naamOverig.roepnaam

In SDB ECD is dit: T_Medewerker.sdRoepnaam

Geboortenaam partner

In Beaufort is dit: persoon.partner.geboortenaam

In SDB ECD is dit: T_Medewerker.sdPartnerNaam

Voorvoegsels van de partnernaam

In Beaufort is dit: persoon.partner.voorvoegsels

In SDB ECD is dit: T_Medewerker.sdVvPartnerNaam

Straatnaam

In Beaufort is dit: persoon.woonAdres.straatnaam

In SDB ECD is dit: T_Medewerker.sdStraatnaam

Huisnummer

In Beaufort is dit: persoon.woonAdres.huisNr

In SDB ECD is dit: T_Medewerker.ndHuisnr

Huisnummer toevoeging

In Beaufort is dit: persoon.woonAdres.huisNrToevoeging

In SDB ECD is dit: T_Medewerker.sdHuisnrToev

Postcode

In Beaufort is dit: persoon.woonAdres.postcode

In SDB ECD is dit: T_Medewerker.sdPostcode

Woonplaats

In Beaufort is dit: persoon.woonAdres.plaatsnaam

In SDB ECD is dit: T_Medewerker.sdWoonplaats

Contract gegevens (deze gegevens worden opgeslagen in T_ContractMut)

Begin dienstverband

In Beaufort is dit: periodeDV.begindatum

In SDB ECD is dit: T_ContractMut.ddBeginDienstverband

Einde dienstverband

In Beaufort is dit: periodeDV.einddatum

In SDB ECD is dit: T_ ContractMut.ddEindeDienstverband

Soort contract

In Beaufort is dit: arbeidsRelatie.soortArbeidsrelatie

In SDB ECD is dit: T_ContractMut.ndSoortContract

Organisatorische Eenheid

In Beaufort is dit: arbeidsRelatie.orgEenheid

In SDB ECD is dit: T_ContractMut.ndOrgEenheid

Functie

In Beaufort is dit: arbeidsRelatie.functiePrimair

In SDB ECD is dit: T_ContractMut.ndFunctie

Begindatum functie

In Beaufort is dit:

arbeidsRelatie.functiePrimair.datumIngang

In SDB ECD is dit: T_ContractMut.ddBeginFunctie

Deskundigheid

In Beaufort is dit: aanvullendDV.rubriekcode=“QIC002”

In SDB ECD is dit: T_Contract_has_EmployeeTypes.employeetype_ID

Vaste uren per week

In Beaufort is dit: arbeidsRelatie.urenPerWeek

In SDB ECD is dit: T_

ContractMut.ndUrenVast

Max. aantal uren per week

In Beaufort is dit: aanvullendDV.rubriekcode=“ P01119”

Dit wordt in SDB ECD niet opgeslagen en wordt enkel gebruikt om het variabele aantal uren te berekenen.

Variabele uren per week

Deze waarde wordt berekend met ( Max. aantal uren per week - Vaste uren per week )

In SDB ECD is dit: T_ContractMut.ndUrenVar

Export naar salarisadministratie

In Beaufort is dit: aanvullendDV.rubriekcode=“QIC004”

In SDB ECD is dit: T_ContractMut.bdUrenSalAdm

Kenmerk 2

In Beaufort is dit: aanvullendDV.rubriekcode=“QIC005”

In SDB ECD is dit: T_ContractMut.ndKenmerk2

Max. inplanbaar

Dit is een gecalculeerde waarde die bepaald wordt middels de formule:

Vaste Uren – ( ( % kort ouderschapsverlof * Vaste Uren ) / 100 )

Het % kort ouderschapsverlof staat bij Beaufort in: anvullendDV.rubriekcode=“P00468”

De berekende waarde wordt in SDB ECD opgeslagen in: T_ContractMut.ndMaxInplanbaar

CAO

In Beaufort is dit : salarisRegeling.algemeenDV.ArbeidsvoorwaardengroepCAO

In SDB ECD is dit: T_ContractMut.ndCAO

Verlofrecht gegevens specifiek voor de cliënt planner

Om de cliëntplanner rekening te laten houden met het verlof van de medewerkers, worden de onderstaande verlofrecht gegevens uit Beaufort gebruikt.

Jaar

In Beaufort is dit: verlof.identificatieVJ.vrlrJr

In SDB ECD is dit: Contract_has_hours_for_actiontype_per_year.year

Aantal uren

In Beaufort is dit: verlof.detailsVJ.verlofrechtHuidigJaar

In SDB ECD is dit: Contract_has_hours_for_actiontype_per_year.hours