Releasedocumentatie Koppeling Metacom-Persmaster Auteur: VanMeijel Documentnr: 041840004 Datum: Versie: 1 22 september 2014 1 Van Meijel Automatisering bv Duit 8-8305 BB Emmeloord T (0527) 61 47 67 F (0527) 61 32 71 info@vanmeijel.nl www.vanmeijel.nl 1 : 12
Inhoudsopgave 1 Inleiding 3 2 Inrichting 4 2.1 Menu functies aanmaken... 4 2.2 Menu wijzigingen... 5 2.3 Ini file... 5 2.4 Personeelsinstellingen... 6 2.5 Instellingen Persmaster... 8 2.6 Vertaaltabellen... 9 3 Gebruik 10 3.1 Uitvoeren communicatie... 10 3.2 XML-bestandsdefinities Persmaster... Fout! Bladwijzer niet gedefinieerd. 3.3 Voorbeeld bestand... 11 2 : 12
1 Inleiding Met behulp van de nieuwe koppeling Metacom-Persmaster kunnen personeelsgegevens vanuit Persmaster in Metacom geïmporteerd worden. Er kan in Metacom geïmporteerd worden richting de personeelstabel en/of de personen tabel. Nieuwe personeelsleden of personen kunnen via de importfunctie aangemaakt worden incl. alle velden uit Persmaster en deze gegevens kunnen onderhouden worden dmv de importfunctie. Voor de koppeling Metacom-Persmaster is een licentie nodig. Zonder licentie werkt de beschreven functionaliteit niet. 3 : 12
2 Inrichting 2.1 Menu functies aanmaken Functionaliteit Nieuw Info voor Applicatiebeheerder De volgende functies moeten aangemaakt worden: Functie Naam Module wm2pmpins Personeelsinstellingen Persmaster b2b wm2pmljp Instellingen Persmaster b2b Maak deze aan vanuit menupad Systeem > Standaarden > Bedrijven > Bewerken > Uitvoeren > Programma: Bij naam uit te voeren procedure geeft u in: sys/daddfunk.r Bij parameters: a=b U komt vervolgens in een scherm terecht waar u de functies kunt aanmaken. 4 : 12
2.2 Menu wijzigingen Menupad Systeem > Standaarden > Menu Info voor Applicatiebeheerder De volgende inrichting dient plaats te vinden in het menu. Dit kan bijv. ingericht worden onder Systeem > Inrichting > B2B. Maak onder B2B een knop aan met 1. aanroep wm2pmpins, label Pers instelling 2. aanroep wm2pmljp, label Inst Persmaster 2.3 Ini file Info voor Applicatiebeheerder In de Metacom opstart directory dienen ini files geïnstalleerd te worden: m2pm.ini, m2pmmetacomza.ini en m2pm-metacoma.ini. Een voorbeeld van een ini file: ; ========================================================== ; file : mtf.ini, afgeleid van b2b.ini ; door : Van Meijel Automatisering BV ; doel : configuratie voor 'Business To Business' module ; opm : of deze file wordt gebruikt, is afhankelijk van de ; -param parameter die aan Progress is meegegeven: ; geen -param: gebruik m2p.ini ; -param test: gebruik m2p-test.ini ; -param cobra : gebruik m2c-cobra.ini 5 : 12
; enzovoorts ; ========================================================= ; sectie [algemeen] ; rootdirectory : locatie waar berichten worden gezocht en geschreven ; rootdirectory moet minstens de volgende subdirectories bevatten: ; inbox, outbox, backup-in, backup-out, rejected-in, log, tmp-out [algemeen] rootdirectory=g:\test60\m2pmdata ; sectie [backup-dagen] ; inbox : een bericht wordt zo veel dagen bewaard in backup-in vanaf het moment ; dat het bericht met succes is geimporteerd ; outbox: een bericht wordt zo veel dagen bewaard in backup-out vanaf het moment ; dat het bericht is aangemaakt [backup-dagen] inbox=14 outbox=21 2.4 Personeelsinstellingen Functionaliteit Nieuw Menupad Systeem > Inrichting > B2B > Pers instelling Info voor Applicatiebeheerder Richt in het scherm Personeelsinstellingen Persmaster in. 6 : 12
De volgende zaken kunnen ingericht worden: Personeel aanmaken Er worden personeelsleden aangemaakt of aangepast Kostensoort koppelen Dit is de functiecode in Polaris. De kostensoort wordt gekoppeld als standaard. Persoon aanmaken Er worden personen aangemaakt of aangepast. Contactpersoon aanmaken De persoon wordt aangemaakt als interne contactpersoon Samenstellen lange naam Bij de personeel en personen import geldt dat de samenstelling van de lange naam uit de xml gehaald kan worden (tag naamconventie) of via de naam samenstelling in Metacom wordt gevuld. Als ingesteld staat dat de lange naam wordt samengesteld a.d.h.v. de naamconventie uit de XML geldt het volgende: De waarde van dit veld kan 1, 2, 3 of 4 zijn. Regels samenstelling naam: 1. Eigennaam 2. Partnernaam + eigennaam 7 : 12
3. Eigennaam + partnernaam 4. Partnernaam Als de instelling staat op 'Gebruik naamsamenstelling Metacom' geldt dat de naam wordt samengesteld a.d.h.v. hetgeen ingesteld staat in menupad Systeem > Standaarden > Bedrijven > Instellingen > Relatiebeheer > Personen > Gegevens overnemen (naam lang vullen met). Telefoon en email niet overnemen Als deze optie aan staat, wordt personeel ingelezen zonder telefoonnummers en emailadressen. Adresgegevens niet overnemen Als deze optie aan staat, wordt personeel ingelezen zonder adres gegevens (inhoud van de velden adres, huisnummer, postcode, plaats en land worden genegeerd). Vertaaltabel voor bedrijf: Voor het importeren van stamgegevens personeel/personen kan ingesteld worden welke vertaaltabel voor de bedrijfscode moet worden toegepast in de personeelsinstellingen: "Bedrijf <-> organisatie"-> de bedrijfsid van het loonpakket wordt vertaald naar de bedrijfscode in Metacom. "Bedrijf <-> administratienummer"-> de vertaling wordt uitgevoerd op basis van de werknemersgroep zoals die wordt meegegeven vanuit het loonpakket Voor importeren personeel geldt het volgende: als de personeelscode wordt vertaald, wordt de contactpersoon ook mee vertaald. Rubriekvelden Er kan de koppeling gelegd worden tussen velden van Metacom en Persmaster. Alle velden die links staan, moeten in rubrieken vastgelegd worden in Metacom. In de kolom personen en/of personeel kan het betreffende veld in de rubriekboom geselecteerd worden. 2.5 Instellingen Persmaster Functionaliteit Nieuw Menupad Systeem > Inrichting > B2B > Inst Persmaster Info voor Applicatiebeheerder Stel indien nodig een afwijkend importpad in (tov het pad uit de ini file). Dit moet ingesteld worden per bedrijf: 8 : 12
2.6 Vertaaltabellen Functionaliteit Nieuw Menupad Systeem > Inrichting > B2B > Vertaaltabel Info voor Applicatiebeheerder Richt indien nodig de vertaaltabellen in. Er kunnen vertaaltabellen ingericht worden voor: Bedrijf <-> Organisatie Kostensoort <-> Functie Personeel <-> Personeel 9 : 12
3 Gebruik 3.1 Uitvoeren communicatie Functionaliteit Nieuw Menupad Systeem > Inrichting > B2B > Communicatie > Communicatie Info voor Gebruiker De import van de Persmaster bestanden in Metacom vindt plaats dmv het opstarten van de communicatie. In het communicatie scherm staat vermeld welke bestanden geimporteerd zijn en hoeveel sessies er inmiddels geweest zijn. 10 : 12
3.2 Voorbeeld bestand <XML> <PERS> <Bedrijf id="fvb04"> <Bedrijf_Spec> <Bedrijfsnr>FVB04</Bedrijfsnr> <WrkNmGroep>1000</WrkNmGroep> </Bedrijf_Spec> <Persnr id="220012"> <naam>de Vries</naam> <voorvoegsels>van</voorvoegsels> <voorletters>h.j.</voorletters> <naampartner>boer</naampartner> <voorvoegselspartner>t</voorvoegselspartner> <voorletterspartner>a</voorletterspartner> <naamsamenstelling>1</naamsamenstelling> <FunctieCode>14</FunctieCode> <FunctieCode_2></FunctieCode_2> <FunctieCode_3></FunctieCode_3> <FunctieCode_4></FunctieCode_4> <FunctieCode_5></FunctieCode_5> <Eenheid>uur</Eenheid> <TituVoor>Dhr</TituVoor> <Telefoon1>0318-115432</Telefoon1> <Telefoon2>06-11532201</Telefoon2> <Telefoon3>06-11532202</Telefoon3> <Telefoon4>5303050341</Telefoon4> <TelefoonType1>Thuis</TelefoonType1> <TelefoonType2>Mobiel</TelefoonType2> <TelefoonType3>Mobiel2</TelefoonType3> <TelefoonType4>Reg.nr.UVI</TelefoonType4> <IdNummer></IdNummer> <IdType>0</IdType> <EMailAdres>p@home.nl</EMailAdres> <EMailAdres2>p2@home.nl</EMailAdres2> <StartRel></StartRel> <Geslacht>1</Geslacht> <Sofi>89941123</Sofi> <Geboortedatum>05-03-1953</Geboortedatum> <Voornamen>Piet</Voornamen> <RoepNaam></RoepNaam> <TituAchter>DHR</TituAchter> <BurgerlijkeStaat>3</BurgerlijkeStaat> <Geboorteplaats>Emmeloord</Geboorteplaats> <Geboorteland>NL</Geboorteland> <DatumOverleden></DatumOverleden> <Nationaliteit></Nationaliteit> <BasisJubileum1>10-11-1980</BasisJubileum1> <Initialen>P.</Initialen> <RoepNaamPartner>Ans</RoepNaamPartner> <GeboorteDatumPartner>18-12-1955</GeboorteDatumPartner> 11 : 12
12 : 12 <VoornamenPartner>Ans</VoornamenPartner> <GeslachtPartner>0</GeslachtPartner> <EindeRel></EindeRel> <Adres>Arnhemseweg</Adres> <Huisnummer>2a</Huisnummer> <Postcode>6731 BS</Postcode> <Plaats>OTTERLO</Plaats> <Land></Land> <Ma>1</Ma> <Di>2</Di> <Wo>3</Wo> <Do>4</Do> <Vr>5</Vr> <Za>6</Za> <Zo>7</Zo> <DgWeekMw>5</DgWeekMw> <CodeActief>3</CodeActief> <AfwUrenBedr>0</AfwUrenBedr> <UurPerJaarMw>2096</UurPerJaarMw> <UurWeekMw>40</UurWeekMw> <DgPerJaarMw>262</DgPerJaarMw> <Stamsalaris></Stamsalaris> <DgDezePerMw>5</DgDezePerMw> <CodeSalUur>1</CodeSalUur> <DatumInAdmin>10-11-1980</DatumInAdmin> <DatumUitSalAdmin></DatumUitSalAdmin> <StamAfdeling>311</StamAfdeling> <PartPerc>100</PartPerc> <NettoUurLoon1></NettoUurLoon1> <NettoUurLoon2></NettoUurLoon2> <UurLoon1>14,09</UurLoon1> <UurLoon2></UurLoon2> <UurDezePerMw>40</UurDezePerMw> <Schaal></Schaal> <Trede></Trede> <Boekingsgegevens> <Bedrijf></Bedrijf> <Soort_boeking>c</Soort_boeking> <Grootboekrekening>491234</Grootboekrekening> <Subnivo_1>10</Subnivo_1> <Subnivo_2>2702159</Subnivo_2> <Type>p</Type> <Waarde>0,00</Waarde> </Boekingsgegevens> </Persnr> </Bedrijf> </PERS> </XML>