|
| 1 | +--- |
| 2 | +title: "Checklist: Unified Interface transition | MicrosoftDocs" |
| 3 | +description: "Checklist to ensure that you're prepared for transition to the Unified Interface." |
| 4 | +ms.custom: "" |
| 5 | +ms.date: 11/04/2019 |
| 6 | +ms.reviewer: "kvivek" |
| 7 | +ms.service: powerapps |
| 8 | +ms.topic: "article" |
| 9 | +author: "Mattp123" |
| 10 | +ms.author: "haybass" |
| 11 | +manager: "kvivek" |
| 12 | +search.audienceType: |
| 13 | + - maker |
| 14 | +search.app: |
| 15 | + - PowerApps |
| 16 | + - D365CE |
| 17 | +--- |
| 18 | + |
| 19 | +# Checklist: Unified Interface transition |
| 20 | + |
| 21 | +Follow the steps in this article to ensure that you're prepared for transition to the |
| 22 | +Unified Interface. Readiness for transitioning to Unified Interface will depend on whether you are |
| 23 | +aiming for basic compatibility or redesigning to take full advantage of new |
| 24 | +capabilities. For more detailed information, see the [Unified Interface playbook](https://docs.microsoft.com/powerapps/maker/model-driven-apps/unified-interface-playbook) |
| 25 | +and [user experience white paper](https://docs.microsoft.com/powerapps/maker/model-driven-apps/approaching-unified-interface). |
| 26 | + |
| 27 | +The instructions apply to the following model-driven apps in Dynamics 365: |
| 28 | + |
| 29 | +- Dynamics 365 Sales |
| 30 | + |
| 31 | +- Dynamics 365 Customer Service |
| 32 | + |
| 33 | +- Dynamics 365 Field Service |
| 34 | + |
| 35 | +- Dynamics 365 Project Service Automation |
| 36 | + |
| 37 | +## Run the PowerApps Solution Checker on your solutions |
| 38 | + |
| 39 | +The [PowerApps solution checker](https://docs.microsoft.com/powerapps/maker/common-data-service/use-powerapps-checker) performs a rich static analysis check on your solutions against a set of best practice rules to quickly identify problematic patterns. After the check completes, you receive a detailed report that lists the issues identified, the |
| 40 | +components and code affected, and links to documentation that describes how to |
| 41 | +resolve each issue. |
| 42 | + |
| 43 | +The solution checker analyzes these solution components: |
| 44 | + |
| 45 | +- Common Data Service plug-ins |
| 46 | + |
| 47 | +- Common Data Service custom workflow activities |
| 48 | + |
| 49 | +- Common Data Service web resources (HTML and JavaScript) |
| 50 | + |
| 51 | +- Common Data Service configurations, such as SDK message steps |
| 52 | + |
| 53 | +**Things to consider** |
| 54 | + |
| 55 | +- Potential issues detected by the solution checker may not exclusively apply |
| 56 | + to the Unified Interface, be mindful of what will impact transition when |
| 57 | + reviewing results. |
| 58 | + |
| 59 | +- As in any automated code review, some issues can be false alarms and don’t |
| 60 | + mean that your application won’t run in Unified Interface. |
| 61 | + |
| 62 | +- Logic executed on the server side, such as plug-ins, custom workflow |
| 63 | + activities, and the configuration of SDK message steps shouldn’t impact the |
| 64 | + user interface and hence shouldn’t impact the transition to Unified |
| 65 | + Interface. |
| 66 | + |
| 67 | +- Even if the all issues aren’t directly associated with the Unified |
| 68 | + Interface, we recommend that you spend time reviewing them to improve the |
| 69 | + overall health of your application. |
| 70 | + |
| 71 | +## Check third-party solutions compatibility with Unified Interface |
| 72 | + |
| 73 | + |
| 74 | +Prior to transitioning to the Unified Interface, it’s important that you make |
| 75 | +sure that any third-party solution that you use in your application works in |
| 76 | +Unified Interface. |
| 77 | + |
| 78 | +- If you have installed ISV (Independent Software Vendor) add-ins through |
| 79 | + [AppSource](https://appsource.microsoft.com), check if upgrades are |
| 80 | + available in the [Power Platform Admin center](https://admin.powerplatform.microsoft.com) by selecting **Environments** > [environment_name] > **Manage Solutions**. |
| 81 | + |
| 82 | +- If you are using third-party solutions that were provided outside of |
| 83 | + AppSource, contact the provider (Partner or ISV) to get a new version that |
| 84 | + updates the apps to Unified Interface. |
| 85 | + |
| 86 | +> [!NOTE] |
| 87 | +> If there are no plans for your third-party solutions to be updated to a |
| 88 | + version compatible with Unified Interface, it is important to identify a |
| 89 | + path to replace these features with either native platform capabilities or |
| 90 | + alternative solutions that are compatible. |
| 91 | + |
| 92 | +## Identify replacements for deprecated client API code and features |
| 93 | + |
| 94 | +Based on the outputs of the **PowerApps Solution Checker** and the information |
| 95 | +contained in [Important changes (deprecations) coming](https://docs.microsoft.com/power-platform/important-changes-coming) on deprecated client APIs and |
| 96 | +features, you should have a good understanding of the customizations and features that |
| 97 | +either need to be corrected or replaced in your Unified Interface project. |
| 98 | + |
| 99 | +Here are some of the most common areas needing attention: |
| 100 | + |
| 101 | +- **Client API**: Recommended replacement methods are documented |
| 102 | +[here](https://docs.microsoft.com/power-platform/important-changes-coming#some-client-apis-are-deprecated). |
| 103 | + |
| 104 | +- **Process dialogs**: Recommended replacements for dialogs are documented |
| 105 | +[here](https://docs.microsoft.com/flow/replace-dialogs). |
| 106 | + |
| 107 | +- **Task flows**: Consider using [Business Process |
| 108 | +Flows](https://docs.microsoft.com/power-platform-release-plan/2019wave2/microsoft-flow/business-process-immersive-experiences) to replace task flows. |
| 109 | + |
| 110 | +- **Service scheduling**: Consider using [Universal Resource Scheduling](https://docs.microsoft.com/dynamics365/common-scheduler/schedule-anything-with-universal-resource-scheduling) to replace legacy service scheduling. |
| 111 | + |
| 112 | +> [!NOTE] |
| 113 | +> You might also consider replacing the Dynamics 365 for Outlook (COM Add-in) with the lightweight [Dynamics 365 App for Outlook](https://docs.microsoft.com/dynamics365/outlook-app/overview). |
| 114 | +
|
| 115 | +## Test your application in Unified Interface |
| 116 | + |
| 117 | +One of the easiest ways to test your application in Unified Interface is to turn |
| 118 | +on the [**Enable Unified Interface Only**](https://docs.microsoft.com/power-platform/admin/enable-unified-interface-only) option on a copy of your production environment. After the Unified Interface is enabled, you should be able to access your application using the **Dynamics 365 – |
| 119 | +Custom** app and test the use cases relevant to your context. |
| 120 | + |
| 121 | +### Test your business and technical scenarios |
| 122 | + |
| 123 | +Focus on what could potentially be impacted: |
| 124 | + |
| 125 | +- **Business processes** such as business process flows, business rules |
| 126 | + |
| 127 | +- **Customizations** such as forms, views, command bar buttons, web resources, and charts |
| 128 | + |
| 129 | +> [!TIP] |
| 130 | +> Challenge the user experience at the same time as doing these early tests: is everything meaningful and adding value? What should be removed/improved/added? For example, are the current list of views relevant? Or are my users forced to create their own views? |
| 131 | +
|
| 132 | +### Identify gaps |
| 133 | + |
| 134 | +- Any potential regressions that weren’t already spotted by the solution |
| 135 | + checker and third-party solution updates. |
| 136 | + |
| 137 | +- User pain points that could lead to optimizations (such as new form |
| 138 | + rendering by reorganizing sections and tabs) or specific training. |
| 139 | + |
| 140 | +- Any other dependencies on the legacy web client such as the use of the |
| 141 | + legacy Outlook COM Add-in instead of the lightweight Dynamics 365 App for |
| 142 | + Outlook. |
| 143 | + |
| 144 | +## Define your app strategy and settings |
| 145 | + |
| 146 | +Instead of using the **Dynamics 365 – Custom** app, which isn‘t optimized for |
| 147 | +Unified Interface but rather runs in compatibility mode, we suggest that you |
| 148 | +leverage either first-party apps made by Microsoft or create your owns apps. |
| 149 | + |
| 150 | +The Dynamics 365 first-party apps that have already been optimized for Unified |
| 151 | +Interface are the following: |
| 152 | + |
| 153 | +- Dynamics 365 Sales Hub |
| 154 | + |
| 155 | +- Dynamics 365 Customer Service Hub |
| 156 | + |
| 157 | +- Dynamics 365 Marketing |
| 158 | + |
| 159 | +- Dynamics 365 Field Service (version 8.x and later) |
| 160 | + |
| 161 | +- Dynamics 365 Project Service Automation (version 3.x and later) |
| 162 | + |
| 163 | +### What are model-driven apps? |
| 164 | + |
| 165 | +**Model-driven apps** are a type of app you can create using PowerApps that helps you provide tailored experience to your users depending on their role in the organization. For example, a salesperson can have a completely different experience than a customer service representative through different model-driven apps even though they are using data from the same environment. Multiple model-driven apps can be created in a Common Data Service environment. More information: [What are model-driven apps?](https://docs.microsoft.com/powerapps/maker/model-driven-apps/model-driven-app-overview) |
| 166 | + |
| 167 | +The Dynamics 365 first-party apps listed earlier are examples of model-driven apps. |
| 168 | + |
| 169 | +### How to define your app strategy? |
| 170 | + |
| 171 | +Ask yourself the following questions: |
| 172 | + |
| 173 | +1. Can you split your users into multiple groups with specific business |
| 174 | + processes? |
| 175 | + |
| 176 | +2. Do these groups have different requirements for what they should see and do? |
| 177 | + |
| 178 | +3. Are you finding it difficult to have different user experiences without |
| 179 | + using apps? |
| 180 | + |
| 181 | +If you have answered "Yes" to these questions then consider having |
| 182 | +multiple apps. |
| 183 | + |
| 184 | +This is the opportunity to rethink the experience in the context of business |
| 185 | +processes for each group or role. |
| 186 | + |
| 187 | +### Out-of-the-box apps (for example, Sales Hub) or customized apps? |
| 188 | + |
| 189 | +- It depends how tailored you’d like the experience to be. |
| 190 | + |
| 191 | +- If you have few customizations or want to benefit from first-party app |
| 192 | + updates, then consider using native apps. |
| 193 | + |
| 194 | +- If you want more control over the experience and updates of standard apps |
| 195 | + and customizations, then create your own app. |
| 196 | + |
| 197 | +### Once you have defined your app strategy, what should be the next steps? |
| 198 | + |
| 199 | +1. Customize your target apps and only include what users will need. Less is better. Reduce the clutter to enable users to work efficiently. |
| 200 | + |
| 201 | +2. Dissociate security roles from unused apps. |
| 202 | + |
| 203 | +## Review your apps settings and user experience fundamentals |
| 204 | + |
| 205 | +### App settings |
| 206 | + |
| 207 | +- Include all required entities in your app, even if they are not in the |
| 208 | + sitemap. |
| 209 | + |
| 210 | +- Provide the **Read** privilege for **Model-driven app** in the **Customization** tab in the **Security Role** dialog box. |
| 211 | + |
| 212 | +- Enable the **Unified Interface only** mode if your users don’t need to use |
| 213 | + the legacy web client. You can still access administration features by |
| 214 | + selecting **Settings** > **Advanced Settings**. |
| 215 | + |
| 216 | +- Create a simpler app URL. For example: https://\*.crm.dynamics.com/apps/MyApp* |
| 217 | + |
| 218 | +- Try to limit the number of apps a user can access. |
| 219 | + |
| 220 | + > [!TIP] |
| 221 | + > When **Use Unified Interface only** is set to **Yes** and when users only |
| 222 | + have access to one app, they are automatically redirected to the app when |
| 223 | + they access the root URL (https://\*.crm.dynamics.com)* |
| 224 | + |
| 225 | +### Optimize navigation (sitemap) |
| 226 | + |
| 227 | +- Define one main **area** with the most used **sub-areas** (dashboard, |
| 228 | + entities, etc.) organized in **groups** |
| 229 | + |
| 230 | +- Create one or more additional areas for less used features |
| 231 | + (configuration, settings, etc.). The idea is to help your users focus only on what’s important to do their work. |
| 232 | + |
| 233 | +### Update icons |
| 234 | + |
| 235 | +- Transitioning to the Unified Interface is a good opportunity to refresh |
| 236 | + icons. |
| 237 | + |
| 238 | +- We recommend **SVG** format as they render well regardless of screen |
| 239 | + resolution. |
| 240 | + |
| 241 | + > [!TIP] |
| 242 | + > Example of SVG icon format: |
| 243 | + > Width and height: 16px; Padding: 0px; Background: transparent; Icon |
| 244 | + color: \#FF000000 |
| 245 | + > To avoid rendering issues, open the SVG file with an editor (for example, Notepad) and remove fill="\#000000" |
| 246 | +
|
| 247 | +## Enrich your app with Unified Interface exclusive features |
| 248 | + |
| 249 | +- Create a **Welcome Page** that users see when they access each of your app. This is a great opportunity to guide users in their first steps. |
| 250 | + |
| 251 | +- Use existing **Custom Controls** to improve the usability of most field |
| 252 | + types, especially on mobile. For example, replace a 0 to 5 field rating with stars, replace a view of |
| 253 | + appointments with a calendar view, replace a sub-grid view with card forms. |
| 254 | + |
| 255 | +- Leverage **Reference Panels** on forms to bundle multiple views, quick |
| 256 | + views, and KB search feature in a single place. |
| 257 | + |
| 258 | +- Leverage the [PowerApps Component |
| 259 | + Framework](https://docs.microsoft.com/powerapps/developer/component-framework/overview) |
| 260 | + to add even more custom controls. You can get some from the community or from partners and ISVs. |
| 261 | + |
| 262 | +- Embed [canvas |
| 263 | + apps](https://docs.microsoft.com/powerapps/maker/canvas-apps/getting-started) |
| 264 | + in your forms to easily extend your application. No-code or low-code extension of your app without the need to develop custom HTML/JS web resources. |
| 265 | + |
| 266 | +- Embed **Power BI** reports and tiles in forms: consolidate data across |
| 267 | + multiple systems in a single view. |
| 268 | + |
| 269 | +- Consider leveraging **Interactive Dashboards** to configure a one-stop |
| 270 | + workplace that allows global filtering across dashboard components. |
| 271 | + |
| 272 | +- Configure **Custom Help Panes and Guided Tasks** so that users quickly get |
| 273 | + help and guidance. |
| 274 | + |
| 275 | +## Conduct user acceptance testing |
| 276 | + |
| 277 | +It is very important that your applications, business scenarios, and technical |
| 278 | +scenarios are tested by your business users in Unified Interface in conditions |
| 279 | +that are similar to your production environment. These users can act as business |
| 280 | +champions to help scale knowledge across the business. |
| 281 | + |
| 282 | +Testing will help identify remaining items to be addressed before transitioning |
| 283 | +all of your users to Unified Interface. |
| 284 | + |
| 285 | +## Update user training materials |
| 286 | + |
| 287 | +Conduct a review of your existing and planned training materials to ensure they |
| 288 | +have the latest screenshots and reflect any changes you have made to the user |
| 289 | +flow. |
| 290 | + |
| 291 | +## Check your transition date |
| 292 | + |
| 293 | +On October 1, 2020, [the legacy web client will no longer be |
| 294 | +available](https://docs.microsoft.com/power-platform/important-changes-coming#legacy-web-client-is-deprecated). |
| 295 | +Be sure to migrate well in advance to ensure there’s time for any issues to be |
| 296 | +addressed. |
0 commit comments