diff --git a/docs/beheerhandleiding/09_datakoppelingen.rst b/docs/beheerhandleiding/09_datakoppelingen.rst index 6ed2f3b0e5..f9748cfb29 100644 --- a/docs/beheerhandleiding/09_datakoppelingen.rst +++ b/docs/beheerhandleiding/09_datakoppelingen.rst @@ -120,17 +120,31 @@ Stappen voor importeren: attributen die ertoe leidde dat bepaalde objecten niet gevonden konden worden, zullen zoveel mogelijk worden vermeld. -9.2. Configuratie ‘Open Klant’ -============================== +9.2. Configuratie Klanten Systeem +================================= -Dit is de configuratie voor de koppeling van het Open Inwoner platform met Open Klant. Om Mijn -Aanvragen te kunnen gebruiken is het noodzakelijk om de Open Zaak API en de Contactmomenten API in -te stellen. Hierdoor worden – na het inloggen met DigiD - de aanvragen van burgers getoond onder het -onderdeel Mijn aanvragen onder het uitvouwmenu bij de gebruikersnaam. +Dit is de configuratie voor de koppeling van het Open Inwoner Platform met een klantensysteem, +zoals eSuite of OpenKlant2. Indien één of beide systemen zijn geconfigureerd, worden klantgegevens +(zoals e-mailadres en telefoonnummer) met deze systemen uitgewisseld. Deze systemen zijn +ook noodzakelijk om gebruik te kunnen maken van het "Mijn Vragen" gedeelte van het platform. -.. image:: images/image63.png - :width: 624px - :height: 350px +In het hoofdscherm is het belangrijk om een "primaire" backend te kiezen. Dit is de +backend waaruit klantgegevens worden uitgelezen en waarin nieuwe vragen in "Mijn Vragen" +worden aangemaakt. + +Het wegschrijven van klantgegevens gebeurt altijd naar alle geconfigureerde backends tegelijk, +maar voor het bijwerken van de klantgegevens op basis van het klantensysteem zal alleen naar +de primaire backend worden gekeken. + +U dient eerst de betreffende backends via de daarvoor bestemde links te configureren. +Vervolgens kunt u een primaire backend selecteren via het dropdown-menu. + +.. image:: images/image144.png + :width: 695px + :height: 394px + +9.2.1. E-suite +-------------- Er zijn diverse zaken die ingesteld moeten worden om Mijn aanvragen naar behoren te laten functioneren. In het volgende screenshot is te zien om welke elementen het gaat. @@ -140,13 +154,13 @@ functioneren. In het volgende screenshot is te zien om welke elementen het gaat. :height: 540px -9.2.1. E-mailregistratie ------------------------- +9.2.1.1. E-mailregistratie +^^^^^^^^^^^^^^^^^^^^^^^^^^ Hier vult u het e-mailadres in waarop de ingezonden contactformulieren ontvangen moeten worden. -9.2.2. Klanten en contacten API registratie -------------------------------------------- +9.2.1.2. Klanten en contacten API registratie +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Hier kunt u aanvinken of u de aanvraag in de contactmomenten API geregistreerd wilt hebben. Laat u het vinkje hier weg, dan wordt de aanvraag niet geregistreerd in de contactmomenten API. De Organisatie @@ -166,15 +180,23 @@ het 'contactform_confimation' e-mailsjabloon gebruikt om een e-mailbevestiging t insturen van het contactformulier. Indien dit is uitgeschakeld wordt aangenomen dat de externe contactmomenten API (eg. eSuite) de e-mailbevestiging zal sturen. -9.2.3. Services ---------------- + +9.2.1.3. Filter contactmomenten +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In deze sectie kunt u een lijst van eSuite-kanalen configureren die uitgesloten worden +bij het opvragen van contactmomenten. Dit is met name nuttig voor kanalen die alleen voor +intern gebruik bestemd zijn. + +9.2.1.4. Services +^^^^^^^^^^^^^^^^^ Hier staan de API’s van de te koppelen services. Bij de configuratie van Open Zaak gaat het om een Klanten API en een Contactmomenten API. Deze services kunnen niet worden verwijderd of veranderd. U selecteert hier de juiste API van de betreffende gemeente. -9.2.4. Contactformulier onderwerpen ------------------------------------ +9.2.1.5. Contactformulier onderwerpen +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Bij Mijn Aanvragen vindt de gebruiker een contactformulier om de aanvraag in te dienen. U kunt als beheerder dit contactformulier configureren door de tekstuele labels aan te passen. Deze onderdelen @@ -185,6 +207,31 @@ Bovendien kunt u elementen uit het formulier verwijderen door een vinkje te zett Om nog een onderwerp aan het contactformulier toe te voegen klikt u op [+ Nog een contactformulier onderwerp toevoegen]. Als alles naar wens is geconfigureerd klikt u op [Opslaan]. +9.2.2. OpenKlant2 +----------------- + +Er zijn diverse zaken die ingesteld moeten worden om Mijn aanvragen naar behoren te laten +functioneren. In het volgende screenshot is te zien om welke elementen het gaat. + +.. image:: images/image145.png + :width: 624px + :height: 428px + +9.2.2.1. API Configuratie +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Bij deze configuratie kan een Service geselecteerd (of aangemaakt) worden die de technische +configuratie bevat voor het communiceren met het OpenKlant2 systeem. + +9.2.2.1. Vragen +^^^^^^^^^^^^^^^ + +Deze instellingen zijn noodzakelijk voor de integratie met OpenKlant2 in het "Mijn Vragen" +gedeelte van de website. Hoewel alle velden afzonderlijk worden toegelicht, verdient het +veld "Mijn Vragen Actor" speciale aandacht. Dit veld vereist een geldige UUID van een +bestaande Actor in het OpenKlant2 systeem. Deze Actor wordt gebruikt om nieuwe vragen +automatisch als interne taken toe te wijzen voor afhandeling. + 9.3. Configuratie ‘Open Zaak’ ============================= diff --git a/docs/beheerhandleiding/images/image144.png b/docs/beheerhandleiding/images/image144.png new file mode 100644 index 0000000000..5807d897bc Binary files /dev/null and b/docs/beheerhandleiding/images/image144.png differ diff --git a/docs/beheerhandleiding/images/image145.png b/docs/beheerhandleiding/images/image145.png new file mode 100644 index 0000000000..3279c6c311 Binary files /dev/null and b/docs/beheerhandleiding/images/image145.png differ diff --git a/src/open_inwoner/openklant/migrations/0020_add_more_help_texts_to_openklant2_config.py b/src/open_inwoner/openklant/migrations/0020_add_more_help_texts_to_openklant2_config.py new file mode 100644 index 0000000000..e6c097faba --- /dev/null +++ b/src/open_inwoner/openklant/migrations/0020_add_more_help_texts_to_openklant2_config.py @@ -0,0 +1,53 @@ +# Generated by Django 4.2.16 on 2025-01-20 09:57 + +from django.db import migrations, models + + +class Migration(migrations.Migration): + + dependencies = [ + ("openklant", "0019_alter_klantensysteemconfig_primary_backend"), + ] + + operations = [ + migrations.AlterField( + model_name="openklant2config", + name="interne_taak_gevraagde_handeling", + field=models.CharField( + blank=True, + default="", + help_text="Beschrijving van de gevraagde handeling voor de interne taak die ontstaat als resultaat van een vraag", + verbose_name="Interne taak gevraagde handeling", + ), + ), + migrations.AlterField( + model_name="openklant2config", + name="interne_taak_toelichting", + field=models.CharField( + blank=True, + default="", + help_text="Toelichting bij de gevraagde handeling voor de interne taak die ontstaat als resultaat van een vraag", + verbose_name="Interne taak toelichting", + ), + ), + migrations.AlterField( + model_name="openklant2config", + name="mijn_vragen_actor", + field=models.CharField( + blank=True, + default="", + help_text="De UUID van een bestaande Actor in de de configureerde API waaraan nieuwe vragen worden toegewezen", + verbose_name="Mijn vragen actor", + ), + ), + migrations.AlterField( + model_name="openklant2config", + name="mijn_vragen_kanaal", + field=models.CharField( + blank=True, + default="", + help_text="Het kanaal waaronder nieuwe vragen als Klantcontact object zullen worden aangemaakt", + verbose_name="Mijn vragen kanaal", + ), + ), + ] diff --git a/src/open_inwoner/openklant/models.py b/src/open_inwoner/openklant/models.py index 3ab2ddfc5b..a34973d85d 100644 --- a/src/open_inwoner/openklant/models.py +++ b/src/open_inwoner/openklant/models.py @@ -202,6 +202,9 @@ class OpenKlant2Config(SingletonModel): verbose_name=_("Mijn vragen kanaal"), default="", blank=True, + help_text=_( + "Het kanaal waaronder nieuwe vragen als Klantcontact object zullen worden aangemaakt" + ), ) mijn_vragen_organisatie_naam = models.CharField( verbose_name=_("Mijn vragen organisatie naam"), @@ -212,16 +215,25 @@ class OpenKlant2Config(SingletonModel): verbose_name=_("Mijn vragen actor"), default="", blank=True, + help_text=_( + "De UUID van een bestaande Actor in de de configureerde API waaraan nieuwe vragen worden toegewezen" + ), ) interne_taak_gevraagde_handeling = models.CharField( verbose_name=_("Interne taak gevraagde handeling"), default="", blank=True, + help_text=_( + "Beschrijving van de gevraagde handeling voor de interne taak die ontstaat als resultaat van een vraag" + ), ) interne_taak_toelichting = models.CharField( verbose_name=_("Interne taak toelichting"), default="", blank=True, + help_text=_( + "Toelichting bij de gevraagde handeling voor de interne taak die ontstaat als resultaat van een vraag" + ), ) class Meta: