# Taken

Het Takensysteem is de geïntegreerde actiebeheerlaag van Magma. Taken worden automatisch aangemaakt wanneer er gebeurtenissen plaatsvinden op het platform die aandacht van stakeholders vereisen — zoals documenten die wachten op validatie, verlopen documenten die vernieuwing nodig hebben, of DTT-mintingvereisten. Taken zorgen ervoor dat niets over het hoofd wordt gezien.

***

## Overzicht

Taken zijn:

* **Automatisch aangemaakt** wanneer triggerende domeingebeurtenissen plaatsvinden (bijv. een document wordt ingediend voor validatie).
* **Automatisch voltooid** wanneer de bijbehorende actie wordt ondernomen (bijv. een validator keurt het document goed).
* **Historisch bewaard** — voltooide en gearchiveerde taken blijven in de geschiedenis voor auditdoeleinden.

***

## Taaktypen

Er zijn 10 taaktypen, georganiseerd in 3 groepen:

### Groep DOCUMENTEN

| Taaktype                       | Beschrijving                                                                                               | Toegewezen aan              |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------- | --------------------------- |
| **VALIDATE\_DOCUMENT**         | Een document is ingediend voor validatie en wacht op beoordeling door de validator.                        | Toegewezen validators       |
| **UPDATE\_EXPIRED\_DOCUMENT**  | De geldigheidsperiode van een document is verlopen en moet worden bijgewerkt of vervangen.                 | Documenteigenaar / uploader |
| **UPDATE\_REJECTED\_DOCUMENT** | Een document is afgewezen door een validator. De eigenaar moet de afwijzing aanpakken en opnieuw indienen. | Documenteigenaar / uploader |

### Groep 3D\_MODEL

| Taaktype                               | Beschrijving                                                                              | Toegewezen aan                |
| -------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------- |
| **VALIDATE\_3D\_MODEL\_FIELD**         | Een BIM-veldwijzigingsverzoek is ingediend en wacht op goedkeuring door de validator.     | Toegewezen BIM-validators     |
| **UPDATE\_REJECTED\_3D\_MODEL\_FIELD** | Een BIM-veldwijzigingsverzoek is afgewezen. De indiener moet herzien en opnieuw indienen. | Indiener van de veldwijziging |

### Groep ENERGY\_METERS (Fluid Synoptic)

| Taaktype                            | Beschrijving                                                                                  | Toegewezen aan               |
| ----------------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------- |
| **VALIDATE\_ENERGY\_METER**         | Een energiemeterrecord is ingediend voor validatie en wacht op beoordeling door de validator. | Toegewezen metervalidator    |
| **UPDATE\_REJECTED\_ENERGY\_METER** | Een energiemeterrecord is afgewezen. De indiener moet corrigeren en opnieuw indienen.         | Indiener van het meterrecord |

### Andere groepen

| Taaktype                            | Groep      | Beschrijving                                                                       | Toegewezen aan               |
| ----------------------------------- | ---------- | ---------------------------------------------------------------------------------- | ---------------------------- |
| **MINT\_DTT**                       | DTT        | Aan de vereisten voor minting is voldaan en het gebouw is klaar voor een DTT-mint. | Eigenaar / AM van het gebouw |
| **VALIDATE\_LOT\_DIVISION**         | DOCUMENTEN | Een Lot Division-record is ingediend voor validatie.                               | Toegewezen validators        |
| **UPDATE\_REJECTED\_LOT\_DIVISION** | DOCUMENTEN | Een Lot Division-record is afgewezen en moet worden gecorrigeerd.                  | Indiener van het record      |

***

## Takenmodi

Het Takenpaneel biedt twee weergavemodi:

### Modus GEBRUIKER (Mijn taken)

Toont alleen taken die persoonlijk aan u zijn toegewezen. Dit is de standaardmodus en de meest gebruikte weergave — het is uw persoonlijke takenlijst van vereiste acties binnen de gebouwen waarop u een stakeholder bent.

### Modus ALLES (Alle taken)

Toont alle taken voor het gebouw, ongeacht aan wie ze zijn toegewezen. In deze modus wordt een extra kolom **Toegewezene** weergegeven, die aangeeft welke stakeholder verantwoordelijk is voor elke taak. Deze modus is beschikbaar voor Eigenaren en Accountmanagers voor overzicht en teambeheer.

***

## Takenpaneel in de BIM 3D Viewer

Het Takenpaneel is rechtstreeks geïntegreerd in de BIM 3D Viewer:

* Druk op **Shift+T** om het Takenpaneel te openen of te sluiten.
* Een **telbadge** wordt weergegeven op de knop Taken in de viewer-werkbalk, waarop het aantal openstaande taken wordt getoond.
* Vanuit de viewer kunt u BIM-gerelateerde taken beheren (VALIDATE\_3D\_MODEL\_FIELD, UPDATE\_REJECTED\_3D\_MODEL\_FIELD) zonder de 3D-context te verlaten.

***

## Taaklevenscyclus

```
(Triggerende gebeurtenis) → Taak aangemaakt (open) → Actie ondernomen → Taak voltooid (gearchiveerd)
```

