Skip to content

Commit 119dca3

Browse files
committed
writer updates
1 parent 18b47b0 commit 119dca3

File tree

1 file changed

+25
-25
lines changed

1 file changed

+25
-25
lines changed
Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,55 @@
11
---
2-
title: Troubleshoot failures in enabling of unified routing
3-
description: Learn how to troubleshoot when enabling of unified routing fails in Dynamics 365 Customer Service.
2+
title: Troubleshoot Failures When Enabling Unified Routing in Dynamics 365
3+
description: Learn how to troubleshoot failures when enabling unified routing in Dynamics 365 Customer Service.
44
author: hbarik
55
ms.author: hbarik
66
ms.reviewer: nenellim
7-
ms.topic: troubleshooting
7+
ms.topic: troubleshooting-problem-resolution
88
ms.collection:
99
ms.date: 09/22/2025
10-
ms.custom: bap-template
10+
ms.custom: sap:Routing Setup\Unable to turn on Unified Routing
1111
---
1212

13-
# Troubleshoot failures in enabling of unified routing
13+
# Troubleshoot failures when provisioning unified routing
1414

15-
This article provides a resolution for the issue where provisioning of unified routing fails and displays an error message. The failure might be due to various causes, and we provide a set of guidelines for you to troubleshoot this error.
15+
This article provides troubleshooting guidance for issues encountered when provisioning [unified routing](/dynamics365/customer-service/administer/overview-unified-routing) in Dynamics 365 Customer Service.
1616

1717
## Symptoms
1818

19-
When you attempt to turn on the unified routing toggle, one of the following error messages appears:
19+
When you try to [enable the unified routing toggle](/dynamics365/customer-service/administer/provision-unified-routing#enable-unified-routing-for-customer-service-only) in Dynamics 365 Customer Service, the feature fails to enable and one of the following error messages appears:
2020

2121
- "Unified routing provisioning failed due to issues in configuration..."
2222
- "Unified routing provisioning failed due to an error in deactivation of basic routing rulesets..."
2323
- "Unified routing provisioning failed due to an error in activation of basic routing rulesets..."
2424

25-
## Cause 1
25+
## Cause 1: Issues with basic routing rulesets
2626

27-
If you're already using basic routing, issues might occur when you activate or deactivate a routing rule set or modify permissions on them.
27+
If you're already using [basic routing](/dynamics365/customer-service/administer/create-rules-automatically-route-cases), conflicts might occur when you activate or deactivate routing rule sets or modify their permissions.
2828

29-
## Resolution 1
29+
### Solution
3030

31-
- Check the owner of all the basic routing rulesets. If the owner user doesn't have access, then enable the user or update the owner of the basic routing rule set to an active user. 
31+
1. Check the ownership of all the basic routing rule sets. If the owner of a rule set no longer has access, either reactivate the user or update the owner of the rule set to an active user.
32+
2. After correcting any ownership or access issues, try enabling unified routing again.
3233

33-
Learn more in [Automatically route cases using basic routing rulesets](/dynamics365/customer-service/administer/create-rules-automatically-route-cases).
34+
For detailed information about basic routing rule sets, see [Automatically route cases using basic routing rulesets](/dynamics365/customer-service/administer/create-rules-automatically-route-cases).
3435

35-
## Cause 2
36+
## Cause 2: Failures due to master entity routing configuration
3637

37-
One of the following issues can cause a failure in enabling unified routing.
38+
During provisioning, the system [creates a master entity routing configuration for the Case table](/dynamics365/customer-service/administer/set-up-record-routing#configure-unified-routing-for-records). This step might fail in the following scenarios:
3839

39-
- During a copy from an existing org, the decision contract is added in the target org but the related records are missed. When the system tries to [create a master entity routing configuration for the Case table](/dynamics365/customer-service/administer/set-up-record-routing#configure-unified-routing-for-records) during provisioning, it fails because of the missing related records.
40-
- When you create the Case master entity record configuration with the same name (new_incidentmasterentityroutingconfiguration) before triggering the provisioning.
40+
- During a copy from an existing org, the decision contract is added in the target org, but the related records are missed.
41+
- When the system tries to create a master entity routing configuration for the Case table during provisioning, it fails because of the missing records.
42+
- You manually create a Case master entity record configuration with the name `new_incidentmasterentityroutingconfiguration` before triggering provisioning.
4143

42-
## Resolution 2
44+
### Solution
4345

44-
1. Delete the record of type msdyn_decisioncontract with the following attributes from your Dataverse instance.
46+
1. Delete the record of type `msdyn_decisioncontract` with the following attributes from your Dataverse instance:
47+
1. `msdyn_name`: `Case decision ruleset`
48+
1. `msdyn_uniquename`: `new_incidentmasterentityroutingconfiguration`
49+
1. After deleting the record, try enabling unified routing again.
4550

46-
- **msdyn_name**: Case decision ruleset
47-
- **msdyn_uniquename**: new_incidentmasterentityroutingconfiguration
48-
49-
1. Try to provision again.
50-
51-
Learn more in [Delete record](/power-apps/developer/model-driven-apps/clientapi/reference/xrm-webapi/deleterecord).
51+
For information on deleting records in Dataverse, see [Delete record](/power-apps/developer/model-driven-apps/clientapi/reference/xrm-webapi/deleterecord).
5252

5353
### Related information
5454

55-
[Enable unified routing in Dynamics 365 Customer Service](/dynamics365/customer-service/administer/provision-unified-routing)
55+
[Enable unified routing in Dynamics 365 Customer Service](/dynamics365/customer-service/administer/provision-unified-routing)

0 commit comments

Comments
 (0)