--- id: object/table/5777 type: object title: Table 5777 "Item Reference" summary: Table 5777 "Item Reference" in Base Application (Microsoft.Inventory.Item.Catalog). 10 fields, 3 public procedures, 12 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: 23d41474bc17184191bbebb732892b167a00ece9e5ef2458b8d38c6392cb538f evidence: - kind: code url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Inventory/Item/Catalog/ItemReference.Table.al title: src/Layers/W1/BaseApp/Inventory/Item/Catalog/ItemReference.Table.al (releases/29.x) date: null commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220 t: null quote: null links: learn: [] objects: [] features: [] topics: [] localizations: [] videos: [] posts: [] guidelines: [] object_type: table object_id: 5777 name: Item Reference namespace: Microsoft.Inventory.Item.Catalog 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: [] ms_search_form_ids: [] counts: fields: 10 procedures: 20 events: 12 subscribers: 0 relations: out: 4 referenced_by: 3 pages: 3 extended_by: 1 event_subscribers: 2 calls: 0 called_by: 0 implements: 0 --- # Table 5777 "Item Reference" > Table 5777 "Item Reference" in Base Application (Microsoft.Inventory.Item.Catalog). 10 fields, 3 public procedures, 12 events. Present since at least BC23, still in BC30, changed in BC24-26, BC28-29. Base Application · Microsoft.Inventory.Item.Catalog · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Inventory/Item/Catalog/ItemReference.Table.al) · facts from BC29 ## Properties | Property | Value | |---|---| | Caption | Item Reference | | 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 | Item No. | Code[20] | Specifies the number on the item card from which you opened the Item Reference Entries window. | TableRelation [Table 27 "Item"](../table/27.md) | | 2 | Variant Code | Code[10] | Specifies the variant of the item on the line. | TableRelation [Table 5401 "Item Variant"](../table/5401.md) ("Item Variant".Code where("Item No." = field("Item No."))) | | 3 | Unit of Measure | Code[10] | Specifies the name of the item or resource's unit of measure, such as piece or hour. | TableRelation [Table 5404 "Item Unit of Measure"](../table/5404.md) ("Item Unit of Measure".Code where("Item No." = field("Item No."))) | | 4 | Reference Type | Enum "Item Reference Type" | Specifies the type of the reference entry. | enum [Enum 5726 "Item Reference Type"](../enum/5726.md) | | 5 | Reference Type No. | Code[20] | Specifies a customer number, a vendor number, or a bar code, depending on what you have selected in the Type field. | TableRelation if ("Reference Type" = const(Customer)) Customer."No." else if ("Reference Type" = const(Vendor)) Vendor."No." | | 6 | Reference No. | Code[50] | Specifies the referenced item number. If you enter a reference between yours and your vendor's or customer's item number, then this number will override the standard item number when you enter the reference number on a sales or purchase document. | NotBlank | | 7 | Description | Text[100] | Specifies a description of the item that is linked to this reference. | | | 9 | Description 2 | Text[50] | Specifies an additional description of the item that is linked to this reference. | | | 10 | Starting Date | Date | Specifies the first day from when the item reference is valid. | | | 11 | Ending Date | Date | Specifies the last day from when the item reference is valid. | | ## Keys - Key1: Item No., Variant Code, Unit of Measure, Reference Type, Reference Type No., Reference No. (clustered) - Key2: Reference No. - Key3: Reference No., Reference Type, Reference Type No. - Key4: Reference Type, Reference No. - Key5: Item No., Variant Code, Unit of Measure, Reference Type, Reference No. - Key6: Reference Type, Reference Type No. ## Events published - `OnAfterCreateItemVendor(var ItemReference: Record "Item Reference"; ItemVendor: Record "Item Vendor")` (integration) - `OnBeforeCreateItemVendor(var ItemReference: Record "Item Reference"; var ItemVendor: Record "Item Vendor")` (integration) - subscribers: [Codeunit 8028 "Usage Based Contr. Subscribers"](../codeunit/8028.md) SynchronizeItemVendorUsageDataSupplierReferenceEntryNoOnBeforeCreateItemVendor - `OnBeforeCreateItemVendorProcedure(var ItemReference: Record "Item Reference"; var ItemVendor: Record "Item Vendor"; var IsHandled: Boolean)` (integration) - `OnBeforeFindItemDescription(var ItemDescription: Text[100]; var ItemDescription2: Text[50]; ItemNo: Code[20]; VariantCode: Code[10]; UnitOfMeasureCode: Code[10]; ReferenceType: Enum "Item Reference Type"; ReferenceTypeNo: Code[20]; var Result: Boolean; var IsHandled: Boolean; var ItemReference: Record "Item Reference"; ToDate: Date)` (integration) - `OnBeforeItemVendorDelete(ItemVendor: Record "Item Vendor"; ItemReference: Record "Item Reference")` (integration) - `OnBeforeUpdateItemVendorNo(var ItemReference: Record "Item Reference"; var IsHandled: Boolean)` (integration) - `OnBeforeMultipleItemReferencesExist(var ItemReference: Record "Item Reference"; var Result: Boolean; var IsHandled: Boolean)` (integration) - `OnInsertTriggerOnBeforeCreateItemVendor(var Rec: Record "Item Reference"; xRec: Record "Item Reference"; Item: Record "Item")` (integration) - `OnBeforeDeleteItemVendor(var ItemReference: Record "Item Reference"; var IsHandled: Boolean)` (integration) - `OnRenameOnBeforeUpdateItemVendor(var ItemReference: Record "Item Reference"; xItemReference: Record "Item Reference"; var IsHandled: Boolean)` (integration) - `OnBeforeValidateReferenceType(var ItemReference: Record "Item Reference"; xItemReference: Record "Item Reference"; var IsHandled: Boolean)` (integration) - `OnInsertTriggerOnBeforeValidateUoM(var ItemReference: Record "Item Reference"; xItemReference: Record "Item Reference"; Item: Record "Item"; var IsHandled: Boolean)` (integration) ## Trigger event subscribers - OnAfterValidateEvent(Supplier Ref. Entry No.): [Codeunit 8028 "Usage Based Contr. Subscribers"](../codeunit/8028.md) SynchronizeItemVendorUsageDataSupplierReferenceEntryNoOnAfterValidateEvent ## Procedures - `CreateItemVendor()` - `FindItemDescription(var ItemDescription: Text[100]; var ItemDescription2: Text[50]; ItemNo: Code[20]; VariantCode: Code[10]; UnitOfMeasureCode: Code[10]; ToDate: Date; ReferenceType: Enum "Item Reference Type"; ReferenceTypeNo: Code[20]): Boolean` - `HasValidUnitOfMeasure(): Boolean` Plus 5 local procedures. ## Triggers OnDelete, OnInsert, OnRename ## Relations - lookup page [Page 5735 "Item Reference List"](../page/5735.md) - Item No.: TableRelation [Table 27 "Item"](../table/27.md) - Variant Code: TableRelation [Table 5401 "Item Variant"](../table/5401.md) - Unit of Measure: TableRelation [Table 5404 "Item Unit of Measure"](../table/5404.md) ## Referenced by 3 fields in 3 objects relate to this table (TableRelation or CalcFormula). - [Table 6101 "E-Document Purchase Line"](../table/6101.md): [BC] Item Reference No. - [Table 6105 "E-Document Line Mapping"](../table/6105.md): Item Reference No. - [Table 6154 "E-Document Sales Line"](../table/6154.md): [BC] Item Reference No. ## Pages and codeunits on this table - [Page 5735 "Item Reference List"](../page/5735.md) (source table) - [Page 5736 "Item References"](../page/5736.md) (source table) - [Page 5737 "Item Reference Entries"](../page/5737.md) (source table) ## Extended by - [Table extension 8008 "Usage Based Item Reference"](../tableextension/8008.md) ## Across versions - Present in: BC23-30 - Changed (declaration) in: BC24-26, BC28-29 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). 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: "Item Reference")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.