XML-output formulieren

Notitie Deze handleiding kan je vanuit ANVA Help afdrukken .

Inleiding XML-output formulieren

Met deze module kunnen de ANVA-labels die voorkomen in de ANVA-formulieren worden geëxporteerd naar een XML-bestand, zodat deze in een andere applicatie verwerkt kunnen worden tot opgemaakte documenten.

Inrichting XML-output formulieren

Stappenplan inrichting XML-output formulieren

Formulieren in XML-output activeren

Pad BYSA, deel 2

Alleen een ANVA-medewerker kan in dit pad de module Formulieren in XML-output activeren.

Instellingen ‘Formulieren in XML-output’

Na activering van de module is een aantal instellingen voor de ‘Formulieren in XML-output’ nodig.

Pad BFVX

Linux-instellingen: output-locatie koppelen aan een Windows-share

Bij gebruik van ANVA op Linux-platformen, moet u de outputlocatie koppelen aan een Windows-share. Dit gebeurt met behulp van het CIFS-protocol. Neem voor de inrichting hiervan contact op met uw beheerder. Volg de volgende stappen:

1. Maak op het Windows-domein een service-account of user-account aan waarvan het wachtwoord niet mag verlopen.
2. Geef dit account lees-, bewerk- en schrijfrechten op de Windows-share waar de XML-output voor formulieren vanuit ANVA terecht moeten komen.
3. Maak op Linux een mappenstructuur aan. Wij adviseren dit buiten de map /anva-apps/data te houden, bijvoorbeeld: /anva-apps/xml/. De eigenaar moet gebruiker "nva001" en groep "anva" zijn.
4. Regel in Linux dat de Windows-share met CIFS wordt gekoppeld onder /anva-apps/xml.
5. Als de share werkt, voeg deze dan toe in /etc/fstab.
   Zie een voorbeeld hieronder. Dit kan per Linux-versie verschillen.
6. Maak op de Windows-share mappen aan per dataset, bijvoorbeeld data1, data2, etc.
7. Stel de map /anva-apps/xml/data1 in als Locatie in pad BFVX (zie: 'Instellingen ‘Formulieren in XML-output’') .
   Als u met meer datasets met XML-output formulieren werkt, moet de locatie hierop worden aangepast.

Voorbeeldregel /etc/fstab:

//winserver/share /anva-apps/xml cifs uid=nva001,username=winuser,password=wachtwoord 0 0

Aansturing per formuliersoort

Voor het aansturen per formuliersoort moet u nieuwe formuliersoorten en/of nummers aanmaken. U kunt hiervoor gewoon een bestaande formuliersoort kopiëren. Zie Formuliersoorten voor meer informatie. De nieuw aangemaakt formuliersoort kunt u vervolgens inregelen voor XML-output.

