Bewerken: PmWorkOrder (Preventief Onderhoudsmodel)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel PmWorkOrder-properties worden niet handmatig ingevuld, maar automatisch berekend of door workflows gevuld bij het doorlopen van de goedkeur- en generatiecyclus. Onderstaande paragrafen beschrijven het gedrag van de meest gebruikte velden; gebruik `lookup_property_usage("PmWorkOrder", "<property>")` voor de volledige lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **`Frequency` en `FrequencyPeriod` — de kern van tijdgestuurd onderhoud** — Deze twee properties worden door meer dan 10 workflows gelézen maar nooit automatisch geschréven; de planner stelt ze handmatig in. `PmWorkOrder_Approved_Validations` en `PmWorkOrder_PreApprove_Validate` controleren of de combinatie valide is (o.a. dat `Frequency != 0` en `FrequencyPeriod != Empty` wanneer het om tijdgestuurd onderhoud gaat). `PmWorkOrder_CheckNeedForMaintenance` berekent op basis van `Frequency`/`FrequencyPeriod` en de `LastMaintenanceDate` of onderhoud benodigd is en initieert vervolgens `PmWorkOrder_CreateJobs`. Consultanttip: een `Frequency = 0` of een lege `FrequencyPeriod` blokkeert de volledige generatieketen — altijd valideren vóór goedkeuring.

- **`ExecutionPercentage` en `ExecutionDays` — afgeleid van het onderhoudsconcept** — Beide worden door `PmWorkOrder_UpdateFromMaintenanceClassification` en `PmWorkOrder_PreApprovePeriodicActivity` gevuld op basis van het gekoppelde [[maintenance-classification|MaintenanceClassification]]. De workflow `PmWorkOrder_PreApprovePeriodicActivity` kopieert `MaintenanceClassification.ExecutionDays` en `MaintenanceClassification.UseExecutionPercentage` naar het PO-model — tenzij `DeviateFromMaintenanceClassification = True`, in welk geval de PO-modelwaarden intact blijven. `PmWorkOrder_EmptyExecutionPercentageFieldsWhenSettingIsDisabled` leegt beide velden wanneer de `UseExecutionPercentage`-instelling wordt uitgeschakeld. Let op: `ExecutionPercentage = 0` terwijl `UseExecutionPercentage = True` is een geblokkeerde configuratie — de workflow sloeg dan de overname over (zie condities in `PmWorkOrder_PreApprovePeriodicActivity`).

- **`Status` — de poortwachter van de generatieketen** — `Status` wordt door 15 workflows geschreven. De kernketen is: `PmWorkOrder_PostApprove` (goedkeuren + PmJobs goedkeuren + volgende onderhoudsdatum op equipment zetten), `PmWorkOrder_PostReopen` (heropenen + goedgekeurde PmJobs terugzetten naar Open), en `PmWorkOrder_RemovePmWorkOrders` (verwijderen incl. gekoppelde PmJobs). `Equipment_ApprovePMAndUnTrashInspectionLines` en `Equipment_ReopenPMAndTrashInspectionLines` schrijven `Status` vanuit equipment-zijde wanneer het equipment in- of uitservice gaat. Bij periodeactiviteiten stuurt `PmWorkOrder_ReopenIfItHasNoApprovedPmJobs` automatisch het heropenen aan als er geen goedgekeurde PmJobs meer zijn.

- **`AutoPmActive` — automatische job-generatie** — Wordt door `ActionField1249` geschreven en bepaalt of de PO-run (`PmWorkOrder_CreateJobs`) automatisch jobs aanmaakt zonder handmatig ingrijpen. `PmWorkOrder_PostApprove` zet de `NextRunDate` zodra `AutoPmActive = True` én de datum nog leeg is. `PmWorkOrder_CreateJobs` leest `AutoPmActive` bij elke run om te beslissen of generatie van toepassing is. In omgevingen met veel PO-modellen levert dit het verschil tussen handmatig beheer en volledig geautomatiseerde preventief-onderhoudsplanning.

- **`LastMaintenanceDate` — historische anker voor frequentieberekening** — Geschreven door `ActionField169` (handmatige correctie), `Job_Actionfield286_ReleaseCondition` (bij het vrijgeven van een job) en `PmWorkOrder_Approve_Validations` (bij het goedkeuringsproces). `PmWorkOrder_CheckNeedForMaintenance` en `PmWorkOrder_PreApprove` lezen deze datum om de volgende benodigde onderhoudsdatum te berekenen. `PmWorkOrder_UpdatePmWorkOrdersWithLowerFrequencyAndBelongingToSchema` gebruikt `LastMaintenanceDate` om schema-PO-modellen met lagere frequentie te synchroniseren. Consultanttip: een verkeerde `LastMaintenanceDate` (bijv. na een datamigatie) leidt direct tot vroeg of laat gegenereerde jobs — altijd controleren bij ingebruikname.

- **`IsBulk` — bulk-inspectiegedrag** — Wordt door `PmWorkOrder_PreReopenPeriodicActivity` op `True` gezet bij heropening van een bulk-periodieke activiteit. `PmWorkOrder_PostReopen` reset vervolgens `Equipment.IsBulk = False` zodra het PO-model is heropend. `PmWorkOrder_Approve_Validations`, `PmWorkOrder_PostApprove` en `Job_PreFinish_BulkJob` lezen `IsBulk` om bulk-specifieke validaties en afsluitlogica toe te passen. Bulk-PO-modellen combineren meerdere inspectiepunten in één job — de `IsBulk`-vlag is de schakelaar daarvoor.

- **`UseExecutionPercentage` — integratie met onderhoudsconcept** — Geschreven door `PmWorkOrder_PreInsert` (initialisatie op `True`), `PmWorkOrder_UpdateFromMaintenanceClassification`, en `PmWorkOrder_PreApprovePeriodicActivity`. Meerdere ActionFields (o.a. `ActionField172`, `ActionField1756`) schrijven deze vlag interactief. De vlag bepaalt of de `ExecutionPercentage`-waarde of de `ExecutionDays`-waarde wordt gebruikt voor de uitvoeringsvensterberekening van de PO-run.

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

---