SpaceMaintenanceActivity (Ruimteonderhoudsactiviteit)

SpaceMaintenanceActivity is de detailregel binnen een SpaceMaintenance-planning en bevat de specifieke onderhoudstaak, de berekende kosten per jaar, de uitvoeringsfrequentie en de koppeling naar jaarplannen. De entiteit is de kleinste planningseenheid in het MJOP/LTAP-model en bepaalt wanneer en hoe duur een onderhoudsmaatregel is. Consultants configureren SpaceMaintenanceActivity bij de inrichting van de meerjarenonderhoudsplanning en bij het opzetten van conditiegestuurde onderhoudscycli.

Entiteitsnaam: SpaceMaintenanceActivity Databasetabel: SpaceMaintenanceActivity

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

De entiteit heeft in totaal 139 properties. Hieronder de belangrijkste; gebruik lookup_entity("SpaceMaintenanceActivity") voor de volledige lijst.

Functionaliteit & property-gedragbewerken

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

• Kosten- en prijsberekening (Price, UnitPrice, FixedPrice, CalculatedCost, CostYear1…CostYear15) — De kostenprognose per jaar wordt niet statisch opgeslagen maar dynamisch herberekend door SpaceMaintenanceActivity_UpdateCostYears. Deze workflow leest CalculationMethod, Quantity, UnitPrice en FixedPrice en verdeelt de resulterende Price over de jaarkolommen (CostYear1 t/m CostYear15) op basis van de geplande uitvoermomenten. MaintenancePartActivity_CalculationUpdates herberekent UnitPrice wanneer de onderliggende MaintenancePartActivity wijzigt (bijv. bij een tariefwijziging). Consultanttip: pas je een eenheidsprijs aan op de MaintenancePartActivity, dan werkt MaintenancePartActivity_CalculationUpdates de UnitPrice bij, waarna SpaceMaintenanceActivity_UpdateCostYears de jaarkolommen opnieuw vult — controleer altijd beide stappen bij massale tariefwijzigingen.

• Onderhoudsfrequentie en -methode (MaintenanceFrequency, MaintenanceFrequencyMethod) — MaintenanceFrequency (aantal keer per planningshorizon) wordt bij activatie gevuld door MaintenancePart_PreActivate_AddAlterSpaceMaintenanceActivity en na wijzigingen bijgewerkt door MaintenancePartActivity_CalculationUpdates en SpaceMaintenanceActivity_InsertActivityMoments. MaintenanceFrequencyMethod (period-based of condition-based) wordt gelezen door SpaceMaintenanceActivity_InsertActivityMoments en SpaceMaintenanceActivity_UpdateMaintenanceMoments om te bepalen hoe de uitvoermomenten worden berekend: bij de period-methode resulteert de frequentie in vaste intervallen; bij de condition-methode stuurt de conditiescore de volgende uitvoering aan.

• Uitvoermomenten en volgend onderhoudsjaar (NextMaintenanceYear, NextMaintenanceYearInspector, ActivityMoments) — SpaceMaintenanceActivity_UpdateMaintenanceMoments is de centrale workflow die op basis van MaintenanceFrequency, MaintenanceFrequencyMethod en de verstreken uitvoering het NextMaintenanceYear herberekent. SpaceMaintenanceActivity_InsertActivityMoments maakt de onderliggende ActivityMoments-records aan (één per gepland uitvoerjaar). NextMaintenanceYearInspector is het veld dat de inspecteur ter plekke kan corrigeren: Mobile_SpaceMaintenanceActivity_ChangeYearAccordingToInspector schrijft dit veld vanuit de mobiele app, waarna YearPlanScenario_PreDefinitive_UpdateYearPlanScenarioLine de definitieve scenarioregel bijwerkt. Consultanttip: NextMaintenanceYear is het systeemjaar; NextMaintenanceYearInspector is de handmatige override — bij het definitief maken van een scenario wint de inspecteur-waarde.

• Gecorrigeerd bouwjaar en levensduur (AdjustedConstructionYear) — Bij de initiële aanmaak of bij een gebouwjaarswijziging berekent SpaceMaintenanceActivity_CalculateAdjustedConstructionYear het gecorrigeerde bouwjaar op basis van het gekoppelde YearPlan. LongTermAsset_ChangeBuildingYear schrijft dit veld ook als het bouwjaar van het langetermijn-asset wordt aangepast. Het gecorrigeerde bouwjaar wordt gebruikt door YearPlanScenario_CreateLtapLines en YearPlanScenario_CreateScenarioLines bij het opbouwen van scenarioregels, zodat de restlevensduurberekening klopt bij deelrenovaties.

