WorkOrder (Werkorder / Project / Stop)

De WorkOrder-entiteit wordt gebruikt voor het bundelen van jobs in projecten, deelprojecten en stops. Een WorkOrder fungeert als container met budgetbewaking en voortgangsregistratie. Let op: in Ultimo-terminologie is "WorkOrder" niet hetzelfde als een job/werkorder in de dagelijkse betekenis.

Entiteitsnaam: WorkOrder Databasetabel: WorkOrder Primaire sleutel: WOID (nvarchar 9)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

Veel WorkOrder-properties worden niet alleen handmatig ingevuld, maar door workflows berekend of overgenomen vanuit bovenliggende structuren. Onderstaande paragrafen beschrijven het gedrag van de meest relevante properties; gebruik lookup_property_usage("WorkOrder", "<property>") voor de volledige, actuele lijst workflows per property en lookup_workflow("<naam>") voor de bijbehorende XML.

• Status (recordstatus) — De levenscyclus van een WorkOrder verloopt via een vaste reeks gateworkflows, analoog aan de Job. De overgangsworkflows WorkOrder_Approve, Workorder_PreActivate, WorkOrder_PreClose bewaken respectievelijk de stap naar Goedgekeurd (2), Actief (4) en Gesloten (32). Projectworkflows propageren statuswijzigingen omhoog: Project_PreActive, Project_PreApproved, Project_PreFinish en Project_PreClose lezen de Status van de bijbehorende WorkOrders om te bepalen of een project de gevraagde overgang mag maken. Een WorkOrder blokkkeert zo de statusovergang van het bovenliggende project zolang onderliggende stappen niet zijn afgerond. Workflow WorkOrder_PostImport zorgt voor correcte statusintialisatie bij importscenario's.

• ScheduledStartDate & TargetDate — In tegenstelling tot bij Job, waar deze datums door tientallen workflows worden geschreven, kent WorkOrder slechts één directe schrijver voor beide datumvelden: Project_AddOrEditStopWorkOrder. Dit is de centrale workflow die een Stop-WorkOrder (context 8) aanmaakt of bewerkt vanuit een plant-stop op project-niveau, en daarin de planningsdatums doorgeeft vanuit de stop-definitie. Meer dan tien workflows lezen de datums vervolgens om onderliggende jobs te plannen en te valideren — de keten Job_PlanForStop, Job_PlanForStop_CreateJob, Job_PlanForStop_Validations en Job_LinkToStop gebruiken ScheduledStartDate/TargetDate van de WorkOrder als kader waarbinnen nieuwe jobs mogen worden ingepland. Consultanttip: de planningsdatums van een Stop-WorkOrder zijn leidend voor alle jobs erin; pas ze aan op WorkOrder-niveau, niet op job-niveau.

• Project (bovenliggend project) — De Project-property wordt nooit direct door een workflow geschreven op WorkOrder: de koppeling wordt vastgelegd bij aanmaak en daarna bewaard. Zeven workflows filteren op Project om de juiste WorkOrders op te halen: Project_EditStop, Project_PreActive, Project_PreApproved, Project_PreClose, Project_PreFinish en WorkOrder_PreApprove controleren of alle onderliggende WorkOrders van een project in de juiste status zijn voordat een projectovergang wordt toegestaan. ActionField1165 filtert ook op Project voor specifieke stop-gerelateerde acties. Dit mechanisme implementeert de hiërarchische voortgangsbewaking: project → WorkOrder → Job.

• ProcessFunction — Wordt door Project_AddOrEditStopWorkOrder overgenomen bij het aanmaken of bewerken van een Stop-WorkOrder. Workflows Job_PlanForStop en WorkOrder_CreateJob lezen de ProcessFunction om de juiste context mee te geven aan nieuw aan te maken jobs. WorkOrder_PreApprove filtert op ProcessFunction als onderdeel van goedkeuringsvalidaties. Dit maakt het mogelijk om werkzaamheden te groeperen per procesfunctie binnen een stop.

• Priority — Wordt geschreven door WorkOrder_SetPriorityByImpactAndUrgency, dat de prioriteit berekent op basis van de combinatie van Impact en Urgency — hetzelfde impact×urgentie-mechanisme dat voor Jobs in ITSM-context wordt gebruikt. WorkOrder_CreateJobSecondWay leest de Priority vervolgens bij het aanmaken van een nieuwe job vanuit de WorkOrder, zodat de job de prioriteit van de container erft. Consultanttip: bij ITSM-gerelateerde WorkOrders (context Change) wordt de prioriteit dus afgeleid, niet handmatig gekozen.

