Merge pull request #2875 from MicrosoftDocs/her-may13

May 13 updates for Hospital Emergency Response app

Author: KumarVivek

powerapps-docs/sample-apps/emergency-response/configure-data-reporting.md

@@ -6,7 +6,7 @@ manager: annbe
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: 
-ms.date: 05/01/2020
+ms.date: 05/13/2020
 ms.author: pankar
 ms.reviewer: kvivek
 searchScope:
@@ -245,6 +245,27 @@ As an admin, you can change the default tracking level of mobile apps.
 
 1. Select **Save** in the lower-right corner to save your changes.
 
+## Configure the Power BI report URL for the Dashboard mobile app
+
+You can set the Power BI report URL for the **Dashboard** mobile app so that frontline workers can view the dashboard in the browser of their mobile app. More information:
+
+> [!NOTE]
+> Ensure that you have the Power BI report URL from your IT admin. The Power BI report URL is available after publishing the Power BI dashboard. More information: [Step 10: Publish the Power BI dashboard](deploy-configure.md#step-10-publish-the-power-bi-dashboard)
+
+
+1.  Sign into the admin app (model-driven app) using the URL provided by your IT admin.
+
+1.  In the left navigation, select the **Administration** area, and then select **Apps**.
+
+1.  Select **Emergency Response App - Dashboard** to open the record.
+
+1.  In the app record, specify the report URL in the **Launch URL** field.
+
+    > [!div class="mx-imgBorder"]
+    > ![dashboard-launch-url](media/dashboard-launch-url.png)
+
+1.  Save the record.
+
 ## View Common Data Service dashboards
 
 Following dashboards are available by default in the Hospital Emergency Response admin (model-driven) app:
@@ -346,6 +367,9 @@ Sign in to [Power BI](https://apps.powerbi.com) to access and view the Power BI
 
 You can use the filters on the right side to filter data for COVID locations, facilities, regions and hospital systems.
 
+> [!NOTE]
+> The Power BI dashboard is also optimized to view in the Power BI mobile app. For information about using the Power BI mobile app to view dashboards, see [Explore dashboards and reports in the Power BI mobile apps](https://docs.microsoft.com/power-bi/consumer/mobile/mobile-apps-quickstart-view-dashboard-report) in Power BI docs.
+
 #### System at a glance page 
 
 The **Systems at a glance page** is the default or the top-level page that provides an overall view.  
@@ -492,9 +516,99 @@ After the required languages are enabled by your system administrator, each admi
 
 The admin app UI will switch to display in the language you selected.
 
-## Extend mobile app labels (Experimental)
+## Extend mobile app labels
+
+You can extend Hospital Emergency Response mobile app labels with custom text. To do this, you model-driven app named **Canvas App Label Management** to customize the mobile app labels. Add new languages supported by the solution and text for corresponding mobile app labels using the model-driven app. You can create and edit strings across different languages for use in the mobile app.
+
+> [!div class="mx-imgBorder"]
+> ![canvas-app-label-app](media/canvas-app-label-app.png)
+
+### Add new language record
+
+Create a new language record for labels in mobile app. After you add the language record, you can add custom labels for Hospital Emergency Response mobile app.
+
+1. Sign in to [Power Apps](https://make.powerapps.com).
+1. Select **Apps** from the left pane.
+1. Select the **Canvas App Label Management** app to open.
+1. Select **Canvas App Languages** from the left pane.
+1. Select **New**.
+1. Enter values for Name, Language Tag and Display Name. For example, 'English' as the name and display name, with 'en' as the language tag.
+
+    ![Create new language record](media/01-create-language-tag.png "Create new language record")
+
+1. Select **Save**.
+
+### Add new string record
+
+1. Select **Canvas App Strings** from the left pane.
+1. Select **New**.
+1. Enter TextID and Description. For example, *SplashScreenFacilityDropdownLabel* and *Facility selection on splash screen*.
+
+    ![Add new string record](media/02-create-string-record.png "Add new string record")
+
+    > [!NOTE]
+    > To find TextID in Hospital Emergency Response mobile app, go to [Find TextID of a label](#find-the-textid-value-of-the-label).
+
+1. Select **Save**.
+
+### Add your canvas app label
+
+1. Select **Canvas App String Values** from the left pane.
+1. Select **New**.
+1. Select TextID, for example *SplashScreenFacilityDropdownLabel*.
+1. Enter Default Text, for example *Facility*.
+1. Select Language Tag, for example *English*.
+1. Enter Override Text, for example *Center*.
+
+    > [!NOTE]
+    > **Override Text** is the new label value to be displayed in your Hospital Emergency Response mobile app.
+
+    ![Add custom string value](media/03-create-string-value.png "Add custom string value")
+
+1. Select **Save**.
+
+You can also follow the steps to add your canvas app label using the sub-grid on the **Canvas App Strings** record.
+
+### View your changes
+
+Play the app to view your changes using your mobile device.
+
+To play the app in browser:
+
+1. Sign in to [Power Apps](https://make.powerapps.com).
+1. Select **Apps** from the left pane.
+1. Select the canvas app to play.
+
+![Play the app with custom label](media/05-play-app-with-change.png "Play the app with custom label")
+
+### Find the TextID value of the label
+
+1. Sign in to [Power Apps](https://make.powerapps.com).
+1. Select **Apps** from the left pane.
+1. Select the canvas app.
+1. Select **Edit** from top menu.
+1. Select the label that you want to customize text for.
+1. From the property list on top left, select the **Text** property.
+
+    ![Check TextID of a label](media/04-get-canvasapp-textid.png "Check TextID of a label")
+
+The **Text** property formula bar on top shows the **TextID**. And the **Text** property on the right side property pane shows the **Default Text** value.
+
+### Uninstalling the Canvas App Strings solution
+
+If you uninstall Canvas App Strings solution, the apps will continue to run, even though the entity that the app is looking for doesn't exist.
+
+You can restore canvas apps to previous version that didn't use Canvas App Strings solution in two different ways:
+
+1. Note the current live version of the app before you import the solution. You can restore the app to this version after you uninstall the solution. For more information: [Restore a canvas app to a previous version in Power Apps](../../maker/canvas-apps/restore-an-app.md).
+
+1. Create a new solution and the existing apps. Export the solution as backup. If you uninstall the Canvas App Strings solution, you can import your backup solution with default apps. To learn how to add apps to solution and export, go to [Link an existing canvas app to a solution](../../maker/canvas-apps/add-app-solution.md#link-an-existing-canvas-app-to-a-solution).
+
+### Considerations when extending mobile app labels
 
-You can extend Hospital Emergency Response mobile app labels with custom text. To do this, you have to import the **Canvas Apps Strings** solution. The solution adds model-driven app named **Canvas App Label Management** that you can use to customize the Hospital Emergency Response mobile app labels. Add new languages supported by the solution and text for corresponding mobile app labels using the model-driven app. For step by step instructions and to download the solution, go to [Extend Hospital Emergency Response mobile app labels (Experimental)](https://github.com/microsoft/powerapps-tools/tree/master/Apps/EmergencyResponse/Experimental/LabelCustomizations).
+- Some TextIDs (labels) can be found in the **OnVisible** property of a screen as a part of a collection.
+- HomeScreen, SplashScreen, FeedbackScreen, MeScreen, Buttons and the timestamp for last submitted data share the same TextIDs across apps. Other screens use separate values for TextIDs, even if the Default Text is same across apps; for example *Location*.
+- Canvas App Strings solution supports the following languages: German, Spanish, French, Italian, Japanese,  Korean, Polish, Portuguese (Portugal), Portuguese (Brazil), and Turkish.
 
 ## Issues and feedback
 

powerapps-docs/sample-apps/emergency-response/deploy-configure.md

@@ -6,7 +6,7 @@ manager: annbe
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: 
-ms.date: 04/29/2020
+ms.date: 05/13/2020
 ms.author: pankar
 ms.reviewer: kvivek
 searchScope:
@@ -210,7 +210,7 @@ Select the **Admin App** to open the model-driven app that lets you configure th
 
 You can change the app icon, color scheme, or display name of the mobile apps to match the branding of your organization. You can also specify whether frontline workers can track information by ___location or facility using the mobile apps. You use **App** and **App Config** entities in the **Administration** area for these.
 
-1.  Open the Admin App, and in the left navigation pane of the admin app, select **Administration** from the area picker, and then select **Apps**. This will show all the canvas app records you imported from the **App Import.xlsx** file.
+1.  Open the Admin App, and in the left navigation pane of the admin app, select **Administration** from the area picker, and then select **Apps**.
 
     > [!div class="mx-imgBorder"] 
     > ![Admin apps](media/conf-admin-app-records.png "Admin apps")
@@ -222,10 +222,13 @@ You can change the app icon, color scheme, or display name of the mobile apps to
 
 1.  In the app details page:
 
-    1. Double-click the app icon, and select an icon file for the app from the **App Icons** folder. The image files are named intuitively so that you can easily select the correct icon. For example, select the "Emergency Response App.png" file for **Emergency Response App**. You can also select a custom image as per your organization branding.
+    1. To select a custom image for the app icon as per your organization branding, double-click the app icon, and select an icon file of your choice.
 
     3. If necessary, update the **Description** or **Display Name** of the app.
 
+    > [!TIP]
+    > You might want to choose a different display name to identify apps in your test environment. For example: **Test - Bed capacity**.
+
     4. If necessary, update the **Hide App from Menu** value to set if the app should be displayed in the app list. As **Emergency Response App** is a container app, the value is set to **No** by default.
 
     5. If necessary, update the **App Display Rank** value to set the display position of app in the app list.
@@ -240,9 +243,12 @@ You can change the app icon, color scheme, or display name of the mobile apps to
 
 1.  Select the **Emergency Response App** record to open it for editing.
 
-    1.  If necessary, update the colors for your app.
+1.  If necessary, update the colors for your mobile app.
+
+    > [!TIP]
+    > You might want to specify a different primary color to identify apps in your test environment.
 
-    2.  Select **Yes** or **No** in the **Device Sharing Enabled** field to specify whether a **Sign Out** option will be available in mobile apps or not. Selecting **Yes** will make the **Sign Out** option available. More information: [End shift - sign out](use.md#end-shift---sign-out) in the user guide.
+2.  Select **Yes** or **No** in the **Device Sharing Enabled** field to specify whether a **Sign Out** option will be available in mobile apps or not. Selecting **Yes** will make the **Sign Out** option available. More information: [End shift - sign out](use.md#end-shift---sign-out) in the user guide.
 
     > [!div class="mx-imgBorder"] 
     > ![Device Sharing Enabled field](media/conf-device-sharing-enabled-field.png "Device Sharing Enabled field")
@@ -415,6 +421,9 @@ This section provides information on how you can use the **Emergency Response Ap
 2. Open the **Emergency Response App.pbit** file in Power BI Desktop. You'll will be prompted to type the following values:
 
     - **Organization_name**: Type your organization name that will be populated on the top-left corner of each report page.
+        > [!TIP]
+        > You might want to specify a different value for **Organization_name** to identify Power BI dashboard in your test environment. For example, **Contoso Test System**.
+
     - **CDS_base_solution_URL**: Type the URL of your Common Data Service environment instance. For example: https://*[myenv]*.crm.dynamics.com
 
     > [!div class="mx-imgBorder"]