Merge pull request MicrosoftDocs#3032 from MicrosoftDocs/canvasapp-1884974

tapanm-MSFT · web-flow · commit fa26bcb895c5 · 2020-08-04T11:28:11.000-07:00
Canvas app issue 1458 fix - RequestHide() - 1884974
diff --git a/powerapps-docs/maker/TOC.yml b/powerapps-docs/maker/TOC.yml
@@ -721,6 +721,8 @@
             href: ./canvas-apps/functions/function-form.md
           - name: Revert
             href: ./canvas-apps/functions/function-revert.md
+          - name: RequestHide
+            href: ./canvas-apps/functions/function-requesthide.md
           - name: RGBA
             href: ./canvas-apps/functions/function-colors.md
           - name: Right
diff --git a/powerapps-docs/maker/canvas-apps/app-from-sharepoint.md b/powerapps-docs/maker/canvas-apps/app-from-sharepoint.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 12/05/2019
+ms.date: 06/18/2020
 ms.author: tapanm
 search.audienceType: 
   - maker
@@ -97,3 +97,7 @@ In this topic, you created an app to manage data in a SharePoint list. As a next
 
 > [!div class="nextstepaction"]
 > [Customize a default browse screen](customize-layout-sharepoint.md)
+
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/connections/connection-sharepoint-online.md b/powerapps-docs/maker/canvas-apps/connections/connection-sharepoint-online.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 04/03/2019
+ms.date: 06/18/2020
 ms.author: niwaggon
 search.audienceType:
   - maker
@@ -210,3 +210,7 @@ Not all types of columns are supported, and not all types of columns support all
 - Learn how to [show data from a data source](../add-gallery.md).
 - Learn how to [view details and create or update records](../add-form.md).
 - See other types of [data sources](../connections-list.md) to which you can connect.
