---
id: object/codeunit/483
type: object
title: Codeunit 483 "Change Global Dimensions"
summary: Codeunit 483 "Change Global Dimensions" in Base Application (Microsoft.Finance.Dimension). 17 public procedures, 10 events. Present since at least BC23, still in BC30, changed in BC26-27.
tier: official
language: en
tags:
  - codeunit
  - base application
versions:
  introduced: null
  last_changed: "27"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: f2b65a539aac429da56858da40966228fd509f9dfa9030b99d7e635f22afd790
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/Dimension/ChangeGlobalDimensions.Codeunit.al
    title: src/Layers/W1/BaseApp/Finance/Dimension/ChangeGlobalDimensions.Codeunit.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: codeunit
object_id: 483
name: Change Global Dimensions
namespace: Microsoft.Finance.Dimension
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "26"
  - "27"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 0
  procedures: 60
  events: 10
  subscribers: 0
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 1
  calls: 3
  called_by: 1
  implements: 0
---

# Codeunit 483 "Change Global Dimensions"

> Codeunit 483 "Change Global Dimensions" in Base Application (Microsoft.Finance.Dimension). 17 public procedures, 10 events. Present since at least BC23, still in BC30, changed in BC26-27.

Base Application · Microsoft.Finance.Dimension · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/Dimension/ChangeGlobalDimensions.Codeunit.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| TableNo | Change Global Dim. Log Entry |
| Permissions | TableData "G/L Entry" = rm, TableData "VAT Entry" = rm, TableData "Cust. Ledger Entry" = rm, TableData "Vendor Ledger Entry" = rm, TableData "Item Ledger Entry" = rm, Tabledata "Approval Entry" = rm, TableData "Sales Shipment Header" = rm, TableData "Sales Shipment Line" = rm, TableData "Sales Invoi... |

## Events published

- `OnAfterGetObjectNoList(var TempAllObjWithCaption: Record AllObjWithCaption temporary)` (integration): Integration event raised after building the object list for dimension change operations. Enables customization of table list used for dimension processing.
- `OnCountingActiveSessions(var IsCurrSessionActiveOnly: Boolean)` (integration): Integration event raised when counting active sessions during dimension change operations. Enables custom logic for determining if only current session is active.
- `OnBeforeScheduleTask(TableNo: Integer; var DoNotScheduleTask: Boolean; var TaskID: Guid)` (integration): Integration event raised before scheduling task for parallel dimension change processing. Enables custom control over task scheduling and task identification.
- `OnBeforeTestDirectModifyPermission(var RecRef: RecordRef; var IsHandled: Boolean)` (integration): Integration event raised before testing direct modify permission on table records. Enables custom permission checking logic for dimension change operations.
- `OnChangeDependentRecords(ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry"; var RecRef: RecordRef; var IsHandled: Boolean)` (integration): Integration event raised when changing dependent records during dimension update operations. Enables custom processing of dependent table records during dimension changes.
- `OnChangeDimsOnRecord(ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry"; var RecRef: RecordRef; var IsHandled: Boolean; var Success: Boolean)` (integration): Integration event raised when changing dimensions on individual records. Enables custom dimension update logic for specific record types during dimension changes.
  - subscribers: [Codeunit 1695 "Bank Deposit Subscribers"](../codeunit/1695.md) HandleOnChangeDimsOnRecord
- `OnAfterFillTableData(var ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry")` (integration): Integration event raised after filling table data for dimension change operations. Enables post-processing of table data after initial dimension change setup.
- `OnChangeDimsOnTableOnBeforeCalcRecordsWithinCommit(var ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry"; var ChangeGlobalDimLogMgt: Codeunit "Change Global Dim. Log Mgt."; var ChangeGlobalDimHeader: Record "Change Global Dim. Header"; var Completed: Boolean; var StartedFromRecord: Integer; var RecRef: RecordRef)` (integration)
- `OnInitTableListOnAfterFindTablesWithDims(var ChangeGlobalDimHeader: Record "Change Global Dim. Header")` (integration)
- `OnInitTableListOnBeforeInsertChangeGlobalDimLogEntry(var ChangeGlobalDimHeader: Record "Change Global Dim. Header"; var ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry")` (integration)

