Skip to main content

Open Zaak Afhandel App for the first time

A first look at ZAA — where the app lives, what the navigation gives you, and how to tell it is wired up to OpenRegister.

Deprecated

The Zaak Afhandel App is no longer actively developed. New deployments should use Procest (process and case management) and Pipelinq (CRM and pipeline). These tutorials are preserved for users still running ZAA in production.

Goal​

By the end you will have opened the Zaak Afhandel App, recognised the dashboard and the in-app navigation, and confirmed that the OpenRegister-backed lists (Zaken, Taken, Klanten, …) load.

Prerequisites​

  • A Nextcloud account on an instance where the Zaak Afhandel App is installed and enabled.
  • The OpenRegister app installed and enabled — ZAA stores everything (zaken, taken, rollen, besluiten) in OpenRegister, so it is a hard dependency.
  • The ZAA register and its schemas imported. An admin runs this once from Settings → Administration → Zaak Afhandel App (see Manage Zaak Afhandel App settings).

Steps​

  1. Open the Nextcloud app menu in the top bar and pick Zaak Afhandel App. You land on the dashboard.

    Zaak Afhandel App dashboard

  2. Read the dashboard. The widgets surface the things case handlers care about most — Open zaken, Taken, Klanten, Contactmomenten, Personen, Organisaties. On a fresh install they read 0; they fill in as work moves through the app.

    Dashboard widgets

  3. Open the in-app navigation. The entries map one-to-one onto the things ZAA tracks: Zaken, Taken, Klanten, Medewerkers, Contactmomenten, Berichten, Rollen, Zaaktypen, Besluiten, Documenten, Resultaten, Statussen. Search (Zoeken) and Settings sit below the divider.

    ZAA navigation

  4. Click Zaken. The list view opens with a search/filter sidebar and an Add Item button. An empty install shows No items found — expected until someone registers the first zaak.

    Zaken list, empty state

Verification​

You are set up correctly when: the ZAA dashboard renders without an error banner, the in-app navigation lists the entries above, and clicking through to Zaken (or any other list) shows either rows or a clean No items found state — not a load error.

Common issues​

SymptomFix
"OpenRegister is not installed or enabled" bannerInstall and enable the OpenRegister app, then reload ZAA.
Lists load but Add Item opens a modal with no form fieldsThe ZAA register import is incomplete — an admin re-runs the configuration import from the admin settings page.
Zaak Afhandel App is missing from the app menuThe app is not enabled for your account — ask an administrator to enable it (and check it is not restricted to a group you are not in).

Reference​