--- id: object/table/349 type: object title: Table 349 "Dimension Value" summary: Table 349 "Dimension Value" in Base Application (Microsoft.Finance.Dimension). 14 fields, 3 public procedures, 5 events. Present since at least BC23, still in BC30, changed in BC24-26, BC28-29. tier: official language: en tags: - table - base application versions: introduced: null last_changed: "29" 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: 05559a7dbc9380a4de23baca279b38c39c95e29bd9f1996c7ec58ad4ebda24a8 evidence: - kind: code url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/Dimension/DimensionValue.Table.al title: src/Layers/W1/BaseApp/Finance/Dimension/DimensionValue.Table.al (releases/29.x) date: null commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220 t: null quote: null links: learn: - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_dimensionvalue_get - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_dimensionvalue - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v2.0/api/dynamics_dimensionvalue_get - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_dimensionvalue - https://learn.microsoft.com/dynamics365/business-central/finance-dimensions objects: [] features: [] topics: - topic/business-central/business-functionality/finance/working-with-dimensions localizations: - localization/ru videos: [] posts: [] guidelines: [] object_type: table object_id: 349 name: Dimension Value 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: - "24" - "25" - "26" - "28" - "29" source_major: "29" obsolete: null countries: - ru ms_search_form_ids: [] counts: fields: 14 procedures: 19 events: 5 subscribers: 0 relations: out: 4 referenced_by: 450 pages: 10 extended_by: 0 event_subscribers: 1 calls: 2 called_by: 0 implements: 0 --- # Table 349 "Dimension Value" > Table 349 "Dimension Value" in Base Application (Microsoft.Finance.Dimension). 14 fields, 3 public procedures, 5 events. Present since at least BC23, still in BC30, changed in BC24-26, BC28-29. Base Application · Microsoft.Finance.Dimension · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/Dimension/DimensionValue.Table.al) · facts from BC29 Learn documents this table through its pages: [Page 20053 "APIV1 Dimension Values Entity"](../page/20053.md) (2 Learn pages), [Page 30040 "APIV2 Dimension Values Entity"](../page/30040.md) (2), [Page 537 "Dimension Values"](../page/537.md) (1), [Page 539 "Dimension Value Combinations"](../page/539.md) (1), [Page 560 "Dimension Value List"](../page/560.md) (1), [Page 2587 "Dim Corr Values Overview"](../page/2587.md) (1), [Page 9253 "Dim. Value Combinations Matrix"](../page/9253.md) (1). ## Properties | Property | Value | |---|---| | Caption | Dimension Value | | DataClassification | CustomerContent | ## Fields Explanation: the field's ToolTip in the code; without one, the ToolTip of a page control bound to the field (marked via the page); without that, its Caption (marked caption) when that differs from the name. | No. | Name | Type | Explanation | Notes | |---|---|---|---|---| | 1 | Dimension Code | Code[20] | Specifies the dimension code for the dimension value. | TableRelation [Table 348 "Dimension"](../table/348.md); NotBlank | | 2 | Code | Code[20] | Specifies the code for the dimension value. | NotBlank | | 3 | Name | Text[50] | Specifies a descriptive name for the dimension value. | | | 4 | Dimension Value Type | Option | Specifies the purpose of the dimension value. | OptionCaption: Standard,Heading,Total,Begin-Total,End-Total | | 5 | Totaling | Text[250] | Specifies an account interval or a list of account numbers. The entries of the account will be totaled to give a total balance. How entries are totaled depends on the value in the Account Type field. | TableRelation [Table 349 "Dimension Value"](../table/349.md) (if ("Dimension Value Type" = const(Total)) "Dimension Value"."Dimension Code" where("Dimension Code" = field("Dimension Code"))) | | 6 | Blocked | Boolean | Specifies that the related record is blocked from being posted in transactions, for example a customer that is declared insolvent or an item that is placed in quarantine. | | | 7 | Consolidation Code | Code[20] | Specifies the code that is used for consolidation. | | | 8 | Indentation | Integer | — | | | 9 | Global Dimension No. | Integer | — | | | 10 | Map-to IC Dimension Code | Code[20] | Specifies the intercompany's dimension code associated with the dimension of the current company. | | | 11 | Map-to IC Dimension Value Code | Code[20] | Specifies which intercompany dimension value corresponds to the dimension value on the line. | TableRelation [Table 412 "IC Dimension Value"](../table/412.md) ("IC Dimension Value".Code where("Dimension Code" = field("Map-to IC Dimension Code"))) | | 12 | Dimension Value ID | Integer | — | not editable; AutoIncrement | | 8001 | Last Modified Date Time | DateTime | — | | | 8002 | Dimension Id | Guid | — | TableRelation Dimension.SystemId | ## Keys - Key1: Dimension Code, Code (clustered) - Key2: Code, Global Dimension No. - Key3: Name ## Events published - `OnAfterCheckIfDimValueUsed(DimensionValue: Record "Dimension Value"; DimensionSetEntry: Record "Dimension Set Entry"; var Result: Boolean)` (integration): Integration event raised after checking if a dimension value is used in the system. Allows extensions to customize the dimension value usage validation logic. - `OnBeforeCheckIfDimValueUsedFromOnDelete(DimensionValue: Record "Dimension Value"; xDimensionValue: Record "Dimension Value"; var IsHandled: Boolean)` (integration): Integration event raised before checking if a dimension value is used during deletion. Allows extensions to implement custom dimension value usage validation. - `OnBeforeUpdateCostAccFromDim(var DimensionValue: Record "Dimension Value"; var xDimensionValue: Record "Dimension Value"; CallingTrigger: Option OnInsert,OnModify,,OnRename; var IsHandled: Boolean)` (integration): Integration event raised before updating cost accounting accounts from dimension value changes. Allows extensions to customize cost accounting integration logic. - `OnBeforeOnRename(var DimensionValue: Record "Dimension Value"; var xDimensionValue: Record "Dimension Value")` (integration): Integration event raised before renaming a dimension value. Allows extensions to perform custom validation or processing before the rename operation. - `OnGetGlobalDimensionNoOnElseCase(DimensionCode: Code[20]; var GlobalDimensionNo: Integer)` (integration): Integration event raised in the else case of GetGlobalDimensionNo function. Allows extensions to provide global dimension numbers for custom dimension codes. ## Trigger event subscribers - OnAfterRenameEvent: [Codeunit 480 "Get Shortcut Dimension Values"](../codeunit/480.md) OnDimValueRename ## Procedures - `CheckIfDimValueUsed(): Boolean`: Checks whether this dimension value is being used in posted entries or dimension sets. Prevents deletion or modification of dimension values that would cause data integrity issues. - `LookUpDimFilter(Dim: Code[20]; var Text: Text): Boolean`: Opens a lookup page for dimension values and returns a filter string of selected values. Used in filter fields to allow multi-selection of dimension values. - `LookupDimValue(DimCode: Code[20]; var DimValueCode: Code[20])`: Opens a lookup page for selecting a single dimension value. Used for dimension value selection in forms and fields. Plus 11 local procedures. ## Triggers OnDelete, OnInsert, OnModify, OnRename ## Relations - lookup page [Page 560 "Dimension Value List"](../page/560.md) - Dimension Code: TableRelation [Table 348 "Dimension"](../table/348.md) - Totaling: TableRelation [Table 349 "Dimension Value"](../table/349.md) - Map-to IC Dimension Value Code: TableRelation [Table 412 "IC Dimension Value"](../table/412.md) ## Referenced by 450 fields in 216 objects relate to this table (TableRelation or CalcFormula). - [Table 15 "G/L Account"](../table/15.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 18 "Customer"](../table/18.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 23 "Vendor"](../table/23.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 2632 "Statistical Account"](../table/2632.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 27 "Item"](../table/27.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 270 "Bank Account"](../table/270.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 376 "G/L Account (Analysis View)"](../table/376.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 482 "Reclas. Dimension Set Buffer"](../table/482.md): Dimension Value Name, New Dimension Value Name, Dimension Value Code, New Dimension Value Code - [Table 5200 "Employee"](../table/5200.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 6210 "Sustainability Account"](../table/6210.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 6225 "Sust. Account (Analysis View)"](../table/6225.md): Global Dimension 1 Code, Global Dimension 1 Filter, Global Dimension 2 Code, Global Dimension 2 Filter - [Table 83 "Item Journal Line"](../table/83.md): New Shortcut Dimension 1 Code, New Shortcut Dimension 2 Code, Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 352 "Default Dimension"](../table/352.md): Dimension Value Name, Dimension Value Code, DimensionValueId - [Table 356 "Dim. Value per Account"](../table/356.md): Dimension Value Name, Dimension Value Type, Indentation - [Table 5489 "Dimension Set Entry Buffer"](../table/5489.md): Dim. Val. Consolidation Code, Dimension Value Name, Dimension Value Code - [Table 1001 "Job Task"](../table/1001.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1004 "Job WIP Entry"](../table/1004.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1005 "Job WIP G/L Entry"](../table/1005.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 110 "Sales Shipment Header"](../table/110.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 111 "Sales Shipment Line"](../table/111.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 112 "Sales Invoice Header"](../table/112.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 113 "Sales Invoice Line"](../table/113.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 114 "Sales Cr.Memo Header"](../table/114.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 115 "Sales Cr.Memo Line"](../table/115.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 120 "Purch. Rcpt. Header"](../table/120.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 121 "Purch. Rcpt. Line"](../table/121.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 122 "Purch. Inv. Header"](../table/122.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 123 "Purch. Inv. Line"](../table/123.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 124 "Purch. Cr. Memo Hdr."](../table/124.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 125 "Purch. Cr. Memo Line"](../table/125.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 13 "Salesperson/Purchaser"](../table/13.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1381 "Customer Templ."](../table/1381.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1382 "Item Templ."](../table/1382.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1383 "Vendor Templ."](../table/1383.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1384 "Employee Templ."](../table/1384.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 152 "Resource Group"](../table/152.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 156 "Resource"](../table/156.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1570 "G/L Entry Posting Preview"](../table/1570.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 167 "Job"](../table/167.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 169 "Job Ledger Entry"](../table/169.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1690 "Bank Deposit Header"](../table/1690.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 1691 "Posted Bank Deposit Header"](../table/1691.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 1692 "Posted Bank Deposit Line"](../table/1692.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 17 "G/L Entry"](../table/17.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 1706 "Deferral Posting Buffer"](../table/1706.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 171 "Standard Sales Line"](../table/171.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 174 "Standard Purchase Line"](../table/174.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 181 "Posted Gen. Journal Line"](../table/181.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - [Table 203 "Res. Ledger Entry"](../table/203.md): Global Dimension 1 Code, Global Dimension 2 Code - [Table 207 "Res. Journal Line"](../table/207.md): Shortcut Dimension 1 Code, Shortcut Dimension 2 Code - and 166 more objects (323 fields): data/code/relations/29.json ## Pages and codeunits on this table - [Page 20053 "APIV1 Dimension Values Entity"](../page/20053.md) (source table) - [Page 2587 "Dim Corr Values Overview"](../page/2587.md) (source table) - [Page 30040 "APIV2 Dimension Values Entity"](../page/30040.md) (source table) - [Page 30302 "API Finance - Dimension Values"](../page/30302.md) (source table) - [Page 537 "Dimension Values"](../page/537.md) (source table) - [Page 539 "Dimension Value Combinations"](../page/539.md) (source table) - [Page 560 "Dimension Value List"](../page/560.md) (source table) - [Page 677 "IC Mapping Dim Values Outgoing"](../page/677.md) (source table) - [Page 706 "IC Dim Values Selector"](../page/706.md) (source table) - [Page 9253 "Dim. Value Combinations Matrix"](../page/9253.md) (source table) - [Codeunit 409 "Dimension Value-Indent"](../codeunit/409.md) (codeunit runs on it) ## 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 1100 "Cost Account Mgt"](../codeunit/1100.md) (2 calls: `UpdateCostAccFromDim → UpdateCostCenterFromDim`, `UpdateCostAccFromDim → UpdateCostObjectFromDim`) - [Codeunit 408 "DimensionManagement"](../codeunit/408.md) (2 calls: `OnDelete → UpdateDefaultDimensionAllowedDimensionValues`, `OnInsert → AddDefaultDimensionAllowedDimensionValue`) ## Across versions - Present in: BC23-30 - Changed (declaration) in: BC24-26, BC28-29 ## Countries that replace it [RU](../../localizations/ru.md) 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: "table", object_name: "Dimension Value")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.