Bewerken: ConditionFlawPresent (Geconstateerd gebrek)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

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

- **Aanmaak en `Status` (levenscyclus)** — Een geconstateerd gebrek wordt zelden handmatig aangemaakt. De kern is `ConditionFlawPresent_Create`, die via een `JobInspectionLine`-filter het record aanmaakt en direct de beginwaarden van `Status`, `ConditionMeasurement` en `JobInspectionLine` invult. Vanuit de mobiele app triggert `Mobile_ConditionFlawPresent_Report` de aanmaak met `Description` en `Status`. Tijdens en na een conditiemeting-job schrijven `Job_CreateConditionMeasurements` en `Job_CreateConditionMeasurementsMaintenanceElements` batches van gebreken met hun volledige setscore-context. Na afsluiting of gereedmelding van de bovenliggende job worden bestaande gebreken bijgewerkt via `Job_UpdateConditionFlawPresents`. In totaal schrijven 16 workflows de `Status`-property; wijzig status nooit rechtstreeks zonder de bijbehorende lifecycle-workflow te doorlopen.

- **Score-berekening: `ConditionIntensity`, `ConditionSize`, `MaintenanceState`** — Deze drie velden vormen samen het NEN 2767-scoringmechanisme. `ConditionIntensity` (intensiteitsklasse 1–6) en `ConditionSize` (omvangsklasse) worden geschreven door `Mobile_ConditionMeasurement_ChangeConditionFlawPresent` en `Mobile_ConditionMeasurement_ReportConditionFlawPresent`. Op basis van deze waarden én `ConditionFlaw` berekent `ConditionFlawPresent_UpdateScore` de `MaintenanceState` (onderhoudsstaat). Aanvullend herberekent `ConditionFlawPresent_SetMaintenanceState` de onderhoudsstaat als ook `Age` en het gebrektype zijn gewijzigd. Consultanttip: de juiste `ConditionFlaw`-koppeling is een vereiste voor een correcte score; ontbreekt die, dan geeft `ConditionFlawPresent_UpdateScore` geen betrouwbare uitkomst.

- **`ConditionSize` en feitelijke omvang (`Size`)** — Naast de omvangsklasse (`ConditionSize`, een referentie-entiteit) bewaakt `ConditionFlawPresent_UpdateSizeAndScore` ook de numerieke `Size`-kolom en herberekent na een wijziging automatisch de score. `ActionField678` schrijft eveneens `ConditionSize` via een desktopscherm, zodat zowel mobiel als desktop dezelfde score-keten triggeren.

- **Koppeling aan herstelwerkorders via `SolveJob`** — Wanneer een gebrek een eigen herstelwerkorder krijgt, schrijft `ConditionFlawPresent_LinkConditionFlawPresentToJob` de `SolveJob`-property en past `Status` aan. Omgekeerd maakt `ConditionFlawPresent_UnlinkConditionFlawPresentFromJob` de `SolveJob`-koppeling ongedaan en reset de status. Na afsluiting of gereedmelding van de herstelwerkorder zorgen `Job_PostFinish` en `Job_PostClose` dat `SolveJob` gefilterd wordt en de gekoppelde gebreken worden afgesloten of op vervallen gezet. `ActionField522` schrijft `SolveJob` via het desktopscherm; zeven workflows filteren op dit veld voor rapportage, waaronder `ArcGIS_ReportConditionFlawPresentsPerProcessFunction_GetConditionFlawPresents`.

- **Verwijdering en `DeletedByInspector`** — In de mobiele inspectie-workflow kan een inspecteur een gebrek als verwijderd markeren via `Mobile_ConditionFlawPresent_ToggleDeletedByInspector`, wat de `DeletedByInspector`-vlag zet. `ActionField795` biedt dezelfde functie op het desktopscherm. `Job_CreateConditionMeasurements` en `Job_CreateConditionMeasurementsMaintenanceElements` lezen dit vlag om soft-deleted gebreken uit de score-aggregatie te houden. Het daadwerkelijk verwijderen (Trash) wordt bewaakt door `ConditionFlawPresent_PreTrash`, die via een `JobInspectionLine`-filter controleert of verwijdering veilig is.

- **Afbeeldingen (`ImageFile` t/m `ImageFile4`)** — Vier afbeeldingsvelden kunnen worden gevuld via de workflow `ConditionFlawPresent_UpdateImageFiles`, die ook zichzelf leest om duplicaten te voorkomen. `JobInspectionLine_ProcessInspectionImageFiles` leest alle vier velden na afsluiting van een inspectielijnen om de afbeeldingen definitief op te slaan.

- **Externe dataproviders (`DataProvider`, `ProviderMutationDate`)** — Bij integratie met externe GIS-systemen (bijv. ArcGIS) vult `DataProvider` de naam van het bronpakket en registreert `ProviderMutationDate` de laatste synchronisatietijd. `ArcGIS_ReportConditionFlawPresentsPerProcessFunction_GetConditionFlawPresents` filtert op `ProcessFunction`, `ConditionFlaw` en `Material` om gebreken te exporteren naar het GIS-platform.

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

---