Aan te bevelen is de inregeling uitsluitend per formuliernummer te doen (pad BFVF, zie hoofdstuk: 'Aansturing per formuliernummer'.

Pad BFVS

1. Open de formuliersoort.
2. Kies de knop Defaultwaarden.
3. Kies bij XML-output voor Ja om aan te geven dat de desbetreffende formulieren in XML-output beschikbaar moet worden gesteld.

   

4. Klik op Afsluiten .
5. Antwoord Ja op de vraag:

   'De mutaties van de defaultwaarden doorvoeren in de basisgegevens van de formulieren?'.

Aansturing per formulier

Afhankelijk van de defaultwaarde in pad BFVS en de keuze om deze door te voeren in de formulieren, kunt u in dit pad per formulier een afwijkende instelling ingeven.

Pad BFVF

1. Open het formulier dat u wilt aanpassen.
2. Ga naar menu Formulier – Basisgegevens.
3. Klik op menu op XML-gegevens.

   

4. Vul het veld Naam 'Root element' van de XML-output voor dit formulier in.

   

   Veld	Betekenis
   Naam ‘Root element’	De naam van het root-element voor dit formulier is vrij in te geven, het is geen codetabel. Als hier niets is ingevuld, wordt in de Output <Root> als root-element gebruikt.

Extra tags toevoegen aan een XML-formulier

Het is mogelijk om in een formulier vaste XML-tags met inhoud mee te geven, die worden opgenomen in de XML-output. Voorbeelden hiervan zijn het formuliernummer en formuliersoortnummer. Dit kunt u gebruiken voor herkenning bij de verwerking in bijvoorbeeld Planet Press.

Pad: BFVF

1. Open het formulier dat u wilt aanpassen.
2. Ga naar menu Acties - Basisgegevens.
3. Ga naar menu XML-gegevens.
4. Klik op XML valideren. ANVA controleert of de xml-tags juist ingevoerd zijn. Dit gebeurt ook bij het afsluiten van het scherm.

   Na het opbouwen van het bijbehorende formulier, worden de tags bovenin de XML-output geplaatst.

     

Voorbeeld

Een voorbeeld van de output van de XML-gegevens van bovenstaand scherm ziet er zo uit:

<?xml version="1.0" encoding="utf-8"?>

<test>

<XMLvoorbeeld>test</XMLvoorbeeld>

<L99907></L99907>

<L99902>Caf&#195;&#169; 2 Jacks</L99902>

<L99901>2 Jacks</L99901>

<L99903>Van Heukelomstraat 5</L99903>

<L99904>6006 JS Weert</L99904>

<L97020>15 december 2016</L97020>

<L00001>1004602</L00001>

<L10004>BHA0012829DR</L10004>

<L97103 Code="ANVA" Omsch="Anva" />

<L00006 Code="" Omsch="" />

<L97103 Code="ANVA" Omsch="Anva" />

</test>

Labelspecifieke instellingen voor XML-output formulieren

Let op dat in een labelcodering geen / of \ gebruikt is. Deze tekens hebben in XML een andere betekenis.

Pad: BPP.., BFVF, BFVBB

Per label kunnen de volgende XML-specificaties worden doorgegeven:

1. Kies een waarde in Weergave.

   Keuze	Resultaat
   Omschrijving	<L Nr="00038" Code="NL" Omsch="Nederland"/>
   Code	<L Nr="00038">NL</L>

2. Kies een waarde in veld Weergave indien label niet gevuld. Als deze op Regel verwijderen of Lege regel afdrukken wordt gezet, wordt het label (indien leeg) niet als element in de XML opgenomen.

   

Clausules op het polisvolgblad

Van de polisvolgbladen wordt alleen de tekst zoals deze in de polisvolgbladen staat, overgenomen. Van alle clausules (label 98125 Clausules pakketpolisvolgblad) is op de polis zelf de informatie al beschikbaar, en deze worden daarom niet extra in het polisvolgblad meegegeven.

Uitzondering is het polisvolgblad gebaseerd op label 99861 ‘Polisvolgblad (body). Dan kun je in de polisblad-XML ook de inhoud van de body van het polisvolgblad meenemen.

Notitie Standaard staat de optie Clausuleteksten in XML-output op Nee bij label 98125 Clausules pakketpolisvolgblad. Het is mogelijk om collectief in te stellen dat de clausules wel meegenomen worden in de XML-output. Dit geldt dan voor alle volgbladen via XML. Je kunt hiervoor contact opnemen met ANVA Customer Support. Je maakt een ticket aan en een medewerker neemt contact met je op om een correctieprogramma te draaien.

Pad: BPP..

Voorbeeld

Het XML-formulier opbouwen

Bij de opbouw van formulieren in ANVA wordt er voor elk document een eigen XML-bestand aangemaakt in de map die in pad BFVX is aangegeven. De volgende melding verschijnt:

'Het formulier is als XML-bestand aangemaakt:
/anva/anva-apps/data/data1/werk/M-xxxxxxxxxxx-xxxxxxxxxxxxxx-xxx.XML'

Middels aanvullend maatwerk kunnen de outputbestanden verplaatst worden naar een locatie buiten ANVA.

Bestandsnaam XML-Output

Ieder XML-document krijgt zijn eigen unieke naam, bijvoorbeeld:

M-PAKOP00001-20100709141937-000.XML

Indeling XML-Output

De kopteksten en voetteksten worden niet in het beheer van het XML-document opgenomen. Het gevolg is dat de XML feitelijk alleen de body is.

Als u toch kop- en/of voetteksten opneemt, dan worden de velden van deze onderdelen wel in de XML-output opgenomen, maar NIET van aparte tags voorzien. Hierdoor ziet u geen overgang van ‘Kop’ naar 'Kopvervolg'.

Tags voor bodyblokken

In de XML-output worden voor en ná de volgende bodyblokken automatisch <tags> en </tags> geplaatst

• Pakket
• Polis
• Dekking
• DekkingHist
• Object
• SchadePolis
• Werknemer
• Factuur

Resultaatvelden

In een formulier kunnen maximaal 99 resultaatvelden worden opgenomen. Deze komen in de output-file terug als:

<R Nr="21">123,45</R>

of

<R21>123,45</R21>

Voorbeeld: polisblad in XML-output

Voorbeeld: een polisblad met twee dekkingen en factuurgegevens. In XML-output is het resultaat als volgt:

Bestand M-POLIS00001-20120930234812-000.XML

<?xml version="1.0" encoding="UTF-8" ?>

- <Polis>

<L Nr="10142" Code="02100" Omsch="Personenauto" />

<L Nr="00001">51</L>

<L Nr="99902">P.R. Zaagsma</L>

<L Nr="99903">'t Erf 10</L>

<L Nr="99904">9999 JK MEULENHOEK</L>

<L Nr="10004">B400-100059</L>

<L Nr="10179">1</L>

<L Nr="10017" Code="00001" Omsch="Nieuwe polis nieuwe relatie" />

<L Nr="99902">P.R. Zaagsma</L>

<L Nr="10004">B400-100059</L>

<L Nr="00001">51</L>

<L Nr="10008">01-06-2012</L>

<L Nr="10147">01-06-2013</L>

<L Nr="10031">01-06-2013</L>

<L Nr="10009">12</L>

- <Polis>

<L Nr="10018">Trabant Future GT2000 Cabrio</L>

<L Nr="10033">11-22-33</L>

<L Nr="10038">800</L>

<L Nr="10034">2012</L>

<L Nr="10043">150,00</L>

<L Nr="10044" />

<L Nr="10007">12</L>

- <Dekking>

<L Nr="99042" Code="02010" Omsch="W.A." />

<L Nr="10042">2.500.000,00</L>

<L Nr="99046">286,50</L>

</Dekking>

- <Dekking>

<L Nr="99042" Code="02030" Omsch="Casco" />

<L Nr="10040">12.000,00</L>

<L Nr="99046">521,00</L>

</Dekking>

</Polis>

<L Nr="10698" Code="PV001" Omsch="Polisvoorwaarde 1" />

<L Nr="10699" Code="PV008" Omsch="Polisvoorwaarde 8" />

<L Nr="10703">CL011</L>

<L Nr="99930">01-06-2012</L>

<L Nr="10006">01-06-2013</L>

<R Nr="99">Nihil</R>

<L Nr="93043">0,00</L>

<L Nr="93045">0,00</L>

<L Nr="93046">0,00</L>

<L Nr="93041">0,00</L>

<L Nr="97028">Amersfoort</L>

<L Nr="97022">30-09-2012</L>

<L Nr="97011" Code="00010" Omsch="Kantoor 10" />

</Polis>

Opbouwen afgeroepen formulieren

Pad: DO

Indien formulieren via de menuoptie DO worden opgebouwd (vanuit selecties of prolongaties), dan wordt de XML-output per formulier aangemaakt. Voor elk formulier wordt dus een apart XML-bestand gecreëerd.

Bij prolongatieformulieren wordt een letter P in de eerste positie van de bestandsnaam geplaatst (in plaats van M).

XML-document in het ANVA-dossier

In het ANVA-dossier wordt een regel opgenomen met bronindicatie XML.

Na [Enter] op deze regel is de inhoud van het XML-document zichtbaar, indien de externe locatie vastgelegd is in het dossier.