PmWorkOrder (Preventief Onderhoudsmodel)

De PmWorkOrder-entiteit (ook wel PO-model genoemd) definieert het preventief onderhoud in Ultimo. Een PO-model bepaalt welk onderhoud wanneer moet worden uitgevoerd, op basis van tijd (frequentie) of conditie (meetwaarden). Het PO-model genereert automatisch jobs wanneer onderhoud gepland staat.

Entiteitsnaam: PmWorkOrder Databasetabel: PmWorkOrder Primaire sleutel: PMWID (nvarchar 5)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

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

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• Frequentie vs. Conditie: Een PO-model kan tijdgestuurd (vaste frequentie) of conditiegestuurd (op basis van meetpuntwaarden) zijn. Bij conditiegestuurd staat Dynamic = true.
• Marges: Via MarginBeforeQuantity/MarginAfterQuantity en bijbehorende tijdseenheden kan een marge worden ingesteld waarbinnen een job moet worden uitgevoerd.
• Groeps-PO: Met GroupPmWorkOrder kunnen PO-modellen worden gegroepeerd zodat ze gezamenlijk worden aangestuurd.
• Looproutes: Context CourseRoute (4) wordt gebruikt voor inspectieroutes waarbij een monteur meerdere equipments langs gaat.
• Generatie: Het PO-model genereert jobs via de PO-run (WorkOrderSchedule). De NextMaintenanceDate wordt automatisch berekend.
• Werkplan: Via het JobPlan worden standaard materialen, taken, resources en uren op de gegenereerde job gezet.
• Stop-gerelateerd: Met StopRelated = true worden jobs alleen gegenereerd tijdens een plant-stop.
• Uitvoeringspercentage: Via ExecutionPercentage kan worden aangegeven hoeveel procent van de geplande taken daadwerkelijk wordt uitgevoerd.

Database Detailsbewerken

De tabel dba.PmWorkOrder bevat 106 kolommen.

Computed columns (berekende velden)bewerken

Kolommen gezet door triggers (selectie van 21 trigger-kolommen)bewerken

Kostengerelateerde kolommen (allemaal decimal(21,5)):

Relatie- en scheduling-kolommen:

Belangrijke defaultsbewerken

Triggers en externe triggersbewerken

PmWorkOrder heeft 2 eigen triggers (INSERT, UPDATE) en wordt beinvloed door 17 externe triggers:

• PmJob-triggers: Wijzigingen in PO-taken updaten het PO-model
• JpMat/JpExt/JpTls/JpRes/JpPurchaseRequestLine-triggers: Werkplan-componentwijzigingen herberekenen de kostenkolommen
• ObjectJobPlan/PmJobJobPlan-triggers: Werkplan-koppelingen synchroniseren
• Equipment-triggers: Wijzigingen aan equipment propageren naar het PO-model
• ProcessFunction-triggers: Procesfunctie-wijzigingen (inclusief DELETE) propageren

Consultanttip: De Sub-kostenkolommen (SubMatCalc, etc.) zijn relevant bij groeps-PO-modellen en bevatten de opgetelde kosten van onderliggende PO-modellen. Bij het analyseren van kosten voor een PO-model moet je zowel de directe kosten als de sub-kosten bekijken.

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("PmWorkOrder") · reference/entities/PmWorkOrder Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("PmWorkOrder") · reference/tables/PmWorkOrder Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="PmWorkOrder") Alle Before/After Save events en andere workflow-ActionFields voor PmWorkOrder. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("PmWorkOrder", "ExecutionPercentage") · reference/properties/PmWorkOrder Welke workflows ExecutionPercentage lezen, schrijven of filteren (8 writers incl. PmWorkOrder_UpdateFromMaintenanceClassification). Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("PmWorkOrder_PreApprovePeriodicActivity") Volledige logica achter het overnemen van ExecutionDays/UseExecutionPercentage uit het MaintenanceClassification bij goedkeuring van een periodieke activiteit. Bron: workflows.xml.

Zie ookbewerken

• equipment - Assets waarvoor PO-modellen gelden
• job - Gegenereerde werkorders
• maintenance-classification - Onderhoudsconcepten
• work-order - Werkorders/stops