Bewerken: Room / Space (Ruimte)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel Space-properties worden niet alleen handmatig ingevuld maar door workflows berekend of gevuld. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik `lookup_property_usage("Space", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **`BuildingFloor` (gebouw/bouwdeel/bouwlaag-koppeling)** — De hiërarchische koppeling `BuildingFloor` (kolommen `SPCBLDID`, `SPCBLDPID`, `SPCBLDFID`) wordt bij CAD-import gezet door `CadImportRuleAction_AddSpace` (aanmaak van nieuwe ruimtes uit een CAD-bestand) en `CadImportRuleAction_CopySpaceBuildingFloor` (overname van bouwlaag van een bestaande ruimte bij herimport). 22 workflows lezen dit veld vervolgens — onder meer voor reserveringen, rapportages en het opzoeken van gerelateerde objecten. Consultanttip: ontbrekende `BuildingFloor`-koppeling is de meest voorkomende reden dat een Space niet verschijnt in bouwlaag-overzichten of ruimteboekingen.

- **`FloorNetArea` (netto vloeroppervlak in m²)** — Wordt bij CAD-import automatisch gevuld door `CadImportRuleAction_AddSpace` (bij aanmaak) en `CadImportRuleAction_CopySpaceFloorNetArea` (bij bijwerken van een bestaand oppervlak). Na import valideert `CadImportRule_CheckCadImportRuleSpaceFloorNetArea` of de waarde overeenkomt met de CAD-meting en markeert de regel als afwijkend bij een discrepantie. Buiten CAD-import wordt `FloorNetArea` handmatig ingevuld; er is geen workflow die dit veld herberekent op basis van ruimtedimensies.

- **`ReservableObject` (reserveerbaar object)** — Wordt gezet door `ActionField560` op het moment dat een Space reserveerbaar wordt gemaakt (koppeling aan een ReservableObject-record). Vijf workflows lezen dit veld: reserveringslogica (`REST_CreateReservation`), Exchange-synchronisatie (`Space_ProcessExchangeNotification`), en opruiming bij het verwijderen van de ruimte (`Space_PreTrash`). Zolang `ReservableObject` gevuld is, blokkeert `Space_PreTrash` het verwijderen als er nog actieve reserveringen bestaan. Zet `Reservable = true` altijd samen met de `ReservableObject`-koppeling; zonder de koppeling werkt de reserveringsflow niet.

- **`StateAgenda` (agendastatus voor verhuurbare eenheden)** — Centraal veld in de VHE-context. `RentableRealEstate_AddBlockage` schrijft en leest het veld bij het opvoeren van een blokkade (bijv. leegstand of renovatie). `ActionField936` en `ActionField942` passen de `StateAgenda` aan bij contractwijzigingen en verlengingen; `ActionField1062` herberekent de agendastatus na een statusovergang op het contract. `ActionField926` filtert op dit veld om te controleren of een ruimte beschikbaar is voor verhuur. Consultanttip: bij VHE-gebruik is `StateAgenda` de primaire indicator voor beschikbaarheid — niet de simpele `Status`.

- **`Rentable` en `RentableRealEstateStartDate` (verhuurbaarheidsvlag en ingangsdatum)** — `ActionField924` schrijft `Rentable` wanneer een ruimte als VHE wordt geactiveerd en leest het veld vervolgens voor verdere VHE-logica (verhuurbaarheidsstatus, agenda-initialisatie). `ActionField927` zet `RentableRealEstateStartDate` op de contractingangsdatum. `Space_AskDateAndCheck` raadpleegt deze startdatum om te valideren of aangevraagde huurperioden overlappen met de VHE-activatiedatum. Beide velden zijn uitsluitend relevant in context `RentableRealEstate` (2).

- **`CostCenter` en `Department` (kostenplaats en afdeling)** — Twee dedicated workflows beheren deze kostendragers: `Space_ChangeCostCenter` vervangt de kostenplaats en `Space_ChangeDepartment` vervangt de afdeling — beide worden ook gelezen door `Job_UpdateCostCarriers` en `PmWorkOrder_CreateJobs_ProcessCreatedJob_SetCostCarriers`, zodat jobs en preventief onderhoud die aan deze ruimte zijn gekoppeld automatisch de kostendragers van de ruimte overnemen. Dit maakt de Space-entiteit tot de primaire bron van waarheid voor kostenallocatie in gebouw-gerelateerde werkorders. Consultanttip: pas `CostCenter`/`Department` op de Space aan vóórdat je PM-werkorders aanmaakt; bestaande jobs erven de waarden niet met terugwerkende kracht.

- **`Site` en `SpaceType` (vestiging en ruimtetype)** — `Site` wordt gevuld door `ActionField581` (bij aanmaak via een dialoog), `RentableRealEstate_CreateFromDomainObject` (bij aanmaak als VHE vanuit een domeinobject) en `ActionField1113` (bulk-actie). Diezelfde `ActionField1113` schrijft ook `SpaceType` en `Vendor`. `ActionField421` en `ActionField422` filteren/lezen `SpaceType` voor typespecifieke afhandeling (bijv. andere schoonmaakfrequentie per type). Zonder correcte `Site`-koppeling ontbreekt de vestigingscontext in job-gerelateerde kostendragerlogica.

> Het volledige, gegenereerde overzicht van álle Space-properties met hun schrijvende/lezende/filterende workflows staat in [[reference/properties/Space]].

---