YearPlan (Jaarplan)
YearPlan is de strategische planningsentiteit in Ultimo waarmee organisaties hun onderhouds- en assetinvesteringen over meerdere jaren kunnen structureren: afhankelijk van de Context dient het als operationeel jaarplan (TD, MID, Fleet, IT), als Meerjarenonderhoudsplan (MJOP, context LongTermMaintenancePlan) of als Langetermijnassetplan (LTAP, context LongTermAssetPlan). Het plan koppelt aan een gebouw of langetermijnasset, bevat scenario's (YearPlanScenario) voor alternatieve ramingen en stuurt via YearsInYearPlan en NumberOfYearsToCalculate hoever vooruit de berekening loopt. Jobs kunnen direct aan een jaarplan worden gekoppeld, wat de brug vormt naar de operationele planning.
Entiteitsnaam: YearPlan
Databasetabel: YearPlan
Primaire sleutel: YRPID (UltimoString(9))
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | YearPlanContext.None | Standaard |
| 1 | YearPlanContext.Standard | Standaard |
| 2 | YearPlanContext.TD | TD |
| 4 | YearPlanContext.MID | MID |
| 8 | YearPlanContext.IT | IT |
| 16 | YearPlanContext.Fleet | Fleet |
| 32 | YearPlanContext.LongTermMaintenancePlan | MJOP |
| 64 | YearPlanContext.LongTermAssetPlan | LTAP |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | YearPlanStatus.Trash | Trash |
| 0 | YearPlanStatus.None | None |
| 1 | YearPlanStatus.Concept | Concept |
| 2 | YearPlanStatus.Definitive | Definitief |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 18 properties. Hieronder de belangrijkste; gebruik
lookup_entity("YearPlan")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Id | UltimoString(9) | YRPID | Nee | Uniek ID van het jaarplan | |
| Description | UltimoString(200) | YRPDESCR | Ja | Omschrijving van het jaarplan | |
| Building | Building | YRPBLDID | Ja | Gebouw waarop het jaarplan betrekking heeft | |
| Customer | Customer | YRPCUSID | Ja | Klant waarvoor het jaarplan is opgesteld (bij externe serviceverlening) | |
| Decomposition | Decomposition | YRPDECID | Ja | Decompositiestructuur die als basis dient voor de planramingen | |
| FeatureChoice | FeatureChoice | YRPFTRID, YRPFTRCID | Ja | , | Geselecteerde feature-keuze die de berekening beïnvloedt |
| LongTermAsset | LongTermAsset | YRPLTAID | Ja | Langetermijnasset waarvoor het plan is opgesteld (bij LTAP-context) | |
| RecordCreateDate | DateTime? | YRPRECCREATEDATE | Ja | SYSDATETIME | Aanmaakdatum van het record |
| SystemCompany | Company | YRPCOMPID | Nee | Bedrijf waartoe het jaarplan behoort | |
| Context | Context | YRPCONTEXT | Nee | 1 | Bepaalt het type plan: TD, MID, IT, Fleet, MJOP of LTAP |
| DepartmentExclude | Boolean | YRPDEPARTMENTEXCLUDE | Nee | 0 | Indien actief: de afdelingsfilter werkt als exclusie in plaats van inclusie |
| NumberOfYearsToCalculate | Int32 | YRPNROFYEARSTOCALCULATE | Nee | 20 | Aantal jaren dat vooruit wordt berekend voor prognoses (default: 20) |
| Status | Status | YRPRECSTATUS | Nee | Status van het plan: Concept of Definitief | |
| Year | Int32 | YRPYEAR | Nee | Basisjaar van het jaarplan | |
| YearsInYearPlan | Int32 | YRPYEARSINYEARPLAN | Nee | 5 | Aantal jaren dat in de planweergave wordt getoond (default: 5) |
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Nullable |
|---|---|---|
| Building | Building | Ja |
| Customer | Customer | Ja |
| Decomposition | Decomposition | Ja |
| FeatureChoice | FeatureChoice | Ja |
| LongTermAsset | LongTermAsset | Ja |
| SystemCompany | Company | Nee |
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar YearPlan:
| Entiteit | Via property |
|---|---|
| Job | YearPlan |
| SpaceMaintenanceActivity | PreviousYearPlan, YearPlan |
| YearPlanDepartment | Id.YearPlan |
| YearPlanScenario | Id.YearPlan |
| YearPlanScenarioLine | OriginalPreviousYearPlan |
Tips voor consultantsbewerken
- Context bepaalt het plantype: Kies de juiste context voor het gebruik —
TD/MID/Fleet/ITvoor operationele jaarplanning,LongTermMaintenancePlanvoor MJOP (meerdere jaren gepland onderhoud aan vastgoed/infra) enLongTermAssetPlanvoor LTAP (kapitaalsinvesteringsplanning op basis van assetlevensduur). - Concept vs. Definitief: Houd jaarplannen in status
Conceptzolang ze nog worden besproken of bijgesteld. Zet het plan pas opDefinitiefals het geaccordeerd is; workflows kunnen op deze statusovergang acties uitvoeren (notificaties, exporttriggers). YearsInYearPlanvs.NumberOfYearsToCalculate:YearsInYearPlan(default 5) bepaalt de weergavehorizon in het scherm;NumberOfYearsToCalculate(default 20) bepaalt hoe ver de achterliggende berekening loopt. Voor MJOP/LTAP is een langere berekeningshorizon gebruikelijk.- Scenario's voor alternatieve ramingen: Via
YearPlanScenarioenYearPlanScenarioLinekun je meerdere scenario's (optimistisch/basisplan/pessimistisch) naast elkaar bewaren zonder het oorspronkelijke plan te overschrijven — essentieel voor bestuurlijke besluitvorming. - Koppeling met jobs: Jobs verwijzen direct terug naar het jaarplan via de
YearPlan-property. Zo is altijd traceerbaar welke werkorders uit welk jaarplan zijn voortgekomen, en kunnen realisatiecijfers worden vergeleken met de raming. - Afdelingssturing via
DepartmentExclude: DeYearPlanDepartment-koppeling filtert welke afdelingen in het plan zijn opgenomen. MetDepartmentExclude = truedraai je de logica om: alle afdelingen behalve de genoemde zijn dan actief.
Database Detailsbewerken
De tabel dba.YearPlan bevat 17 kolommen, 0 eigen trigger(s), 0 externe triggers en 7 foreign keys.
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
YrpContext |
1 |
YrpRecStatus |
0 |
YrpDepartmentExclude |
0 |
YrpNrOfYearsToCalculate |
0 |
YrpRecCreateDate |
sysdatetimeoffset() |
YrpYear |
0 |
YrpYearsInYearPlan |
0 |
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("YearPlan")· reference/entities/YearPlan Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("YearPlan")· reference/tables/YearPlan Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="YearPlan")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml.
Zie ookbewerken
- planning - Planningsfunctionaliteit in Ultimo
- long-term-asset - Langetermijnassets als object van LTAP-plannen
- building - Gebouwen als object van MJOP-jaarplannen
- job - Jobs die aan het jaarplan zijn gekoppeld
- space-maintenance-activity - Ruimteonderhoudsactiviteiten die verwijzen naar jaarplannen
- year-plan - Jaarplan zelf (zelfverwijzend via scenarios)