Overview π₯
Partners may encounter the following error when running inspectors integrated with ConnectWise:
βConnectWise and Liongard are out of sync. On the Admin > Integrations screen, use the troubleshooting dropdown to βSync Mappingsβ and then re-run the inspector.β
This issue typically occurs when configuration mappings between Liongard and ConnectWise become invalid, outdated, or misaligned.
Impact π₯Ά
Inspectors fail with status as "Platform Failure"
Data cannot sync to ConnectWise configurations
Errors related to missing mapped fields
Integration appears connected but is functionally broken
Why This Happens π€
This is a mapping integrity issue, not an inspector or credential failure.
πΉ Root Cause
Liongard relies on field mappings to sync inspector data into ConnectWise Configuration Types.
If those mappings break, Liongard cannot find the expected fields.
π Common Causes
Cause | Explanation |
π Outdated / Legacy Configurations | Integration was disabled for long periods (e.g., months/years), causing schema drift |
π Re-enabled Old Integration | Old mappings reference fields that no longer exist |
βοΈ Changes in ConnectWise Configurations | Fields renamed, removed, or modified |
β Deleted or Missing Fields | Required fields no longer exist in ConnectWise |
π Broken Mapping Relationships | Mapping still exists but points to invalid structure |
What the Error Really Means? π§
Example error from logs:
Unable to find mapped fields "Total Devices", "Active Users Without MFA", "Directory Name"...
π This means:
Liongard is trying to sync data
ConnectWise no longer has those mapped fields
The mapping is stale or invalid
How Data Flow Works (Simplified) π
Liongard Inspector β Data (Dataprint)
β
Mapping Layer (Field Matching)
β
ConnectWise Configuration Type
β If mapping layer breaks β Sync fails
β
If mapping is valid β Data syncs successfully
Steps to Resolve π§βπ«
Step 1 β Attempt Basic Sync Repair
Navigate to:
Admin β Integrations β ConnectWise β Configuration Types
From "Troubleshooting" dropdown menu Run:
Repair
Force Repair
Re-sync
π Then Re-run the affected inspector (Clear Cache + Debug recommended).
Reference:
Step 2 β Validate Configuration Type Mapping
Navigate to:
Admin β Integrations β ConnectWise β Configuration Types β Liongard Configuration Types
Ensure the Configuration Auto-Updating is enabled for Liongard Configuration Type(s) , Example :Cloud Productivity (auto), which is the configuration for Microsoft 365 & Google WorkSpace. Inspector.
Navigate to:
Admin β Integrations β ConnectWise β Configuration Types β All ConnectWise Configuration Types
Locate the affected configuration type, Example :Cloud Productivity (auto), which is the configuration for Microsoft 365 & Google WorkSpace Inspector.
π Check for:
Step 3 β Reset Mapping π§
If mappings appear broken:
Remove the affected mapping completely
Save changes
Run:
Repair
Force Repair
Re-sync
π This forces Liongard to rebuild mappings
π Then re-run the affected inspector. If the issue persists, continue with Step 4
Step 4 β Resolve Legacy Configuration Issues (Critical) π¨
π The problem is likely stale ConnectWise configuration records
β―οΈ Fix: Rename Configuration in ConnectWise
In ConnectWise Manage:
Navigate to:
β System β Setup Tables β ConfigurationsSearch for the affected configuration
Open the configuration record
Rename it (example):
Old Name β Old Name (Legacy)
Click Save
Repeat Step 1
If the problem is still not resolved and a similar ConnectWise-related error appears, please proceed to Step 5.
Step 5 β Delete Old Configuration From ConnectWise (Optional)
In ConnectWise Manage:
Navigate to:
β System β Setup Tables β ConfigurationsSearch for the affected configuration
Delete the affected configuration.
Repeat Step 1
Why This Works π€·π»ββοΈ
Renaming forces ConnectWise to:
Refresh internal references
Break linkage to outdated mappings
Allow Liongard to create a fresh mapping relationship
Expected Result π§βπ»
Inspector runs successfully
No βout of syncβ errors
Data syncs correctly into ConnectWise
New mapping aligns with current schema
When This Issue Commonly Occurs π§βπ«
Integration disabled for long periods (e.g., since 2022 β re-enabled later)
Reusing old ConnectWise configurations
Schema changes in ConnectWise over time
Initial testing environments later reused in production
Troubleshooting Checklist π
Check | Expected Outcome |
Run Sync Mappings | Mapping refresh attempt |
Remove & Recreate Mapping | Clears invalid relationships |
Rename Configuration in ConnectWise | Breaks stale references |
Delete Old Configuration Records from ConnectWise (optional) | Avoid confusion and reduce the likelihood of Liongard-ConnectWise integration sync failures. |
Re-run Inspector (Debug Mode) | Confirms fix |
Review Logs for Missing Fields | Identifies mapping gaps |
When to Contact Support π¦
Contact Liongard Support if:
Issue persists after mapping reset + rename & deletion
Errors continue showing missing fields
Multiple configuration types are affected
You cannot identify which mapping is broken
Provide:
Inspector name(s)
Error message / Inspection logs
Configuration Type name
Confirmation of steps performed
Key Takeaway π‘
This is not an inspector issue β it is a mapping mismatch between Liongard and ConnectWise.
β Most commonly caused by legacy or stale configurations
β Resolved by resetting mappings and refreshing ConnectWise configuration references.
Summary π
Error occurs due to invalid or outdated field mappings
Basic repair steps may not resolve deeply stale mappings
Renaming ConnectWise configurations is often the key fix
After refresh, Liongard rebuilds correct mappings automatically





