Configuratie¶
Deze gids beschrijft beheerder-instellingen en configuratie-opties voor FormVox.
Beheer-instellingen openen¶
- Log in als Nextcloud-beheerder
- Ga naar Instellingen (klik op je profiel → Instellingen)
- Klik onder Beheer op FormVox
Beheer-instellingen-tabbladen¶
Branding-tabblad¶
Configureer organisatie-brede branding voor alle formulieren.
Default-branding¶
- Header-afbeelding-URL — standaard-logo/-banner voor nieuwe formulieren
- Achtergrond-kleur — standaard formulier-achtergrond-kleur
- Accent-kleur — standaard knop- en highlight-kleur
Branding-overerving¶
Formulieren kunnen:
- Organisatie-defaults gebruiken
- Overschrijven met formulier-specifieke branding
Statistieken-tabblad¶
Bekijk gebruiks-statistieken over je Nextcloud-instantie.
Beschikbare statistieken¶
- Totaal aantal formulieren — aantal aangemaakte formulieren
- Totaal aantal antwoorden — som van alle inzendingen
- Actieve gebruikers — gebruikers die formulieren hebben aangemaakt (laatste 30 dagen)
Statistieken-refresh¶
Statistieken worden asynchroon geladen wanneer je het statistieken-tabblad opent, zodat de beheer-instellingen-pagina direct laadt zonder te wachten op de berekening van statistieken.
Embedding-tabblad¶
Bepaal hoe formulieren in externe websites geëmbed kunnen worden.
Toegestane domeinen¶
Beperk welke externe domeinen FormVox-formulieren mogen embedden:
- Ga naar FormVox beheer-instellingen
- Klik op het Embedding-tabblad (of het Instellingen-tabblad)
- Voeg toegestane domeinen toe (één per regel):
- Sla instellingen op
Opties:
- Laat leeg om alle domeinen toe te staan (default)
- Gebruik
*als wildcard voor subdomeinen - Specificeer exacte domeinen voor strikte controle
Beveiligings-notitie: door embed-domeinen te beperken voorkom je dat je formulieren op ongeautoriseerde websites worden geëmbed, wat het risico op phishing-aanvallen verlaagt.
PDF-bevestiging¶
De PDF-bevestiging is ontwikkeld op verzoek van, en gefinancierd door, het Landesinstitut für Schulqualität und Lehrerbildung Sachsen-Anhalt (LISA). De functie zit in de publieke FormVox-code en is beschikbaar voor iedere FormVox-gebruiker.
Of een formulier überhaupt PDF's heeft, bepaalt het formulier zelf: Bewaar een PDF van elk antwoord in het
deelvenster, onder de bevestigingsmail, standaard uit. Aan: een achtergrondtaak maakt de PDF direct na elke inzending en
bewaart hem bij het antwoord; de download in de resultaten, PDF's exporteren (ZIP), de externe API, het blok pdf in
de webhooks en de bevestigingsmail geven alle datzelfde document. Uit: er wordt nergens een PDF voor het formulier
gemaakt. De resultaten tonen geen PDF-download of ZIP, de PDF-route van de API antwoordt 409 met reden pdf_disabled,
webhooks sturen "pdf": null mee en PDF van het antwoord meesturen is niet aan te zetten. Een import krijgt nooit
PDF's, wat de schakelaar ook zegt.
Formulieren kunnen invullers hun antwoorden als PDF meesturen met de bevestigingsmail. Een ingelogde invuller krijgt de bevestiging, met PDF, op het e-mailadres van zijn account; een account zonder adres krijgt geen bevestiging. Standaard krijgen alleen zij die PDF: een anonieme invuller typt het adres zelf in, en dat wordt niet gecontroleerd. Onder Instellingen → PDF-bevestiging zet PDF ook naar anonieme invullers sturen dat ook voor anonieme invullers aan. Dan gaan er hooguit 3 van zulke mails per dag naar één adres en 200 per formulier per uur; daarboven gaat de mail zonder PDF. Om die limieten te bewaken is Redis of Memcached nodig als geheugencache van Nextcloud: APCu telt in elk PHP-proces apart. Zonder staat de schakelaar uit en is hij niet aan te zetten; het overzicht met setup-checks van Nextcloud meldt dat.
PDF's en webhooks: serverinstellingen die ertoe doen¶
overwrite.cli.urlinconfig.php: webhooks gaan uit vanuit een achtergrondtaak, waar Nextcloud zijn eigen adres alleen uit deze instelling kent. Zet hem op het adres dat je integraties gebruiken, anders wijstpdf.urlin een webhook ergens anders heen (http://localhost/…).allow_local_remote_servers: Nextcloud stuurt geen webhook naar een adres op zijn eigen netwerk. Draait de ontvanger daar (bijvoorbeeld Windmill op hetzelfde netwerk), zet dan'allow_local_remote_servers' => true.default_timezoneendefault_language: een PDF toont tijden in de tijdzone van de invuller, als diens browser die doorgaf, en de labels in de taal waarin het formulier is ingevuld. Een antwoord zonder die gegevens, zoals een antwoord via de API of een import, krijgtdefault_timezone(UTC als die niet gezet is), endefault_languageals de PDF op de achtergrond of via de API wordt gemaakt; een download in de app maakt hem in de taal van wie downloadt.- Schriften: de PDF gebruikt het lettertype DejaVu Sans. Latijnse, Griekse en Cyrillische tekst staat er zoals getypt; Chinees, Japans, Koreaans, Thai, Indiase schriften en emoji worden vakjes, Arabische letters staan los van elkaar, en Arabisch en Hebreeuws lopen van links naar rechts.
Telemetrie-tabblad¶
Configureer anonieme telemetrie-rapportage.
Wat wordt verzameld¶
- Aantal formulieren
- Aantal antwoorden
- Aantal actieve gebruikers
- Nextcloud-versie
- FormVox-versie
- PHP-versie
Wat NIET wordt verzameld¶
- Formulier-content
- Antwoord-data
- Gebruikers-informatie
- Server-URLs of IPs
Opt-out¶
Om telemetrie uit te schakelen:
- Ga naar FormVox beheer-instellingen
- Vink Anonieme telemetrie inschakelen uit
- Sla instellingen op
App-configuratie¶
occ-commando's¶
FormVox voegt deze occ-commando's toe:
# Alle formulieren die nog in hun bestand staan nu naar de database verplaatsen, en afronden wat eerdere omzettingen liet liggen
sudo -u www-data php occ formvox:migrate
# Laten zien wat er nog moet gebeuren: formulieren nog in hun bestand, omgezette formulieren nog af te ronden, kapotte bestanden
sudo -u www-data php occ formvox:migrate --status
# Alleen dit formulier omzetten, via het bestands-id van het formulier-bestand
sudo -u www-data php occ formvox:migrate --file-id=<id>
# Formulieren oplijsten waarvan het bestand verdween zonder dat het in Nextcloud is verwijderd (na 30 dagen automatisch weg)
sudo -u www-data php occ formvox:orphans
# Eén wees nu verwijderen, met zijn antwoorden en bestanden
sudo -u www-data php occ formvox:orphans --remove=<form id>
# Antwoorden van een formulier handmatig weer koppelen aan een bestand, als dat elders een nieuw id kreeg dan waar het stond
sudo -u www-data php occ formvox:rebind <file-id> <form-id>
# Een formulier bevrijden waarvan de schrijver werd gedood tijdens het opslaan, voordat FormVox's eigen lock zelf verloopt
sudo -u www-data php occ formvox:unlock <fileId>
Gebruik formvox:migrate om direct na de update alle resterende formulieren om te zetten in plaats van te wachten op
de achtergrondtaak; formvox:orphans als het bestand van een formulier verdween zonder dat iemand het in Nextcloud
verwijderde (een map op schijf verwijderd, een restore waarin het ontbrak, een verwijderde teammap) en je de antwoorden wilt zien of verwijderen vóór de bewaartermijn van 30 dagen verstrijkt. Een formulier dat in
Nextcloud definitief is verwijderd, uit de prullenbak, waar geen prullenbak in gebruik is of samen met het account in wiens thuismap
of prullenbak het stond, verliest zijn antwoorden,
uploads en PDF's meteen en komt hier nooit in voor; formvox:rebind als een bestand ergens anders een nieuw id kreeg dan waar het
stond, zodat FormVox het niet zelf kan terugvinden; formvox:unlock alleen als een formulier bezet blijft gemeld
omdat het proces dat het schreef werd gedood. Zie Waar FormVox data bewaart voor de
omzetting naar 1.6 en Beveiliging voor het verschil met Nextclouds
eigen bestands-lock.
Config-waarden¶
Stel configuratie in via config.php of occ:
# Telemetrie uitschakelen
sudo -u www-data php occ config:app:set formvox telemetry_enabled --value=0
# Standaard-branding-kleur instellen
sudo -u www-data php occ config:app:set formvox default_accent_color --value=#0082c9
Waar FormVox data bewaart¶
Sinds 1.6.0 staat een formulier verdeeld over drie plekken:
- Het
.fvform-bestand bevat alleen nog de formulier-definitie: vragen, pagina's en instellingen. Het staat nog steeds in de bestandsopslag van de eigenaar of teammap en volgt standaard Nextcloud-bestand-permissies, delen en versies. - De database bevat de antwoorden van een formulier, zijn geheimen (link-token, link-wachtwoord-hash, API-keys,
webhook-secrets) en de tellers achter de resultatenpagina, in de tabellen
formvox_forms,formvox_resp,formvox_keys,formvox_counts,formvox_outboxenformvox_secrets. - FormVox's app-data (buiten de bestanden van elke gebruiker) bevat de uploads van invullers, huisstijl- afbeeldingen, het ODT-sjabloon en bewaarde PDF's, één map per formulier-id.
Upgraden naar 1.6¶
Formulieren die vóór 1.6.0 zijn aangemaakt, hebben nog alles in hun .fvform-bestand staan. Na de update zet een
achtergrondtaak (MigrateFormsJob) ze automatisch om naar de database en app-data: die draait bij elke run van de
achtergrondtaken van Nextcloud (elke 5 minuten met systeemcron), zet per run tot 2 minuten lang formulieren om, en neemt
de grootste formulieren eerst, omdat die het drukst zijn. Een site met een paar duizend formulieren is in ongeveer een
uur klaar. Is niets meer over, dan
kijkt hij daarna nog maar één keer per dag, om een formulier terug te vinden dat uit de prullenbak of een back-up is
teruggezet. Een formulier wordt ook meteen omgezet, vooruitlopend op de taak, zodra er voor het eerst iets in
geschreven wordt: een antwoord, een instelling, een opslag in de editor, of een bestand dat via WebDAV of een
versie-restore over het formulier wordt gezet.
Check de voortgang met:
Dit toont hoeveel formulieren nog helemaal in hun bestand staan, hoeveel al zijn omgezet maar nog hun bestanden
(uploads, huisstijl, sjabloon, PDF's) moeten verplaatsen of hun bestand moeten laten opruimen, en welke bestanden als
FormVox-formulier zijn aangemerkt maar geen formulier bevatten; zo'n bestand wordt overgeslagen en getoond, niet
opnieuw geprobeerd tot de volgende update weer kijkt. Draai occ formvox:migrate (zonder opties) om alles nu om te
zetten in plaats van op de achtergrondtaak te wachten.
Back-ups¶
Maak een back-up van de database en FormVox's app-data samen met de bestanden; een back-up van alleen de bestanden bevat de antwoorden of geheimen van een formulier niet meer. Alleen de bestanden terugzetten brengt de formulieren terug, maar zonder hun antwoorden, tenzij de bijbehorende database-back-up er samen mee wordt teruggezet.
Background-jobs¶
FormVox gebruikt Nextcloud's background-job-systeem.
Telemetrie-job¶
Bij ingeschakelde telemetrie:
- Draait dagelijks
- Rapporteert anonieme gebruiks-statistieken
- Minimale server-impact
Zorgen dat jobs draaien¶
Verifieer dat cron is geconfigureerd:
Check job-status:
Logging¶
Log-niveaus¶
FormVox logt naar het Nextcloud-log-bestand:
Log-niveaus:
- Error — kritieke problemen
- Warning — niet-kritieke problemen
- Info — algemene operaties
- Debug — gedetailleerd debuggen (inschakelen in Nextcloud-instellingen)
Issues debuggen¶
Om debug-logging in te schakelen:
- Zet
'loglevel' => 0in config.php - Reproduceer het issue
- Check het log-bestand
- Reset log-niveau na afloop
Integratie-instellingen¶
Externe systemen¶
FormVox ondersteunt integratie via:
- REST-API (zie API-referentie)
- Bestandssysteem-toegang (
.fvform-bestanden zijn JSON) - Nextcloud's sharing-API
Externe API & webhooks¶
FormVox ondersteunt een externe API met API-key-authenticatie en webhooks voor real-time notificaties. Zie de Externe-API-&-webhooks-documentatie voor details over:
- API-key-beheer (per formulier, configureerbare permissies)
- CRUD-operaties op antwoorden
- Webhook-events (
response.created,response.updated,response.deleted) - HMAC-SHA256-gesigneerde payloads
Performance-tuning¶
Voor grote installaties¶
Als je veel formulieren of antwoorden hebt:
- Schakel APCu-caching in in Nextcloud
- Gebruik SSDs voor opslag
- Configureer een goede cron (geen AJAX-cron)
Antwoord-limieten¶
Voor formulieren met duizenden antwoorden:
- Resultaten laden progressief
- Exports kunnen langer duren
- Overweeg oude antwoorden te archiveren
Beveiligings-configuratie¶
Zie de dedicated Beveiligings-gids voor:
- Rate limiting
- Toegangscontrole
- Wachtwoord-beleid
Volgende stappen¶
- Configureer Beveiligings-instellingen
- Bekijk Architectuur voor technische details
- Check API-referentie voor integraties