Equipment (Installatie)

De Equipment-entiteit is de kern-asset entiteit in Ultimo. Hierin worden alle fysieke objecten vastgelegd die onderhouden moeten worden, van installaties en instrumenten tot fleet-voertuigen en configuratie-items. Equipment vormt het hart van het asset management en is gekoppeld aan vrijwel alle andere processen.

Entiteitsnaam: Equipment Databasetabel: Equipment Primaire sleutel: EQMID (nvarchar 14)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

Veel Equipment-properties worden niet alleen handmatig ingevuld maar door workflows gevuld, gekopieerd of afgekeurd. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik lookup_property_usage("Equipment", "<property>") voor de volledige, actuele lijst workflows per property en lookup_workflow("<naam>") voor de XML.

• Status (levenscyclus: BuildIn → Operationeel → BuildOut/Move) — De recordstatus loopt langs vaste lifecycle-workflows in plaats van vrije statuswijziging. Equipment_BuildOut zet status op Afgevoerd (of een wisselstuk-status) en filtert daartoe op Status en ProcessFunction; Equipment_Move schrijft een nieuwe Space en past de status aan bij verplaatsing. Inbouwen gaat via Equipment_ActionField1700_BuildIn, uitbouwen als uitwisselstuk via Equipment_ActionField1700_BuildOutExchangePart. In totaal schrijven 16 workflows de Status-property en lezen er 28 — een wijziging is daardoor zelden een enkelvoudige actie maar een getriggerde keten. Consultanttip: controleer altijd de lifecycle-workflow voordat je Status programmatisch overschrijft; sommige transitions vereisen ook een ProgressStatus-reset.

• EquipmentType + overerving van features en reservedelen — Bij aanmaak via EquipmentType_CreateEquipment worden EquipmentType, IndividualPM, MaintenanceClassification en Description direct vanuit het type gezet. Daarna kopieert Equipment_CopyFeaturesAndSparePartsFromEquipmentType de feature-definities en reservedelen-sjablonen van het type naar het individuele equipment. Wijzigt een consultant later het onderhoudsconcept, dan wordt Equipment_SetEquipmentTypeFieldsFromChangeMntcClassification aangeroepen om type-velden opnieuw te synchroniseren. Zeven workflows schrijven EquipmentType; zorg bij een bulk-import dat het type vóór de features aanwezig is, anders mislukt de kopieeractie.

• IndividualPM en MaintenanceClassification (onderhoudsconcept) — IndividualPM stuurt of het equipment zijn eigen PO-planning krijgt of meeloopt in een groeps-PO. Equipment_ChangeIndividualPM schrijft IndividualPM, herberekent NextPmMaintenanceDate en past IsBulk aan. Equipment_ChangeMaintenanceClassification en zijn variant Equipment_ChangeMaintenanceClassification_IndividualPMIsFalse schrijven MaintenanceClassification en sturen via Equipment_RemovePmWorkOrders / Equipment_AddPmWorkOrdersFromPeriodicActivities de PO-modelkoppeling bij. NextPmMaintenanceDate wordt bijgehouden door vier workflows (o.a. PmWorkOrder_DeletePeriodicActivity) en gelezen door drie — een wijziging in het onderhoudsconcept raakt dus direct de eerstvolgende onderhoudsdatum.

• Kostendragers: CostCenter, Department, Site, ProcessFunction — Deze vier velden worden elk door een dedicated workflow bijgehouden: Equipment_ChangeCostCenter, Equipment_ChangeDepartment, Equipment_ChangeSite. Jobs en inkoopregels lezen de kostendragers rechtstreeks van het equipment (o.a. PmWorkOrder_CreateJobs_ProcessCreatedJob_SetCostCarriers, PurchaseLine_CopyDataFromEquipmentProcessFunction) zodat kosten automatisch op de juiste dragers landen. ProcessFunction wordt daarnaast door Equipment_UpdateExchangePartLocationAndRegisterMutation geschreven bij een exchange-part mutatie.

• Space (ruimte/locatie) — Zeven workflows schrijven Space: naast Equipment_Move ook Equipment_ChangeSpace, EquipmentMoveLine_PreCreated (bij aanmaak van een verplaatsingsregel) en de mobiele flows Mobile_Equipment_ClearSpace en Mobile_Space_AddEquipment. REST_Equipment_UpdateTrackAndTraceLocation schrijft Space via de REST API vanuit track-and-trace systemen. Jobs nemen de ruimte over via Job_SetBuildingAndSpaceFromEquipment.