+
+### See also
+
+- [SharePoint integration scenarios](../sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/customize-forms-sharepoint.md b/powerapps-docs/maker/canvas-apps/customize-forms-sharepoint.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 03/17/2018
+ms.date: 06/18/2020
 ms.author: tapanm
 search.audienceType: 
   - maker
@@ -118,4 +118,8 @@ If you're unfamiliar with canvas-pps, see [What are canvas apps?](getting-starte
 ## Next steps
 
 - [Save and publish](save-publish-app.md) your app.
-- [Customize a card](customize-card.md) in your app.
+- [Customize a card](customize-card.md) in your app.
+
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/customize-layout-sharepoint.md b/powerapps-docs/maker/canvas-apps/customize-layout-sharepoint.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: tutorial
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 05/06/2018
+ms.date: 06/18/2020
 ms.author: tapanm
 search.audienceType: 
   - maker
@@ -144,3 +144,7 @@ In this tutorial, you've customized the gallery and made other changes to the de
 
 > [!div class="nextstepaction"]
 > [Customize forms](customize-forms-sharepoint.md)
+
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/customize-list-form.md b/powerapps-docs/maker/canvas-apps/customize-list-form.md
@@ -204,7 +204,7 @@ You can configure the **Price**, **Availability**, and **Colors** fields to appe
 
 **A:** If you're a tenant administrator for Power Apps or you have environment-administrator permissions on the default Power Apps environment of your organization, do the following:
 
-1. In the [Power Apps admin center](https://admin.powerapps.com), select the default environment for your organization from the list of environments.
+1. In the [Power Apps admin center](https://admin.powerplatform.microsoft.com), select the default environment for your organization from the list of environments.
 
 1. At the top of the default environment page, select **Resources**.
 
diff --git a/powerapps-docs/maker/canvas-apps/formula-reference.md b/powerapps-docs/maker/canvas-apps/formula-reference.md
@@ -282,6 +282,8 @@ Other elements include:
 
 **[Replace](functions/function-replace-substitute.md)** – Replaces part of a string with another string, by starting position of the string.
 
+**[RequestHide](functions/function-requesthide.md)** – Hides a SharePoint form.
+
 **[Reset](functions/function-reset.md)** – Resets an input control to its default value, discarding any user changes.
 
 **[ResetForm](functions/function-form.md)** – Resets a form control for editing of an existing item.
diff --git a/powerapps-docs/maker/canvas-apps/functions/function-requesthide.md b/powerapps-docs/maker/canvas-apps/functions/function-requesthide.md
@@ -0,0 +1,46 @@
+---
+title: RequestHide function | Microsoft Docs
+description: Reference information, including syntax and examples, for the RequestHide function in Power Apps
+author: emcoope-msft
+manager: kvivek
+ms.service: powerapps
+ms.topic: reference
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 06/18/2020
+ms.author: emcoope
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+---
+
+# RequestHide function in Power Apps
+
+Hides the [SharePoint form](../sharepoint-form-integration.md#understand-the-sharepointintegration-control).
+
+>[!NOTE]
+> Only works with [SharePoint forms](../sharepoint-form-integration.md).
+
+## Description
+
+Use the **RequestHide** function to hide the SharePoint form. By default, RequestHide() is used for the *OnSuccess* property of a SharePoint form being customized.
+
+![RequestHide example](media/function-requesthide/requesthide-fuction.png)
+
+### Considerations
+
+- Not required when using **SharePointIntegration** control actions such as **OnCancel** as SharePoint by default hides the form when a user selects **Cancel**, and the function only reacts to a SharePoint form.
+- When using **RequestHide()** outside the context of a **SharePointIntegration** control, such as **OnSelect** for a button, won't return a formula error and the button **OnSelect** won't have any effect.
+
+## Syntax
+
+**RequestHide** ( )
+
+* No parameters.
+
+## Examples
+
+| Formula | Description |
+| --- | --- |
+| **RequestHide()** | Hides the form. |
diff --git a/powerapps-docs/maker/canvas-apps/functions/media/function-requesthide/requesthide-fuction.png b/powerapps-docs/maker/canvas-apps/functions/media/function-requesthide/requesthide-fuction.png
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-form-integration.md b/powerapps-docs/maker/canvas-apps/sharepoint-form-integration.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 11/11/2017
+ms.date: 06/18/2020
 ms.author: niwaggon
 search.audienceType: 
   - maker
@@ -68,7 +68,7 @@ These defaults ensure that the form works when running within SharePoint - they
 ## Understand the SharePointIntegration control
 The **SharePointIntegration** control communicates user actions between SharePoint and Power Apps.
 
-![](./media/sharepoint-form-integration/sharepointintegration-object.png)
+![SharePoint integration object](./media/sharepoint-form-integration/sharepointintegration-object.png)
 
 >[!NOTE]
 >You can access the properties for the **SharePointIntegration** control only when the form is running in SharePoint, not when you're customizing the form in Power Apps Studio. These properties may not be available in **OnStart** or **OnVisible**. 
@@ -106,3 +106,9 @@ Now that you have a better understanding of the default generated form and the *
 * You can't control the hiding of a form when a user clicks or taps **Cancel** in SharePoint, so make sure you reset your forms in the **OnCancel** formula of the **SharePointIntegration** control.
 
 * The properties for the **SharePointIntegration** control may not be available in **OnStart** or **OnVisible**, and those events execute only once while the list is loaded. You can use **OnNew**, **OnView**, or **OnEdit** formulas to run logic before the form is shown to the user every time. 
+
+### See also
+
+- EditForm, NewForm, SubmitForm, ResetForm, and ViewForm functions - [form functions in Power Apps](functions/function-form.md)
+- [RequestHide function](functions/function-requesthide.md)
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-lookup-fields.md b/powerapps-docs/maker/canvas-apps/sharepoint-lookup-fields.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 01/20/2017
+ms.date: 06/18/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
@@ -34,14 +34,20 @@ Data in an enterprise is large and complex. Data in one SharePoint list often re
 For example, you might have an **Orders** list which has a lookup field that links to a **Customers** list, to show which customer placed the order. The lookup field in the **Orders** list lets you get other data from the **Customers** list as well. You might also use a lookup field to connect the **Orders** list to a **Product** list, and bring in information you need about the product ordered, such as product pictures, specifications, manufacturer details, etc.
 
 ### What are Choice fields used for?
+
 **Choice** fields are used for very short lists, but instead of actually creating a separate list, you include the list values in a small menu, which appears when you click or tap on the **Choice** field, and you select one of the values.
 
 Examples include data like Customer Status Code, Product Availability, State Codes; basically any fixed list that is relatively short. This data could in fact be implemented as separate lists, and then you would use a **Lookup** field to link to them, but it is usually easier and quicker to implement them as **Choice** fields.
 
+>[!TIP]
+> For more SharePoint and Power Apps integration tutorials, go to [SharePoint integration scenarios](sharepoint/scenarios-intro.md).
+
 ## Create the lists in SharePoint
+
 In this tutorial, you link two SharePoint custom lists together, **Assets** and **RepairShop**. The **Assets** list is used to track hardware equipment in a team. Since hardware gets broken from time to time, we use the **RepairShop** list to track the local shops which can fix it.
 
 ### The lookup fields used in this example
+
 The **RepairShop** list uses the *ContactEmail* field to identify the shop. This list is defined first so that each row in the **Assets** list has something to point to.
 
 The **Assets** list has two lookup fields:
@@ -52,84 +58,93 @@ The **Assets** list has two lookup fields:
 You most likely would define additional fields, depending on the information you need to track.
 
 ### Define the RepairShop list and add data
+
 You do this first, so that when you add data to the **Assets** list, **RepairShop** entries are available for you to choose from the *Assets.RepairShop* lookup field.
 
 1. On your SharePoint site, create a new **RepairShop** list.
 
-    ![](./media/sharepoint-lookup-fields/new-list.png)
+    ![New list](./media/sharepoint-lookup-fields/new-list.png)
 
 2. Add a *ContactEmail* field of type **Single line of text**.
 
-    ![](./media/sharepoint-lookup-fields/add-email-field.png)
+    ![Add email field](./media/sharepoint-lookup-fields/add-email-field.png)
 
 3. Add any other fields you need.
 
 4. Click or tap **+ New** to enter sample data into the list, at least 3 rows with different *ContactEmail* values. When an asset needs to be repaired, you choose one of these.
 
-    ![](./media/sharepoint-lookup-fields/add-repair-shops.png)
+    ![Add repair shops](./media/sharepoint-lookup-fields/add-repair-shops.png)
 
 ### Define the Assets list
+
 1. On your SharePoint site, create a new **Assets** list.
 
 2. Click or tap the plus sign and choose **More**.
 
-    ![](./media/sharepoint-lookup-fields/choose-more-type.png)
+    ![Choose more type](./media/sharepoint-lookup-fields/choose-more-type.png)
 
 3. Add an *AssetType* field of type **Choice**, and in the **Type each choice on a separate line** text box, fill in the values you want to appear in the choice menu. Then click or tap **OK**.
 
-    ![](./media/sharepoint-lookup-fields/define-choice-column.png)
+    ![Define choice column](./media/sharepoint-lookup-fields/define-choice-column.png)
 
 4. Start to add another field, just like in step 2: click or tap the plus sign and choose **More**.
 
 5. Add a *RepairShop* field of type **Lookup**, choose **RepairShop** from the **Get information from** text box, and choose *ContactEmail* from the **In this column** text box. Then click or tap **OK**.
 
-    ![](./media/sharepoint-lookup-fields/setup-lookup-column.png)
+    ![Setup lookup column](./media/sharepoint-lookup-fields/setup-lookup-column.png)
 
 6. Add any additional fields you want.
 
 ## Create an app from the Assets list
+
 You use this app to add data to the **Assets** list.
 
 1. [Sign in to Power Apps Studio](https://make.powerapps.com?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc). If you are new to Power Apps, [sign up for free](https://powerapps.microsoft.com) using your organizational email address.
 
 2. In the **File** menu (along the left edge), click or tap **New**, and then click or tap **SharePoint**.
 
-    ![](./media/sharepoint-lookup-fields/create-app.png)
+    ![Create app](./media/sharepoint-lookup-fields/create-app.png)
 
 1. Choose your SharePoint site from the **Recent sites** list or enter your site's url directly into the text box. Click or tap **GO**.
 
-    ![](./media/sharepoint-lookup-fields/choose-sharepoint-site.png)
+    ![Choose SharePoint site](./media/sharepoint-lookup-fields/choose-sharepoint-site.png)
 
 1. Choose the main list from your SharePoint site, in this example, **Assets**. Click or tap the **Connect** button in the lower-right corner.
 
-    ![](./media/sharepoint-lookup-fields/choose-main-list.png)
+    ![Choose main list](./media/sharepoint-lookup-fields/choose-main-list.png)
 
 
 ## Add data to the Assets list
+
 Now you can run the app and see how the view details screen looks for the lookup fields.
 
-1. Press F5 or select Preview ( ![](./media/sharepoint-lookup-fields/preview.png) ).
+1. Press F5 or select Preview ( ![Preview](./media/sharepoint-lookup-fields/preview.png) ).
 
 2. Click or tap the **+** symbol in the upper right corner to add an entry.
 
 3. Enter a **Title** for this asset.
 
 4. Click or tap the **AssetType** dropdown arrow. The values displayed are those you entered when you created this field. Choose one of the entries.
 
-    ![](./media/sharepoint-lookup-fields/fill-asset-type-3.png)
+    ![Fill asset type](./media/sharepoint-lookup-fields/fill-asset-type-3.png)
 
 5. Click or tap the **RepairShop** dropdown arrow. Choose one of the entries.
 
-    ![](./media/sharepoint-lookup-fields/fill-repair-shop-3.png)
+    ![Fill repair shop](./media/sharepoint-lookup-fields/fill-repair-shop-3.png)
 
 6. In the upper-right corner, click or tap the check mark to save the new entry.
 
 7. (optional) Repeat this procedure to add as many items to the list as you want.
 
 8. Press Esc to return to the default workspace.
 
-## For more information
+## Next steps
+
 * [Introducing support for lookups and a new sample app](https://powerapps.microsoft.com/blog/support-for-lookups/)
 * [Performance, Refresh button, ForAll, and multiple field lookups](https://powerapps.microsoft.com/blog/performance-refresh-forall-multiple-field-lookups-531/)
 * [Generate an app by using a Common Data Service database](data-platform-create-app.md)
 * [Create an app from scratch using a Common Data Service database](data-platform-create-app-scratch.md)
+
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-alerts-flow.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-alerts-flow.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 06/12/2017
+ms.date: 06/18/2020
 ms.author: niwaggon
 search.audienceType: 
   - maker
@@ -68,3 +68,6 @@ We will see this flow run when we [run through the scenario end-to-end](sharepoi
 ## Next steps
 The next step in this tutorial series is to [embed the Power BI project report in SharePoint Online](sharepoint-scenario-embed-report.md).
 
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-approval-flow.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-approval-flow.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 01/09/2018
+ms.date: 06/18/2020
 ms.author: stepsic
 search.audienceType: 
   - maker
@@ -161,3 +161,6 @@ By default, this branch sends a rejection email to the requestor. We'll also upd
 ## Next steps
 The next step in this tutorial series is to [create an app to manage projects](sharepoint-scenario-build-app.md).
 
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-build-app.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-build-app.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 04/30/2020
+ms.date: 06/18/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
@@ -509,3 +509,6 @@ When you put the functions together in the formula, here's what happens:
 ## Next steps
 The next step in this tutorial series is to [create a Power BI report to analyze projects](sharepoint-scenario-build-report.md).
 
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-build-report.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-build-report.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 01/10/2018
+ms.date: 06/18/2020
 ms.author: fikaradz
 search.audienceType: 
   - maker
@@ -381,3 +381,6 @@ That brings us to the end of the report section, and you should now have a compl
 ## Next steps
 The next step in this tutorial series is to [publish the Power BI project report and create a dashboard](sharepoint-scenario-publish-report.md).
 
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-embed-report.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-embed-report.md
@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 01/30/2018
+ms.date: 06/18/2020
 ms.author: niwaggon
 search.audienceType: 
   - maker
@@ -62,3 +62,6 @@ That wraps up our work in Power BI for this scenario. You started by pulling dat
 ## Next steps
 The next step in this tutorial series is to [run through the workflow we created end-to-end](sharepoint-scenario-summary.md).
 
+### See also
+
+- [SharePoint integration scenarios](sharepoint/scenarios-intro.md)
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-generate-app.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-generate-app.md
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-intro.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-intro.md
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-publish-report.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-publish-report.md
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-setup.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-setup.md
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint-scenario-summary.md b/powerapps-docs/maker/canvas-apps/sharepoint-scenario-summary.md
