Merge pull request #3331 from MicrosoftDocs/canvasapp-1990538

tapanm-MSFT · web-flow · commit af0bb736b7ce · 2020-09-01T20:34:29.000-07:00
SharePoint scenarios for canvas apps - copy edits - 1990538
diff --git a/powerapps-docs/maker/TOC.yml b/powerapps-docs/maker/TOC.yml
@@ -941,15 +941,15 @@
         items:
         - name: SharePoint scenarios overview
           href: ./canvas-apps/sharepoint/scenarios-intro.md
-        - name: How to filter a search list in an app?
+        - name: Filter a search list in an app
           href: ./canvas-apps/sharepoint/scenarios-filter-search-list.md
-        - name: How to use drop down list with choices from lookup column in a SharePoint list?
+        - name: Use drop down list with choices from lookup column in a SharePoint list
           href: ./canvas-apps/sharepoint/scenarios-choice-to-lookup.md
-        - name: How to customize an app screen based on column status inside SharePoint list?
+        - name: Customize an app screen based on column status inside SharePoint list
           href: ./canvas-apps/sharepoint/scenarios-customize-view-based-on-column-status.md
-        - name: How to work with permissions in a lookup list from SharePoint site?
+        - name: Work with permissions in a lookup list from SharePoint site
           href: ./canvas-apps/sharepoint/scenarios-lookup-list-permissions.md
-        - name: How to create SharePoint integrated canvas app from scratch to view, edit, add, and delete SharePoint list items?
+        - name: Create SharePoint integrated canvas app from scratch to view, edit, add, and delete SharePoint list items
           href: ./canvas-apps/sharepoint/scenarios-sharepoint-form-from-scratch.md
     - name: Cognitive Services
       href: ./canvas-apps/cognitive-services-api.md
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-choice-to-lookup.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-choice-to-lookup.md
@@ -1,19 +1,19 @@
 ---
-title: How to use drop down list with choices from lookup column in a SharePoint list | Microsoft Docs
+title: Use drop-down lists with choices from lookup columns in a SharePoint list | Microsoft Docs
 description: This article explains how to use the drop-down list in your app to show choices from a lookup column in a SharePoint list.
 author: emcoope-msft
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/01/2020
+ms.date: 09/01/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
 search.app: 
   - PowerApps
 ---
-# How to use drop down list with choices from lookup column in a SharePoint list?
+# Use drop-down lists with choices from lookup columns in a SharePoint list
 
 In this scenario article, you'll learn how to use a drop-down list with choices from a lookup column in a SharePoint list.
 
@@ -26,7 +26,7 @@ In this scenario article, you'll learn how to use a drop-down list with choices
 
 You can use lookup columns in SharePoint that consume values from other lists or libraries.
 
-When using such column as a field in a canvas app, you can use drop down list with choices.
+When using such columns as a field in a canvas app, you can use a drop-down list with choices.
 
 To use the choices in a drop-down list, you have to use the function [choices](../functions/function-choices.md). For example, `Choices([@'Vehicle registration'].Vehicle_x0020_type)` uses the SharePoint list **Vehicle Registration** and the column **Vehicle type** for the lookup of the type of the vehicle.
 
