|
1 | 1 | --- |
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. |
4 | 4 | author: hbarik |
5 | 5 | ms.author: hbarik |
6 | 6 | ms.reviewer: nenellim |
7 | | -ms.topic: troubleshooting |
| 7 | +ms.topic: troubleshooting-problem-resolution |
8 | 8 | ms.collection: |
9 | 9 | ms.date: 09/22/2025 |
10 | | -ms.custom: bap-template |
| 10 | +ms.custom: sap:Routing Setup\Unable to turn on Unified Routing |
11 | 11 | --- |
12 | 12 |
|
13 | | -# Troubleshoot failures in enabling of unified routing |
| 13 | +# Troubleshoot failures when provisioning unified routing |
14 | 14 |
|
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. |
16 | 16 |
|
17 | 17 | ## Symptoms |
18 | 18 |
|
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: |
20 | 20 |
|
21 | 21 | - "Unified routing provisioning failed due to issues in configuration..." |
22 | 22 | - "Unified routing provisioning failed due to an error in deactivation of basic routing rulesets..." |
23 | 23 | - "Unified routing provisioning failed due to an error in activation of basic routing rulesets..." |
24 | 24 |
|
25 | | -## Cause 1 |
| 25 | +## Cause 1: Issues with basic routing rulesets |
26 | 26 |
|
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. |
28 | 28 |
|
29 | | -## Resolution 1 |
| 29 | +### Solution |
30 | 30 |
|
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. |
32 | 33 |
|
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). |
34 | 35 |
|
35 | | -## Cause 2 |
| 36 | +## Cause 2: Failures due to master entity routing configuration |
36 | 37 |
|
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: |
38 | 39 |
|
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. |
41 | 43 |
|
42 | | -## Resolution 2 |
| 44 | +### Solution |
43 | 45 |
|
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. |
45 | 50 |
|
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). |
52 | 52 |
|
53 | 53 | ### Related information |
54 | 54 |
|
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