Categorie: entities
Bijgewerkt: 2026-05-27
budget budgetperiode kostenplaats financieel jaarplan
BudgetPeriod (Budgetperiode)
BudgetPeriod is de entiteit waarmee budgetten per periode (jaar, kwartaal of maand) worden beheerd en bewaakt in Ultimo. Een budgetperiode koppelt een CostCenter (of CostType) aan een tijdvak, legt het vastgestelde budget vast en registreert automatisch de werkelijke kosten via databasetriggers. Via de hiërarchische relaties (PartOfBudgetPeriod, PartOfYearBudgetPeriod) worden sub-periodes aan jaarniveau of moederperiodes gekoppeld, zodat budget-mutaties en -overzichten op meerdere niveaus beschikbaar zijn. De goedkeuringsstatus (Created → Requested → Approved/Rejected) ondersteunt een formeel budgetaanvraagproces.
Entiteitsnaam: BudgetPeriod
Databasetabel: BudgetPeriod
Primaire sleutel: BDGPID (UltimoString(12))
| Value |
Naam |
Beschrijving |
| 0 |
BudgetPeriodContext.None |
Standaard |
| 1 |
BudgetPeriodContext.Year |
Jaar |
| 2 |
BudgetPeriodContext.Quarter |
Kwartaal |
| 4 |
BudgetPeriodContext.Month |
Maand |
| 8 |
BudgetPeriodContext.CostTypeYear |
Kostensoort jaar |
| 16 |
BudgetPeriodContext.CostTypeQuarter |
Kostensoort kwartaal |
| 32 |
BudgetPeriodContext.CostTypeMonth |
Kostensoort maand |
| 64 |
BudgetPeriodContext.YearMutation |
Jaarmutatie |
| 128 |
BudgetPeriodContext.QuarterMutation |
Kwartaalmutatie |
| 256 |
BudgetPeriodContext.MonthMutation |
Maandmutatie |
| Value |
Naam |
Beschrijving |
| -1 |
BudgetPeriodStatus.Trash |
Trash |
| 0 |
BudgetPeriodStatus.None |
None |
| 1 |
BudgetPeriodStatus.Created |
Aangemaakt |
| 2 |
BudgetPeriodStatus.Requested |
Aangevraagd |
| 4 |
BudgetPeriodStatus.Rejected |
Afgewezen |
| 8 |
BudgetPeriodStatus.Approved |
Goedgekeurd |
| 16 |
BudgetPeriodStatus.AutomaticallyAdded |
Automatisch toegevoegd |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 37 properties. Hieronder de belangrijkste; gebruik lookup_entity("BudgetPeriod") voor de volledige lijst.
| Property |
Type |
Kolom |
Nullable |
Default |
Omschrijving |
| Id |
UltimoString(12) |
BDGPID |
Nee |
|
Uniek ID van de budgetperiode (maximaal 12 tekens) |
| CostCenter |
CostCenter |
BDGPCCRID |
Ja |
|
Kostenplaats waarvoor dit budget geldt |
| CostType |
CostType |
BDGPCSTTID |
Ja |
|
Kostensoort waarvoor dit budget geldt (bij CostType-contexten) |
| PartOfBudgetPeriod |
BudgetPeriod |
BDGPPARTOFBDGPID |
Ja |
|
Bovenliggende budgetperiode in de hiërarchie |
| PartOfBudgetPeriodForBudgetMutation |
BudgetPeriod |
BDGPPARTOFBDGPIDFORMUTATION |
Ja |
|
Bovenliggende periode waarnaar budgetmutaties worden opgerold |
| PartOfBudgetPeriodForCostType |
BudgetPeriod |
BDGPPARTOFBDGPIDFORCSTT |
Ja |
|
Bovenliggende kostensoort-periode in de hiërarchie |
| PartOfBudgetPeriodForCostTypeBudgetMutation |
BudgetPeriod |
BDGPPARTOFBDGPIDFORCSTTMUT |
Ja |
|
Bovenliggende kostensoort-periode voor budget-mutaties |
| PartOfYearBudgetPeriod |
BudgetPeriod |
BDGPPARTOFYEARBDGPID |
Ja |
|
Jaarniveau waartoe deze periode behoort |
| RecordCreateDate |
DateTime? |
BDGPRECCREATEDATE |
Ja |
SYSDATETIME |
Aanmaakdatum van het record |
| StatusApprovedDate |
DateTime? |
BDGPAPPROVEDDATE |
Ja |
|
Datum waarop het budget is goedgekeurd |
| StatusApprovedEmployee |
Employee |
BDGPAPPROVEDEMPID |
Ja |
|
Medewerker die het budget heeft goedgekeurd |
| StatusAutomaticallyAddedDate |
DateTime? |
BDGPAUTADDDATE |
Ja |
|
Datum waarop het record automatisch is toegevoegd |
| StatusAutomaticallyAddedEmployee |
Employee |
BDGPAUTADDEMPID |
Ja |
|
Medewerker in wiens context de automatische toevoeging plaatsvond |
| StatusCreatedDate |
DateTime? |
BDGPCREATEDDATE |
Ja |
SYSDATETIME |
Datum van aanmaak (default: systeemtijdstip) |
| StatusCreatedEmployee |
Employee |
BDGPCREATEDEMPID |
Ja |
USERID |
Medewerker die het budget heeft aangemaakt (default: ingelogde gebruiker) |
| StatusRejectedDate |
DateTime? |
BDGPREJECTEDDATE |
Ja |
|
Datum waarop het budget is afgewezen |
| StatusRejectedEmployee |
Employee |
BDGPREJECTEDEMPID |
Ja |
|
Medewerker die het budget heeft afgewezen |
| StatusRequestedDate |
DateTime? |
BDGPREQUESTEDDATE |
Ja |
|
Datum waarop het budget ter goedkeuring is aangevraagd |
| StatusRequestedEmployee |
Employee |
BDGPREQUESTEDEMPID |
Ja |
|
Medewerker die het budget ter goedkeuring heeft aangevraagd |
| SystemCompany |
Company |
BDGPCOMPID |
Nee |
|
Administratie waartoe deze budgetperiode behoort |
| Budget |
CompanyMoney |
BDGPBUDGET |
Nee |
0 |
Vastgesteld budgetbedrag voor de periode |
| BudgetMutation |
CompanyMoney |
BDGPBUDGETMUTATION |
Nee |
0 |
Budgetaanpassing (bijv. aanvullend budget of bijstelling) |
| BudgetRemaining |
CompanyMoney |
BDGPBUDREMAIN |
Nee |
0 |
Resterend budget (berekend: Budget + BudgetMutation - Cost) |
| Context |
Context |
BDGPCONTEXT |
Nee |
1 |
Type periode: Year, Quarter, Month, CostTypeYear, etc. |
| Cost |
CompanyMoney |
BDGPCOST |
Nee |
0 |
Werkelijke kosten in de periode (automatisch bijgewerkt door triggers) |
| IsBudgetMutation |
Boolean |
BDGPISBUDGETMUTATION |
Nee |
|
Geeft aan of dit record een budgetmutatie is (computed op basis van context) |
| Month |
Int32 |
BDGPMONTH |
Nee |
0 |
Maandnummer (1-12) voor maandperiodes, anders 0 |
| PercentageUsed |
Decimal |
BDGPPERCENTAGEUSED |
Nee |
|
Percentage van het budget dat is verbruikt (computed) |
Relaties met andere entiteitenbewerken
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar BudgetPeriod:
| Entiteit |
Via property |
| Cost |
BudgetPeriod, BudgetPeriodForCostType |
Tips voor consultantsbewerken
- Context bepaalt type: De
Context (Year=1, Quarter=2, Month=4, CostTypeYear=8, etc.) bepaalt of een periode een jaarniveau, kwartaal of maand betreft. Stel dit correct in bij aanmaak — achteraf wijzigen heeft impact op berekende velden.
- Computed velden niet schrijven:
BudgetRemaining, IsBudgetMutation, PercentageUsed en TotalBudget zijn computed columns; schrijf er nooit rechtstreeks naar via SQL.
- Kosten via triggers:
BdgpCost wordt bijgewerkt door de externe triggers TRSD_COST en TRSM_COST op de Cost-tabel. Bij directe cost-inserts via SQL buiten Ultimo om klopt het budgetoverzicht mogelijk niet.
- Hiërarchie voor aggregatie: Via
PartOfYearBudgetPeriod kun je kwartaal- en maandperiodes aan een jaarperiode hangen voor geaggregeerde budgetrapportages. Gebruik PartOfBudgetPeriodForBudgetMutation expliciet voor budgetmutatieregistratie.
- Goedkeuringsworkflow: De statussen (Created → Requested → Approved) zijn bedoeld voor een formele budgetcyclus. Configureer workflows via UCT om automatisch mails te sturen bij statusovergang.
- CostType-splitsing: Via
SplitForCostType kan een budget worden opgesplitst per kostensoort (contexten 8/16/32). Dit genereert extra BudgetPeriod-records per kostensoort.
De tabel dba.BudgetPeriod bevat 37 kolommen, 3 eigen trigger(s), 3 externe triggers en 13 foreign keys.
Computed columns (berekende velden)bewerken
| Kolom |
Definitie |
BdgpBudRemain |
(CONVERT([decimal](21,5),case when [BdgpContext]=(256) OR [BdgpContext]=(128) OR [BdgpC... |
BdgpIsBudgetMutation |
(CONVERT([smallint],case when [BdgpContext]=(256) OR [BdgpContext]=(128) OR [BdgpContex... |
BdgpPercentageUsed |
(CONVERT([decimal](21,2),case when [BdgpContext]=(256) OR [BdgpContext]=(128) OR [BdgpC... |
BdgpTotalBudget |
(CONVERT([decimal](21,5),case when [BdgpContext]=(256) OR [BdgpContext]=(128) OR [BdgpC... |
Kolommen gezet door triggersbewerken
Deze kolommen worden automatisch bijgewerkt door database-triggers en mogen niet handmatig worden aangepast.
| Kolom |
Type |
Trigger(s) |
BdgpRecStatus |
int |
TRGU_BUDGETPERIOD, TRGU_UmmGlobals |
BdgpCost |
decimal(21,5) |
TRSD_COST, TRSM_COST |
Belangrijke defaultsbewerken
| Kolom |
Default |
BdgpContext |
0 |
BdgpRecStatus |
0 |
BdgpBudget |
0 |
BdgpBudgetMutation |
0 |
BdgpCost |
0 |
BdgpMonth |
0 |
BdgpQuarter |
0 |
BdgpRecCreateDate |
sysdatetimeoffset() |
BdgpSplitForCostType |
0 |
BdgpYear |
0 |
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("BudgetPeriod") · reference/entities/BudgetPeriod
Alle properties, contexts en statussen. Bron: Entities.xml.
- DB-schema —
lookup_table_schema("BudgetPeriod") · reference/tables/BudgetPeriod
Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
- Gerelateerde workflows —
find_workflows("", entity="BudgetPeriod")
Alle Before/After Save events en andere workflow-ActionFields. Bron: workflows.xml.
- cost-center - Kostenplaats waaraan de budgetperiode is gekoppeld
- cost-type - Kostensoort voor CostType-budgetperiodes
- company - Administratie waaronder de budgetperiode valt
- employee - Medewerkers in de goedkeuringsketen
- year-plan - Jaarplan dat gebruik maakt van budgetperiodes
- domain-settings - DomainSettings bepaalt welk BudgetPeriod-contexttype actief is