@@ -37,25 +37,25 @@ To use the choices in a drop-down list, you have to use the function [choices](.
 1. [Create](../app-from-sharepoint.md) a new app, or [edit](../edit-app.md) an existing app.
 
     > [!NOTE]
-    > Ensure the app uses SharePoint connection and connects to a SharePoint list as described in the prerequisites.
+    > Ensure the app uses a SharePoint connection and connects to a SharePoint list as described in the prerequisites.
 
-1. Select **+** (Insert) from the left pane.
+1. Select **+** (insert) from the left pane.
 
 1. Select **Drop down**.
 
-    ![Insert drop-down](./media/scenarios-choice-to-lookup/insert-drop-down.png "Insert drop down")
+    ![Select Drop down](./media/scenarios-choice-to-lookup/insert-drop-down.png "Select Drop down")
 
 1. Update the **Items** property with the following formula:
 
     `Choices([@'Vehicle registration'].Vehicle_x0020_type)`
 
-    Replace **Vehicle registration** with the name of your SharePoint list and **Vehicle type** with the name of lookup column in the list.
+    Replace **Vehicle registration** with the name of your SharePoint list and **Vehicle type** with the name of the lookup column in the list.
 
     ![Choices formula](./media/scenarios-choice-to-lookup/choices-formula.png "Choices formula")
 
-1. Play the app, or press the **Alt** key on the keyboard and select the drop-down.
+1. Play the app, or press **Alt** on the keyboard and select the drop-down list.
 
-    ![Drop down choices](./media/scenarios-choice-to-lookup/drop-down-choices.png "Drop down choices")
+    ![Drop-down choices](./media/scenarios-choice-to-lookup/drop-down-choices.png "Drop-down choices")
 
 ### See also
 
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-customize-view-based-on-column-status.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-customize-view-based-on-column-status.md
@@ -1,67 +1,67 @@
 ---
-title: How to customize an app screen baed on column status inside SharePoint list. | Microsoft Docs
-description: This article explains how to customize an app screen based on column status inside SharePoint list.
+title: Customize an app screen based on column status inside a SharePoint list | Microsoft Docs
+description: This article explains how to customize an app screen based on column status inside a SharePoint list.
 author: emcoope-msft
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/01/2020
+ms.date: 09/01/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
 search.app: 
   - PowerApps
 ---
-# How to customize an app screen based on column status inside SharePoint list?
+# Customize an app screen based on column status inside a SharePoint list
 
-In this scenario article, you'll learn how to customize an app screen based on column status inside SharePoint list. You can customize forms for supported lists or libraries; and you can also create app for lists or libraries.
+In this scenario article, you'll learn how to customize an app screen based on column status inside a SharePoint list. You can customize forms for supported lists or libraries, and you can also create apps for lists or libraries.
 
-Limiting access to SharePoint objects can be achieved using fine-grained permissions inside SharePoint. However, it becomes difficult to scan through all items in your app screen especially when using different devices. 
+Limiting access to SharePoint objects can be achieved using fine-grained permissions inside SharePoint. However, it can become difficult to scan through all items in your app screen, especially when using different devices. 
 
-One of the most common problems is how to limit the items in a canvas app screen based on status of columns, instead of controlling access using the permissions.
+One of the most common problems is how to limit the items in a canvas app screen based on the status of columns, instead of controlling access using the permissions.
 
 This method allows you to create multiple screens to show different SharePoint objects based on column status, while at the same time without customizing permissions or overwhelming the app user with the entire list.
 
 ## Prerequisites
 
-- You must have created an app using SharePoint connector that connects to a SharePoint list.
+- You must have created an app using a SharePoint connector that connects to a SharePoint list.
 - You need two user accounts with access to the app and SharePoint site hosting the lists.
 - You need to be knowledgeable about how to configure SharePoint lists and list/item permissions.
 
 ## Scenario details
 
-You can use the function [filter](../functions/function-filter-lookup.md) for a specific column from SharePoint and apply filter with a particular condition. With this approach, you can setup multiple screens with filtered SharePoint list items.
+You can use the function [filter](../functions/function-filter-lookup.md) for a specific column from SharePoint and apply the filter with a particular condition. With this approach, you can set up multiple screens with filtered SharePoint list items.
 
 For example, you created a list named Issue Tracking, based on the out-of-the-box SharePoint app template **Issue Tracking**. And you want to create an app that only shows **Active** issues on the app screen. 
 
 ## Example
 
-1. Create a list based on out-of-the-box SharePoint app template **Issue Tracking**.
+1. Create a list based on the out-of-the-box SharePoint app template **Issue Tracking**.
 
 1. Create a few sample issue items.
 
     ![Issue tracking sample items](./media/scenarios-customize-view-based-on-column-status/issue-tracking-list-items.png "Issue tracking sample items")
 
     Ensure the issue items have both *Active* and *Closed* items.
 
-1. Share the list with user, for example Kenny Smith.
+1. Share the list with a user—for example, Kenny Smith.
 
 1. Select **Power Apps**, and then select **Create an app** from the SharePoint list page.
 
     ![Create an app](./media/scenarios-customize-view-based-on-column-status/create-app.png "Create an app")
 
-1. You can see all issues listed in the app inside the studio.
+    You can see all issues listed in the app inside the studio.
 
     ![List of issues](./media/scenarios-customize-view-based-on-column-status/app-list-of-issues.png "List of issues")
 
-    The sample list only has two items. However, when the number of issues increase, it becomes overwhelming to scan through issues or search them. Especially when the objective is to only show active issues.
+    The sample list only has two items. However, when the number of issues increases, it becomes overwhelming to scan through issues or search them, especially when the objective is to show only active issues.
 
 1. Select the items gallery, by default named BrowseGallery1.
 
     ![Items gallery](./media/scenarios-customize-view-based-on-column-status/select-browse-gallery.png "Items gallery")
 
-1. Update the formula for **Items** property the default to include filter criteria for issues status.
+1. Update the formula for the default **Items** property to include filter criteria for issues status.
 
     Default:
 
@@ -79,8 +79,8 @@ For example, you created a list named Issue Tracking, based on the out-of-the-bo
 
     - [SortByColumns](../functions/function-sort.md) for sorting columns.
     - [Filter](../functions/function-filter-lookup.md) to filter items.
-    - [StartsWith](../functions/function-startswith.md) to allow search based on entered text in search box on the top.
-    - [If](../functions/function-if.md) for sorting items based on sort icon selection.
+    - [StartsWith](../functions/function-startswith.md) to allow search based on entered text in the search box on the top.
+    - [If](../functions/function-if.md) for sorting items based on the sort icon selection.
 
 1. [Save and publish](../save-publish-app.md) the app.
 
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-filter-search-list.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-filter-search-list.md
@@ -1,32 +1,32 @@
 ---
-title: How to filter a search list in an app. | Microsoft Docs
+title: Filter a search list in an app | Microsoft Docs
 description: This article explains how to search for items and filter the list in your app when sourcing data from a SharePoint list.
 author: emcoope-msft
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/01/2020
+ms.date: 09/01/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
 search.app: 
   - PowerApps
 ---
-# How to filter a search list in an app?
+# Filter a search list in an app
 
 In this scenario article, you'll learn how to filter a search list in a canvas app.
 
 ## Prerequisites
 
-- You must have created an app using SharePoint connector that connects to a SharePoint list.
-- The SharePoint list should consist of several list items to filter data inside canvas app.
+- You must have created an app using a SharePoint connector that connects to a SharePoint list.
+- The SharePoint list should consist of several list items to filter data inside the canvas app.
 
 ## Scenario details
 
 You can use text input control in a canvas app to input text and filter the list such as a data table to filter list items from the connected SharePoint list.
 
-To use the ability to search using a text input and filter the records, you have to use the function [filter](../functions/function-filter-lookup.md). For example, `Filter([@Colors], StartsWith(Title, TextInput1.Text))` uses the SharePoint list connection **Colors** and the column **Title** to filter the records.
+To search using text input and to filter the records, you have to use the function [filter](../functions/function-filter-lookup.md). For example, `Filter([@Colors], StartsWith(Title, TextInput1.Text))` uses the SharePoint list connection **Colors** and the column **Title** to filter the records.
 
 ## Example
 
@@ -37,9 +37,9 @@ To use the ability to search using a text input and filter the records, you have
     > [!NOTE]
     > Ensure the app uses SharePoint connection and connects to a SharePoint list as described in the prerequisites.
 
-1. Select **+** (Insert) from the left pane.
+1. Select **+** (insert) from the left pane.
 
-1. Select **Text Input**.
+1. Select **Text input**.
 
     ![Insert text input](./media/scenarios-filter-search-list/insert-text-input.png "Insert text input")
 
@@ -51,15 +51,15 @@ To use the ability to search using a text input and filter the records, you have
 
     `Filter([@Colors], StartsWith(Title, TextInput1.Text))`
 
-    Replace **Colors** with the name of your SharePoint list, **Title** with the name of column in the list, and **TextInput1** with your text input control name.
+    Replace **Colors** with the name of your SharePoint list, **Title** with the name of the column in the list, and **TextInput1** with your text input control name.
 
     ![Filter formula](./media/scenarios-filter-search-list/filter-formula.png "Filter formula")
 
 1. Play the app.
 
-1. Enter text, such as 'B' to filter items starting with 'B'.
+1. Enter text, such as 'B,' to filter items starting with 'B'.
 
-    ![Colors](./media/scenarios-filter-search-list/colors.png "Colors")
+    ![Colors with filtered for 'B'](./media/scenarios-filter-search-list/colors.png "Colors with filtered for 'B'")
 
 ### See also
 
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-intro.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-intro.md
@@ -6,7 +6,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 08/12/2020
+ms.date: 09/01/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
@@ -24,11 +24,11 @@ In this section, you'll learn about common scenarios when working with an app th
 
 Articles in this section explain individual and short scenarios when working with SharePoint integration with canvas app.
 
-- [How to filter a search list in an app?](scenarios-filter-search-list.md)
-- [How to use drop down list with choices from lookup column in a SharePoint list?](scenarios-choice-to-lookup.md)
-- [How to customize an app screen based on column status inside SharePoint list?](scenarios-customize-view-based-on-column-status.md)
-- [How to work with permissions in a lookup list from SharePoint site?](scenarios-lookup-list-permissions.md)
-- [How to create SharePoint integrated canvas app from scratch to view, edit, add, and delete SharePoint list items?](scenarios-sharepoint-form-from-scratch.md)
+- [Filter a search list in an app](scenarios-filter-search-list.md)
+- [Use drop-down lists with choices from lookup columns in a SharePoint list](scenarios-choice-to-lookup.md)
+- [Customize an app screen based on column status inside a SharePoint list](scenarios-customize-view-based-on-column-status.md)
+- [Work with permissions in a lookup list from a SharePoint site](scenarios-lookup-list-permissions.md)
+- [Create SharePoint integrated canvas apps from scratch to view, edit, add, and delete SharePoint list items](scenarios-sharepoint-form-from-scratch.md)
 
 ## SharePoint integration documentation
 
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-lookup-list-permissions.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-lookup-list-permissions.md
@@ -1,34 +1,34 @@
 ---
-title: How to work with permissions in a lookup list from SharePoint site. | Microsoft Docs
+title: Work with permissions in a lookup list from a SharePoint site | Microsoft Docs
 description: This article explains how to configure lookup list permissions in SharePoint when using a canvas app.
 author: emcoope-msft
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/01/2020
+ms.date: 09/01/2020
 ms.author: emcoope
 search.audienceType: 
   - maker
 search.app: 
   - PowerApps
 ---
-# How to work with permissions in a lookup list from SharePoint site?
+# Work with permissions in a lookup list from a SharePoint site
 
 In this scenario article, you'll learn how to configure permissions for fields that use lookup columns from SharePoint lists. When you create a canvas app that connects to SharePoint, the app follows permissions configured inside SharePoint. Unique permissions at different levels inside SharePoint can become confusing when surfacing lists, libraries, or items on a canvas app screen.
 
 The example in this tutorial explains how you can work with a canvas app that connects to SharePoint with such broken inheritance.
 
 ## Prerequisites
 
-- You must have created an app using SharePoint connector that connects to a SharePoint list.
+- You must have created an app using a SharePoint connector that connects to a SharePoint list.
 - The SharePoint list should consist of a lookup column with values from another column.
-- You need two user accounts with access to the app and SharePoint site hosting the lists.
+- You need two user accounts with access to the app and the SharePoint site hosting the lists.
 - You need to be knowledgeable about how to configure SharePoint lists and list/item permissions.
 
 ## Scenario details
 
-You can customize permissions for a SharePoint list or list item when you [stop inheriting permissions](https://support.office.com/en-us/article/share-sharepoint-files-or-folders-1fe37332-0f9a-4719-970e-d2578da4941c). Consider you connect your app with a SharePoint site that has broken inheritance at different levels. The app behavior may appear confusing if the user doesn't have access to the correct SharePoint objects as intended. Ensure the user can browse to the list and work with the objects with same permissions that you expect canvas app to surface.
+You can customize permissions for a SharePoint list or list item when you [stop inheriting permissions](https://support.office.com/en-us/article/share-sharepoint-files-or-folders-1fe37332-0f9a-4719-970e-d2578da4941c). Consider, for example, that you connect your app with a SharePoint site that has a broken inheritance at different levels. The app behavior might appear confusing if the user doesn't have access to the correct SharePoint objects as intended. Ensure the user can browse to the list and work with the objects with the same permissions that you expect the canvas app to surface.
 
 ## Example
 
@@ -39,17 +39,17 @@ You can customize permissions for a SharePoint list or list item when you [stop
     | Shapes | - Title <br> - Color (lookup column)
     | Colors | - Title (for color of the shape)
 
-     Shapes list has a Color lookup column. This lookup column is connected to the Color column from the Colors list for values. You can also use your own lists instead.
+     The Shapes list has a Color lookup column. This lookup column is connected to the Color column from the Colors list for values. You can also use your own lists instead.
 
 1. If necessary, create sample items:
 
-    | Shapes | Color |
+    | Shapes | Color 
     | - | - |
     | Circle | Red
     | Rectangle | Blue
     | Triangle | Green
 
-    The shape colors are through lookup column from the Colors list.
+    The shape colors are through the lookup column from the Colors list.
 
 1. Sign in to [Power Apps](https://make.powerapps.com).
 
@@ -80,7 +80,7 @@ You can customize permissions for a SharePoint list or list item when you [stop
     > [!NOTE]
     > If the user can see the lookup column, check the permissions for the lookup column list. If the lookup column list has unique permissions and the user is added, you can skip the next step.
 
-1. Go to Colors list permissions and add the other user, Kenny Smith in this example, explicitly.
+1. Go to Colors list permissions and add the other user (Kenny Smith in this example) explicitly.
 
     ![Colors list permissions](./media/scenarios-lookup-list-permissions/colors-list-permissions.png "Colors list permissions")
 
diff --git a/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-sharepoint-form-from-scratch.md b/powerapps-docs/maker/canvas-apps/sharepoint/scenarios-sharepoint-form-from-scratch.md
