Bewerken: PmJob (Periodieke onderhoudsjob)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

PmJob-properties worden deels handmatig ingesteld door de planner en deels automatisch gevuld door workflows bij het goedkeuren van het PO-model of het genereren van jobs. Onderstaande paragrafen beschrijven het gedrag van de meest relevante velden; gebruik `lookup_property_usage("PmJob", "<property>")` voor de volledige lijst en `lookup_workflow("<naam>")` voor de XML.

- **`Status` — de levenscyclus van de PO-taak** — `Status` wordt door 12 workflows geschreven. De kernstroom is: `PmWorkOrder_PostApprove` keurt alle openstaande PmJobs goed (`PmJobStatus.Approved`) als de instelling `PmWorkOrder.ApprovePmJobs = True` of het PO-model tot een groep behoort. `PmWorkOrder_PostReopen` zet goedgekeurde PmJobs terug naar `Created` bij heropening van het PO-model. Bij wijziging van het [[maintenance-classification|MaintenanceClassification]] schrijft `Equipment_ChangeMaintenanceClassification_IndividualPMIsFalse` de status rechtstreeks. `PmJob_PostImport` stelt de status na een import in. Het statusfilter van 18 workflows maakt `Status` tot de meest gefilterde property van PmJob — gebruik de status altijd als eerste filter bij GetList-queries op PmJobs.

- **`JobPlan` — de blauwdruk voor de gegenereerde job** — Geschreven door `JobPlan_PreDelete` (leegmaken bij verwijdering van het werkplan). `PmJob_PreApprove_Validate` valideert dat een werkplan aanwezig is wanneer `UseStandardJobPlan = True`, en dat het `JobPlan.DowntimeRequired` overeenkomt met `PmJob.DowntimeRequired`. `PmWorkOrder_CreateJobs` leest `JobPlan` bij de job-generatie om materialen, resources, gereedschappen en taken op de nieuwe [[job]] te zetten. Consultanttip: bij gebruik van `UseStandardJobPlan = True` wordt het standaard werkplan van het equipmenttype gebruikt in plaats van het hier gekoppelde werkplan — controleer welk pad actief is vóór goedkeuring.

- **`UseStandardJobPlan` — overschakelen naar standaard werkplan** — Geschreven door `ActionField705` (interactief), `PmJobJobPlan_CreatePmJobJobPlanForJobPlanAndPmJob` en `PmJobJobPlan_PreDelete`. `PmJob_PreApprove_Validate` en `WorkOrder_CreateJobSecondWay` lezen deze vlag om te bepalen welk werkplan bij generatie wordt toegepast. Als `UseStandardJobPlan = True` wordt het JobPlan van het gekoppelde equipment- of procesfunctietype gekozen; bij `False` geldt het expliciet ingestelde `JobPlan`. De vlag is dus bepalend voor of aanpassingen aan het werkplan via het equipmenttype automatisch doorsijpelen.

- **`DowntimeRequired` — stilstandbeheer** — Wordt door `ActionField1624` en `PmJobJobPlan_CreatePmJobJobPlanForJobPlanAndPmJob` geschreven. `PmJob_PreApprove_Validate` valideert de consistentie met het gekoppelde werkplan: als `DowntimeRequired = False` op de PmJob staat maar het werkplan wél stilstand vereist, blokkeert de validatie de goedkeuring. `ActionField1625` toont een waarschuwing op basis van deze vlag. Correct instellen van `DowntimeRequired` is cruciaal bij de planning van stoprelevante onderhoudstaken.

- **`Description` — ingevuld bij goedkeuring** — Geschreven door `PmJob_PreApprove` en `PmWorkOrder_PostApprove`. Bij looproute-contexten (CourseRoute, BuildingCourseRoute, InfraCourseRoute) overschrijft `PmWorkOrder_PostApprove` de `Description` met de omschrijving van het bovenliggende PO-model. Dit zorgt voor consistente benamingen in de gegenereerde looproute-jobs zonder handmatige aanpassing per PmJob.

- **`Delay` en `DurationCalculated` — timing-offset van de job** — Beide geschreven door `PmJob_ConvertDurationFromDaysToHours`. `Delay` slaat de offset op in dagen die een job na de planningstrigger moet starten (bijv. PmJob 2 start 7 dagen na PmJob 1). `DurationCalculated` bevat de omgezette doorlooptijd in uren nadat de conversie van dagen naar uren is uitgevoerd. De vlag `ConvertedDurationToHours` (ook geschreven/gelezen door `PmJob_ConvertDurationFromDaysToHours`) voorkomt dubbele conversie.

- **`ReopenedAutomatically` — heropening door equipment-wijziging** — Wordt door `Equipment_ReopenPMAndTrashInspectionLines` op `True` gezet wanneer het equipment heractivering triggert, en door `PmJob_PostApproved` bij het goedkeuren van de PmJob. `Equipment_ApprovePMAndUnTrashInspectionLines` filtert op deze vlag om te bepalen welke PmJobs heractivering behoeven. Via deze vlag is het traceerbaar welke PmJobs door een automatische trigger zijn heropend versus handmatige heractivering — relevant bij audits en probleemanalyse.

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

---