Results for “csi_item_instances_u02”
12 results
AI-generated from documented ETRM metadata — verify critical details on the linked pages.
Overview
CSI.CSI_ITEM_INSTANCES is the core master table of Oracle E-Business Suite's Customer Item / Installed Base (CSI) module, holding one row per tracked item instance — a serialized unit, lot-controlled assembly, or configured product tracked through its operational life. In Oracle EBS 12.1.1 and 12.2.2 this table serves as the authoritative repository for instance identity, ownership, location, and status, and it underpins Installed Base management, Field Service (AHL, CS), Depot Repair, Service Contracts (OKS), and Order Management integration.
The table resides in tablespace APPS_TS_TX_DATA with a PCT Free of 10. The primary key is CSI_ITEM_INSTANCES_PK on INSTANCE_ID. Under the supplied Data Vault heuristic classification, CSI_ITEM_INSTANCES models as a hub: it carries the durable business key of an item instance, and the many dependent CSI_I_*, CSI_T_*, AHL_*, CS_*, and OKS_* tables behave as satellites and links hanging off that hub. This is a modeling suggestion only, useful when mapping EBS objects into a Data Vault or dimensional warehouse.
Key Information Stored
The documented schema exposes 121 columns. The most significant are:
- INSTANCE_ID — surrogate primary key (CSI_ITEM_INSTANCES_PK) and the join key used by virtually every dependent table.
- INSTANCE_NUMBER — user-visible instance number; a documented business-key candidate via unique index CSI_ITEM_INSTANCES_U02.
- SERIAL_NUMBER / MFG_SERIAL_NUMBER_FLAG / LOT_NUMBER — external traceability identifiers; SERIAL_NUMBER is also indexed uniquely (case-insensitively) through the function-based index CSI_ITEM_INSTANCES_F01 on UPPER("SERIAL_NUMBER") and non-uniquely via CSI_ITEM_INSTANCES_N05.
- INVENTORY_ITEM_ID / INVENTORY_REVISION / INV_MASTER_ORGANIZATION_ID — the master item definition and its owning organization.
- INSTANCE_STATUS_ID / INSTANCE_CONDITION_ID — pointers to CSI_INSTANCE_STATUSES and MTL_MATERIAL_STATUSES_B respectively, defining the life-cycle state and condition of the instance.
- LOCATION_TYPE_CODE / LOCATION_ID / INV_ORGANIZATION_ID / INV_SUBINVENTORY_NAME / INV_LOCATOR_ID — composite location model (indexed by N03 and N06) describing where the instance currently resides.
- SYSTEM_ID — reference to CSI_SYSTEMS_B, linking the instance to a higher-level installed system.
- OWNER_PARTY_ID / OWNER_PARTY_ACCOUNT_ID / OWNER_PARTY_SOURCE_TABLE — ownership model (indexed by N12 and N13).
- ACTIVE_START_DATE / ACTIVE_END_DATE — instance validity window; ACTIVE_END_DATE is indexed by N04 and drives "currently active" queries.
- INSTALL_DATE / INSTALL_LOCATION_TYPE_CODE / INSTALL_LOCATION_ID — where and when the instance was installed (N15 supports install-location lookups).
- EXTERNAL_REFERENCE — indexed by N17, used to reconcile with external systems.
- CONFIG_INST_HDR_ID / CONFIG_INST_REV_NUM / CONFIG_INST_ITEM_ID — configuration-instance linkage (N16).
- LAST_OE_ORDER_LINE_ID / LAST_OE_AGREEMENT_ID / LAST_OE_RMA_LINE_ID / PO_ORDER_LINE_ID / WIP_JOB_ID / PA_PROJECT_ID / PA_PROJECT_TASK_ID — the "last transaction" pointers that tie the instance back to the Order Management, Purchasing, WIP, and Projects transactions that most recently touched it.
Common Use Cases and Queries
Typical uses include: locating an instance by serial number, listing all active instances for a customer or system, tracing where an instance sits physically, and driving field-service or depot-repair transactions.
- Lookup by serial number (uses CSI_ITEM_INSTANCES_F01 / CSI_ITEM_INSTANCES_N05):
SELECT instance_id, instance_number, serial_number, inventory_item_id
FROM csi_item_instances
WHERE UPPER(serial_number) = UPPER(:p_serial); - Active instances for a system (uses CSI_ITEM_INSTANCES_N07 and N04):
SELECT instance_id, instance_number, inventory_item_id
FROM csi_item_instances
WHERE system_id = :p_system_id
AND (active_end_date IS NULL OR active_end_date > SYSDATE); - Instances in an inventory location (uses CSI_ITEM_INSTANCES_N03):
SELECT instance_id, serial_number, inv_subinventory_name
FROM csi_item_instances
WHERE location_type_code = 'INV'
AND inv_organization_id = :p_org_id; - Instances owned by a party (uses CSI_ITEM_INSTANCES_N12):
SELECT instance_id, inventory_item_id, owner_party_account_id
FROM csi_item_instances
WHERE owner_party_id = :p_party_id; - Instances associated with a project (uses CSI_ITEM_INSTANCES_N08):
SELECT instance_id, serial_number, pa_project_id
FROM csi_item_instances
WHERE pa_project_id = :p_project_id;
Because the table is very wide (121 columns) and heavily indexed (17+ secondary indexes), reports should always filter on one of the documented indexed columns above; full-table scans on CSI_ITEM_INSTANCES are prohibitively expensive in production installations.
Related Objects
CSI_ITEM_INSTANCES is referenced by a large family of dependent tables through INSTANCE_ID or equivalent FK columns. The most significant include:
- CSI_ITEM_INSTANCES_H — history/audit table joined on INSTANCE_ID, capturing prior versions of the same instance.
- CSI_I_ASSETS, CSI_I_PARTIES, CSI_I_ORG_ASSIGNMENTS, CSI_I_EXTENDED_ATTRIBS, CSI_I_PRICING_ATTRIBS, CSI_I_VERSION_LABELS, CSI_IEA_VALUES — CSI satellites keyed on INSTANCE_ID holding asset, party, organization, descriptive, pricing, version, and flexfield attributes.
- CSI_II_RELATIONSHIPS (SUBJECT_ID / OBJECT_ID) — models parent-child relationships between instances in a configured structure.
- CSI_T_TXN_LINE_DETAILS (INSTANCE_ID / CHANGED_INSTANCE_ID) — transactional history of each instance change.
- AHL_VISITS_B (ITEM_INSTANCE_ID), AHL_UNIT_CONFIG_HEADERS, AHL_PART_CHANGES, AHL_UC_HEADERS_H — Field Service visits, unit configurations, and installed/removed part tracking.
- CSD_REPAIRS (CUSTOMER_PRODUCT_ID), CSD_MRO_SERIAL_NUMBERS — Depot Repair work orders and MRO serial tracking.
- OKS_SUBSCR_HEADER_B (INSTANCE_ID), OKL_TXL_ITM_INSTS (INSTANCE_ID) — Service Contracts and Lease Management linkages.
- CS_INCIDENTS_ALL_B (CUSTOMER_PRODUCT_ID) — Service (TeleService) incidents raised against a specific instance.
- CS_COUNTER_GROUPS (SOURCE_OBJECT_ID) — meter/counter groupings applied to the instance.
Outbound foreign keys confirm that the instance master validates against MTL_SYSTEM_ITEMS_B and MTL_ITEM_REVISIONS_B (via INVENTORY_ITEM_ID/INVENTORY_REVISION), MTL_SERIAL_NUMBERS (SERIAL_NUMBER), MTL_LOT_NUMBERS, MTL_MATERIAL_STATUSES_B (INSTANCE_CONDITION_ID), CSI_INSTANCE_STATUSES (INSTANCE_STATUS_ID), CSI_SYSTEMS_B (SYSTEM_ID), HZ_PARTY_SITES (LOCATION_ID), PA_PROJECTS_ALL and PA_TASKS, OE_ORDER_LINES_ALL (IN_TRANSIT_ORDER_LINE_ID), WIP_DISCRETE_JOBS, PO_LINES_ALL, and FND_SECURITY_GROUPS. Together these relationships establish CSI_ITEM_INSTANCES as the central hub object for installed-base data across the EBS Service, Manufacturing, Order Management, and Projects applications.
-
12.1.1 DBA Data 12.1.1
-
12.2.2 DBA Data 12.2.2
-
12.1.1 DBA Data 12.1.1
-
12.2.2 DBA Data 12.2.2
-
Item Instance details.
-
Item Instance details.
-
eTRM - CSI Tables and Views 12.2.2
Temporary table that holds the unprocessed XNP messages during data correction process.
-
eTRM - CSI Tables and Views 12.1.1
Temporary table that holds the unprocessed XNP messages during data correction process.