Skip to content

Commit e745739

Browse files
committed
Update deploy.md
1 parent d7a5cc1 commit e745739

File tree

1 file changed

+33
-7
lines changed
  • powerapps-docs/sample-apps/return-to-workplace

1 file changed

+33
-7
lines changed

powerapps-docs/sample-apps/return-to-workplace/deploy.md

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -99,13 +99,13 @@ The Return to the Workplace solution has two Power BI dashboards, one for execut
9999
> [!div class="mx-imgBorder"]
100100
> ![Connect](media/deploy-connect-data-source.png "Connect")
101101
102-
3. Enter the URL of the Common Data Service environment (for example, https://[myenv].crm.dynamics.com), and then select **Next**.
102+
3. Enter the URL of the Common Data Service environment (for example, https://[myenv].[region].dynamics.com), and then select **Next**.
103103
> [!div class="mx-imgBorder"]
104104
> ![Common Data Service environment name](media/deploy-connect-CDS.png "Common Data Service environment name")
105105
106106
4. Determine where the displayed URL is pointing to in the Common Data Service environment:
107107

108-
- If it's pointing to Common Data Service, set the **Authentication method** to **Microsoft account** and set **Privacy level setting for this data source** to **Organizational**. Select **Sign in**.
108+
- If it's pointing to Common Data Service, set the **Authentication method** to **OAuth2** and set **Privacy level setting for this data source** to **Organizational**. Select **Sign in**.
109109
- If it's not pointing to Common Data Service, set the **Authentication method** to **Anonymous** and set **Privacy level setting for this data source** to **Public**. Select **Sign in**
110110
> [!div class="mx-imgBorder"]
111111
> ![Privacy](media/deploy-privacy-level.png "Privacy")
@@ -156,7 +156,7 @@ Next, we'll configure the data refresh settings for the dataset.
156156
157157
> [!NOTE]
158158
> - There are limits to how many times data can be refreshed. Power BI limits datasets on shared capacity to eight daily refreshes. If the dataset resides on a Power BI Premium capacity node, you can schedule up to 48 refreshes per day in the dataset settings. More information: [Refresh data](https://docs.microsoft.com/power-bi/refresh-data#data-refresh)
159-
>- We recommend scheduling data to be refreshed every 30 minutes.
159+
> - We recommend scheduling data to be refreshed every 30 minutes.
160160
161161
5. Go back to your workspace, select the **Reports** tab, and then select the report to open it in a browser.
162162

@@ -173,15 +173,41 @@ The facility manager Power BI dashboard is used in the model-driven app. Because
173173
> [!div class="mx-imgBorder"]
174174
> ![Enable Power BI](media/deploy-settings-admin1.png "Enable Power BI")
175175
176-
4. Go to [Power Apps](https://make.powerapps.com), select **Solutions** in the left pane, and create a new solution. After opening the solution, select **Add existing**, and then select **Entity**. From the list of entities, select **Facility** > **select components**, under the **Forms** tab, select **Main - Information Form**.
176+
4. Go to [Power Apps](https://make.powerapps.com), select **Solutions** in the left pane, and create a new solution. After opening the solution, select **Add existing**, and then select **Entity**.
177+
178+
5. From the list of entities, select **Facility (msft_facility)** > **select components**, under the **Forms** tab, select **Main - Information Form**, and then select **Add** to finish the process.
177179

178180
> [!div class="mx-imgBorder"]
179-
> ![Facility form](media/deploy-new-facility-form.png "Facility form")
181+
> ![Enable Power BI](media/deploy-settings-report1.png "Step1")
182+
183+
6. Within the newly created solution, select **Export** . On the right side of your browser a window pops up, select **Publish**, select **Run** to check whether the solution has any issues or dependencies, and then select **Next**. With the **Version number** and **Unmanaged** option selected, select **Export**.
184+
185+
7. In the **Download** dialog box, select **Save**, and in the **Download complete** dialog box, select **Open Folder**. Right-click to select the compressed .zip file that you downloaded, and then select **Extract All**. Select a ___location to extract the files to, and then select **Extract**. The customizations.xml file is the file that you'll edit.
186+
187+
8. Open the customization.xml file,, look for the section similar to the XML code specified in this example: https://docs.microsoft.com/powerapps/maker/model-driven-apps/embed-powerbi-report-in-system-form#embed-without-contextual-filtering
180188

181-
5. Export the solution, unpack the solution, and then apply the changes in the form XML listed in this article: [Embed a Power BI report in a model-driven system form](https://docs.microsoft.com/powerapps/maker/model-driven-apps/embed-powerbi-report-in-system-form). Pack the solution, reimport the solution, and then select **Publish all customizations**.
189+
In this XML file you need to update the **PowerBIGroupID**, **PowerBIReportID** and **TileURL** according to your PowerBI workspace and report. You can find this information by opening the Facility Manager report in PowerBI and examine the URL: https://...powerbi.com/groups/PowerBIGroupID/reports/PowerBIReportID/ReportSection
190+
191+
The `TileURL` can be found within the PowerBI report. You can find it at the following destination **... (ellipsis)** > **Embed** > **Website or portal**.
192+
193+
> [!div class="mx-imgBorder"]
194+
> ![Enable Power BI](media/deploy-settings-report2.png "Step1")
182195
183-
For ease of implementation, you can also use the [Power BI Embedder](https://www.xrmtoolbox.com/plugins/Fic.XTB.PowerBiEmbedder/) in XRMToolBox.
196+
From the displayed `Secure embed code` window, capture the content of the link in the first field up to the end of the `PowerBIReportID` (as shown in the example code).
184197

198+
See the article https://docs.microsoft.com/powerapps/maker/model-driven-apps/embed-powerbi-report-in-system-form#remove-unmodified-attribute-before-import and verify if the changes that you made to the XML file apply as in the example.
199+
200+
9. **Save** the XML file with the modifications you made and zip the files in the folder again. Now you have a .zip file with 3 files in it, including the updated customizations.xml file.
201+
202+
10. Sign in to [Power Apps](https://make.powerapps.com), and select **Solutions** from the left pane.
203+
On the command bar, select **Import**. On the **Select Solution Package** page, select **Browse** to locate the compressed (.zip or .cab) file that contains the solution you want to import.
204+
205+
11. Select **Next**. On the page that displays information about the solution, select **Import**.
206+
207+
You might need to wait a few moments while the import is completed. View the results, and then select **Close**.
208+
209+
Open a facility record in the Facility Safety Management app and you’ll see the embedded report on the **General** tab.
210+
185211
## Step 6: Publish a theme
186212

187213
You can change the look and feel of the app by applying themes to match your company branding.

0 commit comments

Comments
 (0)