| Status           | Beschrijving                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| **Open**         | De taak is actief en wacht op actie.                                                                    |
| **Voltooid**     | De vereiste actie is ondernomen. De taak is gemarkeerd als voltooid en verplaatst naar de geschiedenis. |
| **Gearchiveerd** | Historische taken die niet meer uitvoerbaar zijn (bijv. verlopen, vervangen).                           |

### Automatisch aanmaken

Taken worden automatisch aangemaakt door het platform wanneer relevante gebeurtenissen plaatsvinden:

| Gebeurtenis                          | Aangemaakt taak                                                     |
| ------------------------------------ | ------------------------------------------------------------------- |
| Document ingediend voor validatie    | VALIDATE\_DOCUMENT (voor elke toegewezen validator)                 |
| Vervaldatum document bereikt         | UPDATE\_EXPIRED\_DOCUMENT (voor documenteigenaar)                   |
| Document afgewezen door validator    | UPDATE\_REJECTED\_DOCUMENT (voor documenteigenaar)                  |
| BIM-veldwijziging ingediend          | VALIDATE\_3D\_MODEL\_FIELD (voor elke toegewezen BIM-validator)     |
| BIM-veldwijziging afgewezen          | UPDATE\_REJECTED\_3D\_MODEL\_FIELD (voor indiener van de wijziging) |
| Lot-record ingediend voor validatie  | VALIDATE\_LOT\_DIVISION (voor toegewezen validators)                |
| Lot-record afgewezen                 | UPDATE\_REJECTED\_LOT\_DIVISION (voor indiener van het record)      |
| Meterrecord ingediend voor validatie | VALIDATE\_ENERGY\_METER (voor toegewezen validator)                 |
| Meterrecord afgewezen                | UPDATE\_REJECTED\_ENERGY\_METER (voor indiener van het record)      |
| DTT-mintingvereisten vervuld         | MINT\_DTT (voor Eigenaar/AM van het gebouw)                         |

### Automatisch voltooien

Taken worden automatisch voltooid wanneer de bijbehorende actie wordt ondernomen:

| Taak                               | Automatisch voltooid wanneer                          |
| ---------------------------------- | ----------------------------------------------------- |
| VALIDATE\_DOCUMENT                 | Validator keurt het document goed of wijst het af.    |
| UPDATE\_EXPIRED\_DOCUMENT          | Een nieuwe versie van het document is geüpload.       |
| UPDATE\_REJECTED\_DOCUMENT         | Een gecorrigeerde documentversie is ingediend.        |
| VALIDATE\_3D\_MODEL\_FIELD         | Validator stemt over de veldwijziging.                |
| UPDATE\_REJECTED\_3D\_MODEL\_FIELD | Een herziene veldwijziging is ingediend.              |
| VALIDATE\_LOT\_DIVISION            | Validator keurt het lot-record goed of wijst het af.  |
| UPDATE\_REJECTED\_LOT\_DIVISION    | Een gecorrigeerd lot-record is ingediend.             |
| VALIDATE\_ENERGY\_METER            | Validator keurt het meterrecord goed of wijst het af. |
| UPDATE\_REJECTED\_ENERGY\_METER    | Een gecorrigeerd meterrecord is ingediend.            |
| MINT\_DTT                          | De DTT-minting is succesvol voltooid.                 |

***

## Taken in de Activiteitsfeed

Taakgerelateerde gebeurtenissen verschijnen ook in de [Activiteitsfeed](/magma-documentation/nl/functies/activity-feed.md). De Activiteitsfeed biedt actieknoppen die rechtstreeks linken naar de relevante taak:

* **Validator toewijzen** — Wijs een validator toe aan een document dat er een wacht.
* **Verzoek beoordelen** — Keur een toegangsverzoek goed of wijs het af.
* **Taken bekijken** — Navigeer naar het Takenpaneel voor het relevante gebouw.

***

## Tips voor effectief takenbeheer

* Controleer het Takenpaneel regelmatig — taken stapelen zich op in de loop der tijd en achterstallige taken kunnen de voortgang van de Magma Index vertragen en minting vertragen.
* Gebruik de **modus ALLES** als Eigenaar of Accountmanager om knelpunten te identificeren — als een validator veel openstaande VALIDATE\_DOCUMENT-taken heeft, overweeg dan om sommige documenten opnieuw toe te wijzen.
* Houd in de BIM 3D Viewer de **telbadge** (Shift+T) in de gaten — een groeiend aantal openstaande BIM-veldvalidatietaken geeft aan dat wijzigingsverzoeken zich opstapelen zonder beoordeling.
* Voor tijdsgevoelige documenten (bijv. Verzekering, Belastingen), prioriteer UPDATE\_EXPIRED\_DOCUMENT-taken onmiddellijk om de gegevensvervaalstraf op de Magma Index te vermijden.
* Stakeholders kunnen hun taken bijhouden via de **Activiteitsfeed**-meldingen — elke relevante gebeurtenis genereert een activiteitsitem met een directe actieknop.


---

# Agent Instructions: 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.mymagma.com/magma-documentation/nl/functies/tasks.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.
