Koppelprofiel Key2Financien: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Beheer en onderhoud)
(LET OP: deze koppeling is niet meer in gebruik. Wil je alsnog koppelen met Key2Financien, neem dan contact op met Zaaksysteem om een alternatieve implementatie af te stemmen.)
 
(11 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
 
__TOC__
 
__TOC__
  
 +
===LET OP: deze koppeling is niet meer in gebruik. Wil je alsnog koppelen met Key2Financien, dan is er een softwareaanpassing nodig.===
  
 
= Inleiding =
 
= Inleiding =
 
Dit is een export feature die zaken met financiele informatie exporteert, en na een complete export de zaken sluit.<br>
 
Dit is een export feature die zaken met financiele informatie exporteert, en na een complete export de zaken sluit.<br>
  
= Inrichting zaaksysteem =
+
= Koppelprofiel =
 
=====Configuratie=====
 
=====Configuratie=====
Maak eerst een exportprofiel aan:<br>
+
{| width="100%"
 +
|- style="vertical-align:top;"
 +
|Maak eerst een exportprofiel aan:<br>
 
<ul>
 
<ul>
 
<li>Ga naar het configuratiescherm en klik op de plusknop</li>
 
<li>Ga naar het configuratiescherm en klik op de plusknop</li>
Regel 13: Regel 16:
 
<li>Geef een naam op, bijvoorbeeld die van het product in kwestie</li>
 
<li>Geef een naam op, bijvoorbeeld die van het product in kwestie</li>
 
</ul>
 
</ul>
<br>
+
|[[bestand:Koppeling nieuw.png|thumb|Koppeling toevoegen]]
[[bestand:Koppeling nieuw.png]]<br>
+
|}
<br>
+
{|
Stel nu de volgende instellingen in:
+
|- style="vertical-align:top;"
 +
|Stel nu de volgende instellingen in:
 
<ul>
 
<ul>
 
<li>Geef een API key op, met de key kan een externe partij authenticeren.<br>Een goede method om een key te genereren is een GUID tool zoals  
 
<li>Geef een API key op, met de key kan een externe partij authenticeren.<br>Een goede method om een key te genereren is een GUID tool zoals  
 
http://www.guidgenerator.com</li>
 
http://www.guidgenerator.com</li>
<li>Kies een zaaktype waarop gefilterd moet worden. De exportmodule zal alle zaken selecteren van dat zaaktype die klaar staan om afgerond te worden. Dat wil o.a. zeggen dat een resultaat ingevuld is, alle verplichte velden aanstaan en de zaak in de laatste fase is.</li>
+
<li>Kies een zaaktype waarop gefilterd moet worden. De exportmodule zal alle zaken selecteren van dat zaaktype die klaar staan om afgerond te worden. Dat wil o.a. zeggen dat een resultaat ingevuld is, alle verplichte velden aanstaan, de zaak in de laatste fase is en de status van de zaak 'in behandeling' is.</li>
 
<li>Stel vervolgens de gegevensmapping in. Een uitgebreide beschrijving hiervan volgt hieronder.</li>
 
<li>Stel vervolgens de gegevensmapping in. Een uitgebreide beschrijving hiervan volgt hieronder.</li>
 
<li>Activeer de koppeling</li>
 
<li>Activeer de koppeling</li>
 
</ul>
 
</ul>
<br>
+
|[[bestand:Koppelingen key2finance.png|thumb|Koppeling beheren]]
[[bestand:Koppelingen key2finance.png]]<br>
+
|}
<br>
+
{|
In de gegevensmapping worden twee kolommen getoond. De linkerkolom toont de namen van de 'kolommen' van het CSV bestand. De rechterkolom moet ingevuld worden met de (systeem)kenmerken. Bij de export wordt de data uit die kenmerken geplaatst in de kolommen van het CSV bestand.<br>
+
|- style="vertical-align:top;"
<br>
+
|In de gegevensmapping worden twee kolommen getoond. De linkerkolom toont de namen van de 'kolommen' van het CSV bestand. De rechterkolom moet ingevuld worden met de (systeem)kenmerken. Bij de export wordt de data uit die kenmerken geplaatst in de kolommen van het CSV bestand.
[[bestand:Koppelingen gegevensmapping key2finance.png]]<br>
+
|[[bestand:Koppelingen gegevensmapping key2finance.png|thumb|Gegevensmapping]]
<br>
+
|}
  
 
=====Gegevens uit gerelateerde zaken=====
 
=====Gegevens uit gerelateerde zaken=====
Regel 51: Regel 55:
 
</pre>
 
</pre>
  
=====Geautomatiseerde uitvoer=====
+
= Export =
Er is ook een pythonscript beschikbaar om de bovenstaande handelingen geautomatiseerd uit te voeren:
 
[http://zaaksysteem.nl/wp-dev/wp-content/uploads/2013/10/export_key2finance.zip Download Pythonscript]<br>
 
<ul>
 
<li>Eenmalig: [http://www.python.org/download/ Installeer python]</li>
 
<li>Eenmalig: Voeg de URL naar de programmamap toe in Path (zie screenshot 1)</li>
 
<li>Open het bestand in een tekstverwerker, zoals kladblok of notepad++</li>
 
<li>Vervang '<base_url> <interface_id> <api_key>' met de juiste gegevens (gescheiden door spatie) (zie screenshot 2)</li>
 
<li>Roep het bestand aan door in cmd.exe naar de juiste folder te browsen en in te typen: 'python' <bestandsnaam> (zie screenshot 3)</li>
 
</ul>
 
<br>
 
<gallery widths=200px heights=200px>
 
File:Koppeling_key2fin_pythonscript_instelling.png|Instelling voor pythonscript
 
File:Koppeling_key2fin_pythonscript_notepad_.png|Variabele pythonscript in Notepad++
 
File:Koppeling_key2fin_pythonscript_dos.png|Pythonscript aanroepen
 
</gallery>
 
<br>
 
 
 
= Inrichting extern systeem =
 
= Testscenario =
 
== Koppelprofiel beheren ==
 
== Meldingen behandelen ==
 
= Beheer en onderhoud =
 
 
===== Handmatige uitvoer=====
 
===== Handmatige uitvoer=====
 
Het uitvoeren van de export bestaat uit 4 stappen. Elke stap is het invoeren van een URL in de navigatiebalk van de browser. In de URL's moeten verschillende variabele handmatig worden ingevoerd. Vervang hiervoor simpewel '<u><dit></u>' gedeelte door de variabele, bijvoorbeeld: '<u>52</u>'<br>
 
Het uitvoeren van de export bestaat uit 4 stappen. Elke stap is het invoeren van een URL in de navigatiebalk van de browser. In de URL's moeten verschillende variabele handmatig worden ingevoerd. Vervang hiervoor simpewel '<u><dit></u>' gedeelte door de variabele, bijvoorbeeld: '<u>52</u>'<br>
Regel 82: Regel 64:
 
|-
 
|-
 
| <omgeving>
 
| <omgeving>
| De gemeentenaam uit de zaaksysteem-URL: <u>gemeentenaam</u>.zaaksysteem.nl
+
| De gemeentenaam uit de zaaksysteem-URL: <u>gemeentenaam.zaaksysteem.nl</u>, <u>mijn.gemeentenaam.nl</u>, <u>zaaksysteem-accept.gemeentenaam.nl</u>
 
|-
 
|-
 
| <interface_id>
 
| <interface_id>
Regel 91: Regel 73:
 
|-
 
|-
 
| <transactionID>
 
| <transactionID>
| Deze is terug te vinden onderaan de pagina die getoond wordt na het invoeren van de eerste URL
+
| Wanneer de eerste URL wordt uitgevoerd wordt de transactie aangemaakt. Op die pagina wordt eerst alle opgehaalde zaakinformatie getoond, gevolgd door de transactieinformatie. Hier staat het 'transactionID' vermeld bij 'id'
 
|}
 
|}
 
<ol>
 
<ol>
 
<li><b>Transactie klaarzetten:</b><br>
 
<li><b>Transactie klaarzetten:</b><br>
https://<u><omgeving></u>.zaaksysteem.nl/sysin/interface/<u><interface_id></u>/trigger/set_case_list?api_key=<u><api_key></u><br>
+
https://<u><omgeving></u>/sysin/interface/<u><interface_id></u>/trigger/set_case_list?api_key=<u><api_key></u><br>
 
<br>
 
<br>
 
Helemaal onderaan staat het ‘transaction_id’, welke nodig is in de volgende stappen.<br>
 
Helemaal onderaan staat het ‘transaction_id’, welke nodig is in de volgende stappen.<br>
 
</li><br>
 
</li><br>
 
<li><b>STDDEB.csv downloaden</b><br>
 
<li><b>STDDEB.csv downloaden</b><br>
https://<u><omgeving></u>.zaaksysteem.nl/sysin/interface/<u><interface_id></u>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
+
https://<u><omgeving></u>/sysin/interface/<u><interface_id></u>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
 
</li><br>
 
</li><br>
 
<li><b>STDNAW.csv downloaden</b><br>
 
<li><b>STDNAW.csv downloaden</b><br>
https://<u><omgeving></u>.zaaksysteem.nl/sysin/interface/<u><interface_id></u>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
+
https://<u><omgeving></u>/sysin/interface/<u><interface_id></u>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
 
</li><br>
 
</li><br>
 
<li><b>Transactie afsluiten</b><br>
 
<li><b>Transactie afsluiten</b><br>
https://<u><omgeving></u>.zaaksysteem.nl/sysin/interface/<u><interface_id></u>/trigger/close_cases?transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
+
https://<u><omgeving></u>/sysin/interface/<u><interface_id></u>/trigger/close_cases?transaction_id=<u><transactionID></u>&api_key=<u><api_key></u><br>
 
<br>
 
<br>
 
Dit maakt de transactie af, en sluit de geexporteerde zaken.<br>
 
Dit maakt de transactie af, en sluit de geexporteerde zaken.<br>
Regel 112: Regel 94:
 
</li>
 
</li>
 
<pre>
 
<pre>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>
+
https://<omgeving>/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
+
https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
+
https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
https://<omgeving>.zaaksysteem.nl/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>
+
https://<omgeving>/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>
 
</pre>
 
</pre>
 
</ol>
 
</ol>
  
= Voorbeeldbestanden =
+
===== Geautomatiseerde uitvoer=====
= Overige documentatie =
+
{|
 +
|- style="vertical-align:top;"
 +
|Er is ook een pythonscript beschikbaar om de bovenstaande handelingen geautomatiseerd uit te voeren:
 +
[http://zaaksysteem.nl/wp-dev/wp-content/uploads/2013/10/export_key2finance.zip Download Pythonscript]<br>
 +
<ul>
 +
<li>Eenmalig: [http://www.python.org/download/ Installeer python]</li>
 +
<li>Eenmalig: Voeg de URL naar de programmamap toe in Path (zie screenshot 1)</li>
 +
<li>Open het bestand in een tekstverwerker, zoals kladblok of notepad++</li>
 +
<li>Vervang '<base_url> <interface_id> <api_key>' met de juiste gegevens (gescheiden door spatie) (zie screenshot 2)</li>
 +
<li>Roep het bestand aan door in cmd.exe naar de juiste folder te browsen en in te typen: 'python' <bestandsnaam> (zie screenshot 3)</li>
 +
</ul>
 +
<br>
 +
|[[bestand:Koppeling_key2fin_pythonscript_instelling.png|thumb|Instelling voor pythonscript]]
 +
|[[bestand:Koppeling_key2fin_pythonscript_notepad_.png|thumb|Variabele pythonscript in Notepad++]]
 +
|[[bestand:Koppeling_key2fin_pythonscript_dos.png|thumb|Pythonscript aanroepen]]
 +
|}

Huidige versie van 4 sep 2019 om 06:16

LET OP: deze koppeling is niet meer in gebruik. Wil je alsnog koppelen met Key2Financien, dan is er een softwareaanpassing nodig.

Inleiding

Dit is een export feature die zaken met financiele informatie exporteert, en na een complete export de zaken sluit.

Koppelprofiel

Configuratie
Maak eerst een exportprofiel aan:
  • Ga naar het configuratiescherm en klik op de plusknop
  • Selecteer het type 'Key2Finance'
  • Geef een naam op, bijvoorbeeld die van het product in kwestie
Koppeling toevoegen
Stel nu de volgende instellingen in:
  • Geef een API key op, met de key kan een externe partij authenticeren.
    Een goede method om een key te genereren is een GUID tool zoals http://www.guidgenerator.com
  • Kies een zaaktype waarop gefilterd moet worden. De exportmodule zal alle zaken selecteren van dat zaaktype die klaar staan om afgerond te worden. Dat wil o.a. zeggen dat een resultaat ingevuld is, alle verplichte velden aanstaan, de zaak in de laatste fase is en de status van de zaak 'in behandeling' is.
  • Stel vervolgens de gegevensmapping in. Een uitgebreide beschrijving hiervan volgt hieronder.
  • Activeer de koppeling
Koppeling beheren
In de gegevensmapping worden twee kolommen getoond. De linkerkolom toont de namen van de 'kolommen' van het CSV bestand. De rechterkolom moet ingevuld worden met de (systeem)kenmerken. Bij de export wordt de data uit die kenmerken geplaatst in de kolommen van het CSV bestand.
Gegevensmapping
Gegevens uit gerelateerde zaken

Gegevens uit gerelateerde zaken kunnen opgehaald worden door gebruik te maken van de iteratie-functie, die specifiek voor deze export mogelijk gemaakt is.

Door in een groot tekstveld dezelfde iteratie-syntax te gebruiken als bij e-mailsjablonen worden de magicstrings verwerkt voor de gerelateerde zaken, i.p.v. voor de zaak zelf.

{{ itereer over zaak_relaties
<willekeurige tekst>
}}

Bijvoorbeeld:

{{ itereer over zaak_relaties
[[zaak_bedrag]]
}}

Export

Handmatige uitvoer

Het uitvoeren van de export bestaat uit 4 stappen. Elke stap is het invoeren van een URL in de navigatiebalk van de browser. In de URL's moeten verschillende variabele handmatig worden ingevoerd. Vervang hiervoor simpewel '<dit>' gedeelte door de variabele, bijvoorbeeld: '52'

Variabele Locatie
<omgeving> De gemeentenaam uit de zaaksysteem-URL: gemeentenaam.zaaksysteem.nl, mijn.gemeentenaam.nl, zaaksysteem-accept.gemeentenaam.nl
<interface_id> Het cijfer dat achter de naam van de koppeling wordt weergegeven, in het configuratiescherm
<api_key> De opgegeven tekst in het API-veld de koppeling, in het configuratiescherm
<transactionID> Wanneer de eerste URL wordt uitgevoerd wordt de transactie aangemaakt. Op die pagina wordt eerst alle opgehaalde zaakinformatie getoond, gevolgd door de transactieinformatie. Hier staat het 'transactionID' vermeld bij 'id'
  1. Transactie klaarzetten:
    https://<omgeving>/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>

    Helemaal onderaan staat het ‘transaction_id’, welke nodig is in de volgende stappen.

  2. STDDEB.csv downloaden
    https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>

  3. STDNAW.csv downloaden
    https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>

  4. Transactie afsluiten
    https://<omgeving>/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>

    Dit maakt de transactie af, en sluit de geexporteerde zaken.
    Let op: Fase acties worden niet uitgevoerd. De zaak wordt afgesloten dmv. de vroegtijdig afsluiten methode.
  5. https://<omgeving>/sysin/interface/<interface_id>/trigger/set_case_list?api_key=<api_key>
    https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_deb?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
    https://<omgeving>/sysin/interface/<interface_id>/trigger/get_csv_naw?zapi_format=csv&transaction_id=<transactionID>&api_key=<api_key>
    https://<omgeving>/sysin/interface/<interface_id>/trigger/close_cases?transaction_id=<transactionID>&api_key=<api_key>
    
Geautomatiseerde uitvoer
Er is ook een pythonscript beschikbaar om de bovenstaande handelingen geautomatiseerd uit te voeren:

Download Pythonscript

  • Eenmalig: Installeer python
  • Eenmalig: Voeg de URL naar de programmamap toe in Path (zie screenshot 1)
  • Open het bestand in een tekstverwerker, zoals kladblok of notepad++
  • Vervang '<base_url> <interface_id> <api_key>' met de juiste gegevens (gescheiden door spatie) (zie screenshot 2)
  • Roep het bestand aan door in cmd.exe naar de juiste folder te browsen en in te typen: 'python' <bestandsnaam> (zie screenshot 3)


Instelling voor pythonscript
Variabele pythonscript in Notepad++
Pythonscript aanroepen