• Statusbeheer en activering (Status, Active) — De activiteit doorloopt de statussen via dedicated workflows: SpaceMaintenanceActivity_Activate en SpaceMaintenanceActivity_Deactivate schakelen tussen Active (4) en andere statussen; SpaceMaintenanceActivity_PreTrash bewaakt de verwijdering. De boolean Active (default 0) wordt door SpaceMaintenanceActivity_PreActivate, SpaceMaintenanceActivity_PreExpired en SpaceMaintenanceActivity_PreOpen gezet en bepaalt of de activiteit meedraait in kostenberekeningen en jaarplanopbouw. SpaceMaintenanceActivity_Reactivate herstart een inactieve activiteit en filtert op Active en Quantity om te bepalen of heractivering zinvol is.

• Jaarplanscenario-koppeling (YearPlan, PreviousYearPlan, LastMaintenanceYear) — Bij het aanmaken van een concept-scenario schrijft YearPlanScenario_PostConcept de velden YearPlan, PreviousYearPlan, LastMaintenanceYear, NextMaintenanceYear en de bijbehorende "PreviousYearPlan"-varianten. Bij definitief maken van een scenario (YearPlanScenario_PreDefinitive en YearPlanScenario_PreDefinitive_UpdateYearPlanScenarioLine) worden deze velden definitief vastgelegd en worden MaintenanceFrequency en NextMaintenanceYearInspector geüpdatet vanuit de gekozen scenarioregel. YearPlanScenario_CreateScenarioLines en YearPlanScenario_CreateLtapLines lezen vervolgens LastMaintenanceYear, AdjustedConstructionYear en NextMaintenanceYear om de scenarioregels op te bouwen.

Relaties met andere entiteitenbewerken

Onderliggende / verwijzende entiteiten (1-op-veel)bewerken

De volgende entiteiten verwijzen naar SpaceMaintenanceActivity:

Tips voor consultantsbewerken

• Statussen bewaken de workflow: Een activiteit doorloopt de statussen Created (1) → Scheduled (2) → Active (4) → Expired (8). Activiteiten die de status Expired krijgen, moeten worden geëvalueerd: is de planning nog actueel of dient de SpaceMaintenance-regel te worden herzien?
• Active-vlag: De boolean Active (default 0) bepaalt of de activiteit meegenomen wordt in kostenberekeningen en jaarplannen. Vergeet niet deze vlag in te stellen bij import of bulkopvoer, anders verschijnen de activiteiten niet in het MJOP-overzicht.
• Berekeningsmethode: CalculationMethod en CalculatedCost werken samen: de berekeningsmethode bepaalt of kosten worden berekend op basis van oppervlakte, eenheidsprijs of een vaste bedrag. Controleer de instelling per activiteitstype om onjuiste prognoses te voorkomen.
• AdjustedConstructionYear: Dit veld wordt gebruikt om de resterende levensduur te berekenen wanneer een onderdeel later is vervangen dan het bouwjaar. Vul het in bij renovaties of deelvervanging zodat de vervangingsprognose klopt.
• Jaarplan-koppeling: YearPlan en PreviousYearPlan leggen de historie vast van welke activiteit in welk jaarplan is opgenomen. Gebruik PreviousYearPlan bij evaluaties van de uitvoering in vorige planperioden.
• Trigger SpcmaEndYearMaintFreq: De kolom SpcmaEndYearMaintFreq wordt automatisch bijgewerkt door de trigger TRGU_Company bij wijzigingen in de bedrijfsinstellingen. Dit veld stuur je niet aan — het is een berekende eindgrens voor de onderhoudsfrequentie.

Database Detailsbewerken

De tabel dba.SpaceMaintenanceActivity bevat 138 kolommen, 0 eigen trigger(s), 1 externe triggers en 10 foreign keys.

Kolommen gezet door triggersbewerken

Deze kolommen worden automatisch bijgewerkt door database-triggers en mogen niet handmatig worden aangepast.

Belangrijke defaultsbewerken

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("SpaceMaintenanceActivity") · reference/entities/SpaceMaintenanceActivity Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("SpaceMaintenanceActivity") · reference/tables/SpaceMaintenanceActivity Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="SpaceMaintenanceActivity") Alle Before/After Save events en andere workflow-ActionFields. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("SpaceMaintenanceActivity", "NextMaintenanceYear") · reference/properties/SpaceMaintenanceActivity Welke workflows een specifieke SpaceMaintenanceActivity-property lezen/schrijven/filteren (per property). Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("SpaceMaintenanceActivity_UpdateCostYears") De volledige logica achter de jaarlijkse kostenprognoseberekening (Price → CostYear1…CostYear15). Bron: workflows.xml.

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

Zie ookbewerken

• space-maintenance - De bovenliggende MJOP-planningsregel
• year-plan - Het jaarplan waaraan de activiteit is gekoppeld
• maintenance-state - Onderhoudsstaten gekoppeld aan de activiteit
• cost-center - Kostenplaats voor kostentoewijzing per activiteit
• cost-type - Kostensoort van de activiteit
• room - Ruimte bovenaan de hiërarchie via SpaceMaintenance