> For the complete documentation index, see [llms.txt](https://docs.totallink.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.totallink.nl/functioneel-beheer/how-to../module-specifieke-configuratie/woningbouwmonitor-inrichten.md).

# Woningbouwmonitor inrichten

Als functioneel beheerder zet je de basis klaar waarmee medewerkers de Woningbouwmonitor kunnen vullen: je regelt de rechten, de keuzelijsten voor woningtypen en segmenten, het startjaar van de grafieken en de kleuren. Pas als dit staat, kunnen medewerkers adressen koppelen en de monitor bekijken.

{% hint style="info" %}
Dit is eenmalig werk per omgeving. De keuzelijsten en instellingen die je hier maakt, gelden centraal voor alle (deel)projecten. Je hoeft dit dus niet per project te herhalen.
{% endhint %}

## In welke volgorde stel ik alles in?

Houd deze volgorde aan, dan loop je niet vast:

1. **Rechten toekennen** — anders ziet de medewerker het tandwiel of de tab niet.
2. **Programmagroep vullen** — segmenten en woningkenmerken, zodat de keuzelijsten werken.
3. **Startjaar instellen** — anders blijft het dashboard leeg per jaar.
4. **Kleuren instellen** — zodat de categorieën herkenbaar zijn in de monitor.

> 📸 **Afbeelding:** De linkerbalk met het tandwiel-icoon (⚙️ Beheertegels) gemarkeerd.

## Welke rechten moet ik toekennen?

Een medewerker heeft twee soorten rechten nodig: rechten om te muteren en beheerrechten op de juiste tegels.

{% tabs %}
{% tab title="Medewerker (adressen koppelen)" %}
Geef minimaal één van deze mutatierechten:

* **Mutatierechten Exploitatie**, of
* **Mutatierechten in de rapportagetool** (tab Woningbouwrealisatie).

Hiermee kan de medewerker adressen aan programmaregels koppelen.
{% endtab %}

{% tab title="Beheerder (inrichting)" %}
Geef beheerrechten op deze twee tegels:

* **Programmagroep** — om categorieën, segmenten en woningkenmerken te beheren.
* **Uitgangspunten en Totalen** — om het startjaar voor de grafieken in te stellen.

Er moet altijd **minimaal één beheerder** zijn met toegang tot beide tegels.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Ziet een medewerker het ⚙️ tandwiel niet in het hoofdscherm? Dan ontbreken de beheerrechten. Dit is bijna altijd de oorzaak van "ik kan niets instellen".
{% endhint %}

## Hoe stel ik de woningkenmerken en segmenten in?

Dit doe je in de Programmagroep. Hier leg je de keuzes vast die later als keuzelijsten verschijnen bij de programmaregels.

{% stepper %}
{% step %}

### Open de Programmagroep

Klik op het ⚙️ tandwiel in de linkerbalk en open de tegel **Programmagroep > Woningen**. Je ziet nu de instellingen voor woningen.
{% endstep %}

{% step %}

### Zet Programmatype op "Woningen"

Zorg dat in het veld **Programmatype** de optie **Woningen** aanstaat. Hierdoor verschijnen straks de juiste keuzelijsten bij de programmaregels.
{% endstep %}

{% step %}

### Vul de Segmenten

Ga naar de tabel **Segmenten** en voeg de opties toe die jouw organisatie gebruikt, bijvoorbeeld *goedkoop*, *midden* en *duur*.

* Vul desgewenst een **Code** in voor snelle invoer.
* Kies bij **Vertaling voor rapportage** de doelcategorie voor dashboard en rapportage.
  {% endstep %}

{% step %}

### Definieer de Woningkenmerken

Open de tabel **Woningkenmerken** en vul per regel in:

* **Woningtype** — vrije tekst (bijv. appartement, 2-kapper, vrijstaand).
* **Woonvorm** — eengezins of meergezins.
* **Segment** — goedkoop, midden of duur.
* **Code** (optioneel) — korte codering voor snelle selectie.

Je ziet de ingevulde kenmerken straks terug als keuzelijst bij medewerkers.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Klaar als de keuzelijsten gevuld zijn? Vraag een medewerker een programmaregel te openen. Verschijnen jouw segmenten en woningtypen in de keuzelijst, dan staat de inrichting goed.
{% endhint %}

## Hoe stel ik het startjaar van de grafieken in?

Het startjaar bepaalt vanaf welk jaar de monitor losse jaarstaven toont. Stel je het niet in, dan blijft het dashboard leeg per jaar.

{% stepper %}
{% step %}

### Open Uitgangspunten en Totalen

Open de tegel **Uitgangspunten en Totalen** en ga naar de tab **Uitgangspunten Woningbouwmonitor**.
{% endstep %}

{% step %}

### Kies het startjaar

Kies het jaar waarop de jaarlijkse staven beginnen. Kies je bijvoorbeeld **2023**, dan toont de eerste staaf "opgeleverd vóór 2023", gevolgd door 2023, 2024, enzovoort.
{% endstep %}
{% endstepper %}

## Hoe stel ik de kleuren van de categorieën in?

De kleuren bepalen hoe de categorieën in de monitor worden weergegeven.

{% stepper %}
{% step %}

### Open de instellingen

Ga naar ⚙️ **Programmagroep > Woningen** en open de tab **Instellingen**.
{% endstep %}

{% step %}

### Kies de kleuren

Stel per categorie de kleur in voor de visualisatie in de monitor. Ververs daarna het scherm om het resultaat te zien.
{% endstep %}
{% endstepper %}

## Wat moet ik weten over de projectgrenzen?

De projectgrenzen bepalen binnen welk gebied de BAG wordt gecontroleerd. Vaak komen ze automatisch uit een externe bron; anders tekent een medewerker ze zelf in de tab Ruimtegebruik.

{% hint style="info" %}
Elke nacht controleert TotalLink de BAG binnen de projectgrenzen. Gevonden adressen verschijnen per (deel)project op de tab **Woningbouwrealisatie**. Een nieuw of aangepast gebied is dus pas de volgende dag volledig zichtbaar.
{% endhint %}

## Veelvoorkomende problemen oplossen

<details>

<summary>Een medewerker ziet het ⚙️ tandwiel niet</summary>

De beheerrechten ontbreken. Ken de rechten op **Programmagroep** en **Uitgangspunten en Totalen** toe.

</details>

<details>

<summary>De keuzelijst mist een type of segment</summary>

Controleer in **Programmagroep > Woningen** of **Programmatype = Woningen** aanstaat én of de tabellen **Woningkenmerken** en **Segmenten** gevuld zijn.

</details>

<details>

<summary>Het dashboard toont geen data per jaar</summary>

Het startjaar is nog niet ingesteld. Stel het in onder **Uitgangspunten en Totalen > Uitgangspunten Woningbouwmonitor**.

</details>

<details>

<summary>Een kleur klopt niet</summary>

Pas de kleur aan onder **Programmagroep > Woningen > Instellingen** en ververs het scherm.

</details>

<details>

<summary>Een adres ontbreekt op Woningbouwrealisatie</summary>

Controleer of de projectgrens het adres dekt. Wacht daarna op de nachtelijke BAG-sync, of laat de grens aanpassen en opslaan.

</details>

## Checklist inrichting (per omgeving)

* [ ] Mutatierechten toegekend (Exploitatie of rapportagetool)
* [ ] Beheerrechten toegekend op Programmagroep en Uitgangspunten en Totalen
* [ ] Programmatype op "Woningen" gezet
* [ ] Segmenten ingevuld (incl. Vertaling voor rapportage)
* [ ] Woningkenmerken ingevuld (woningtype, woonvorm, segment)
* [ ] Startjaar ingesteld (Uitgangspunten Woningbouwmonitor)
* [ ] Kleuren ingesteld (Programmagroep > Instellingen)

## Begrippen

* **BAG** — Basisregistratie Adressen en Gebouwen; de bron voor adressen en hun status.
* **Programmagroep** — de plek waar je categorieën, segmenten en woningkenmerken beheert.
* **Programmaregel** — één rij in Programma met een gekozen type, segment en woonvorm.
* **Vertaling voor rapportage** — de doelcategorie waaronder een segment in dashboard en rapportage valt.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.totallink.nl/functioneel-beheer/how-to../module-specifieke-configuratie/woningbouwmonitor-inrichten.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.