[[TOC(heading=ZG-Module)]]
[[TOC(heading=Moduleconfiguratie, sectionindex, compact, depth=3, allactive, Documentatie/Beheerder/Modules/)]]
[[TOC(heading=Beheerder, sectionindex, compact, depth=2, allactive, indirect=Documentatie/Beheerder/TOC)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= ZG-module =

== Inrichting ==
Zie [wiki:Documentatie/Beheerder/Modules/Agendаserver Installatie Server] voor de installatiehandleiding.

Zie [wiki:Documentatie/Gebruiker/ZgDossier ZG-dossier] voor een functionele beschrijving van het ZG-dossier.

=== Configuratiebestanden ===
De locatie van de OpenAC 3 configuratiebestanden kun je terugvinden op de /status pagina. Voor de ZG-module zijn de volgende configuratiebestanden van belang:
* appsettings.json - het algemene configuratiebestand van OpenAC 3
* zg_stamtabellen.json - de stamtabellen van de ZG-module.

=== Financieringsbronnen ===
In de configuratie van de ZG-module kan worden opgegeven bij welke financieringsbronnen ZG-activiteiten mogen worden geregistreerd. Dat kan in appsettings.json in de sectie ZG/Financieringsbronnen.

{{{
  "ZG": {
    "Financieringsbronnen": [
      {
        "Key": "awbz_gb",
        "Omschrijving": "ZG SGB",
        "AgbCode":  "12345678"
      },
      {
        "Key": "awbz_hac",
        "Omschrijving": "ZG Adelante",
        "AgbCode":  "87654321"
      }
    ]
  },

}}}

Let op: de key moet voorkomen in de OpenAC codetabel financieringsbron!

=== Verdichtingcodes ===
De volgende verdichtingcodes worden gebruikt:
||TIJDSCHRIJVEN_DIRECT_DECLARABEL (F)||1210||
||TIJDSCHRIJVEN_INDIRECT_DECLARABEL (G)||2210||
||TIJDSCHRIJVEN_INDIRECT_NIET_DECLARABEL (H)||2236||
||TIJDSCHRIJVEN_REISTIJD (I)||3300||

=== Kantoor werktijden===
De default werktijden zijn op dit moment ingesteld tussen 08:00 en 23:00 uur. Als echter de werktijden bij de instelling anders zijn, kan je die in de configuratie van de ZG-module aanpassen. Dat kan in appsettings.json in de sectie ZG/Werktijden.

{{{
  "ZG": {
    "Financieringsbronnen": [
      {
        "Key": "awbz_gb",
        "Omschrijving": "ZG SGB",
        "AgbCode":  "12345678"
      },
      {
        "Key": "awbz_hac",
        "Omschrijving": "ZG Adelante",
        "AgbCode":  "87654321"
      }
    ],
    "Werktijden": {
      "Begin": "08:00",
      "Eind":  "23:00"
    }
  },
}}}

=== Koppeling activiteiten en zorgmodules ===
In het ZG-dossier worden activiteiten geregistreerd in een geopende behandelmodule.

Activiteiten worden echter niet alleen in het ZG-dossier geregistreerd, maar ook bij afspraken in de OpenAC agenda. De agenda weet niets van ZG-behandelmodules. Dat maakt een koppeling tussen ZG-activiteiten en behandelmodules noodzakelijk. De ZG-module moet uit in de agenda geregistreerde activiteiten kunnen afleiden aan welke behandelmodule deze moeten worden toegewezen.

Per behandelmodule kan worden aangegeven welke activiteiten mogen worden geregistreerd. Hierdoor kan één activiteit aan meerdere behandelmodules zijn gekoppeld.
De toewijzing van de behandelmodule aan de activiteit wordt vastgelegd in het tijdvak.

==== Automatische toewijzing ====
In veel gevallen zijn activiteiten maar aan één behandelmodule gekoppeld. Deze activiteiten zullen bij registratie automatisch aan een behandelmodule worden toegewezen.
Soms kunnen activiteiten die aan meerdere behandelmodules zijn gekoppeld ook automatisch worden toegewezen, bijvoorbeeld als de datum van de geregistreerde activiteit in de looptijd van maar één behandelmodule valt.

==== Handmatige toewijzing ====
Activiteiten die aan meerdere behandelmodules zijn gekoppeld kunnen bij registratie niet automatisch worden toegewezen. In het ZG-dossier komt een overzicht met activiteiten die nog niet aan een behandelmodule zijn toegewezen. Het overzicht bevat de volledige tijdvakinformatie: datum, begintijd, eindtijd, activiteit en medewerkers. Met behulp van vinkjes kunnen één of meerdere tijdvakken worden geselecteerd en toegewezen aan een behandelmodule.

==== Niet-patiëntgebonden activiteiten ====
Niet-patiëntgebonden activiteiten worden op dezelfde manier als cliëntgebonden activiteiten automatisch dan wel handmatig toegewezen aan een behandelmodule. In de rapportage wordt een verdeelsleutel toegepast met behulp van een bij medewerkers ingevoerde percentuele werkverdeling per financieringsbron (reeds gerealiseerd).

== Migratie ==
Voor het migreren van oude naar nieuwe ZG-activiteiten in een script beschikbaar: zg_activiteitmigratie

Voordat het script kan worden uitgevoerd moet in OpenAC 2 eerst de codetabel kern.d080_zg/Activiteitmigratie worden gevuld. In deze codetabel kan voor elke oude ZG-activiteit een nieuwe activiteit worden opgegeven waar naartoe gemigreerd moet worden.

Het migratiescript migreert voor alle ZG-trajecten de activiteiten die zijn opgenomen in de migratietabel. Alle afspraken en bezoeken later dan 1-1-2017 worden hierbij meegenomen.

Start het migratiescript met python27\python script.py zg_activiteitmigratie vanuit de OpenAC map. Zie ook ticket #10396.

== JSON Query's voor veld zg_behandeltraject_body ==
Om performance redenen wordt (een gedeelte van het) ZG-dossier als JSON opgeslagen in het veld zg_behandeltraject_body.

In recente versies van SQL Server is het mogelijk om met query's gegevens uit de JSON te halen. Zie hiervoor de documentatie van SQL Server. Als voorbeeld:
{{{#!sql
SELECT zg_behandeltraject_patient_key,
 JSON_VALUE(zg_behandeltraject_body,'$.Financieringsbron') AS Financieringsbron,
 JSON_Value(zg_behandeltraject_body, '$.Clientprofiel.Naam') As Clientprofiel,
 JSON_QUERY(zg_behandeltraject_body, '$.Scorekaart') As Scorekaart
FROM zg_behandeltraject_data
WHERE  JSON_VALUE(zg_behandeltraject_body,'$.Financieringsbron') is not NULL
}}}

Heeft de volgende uitput:

[[Image(json_query_resultaat.png)]]