• Description & SortOrder — Beide worden door Project_AddOrEditStopWorkOrder geschreven bij het aanmaken of updaten van een Stop-WorkOrder. SortOrder bepaalt de volgorde van WorkOrders binnen een stop-gantt of planningsoverzicht; wijzigingen via het gantt-scherm gaan via dezelfde workflow. Description wordt door Job_PlanForStop en de bijbehorende feedbackworkflows gelezen om de context van de stop te communiceren naar de aangemaakte jobs.

• Equipment — Wordt door ActionField120 geschreven (koppeling van een asset aan de WorkOrder) en direct daarna gelezen om bij WorkOrder_CreateJobSecondWay het equipment door te zetten naar nieuw aangemaakte jobs. Hierdoor erven jobs die vanuit een WorkOrder worden aangemaakt automatisch het gekoppelde object, inclusief de bijbehorende kostendragers (CostCenter, Department, Site) die via WorkOrder_CreateJobSecondWay worden meegenomen.

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

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• Stops: Context Stop (8) wordt gebruikt voor plant-stops/shutdowns waarbij meerdere jobs worden gebundeld.
• Deelprojecten: Context Deelproject (4) is een WorkOrder die onder een project valt.
• Budgetbewaking: Het budget wordt bewaakt via BudgetOriginal + BudgetMutation = BudgetTotal. Kosten worden automatisch opgerold vanuit onderliggende jobs.
• Auto-sluiten: Met AutoClose = true wordt de WorkOrder automatisch gesloten als alle onderliggende jobs zijn afgerond.
• Kosten: Alle kostensoorten (uren, materialen, inkoop, extern) worden vanuit de jobs geaggregeerd naar de WorkOrder.
• Prognose: Via ToSpendForecast kan een inschatting worden gegeven van de nog te verwachten kosten.

Database Detailsbewerken

De tabel dba.WorkOrder bevat 113 kolommen.

Computed columns (berekende velden)bewerken

Consultanttip: De vier computed totaalkolommen geven een compleet financieel overzicht: budget vs. begroot vs. werkelijk vs. gefactureerd. Gebruik deze voor budgetbewaking en financiele rapportages.

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

Kostengerelateerde kolommen (alle decimal(21,5), geaggregeerd vanuit onderliggende Jobs):

Overige trigger-kolommen:

Belangrijke defaultsbewerken

Triggers en externe triggersbewerken

WorkOrder heeft 3 eigen triggers (UPDATE, DELETE-summary, INSERT/UPDATE-summary) en wordt beinvloed door 5 externe triggers:

• Job-triggers: Bij INSERT/UPDATE/DELETE van jobs worden alle kosten- en urenkolommen opnieuw geaggregeerd
• WorkOrderBudgetSuppl-triggers: Budgetsuppleties updaten WoBudgetMutation

Consultanttip: De WorkOrder-tabel aggregeert alle kosten vanuit onderliggende Jobs. Dit betekent dat de financiele kolommen op WorkOrder altijd actueel zijn, maar ook dat elke Job-mutatie een UPDATE op de WorkOrder triggert. Bij grote aantallen jobs onder een WorkOrder kan dit performance-impact hebben.

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("WorkOrder") · reference/entities/WorkOrder Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("WorkOrder") · reference/tables/WorkOrder Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="WorkOrder") Alle Before/After Save events en andere workflow-ActionFields voor WorkOrder. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("WorkOrder", "ScheduledStartDate") · reference/properties/WorkOrder Toont welke workflows de planningsdatums van WorkOrder schrijven, lezen of filteren; onmisbaar bij stop-planningsproblemen. Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("Project_AddOrEditStopWorkOrder") Volledige logica van de centrale stop-aanmaakworkflow die ScheduledStartDate, TargetDate, Description, ProcessFunction en SortOrder schrijft. Bron: workflows.xml.

Zie ookbewerken

• project - Projecten (bovenliggend niveau)
• job - Werkorders binnen de WorkOrder
• pm-workorder - PO-modellen die WorkOrders gebruiken
• equipment - Assets