## Procedures

- `ResetIfAllCompleted()`: Resets the global dimension change state if all dimension change operations have been completed. Verifies completion status and initiates state reset automatically when all tables are processed.
- `Prepare()`: Prepares the global dimension change operation by initializing tables and validating configuration. Sets up the dimension change environment with table analysis and dependency mapping.
- `RemoveHeader()`: Removes the global dimension change header and all associated log entries. Cleans up dimension change configuration data after completion or cancellation.
- `ResetState()`: Resets the global dimension change state by clearing all log entries and cached data. Initializes the system for a new dimension change operation or after completion.
- `Rerun(var ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry")`: Reruns failed dimension change operations for specified log entries. Reprocesses table updates that encountered errors during the initial dimension change operation.
- `Start()`: Initiates the global dimension change process using the configured processing mode. Starts dimension change operations with either parallel or sequential processing based on configuration.
- `StartSequential()`: Initiates global dimension change processing in sequential mode with progress tracking. Executes dimension changes table by table without parallel processing for controlled execution.
- `FillBuffer()`: Fills the internal buffer with dimension change log entries for processing coordination. Populates buffer data structures used for progress tracking and parallel processing management.
- `FindTablesForScheduling(var ChangeGlobalDimLogEntry: Record "Change Global Dim. Log Entry"): Boolean`: Finds tables available for scheduling in parallel processing mode. Identifies root tables with records requiring dimension updates for job queue scheduling.
- `IsDimCodeEnabled(): Boolean`: Determines if dimension code configuration is enabled for modification. Checks buffer state to allow dimension code changes when no operations are in progress.
- `IsPrepareEnabled(var ChangeGlobalDimHeader: Record "Change Global Dim. Header"): Boolean`: Determines if the preparation phase can be initiated for dimension changes. Validates configuration and system state to enable dimension change preparation.
- `IsStartEnabled(): Boolean`: Determines if the dimension change process can be started. Validates that preparation is complete and no processing is currently active.
- `RefreshHeader()`: Refreshes the global dimension change header with current status and progress information. Updates header record with latest processing state and statistical data.
- `SetParallelProcessing(NewParallelProcessing: Boolean)`: Configures parallel processing mode for global dimension changes. Enables or disables parallel execution based on system capacity and processing requirements.
- `InitTableList(): Boolean`: Initializes the table list for dimension change operations with dependency analysis. Builds comprehensive list of tables requiring dimension updates with parent-child relationships.
- `GetCloseSessionsNotificationID(): Guid`: Gets the unique identifier for close sessions notification management. Returns consistent notification ID for session closure messaging during dimension changes.
- `ShowActiveSessions(BlockNotification: Notification)`: Displays the active sessions list for review during dimension change operations. Shows current active sessions that may interfere with dimension change processing.

Plus 33 local procedures.

## Triggers

OnRun

## Relations

- runs on [Table 483 "Change Global Dim. Log Entry"](../table/483.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 484 "Change Global Dim. Log Mgt."](../codeunit/484.md) (14 calls: `DeleteEntry → ExcludeTable`, `FillBuffer → FillBuffer`, `FindChildTables → FindChildTables`, …)
- [Codeunit 408 "DimensionManagement"](../codeunit/408.md) (3 calls: `FindTablesWithDims → DefaultDimObjectNoWithGlobalDimsList`, `FindTablesWithDims → GlobalDimObjectNoList`, `FindTablesWithDims → JobTaskDimObjectNoList`)
- [Page 670 "Concurrent Session List"](../page/670.md) (1 call: `ShowActiveSessions → (object)`)

## Called by

- [Page 577 "Change Global Dimensions"](../page/577.md) (6 calls: `OnAfterGetCurrRecord → FillBuffer`, `OnAfterGetCurrRecord → IsDimCodeEnabled`, `OnAfterGetCurrRecord → IsPrepareEnabled`, …)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC26-27

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "codeunit", object_name: "Change Global Dimensions")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.