Bewerken: Equipment (Installatie)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

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

- **`Status` (levenscyclus: BuildIn → Operationeel → BuildOut/Move)** — De recordstatus loopt langs vaste lifecycle-workflows in plaats van vrije statuswijziging. `Equipment_BuildOut` zet status op *Afgevoerd* (of een wisselstuk-status) en filtert daartoe op `Status` en `ProcessFunction`; `Equipment_Move` schrijft een nieuwe `Space` en past de status aan bij verplaatsing. Inbouwen gaat via `Equipment_ActionField1700_BuildIn`, uitbouwen als uitwisselstuk via `Equipment_ActionField1700_BuildOutExchangePart`. In totaal schrijven 16 workflows de `Status`-property en lezen er 28 — een wijziging is daardoor zelden een enkelvoudige actie maar een getriggerde keten. Consultanttip: controleer altijd de lifecycle-workflow voordat je `Status` programmatisch overschrijft; sommige transitions vereisen ook een `ProgressStatus`-reset.

- **`EquipmentType` + overerving van features en reservedelen** — Bij aanmaak via `EquipmentType_CreateEquipment` worden `EquipmentType`, `IndividualPM`, `MaintenanceClassification` en `Description` direct vanuit het type gezet. Daarna kopieert `Equipment_CopyFeaturesAndSparePartsFromEquipmentType` de feature-definities en reservedelen-sjablonen van het type naar het individuele equipment. Wijzigt een consultant later het onderhoudsconcept, dan wordt `Equipment_SetEquipmentTypeFieldsFromChangeMntcClassification` aangeroepen om type-velden opnieuw te synchroniseren. Zeven workflows schrijven `EquipmentType`; zorg bij een bulk-import dat het type vóór de features aanwezig is, anders mislukt de kopieeractie.

- **`IndividualPM` en `MaintenanceClassification` (onderhoudsconcept)** — `IndividualPM` stuurt of het equipment zijn eigen PO-planning krijgt of meeloopt in een groeps-PO. `Equipment_ChangeIndividualPM` schrijft `IndividualPM`, herberekent `NextPmMaintenanceDate` en past `IsBulk` aan. `Equipment_ChangeMaintenanceClassification` en zijn variant `Equipment_ChangeMaintenanceClassification_IndividualPMIsFalse` schrijven `MaintenanceClassification` en sturen via `Equipment_RemovePmWorkOrders` / `Equipment_AddPmWorkOrdersFromPeriodicActivities` de PO-modelkoppeling bij. `NextPmMaintenanceDate` wordt bijgehouden door vier workflows (o.a. `PmWorkOrder_DeletePeriodicActivity`) en gelezen door drie — een wijziging in het onderhoudsconcept raakt dus direct de eerstvolgende onderhoudsdatum.

- **Kostendragers: `CostCenter`, `Department`, `Site`, `ProcessFunction`** — Deze vier velden worden elk door een dedicated workflow bijgehouden: `Equipment_ChangeCostCenter`, `Equipment_ChangeDepartment`, `Equipment_ChangeSite`. Jobs en inkoopregels lezen de kostendragers rechtstreeks van het equipment (o.a. `PmWorkOrder_CreateJobs_ProcessCreatedJob_SetCostCarriers`, `PurchaseLine_CopyDataFromEquipmentProcessFunction`) zodat kosten automatisch op de juiste dragers landen. `ProcessFunction` wordt daarnaast door `Equipment_UpdateExchangePartLocationAndRegisterMutation` geschreven bij een exchange-part mutatie.

- **`Space` (ruimte/locatie)** — Zeven workflows schrijven `Space`: naast `Equipment_Move` ook `Equipment_ChangeSpace`, `EquipmentMoveLine_PreCreated` (bij aanmaak van een verplaatsingsregel) en de mobiele flows `Mobile_Equipment_ClearSpace` en `Mobile_Space_AddEquipment`. `REST_Equipment_UpdateTrackAndTraceLocation` schrijft `Space` via de REST API vanuit track-and-trace systemen. Jobs nemen de ruimte over via `Job_SetBuildingAndSpaceFromEquipment`.

- **Wisselstukken (`ExchangePart`) — locatie en mutatie** — Als `ExchangePart = true` geldt een aparte levenscyclus met eigen statuswaarden (Inzetbaar/Operationeel/Defect). `Equipment_UpdateExchangePartLocationAndRegisterMutation` schrijft `ProcessFunction` bij een locatiewissel en registreert de mutatie; `Equipment_ChangeLocationExchangePart` verwerkt een handmatige locatiewijziging. `ExchangePart` zelf wordt door geen enkele workflow geschreven (het is een configuratieveld) maar wél door tien workflows gelezen en drie gefilterd — onder meer `Equipment_BuildOut`, dat het gedrag splitst op basis van dit veld.

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

---