[[TOC(heading=Portaal)]]
[[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/)]]


= Portaal =
Documentatie voor de portaalmodule.

Voordat de portaalmodule in gebruik kan worden genomen moet deze worden geconfigureerd. De configuratie bestaat uit 3 onderdelen:
1. Configureren van de secties E-mail en Portaal in het instellingenscherm
2. Beheren van spreekuren in het spreekurenscherm
3. Maken van sjablonen voor de uitnodigings- en herinneringsmail

== Draaiboek test ==
* Configureer de module zoals hieronder beschreven
* Voer de scheduled Job Portaal / !AanleverenVrijeTijdvakken uit
* Zorg dat de testpatiënt een geldig e-mailadres heeft dat je zelf kunt ontvangen. Zorg ervoor dat het is toegestaan om hier mail aan te versturen (vinkje Herinneringen)
* Maak een nieuwe reservering, geef aan dat de patiënt zelf mag inplannen, kies een spreekuur en sublocatie en verstuur de uitnodigingsmail
* Sluit het dossier!
* Klik op de link in de ontvangen uitnodigingsmail en plan een uitnodiging in in het portaal
* Voer de scheduled Jop Portaal / !GetReserveringen uit
* Open het dossier en controleer dat OpenAC de reservering heeft omgezet in een afspraak met de gekozen datum/tijd.

== Configuratie ==
=== Instellingen ===

==== E-mail ====
===== From e-mailadres =====
Het e-majiladres dat OpenAC gebruikt als afzender. Het is belangrijk dat de domeinnaam overeenkomt met een domeinnaam waarvoor de geconfigureerde SMTP-server mail mag versturen. Als het niet is ingevuld dan zal OpenAC geen portaalmail versturen.

===== Reply to e-mailadres =====
Als een cliënt een mail wil beantwoorden dan zal dit e-mailadres worden gebruikt. Als het niet is ingevuld dan gebruikt OpenAC het From e-mailadres



==== Portaal ====
===== Wachttijd =====
De wachttijd in weken

===== Maanden vooruit =====
Hoeveel maanden er vooruit kan worden gepland. Dit heeft invloed op hoeveel vrije blokken OpenAC aanlevert aan het portaal

===== E-mailadres beheerder =====
E-mailadres waar OpenAC mail naartoe stuurt bij problemen

===== URL aanleveren tijdsblokken =====
URL voor het aanleveren van vrije tijdsblokken. Voor de acceptatieomgeving is dit
{{{
https://adelanteafspraken-accp.mendixcloud.com/rest/vrijeblokken/v1/portaalvrijblok
}}}

===== URL inplannen afspraken =====
URL in de uitnodigingsbrief aan de cliënt voor het inplannen van afspraken. Voor de acceptatieomgeving is dit
{{{
https://adelanteafspraken-accp.mendixcloud.com/p/inplannen
}}}

De mailmerge-variabele {{{uitnodigingslink}}} is beschikbaar voor gebruik in portaalsjablonen

===== URL ophalen reserveringen =====
URL voor het ophalen van gereserveerde tijdvakken. Voor de acceptatieomgeving is dit
{{{
https://adelanteafspraken-accp.mendixcloud.com/rest/reservering/v1/portaalreservering
}}}

===== Geldigheidsduur uitnodigingslink =====
Hoeveel dagen de uitnodigingslink geldig blijft.

===== Sjabloon uitnodigingsbrief =====
OpenAC gebruikt dit sjabloon voor het versturen van de uitnodigingsmail aan de cliënt voor het inplannen van een afspraak. De mail bevat een link naar het portaal. Hiervoor is de mailmerge-variabele {{{uitnodigingslink}}} beschikbaar.

===== Onderwerp uitnodigingsbrief =====
Het onderwerp van de uitnodigingsmail

===== Sjabloon herinneringsbrief =====
OpenAC gebruikt dit sjabloon voor het versturen van een herinneringsmail als de cliënt binnen de herinneringstermijn geen afspraak heeft ingepland. De mail bevat een link naar het portaal. Hiervoor is de variabele {{{uitnodigingslink}}} beschikbaar

===== Onderwerp herinneringsbrief =====
Het onderwerp van de herinneringsmail

===== Herinneringstermijn =====
Termijn in dagen waarna OpenAC een herinnering verstuurt als de cliënt binnen deze termijn geen afspraak heeft ingepland.

===== Spreekuren =====
Klik op de link om spreekuren te beheren

=== Spreekurenscherm ===
OpenAC verstuurt vrije blokken die gebaseerd zijn op in dit scherm geconfigureerde spreekuren. Kies "Nieuw spreekuur invoeren" en voer minimaal één spreekuur in.

[[Image(spreekuur.png, width=500)]]

==== Code ====
Een code om het spreekuur aan te duiden. Deze code moet bekend zijn bij de !SquadApps applicatie.
==== Omschrijving ====
De omschrijving van het spreekuur
==== Activiteiten ====
De activiteiten die worden verricht in het spreekuur. Vooralsnog kiezen we hier 1 activiteit; in de toekomst is het mogelijk om hier meerdere activiteiten te kiezen
==== Duur ====
Dit is een readonly veld en wordt automatisch berekend door OpenAC. Het is de totale planduur van de geselecteerde activiteiten.
==== Duur in seconden ====
Dit is een readonly veld en wordt automatisch berekend door OpenAC. Het is de totale planduur van de geselecteerde activiteiten in seconden.
==== Aantal patiënten ====
Vul hier 1 in
==== Aantal medewerkers ====
Het aantal medewerkers dat betrokken is bij het spreekuur

=== Sjablonen ===
In het instellingenscherm moeten twee sjablonen worden gekozen, een sjabloon voor de uitnodigingsmail en een sjabloon voor de herinneringsmail. De sjablonen lijken op sjablonen voor reguliere uitnodigingen zoals {{{bezoek_locatie}}} maar moeten de bookmark {{{uitnodigingslink}}} bevatten.

== Bepalen van vrije blokken ==
OpenAC bepaalt de vrije blokken die voor het portaal beschikbaar zijn om in te plannen als volgt:

* OpenAC haalt de roosters op voor in spreekuren geconfigureerde activiteiten;
* OpenAC kijkt welke medewerkers betrokken zijn bij deze roosters;
* OpenAC haalt afspraken op van medewerkers en legt deze over de roosters heen;
* Wat overblijft zijn netto vrije plekken in de agenda. Vervolgens
 - controleert OpenAC voor elke vrije plek of de beschikbare tijd voldoende is voor het spreekuur
 - of het minimum aantal medewerkers beschikbaar is
* Aansluitende vrije plekken worden door OpenAC samengevoegd tot vrije blokken die worden doorgegeven aan het portaal