--- schema_version: "1" id: 61381713a13156c2a721ad0955b2215dd9104c958766a2ed3ca6ecca60276e22 title: Coordinate IT Assets and Configuration Items collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/it_srvcs_asset_mgmt_cmdb_sync.md canonical_url: https://help.salesforce.com/s/articleView?id=service.it_srvcs_asset_mgmt_cmdb_sync.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 7a1ae43672b4e7382834c7795188fec9cdeed275d27e1dacdbdd22f14885aa7a description: Synchronize your IT hardware assets and configuration items to maintain data consistency across tracking environments. products: - Service Cloud - Agentforce IT Service release: "264" --- # Coordinate IT Assets and Configuration Items Synchronize your IT hardware assets and configuration items to maintain data consistency across tracking environments. ### Required Editions
Available in: Lightning Experience
Available in: Enterprise, Performance, and Unlimited Editions with Agentforce IT Service.
Automated bidirectional updates eliminate manual reconciliation and ensure your IT reps work with accurate records. ## Operational Precedence and Source of Truth To coordinate dataflow without creating duplicate records, synchronization uses field mapping and field-ownership rules. Every mapped field connects with a single designated source of truth. The asset repository or the configuration management database (CMDB) defines which platform takes precedence. ## Prerequisites for Source of Truth Configurations Before you configure field ownership rules, consider these system behaviors: - **Override Controls**: The platform designated as the source of truth dictates the value. If a rep updates a non-authoritative repository, the engine flags and discards the change. - **Automatic Rollbacks**: When the authoritative platform updates, the engine overwrites modifications made on the secondary side. - **Data Overwrite Risks**: Selecting an incorrect source of truth causes permanent data loss. For example, if an admin reassigns a laptop via a deployment flow, but the map marks the CMDB as authoritative, the next automated scan rolls back the assignment. This rollback removes visibility from employee self-service portals. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-it_service-264-0-0-production-enus/0a574a10-4c7a-4681-aacf-0767f8beaad4/images/icon_note.png) Note Inbound dates synchronized at UTC midnight can show as the previous calendar day in browser time zones west of UTC. The stored UTC date remains accurate. ## Recommended Authoritative Field Mappings Field ownership configurations align with the operational strengths of each data repository. | Data Category | Authoritative Platform | Operational Fields and Sourcing Impact | | --- | --- | --- | | **Financial & Contractual Lifecycle** | Asset | Tracks asset procurement, financial depreciation, and ownership assignments. Mapped values include **Assigned To**, **Cost Center**, **Location**, and **Status**. | | **Technical & Operational Discovery** | Configuration Item (CMDB) | Tracks properties discovered through network scanning. Mapped values include **Hostname**, **IP Address**, **Operating System Version**, and hardware parameters. | ## Infinite Loop Prevention Because modifications flow bidirectionally between records, updating an asset can trigger a configuration item modification. This change publishes a platform event that updates the asset record again. To prevent infinite update loops, the framework uses explicit source attribution rules. When a change originates in the repository, the outbound synchronization engine tags the update with a tracking identifier. If the engine detects this self-originated tracking tag, it drops the event. This action breaks the background processing cycle. When the configuration management system processes the update, the system maintains the source indicator string. The framework continually evaluates incoming payloads. If the engine detects the tracking value, it identifies the transaction as self-originated and drops the event. ## Sync Log Audit Structures System warnings and transaction errors populate the Configuration Management Item Sync Log (`CnfgMgmtItemSyncLog`). These entries provide clear troubleshooting metrics directly in the setup console and eliminate inspecting raw engineering data. ## Key Fields for Troubleshooting and Auditing Each log entry exposes essential operational metadata to isolate synchronization issues: - **Log Title**: Shows a high-level summary of the transaction status. - **Log Description**: Provides granular error data, delta properties, and suggestions for resolution. - **Status**: Identifies the context category, such as **Success**, **Warning**, **Error**, or **Action Required**. - **Related Object and Configuration Item ID**: Links to the specific asset record or unique identifier causing the mapping conflict. - **Log Timestamp**: Shows an immutable marker of the exact date and time that the event occurred. ## Common Synchronization Exceptions and System Outcomes Reps frequently encounter these synchronization scenarios during system updates: - **Multi-Asset Matches**: If a discovery scan maps an incoming configuration item to multiple asset records, the framework halts the transaction. The engine generates an alert instructing the admin to resolve duplicate records. - **Missing Mandatory Fields**: If an incoming event initiates creation of an asset record but lacks required attributes, the engine creates a locked asset shell. The log sets the status to **Action Required** to prompt manual remediation. - **Unmapped Picklist Values**: If an operational state changes within the configuration management database, but the text value lacks a defined translation rule, the engine skips the update. This path preserves asset record data integrity across both systems. #### See Also - [Configure Field Mappings for IT Services](https://help.salesforce.com/s/articleView?id=service.it_srvcs_field_mapping.htm&type=5&language=en_US) - [Configuration Items in CMDB](https://help.salesforce.com/s/articleView?id=service.it_srvcs_cmdb_ci_overview.htm&release=264.0.0&type=5 "Configuration items (CIs) represent the individual assets in your IT environment. Each CI stores key details about a specific hardware or software component, helping your teams track, manage, and understand the infrastructure that supports your business. CIs provide the foundation for service management, impact analysis, and discovery.") - [Configure Asset Matching Criteria](https://help.salesforce.com/s/articleView?id=service.it_srvcs_cmdb_configure_matching_asset_rules.htm&release=264.0.0&type=5 "Define criteria to automatically link discovered configuration items (CIs) to existing assets in IT Asset Management. Create global rules that apply to a parent CI hierarchy, or create specific rules for individual CI types. Setting up a global rule follows the same steps as creating a specific rule.")