PmJob (Periodieke onderhoudsjob)

De PmJob-entiteit is een onderdeel van een PmWorkOrder (PO-model). Elk PO-model bevat een of meerdere PmJobs die de daadwerkelijke werkzaamheden beschrijven. Bij het genereren van een werkorder wordt per PmJob een job aangemaakt.

Entiteitsnaam: PmJob Databasetabel: PmJob Primaire sleutel: PMJPMWID + PMJID (composiet: PmWorkOrder + LineId)

Contextsbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

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 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.

Statussenbewerken

Sub-entiteitenbewerken

PmJobMaterialbewerken

Gepland materiaal op PO-job. PK: PMJMPMWID + PMJMPMJID + PMJMARTID.

PmJobResourcebewerken

Geplande capaciteit op PO-job. PK: PMJRPMWID + PMJRPMJID + PMJRLINEID.

Statussen PmJobResource: None (0), Te plannen (4).

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• PO-model structuur: Een PmWorkOrder bevat een of meer PmJobs. Elk genereert een aparte job bij het draaien van de planning.
• Delay-veld: Met Delay kun je jobs na de planning-trigger laten starten (bijv. 7 dagen na de basisdatum).
• UseStandardJobPlan: Als true, wordt het standaard werkplan van het equipmenttype gebruikt i.p.v. een specifiek werkplan.
• Kostenberekening: TotalCalculated is de som van materialen, uren, gereedschap en diversen. De deelberekeningen staan in MaterialsCalculated, ResourcesCalculated, ToolsCalculated, ExternalsCalculated.
• UseWorkScheduleForPlanning: Bepaalt of bij het berekenen van de jobduur rekening wordt gehouden met het werkrooster.

Brondatabewerken

Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.

• Entity-definitie — lookup_entity("PmJob") · reference/entities/PmJob Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("PmJob") · reference/tables/PmJob Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="PmJob") Alle Before/After Save events en andere workflow-ActionFields voor PmJob. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("PmJob", "Status") · reference/properties/PmJob Welke workflows Status schrijven, lezen of filteren (12 writers incl. PmWorkOrder_PostApprove, Equipment_ReopenPMAndTrashInspectionLines). Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("PmWorkOrder_PostApprove") Volledige logica achter het goedkeuren van PmJobs, zetten van de volgende onderhoudsdatum op equipment, en activering van AutoPmActive. Bron: workflows.xml.

Zie ookbewerken

• pm-workorder - PO-modellen
• job - Werkorders
• job-plan - Werkplannen
• job-material - Materiaalregels
• activity - Activiteiten