• Wisselstukken (ExchangePart) — locatie en mutatie — Als ExchangePart = true geldt een aparte levenscyclus met eigen statuswaarden (Inzetbaar/Operationeel/Defect). Equipment_UpdateExchangePartLocationAndRegisterMutation schrijft ProcessFunction bij een locatiewissel en registreert de mutatie; Equipment_ChangeLocationExchangePart verwerkt een handmatige locatiewijziging. ExchangePart zelf wordt door geen enkele workflow geschreven (het is een configuratieveld) maar wél door tien workflows gelezen en drie gefilterd — onder meer Equipment_BuildOut, dat het gedrag splitst op basis van dit veld.

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

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• Hierarchie: Equipment kan hiermee in een boomstructuur worden opgebouwd via PartOfEquipment. Gebruik TopOfEquipmentId om snel de root te vinden.
• Contexts: De context bepaalt welk scherm en welke processen beschikbaar zijn. Installatie (1) is de standaard voor TD-assets, Fleet (8) voor voertuigen, Instrument (512) voor meetinstrumenten.
• Meetpunten: Via EquipmentMeasurementPoints kunnen meterstanden en meetwaarden worden bijgehouden die preventief onderhoud triggeren.
• Wisselstukken: Met ExchangePart = true wordt het equipment behandeld als wisselstuk met een eigen levenscyclus (Inzetbaar/Operationeel/Defect).
• Kosten: CostCurrentYear, CostLastYear en TotalCost worden automatisch berekend op basis van geboekte uren, materialen en inkoop.
• Extra-velden: Er zijn diverse Extra-velden (Extra1 t/m Extra9) en Tech-velden (Tech1 t/m Tech10) beschikbaar voor klantspecifieke gegevens.
• NFC/Barcode: Via NFCSerialNumber en barcode-functionaliteit kan equipment worden gescand in de mobiele app.
• Depreciation: Afschrijving kan worden geconfigureerd via DepreciationActivated, DepreciationLife en gerelateerde velden.

Database Detailsbewerken

De tabel dba.Equipment bevat 218 kolommen. Hieronder de belangrijkste technische details die niet direct zichtbaar zijn in de Properties-tabel.

Computed columns (berekende velden)bewerken

Let op: Equipment heeft geen functionele computed columns -- de berekende velden zijn puur technisch (full-text indexering). Kosten worden bijgehouden via triggers.

Kolommen gezet door triggersbewerken

De volgende kolommen worden automatisch bijgewerkt door database-triggers en mogen niet handmatig worden aangepast:

Belangrijke defaultsbewerken

Triggers en externe triggersbewerken

Equipment heeft 3 eigen triggers (INSERT, UPDATE, INSTEAD OF DELETE) en wordt beinvloed door 17 externe triggers:

• Cost-triggers: Wijzigingen in de Cost-tabel updaten EqmCostLY, EqmMaintTotal, EqmMaintYear
• EqmSparePart-triggers: Wijzigingen in reservedelen updaten het equipment
• EqmTypeHierarchy-triggers: Wijzigingen in de type-hierarchie worden doorgecopieerd
• ObjectImportedPmTask-triggers: Bij import van PO-taken wordt EqmObjImpPmTasksToProcess bijgewerkt
• ReservableObject-triggers: Synchronisatie met reserveerbare objecten
• Company-triggers: Wijzigingen in bedrijfsinstellingen worden doorgevoerd
• UmmGlobals-triggers: Wijzigingen in globale instellingen

Consultanttip: Het INSTEAD OF DELETE-trigger op Equipment betekent dat equipment niet direct kan worden verwijderd. In plaats daarvan wordt een soft-delete uitgevoerd (status Trash).

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("Equipment") · reference/entities/Equipment Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("Equipment") · reference/tables/Equipment Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="Equipment") Alle Before/After Save events en andere workflow-ActionFields voor Equipment. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("Equipment", "Status") · reference/properties/Equipment Welke workflows een specifieke Equipment-property lezen/schrijven/filteren (bijv. 16 schrijvers en 28 lezers voor Status). Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("Equipment_BuildOut") De volledige logica achter de BuildOut-lifecycle (status-schrijven, exchange-part splitsing, ProcessFunction-filter). Bron: workflows.xml.

Zie ookbewerken

• job - Werkorders gekoppeld aan equipment
• pm-workorder - Preventief onderhoudsmodellen
• article - Reservedelen
• supplier - Leveranciers
• contract - Servicecontracten
• maintenance-classification - Onderhoudsconcepten
• location - Locaties