Merge pull request MicrosoftDocs#372 from AFTOwen/mvc

updated AFD/CDS and customize/gallery

Author: rjagiewich

powerapps-docs/maker/TOC.yml

@@ -35,11 +35,11 @@
     items:
     - name: Customize a generated app
       items:
-      - name: Customize a browse screen
+      - name: 1 - Galleries
         href: ./canvas-apps/customize-layout-sharepoint.md
-      - name: Customize a form
+      - name: 2 - Forms
         href: ./canvas-apps/customize-forms-sharepoint.md
-      - name: Customize a card
+      - name: 3 - Cards
         href: ./canvas-apps/customize-card.md
     - name: Create an app from scratch
       items:

powerapps-docs/maker/canvas-apps/customize-layout-sharepoint.md

@@ -1,117 +1,111 @@
 ---
-title: Tutorial for customizing a gallery | Microsoft Docs
-description: In this tutorial, you customize the default browse screen, including the gallery, of an app generated in PowerApps.
-documentationcenter: na
+title: Tutorial - Customize a gallery in a generated app | Microsoft Docs
+description: In this tutorial, you customize the data that appears in the gallery and other elements of an app that was generated automatically in PowerApps.
 author: AFTOwen
-manager: kfile
-editor: ''
-tags: ''
 
 ms.service: powerapps
-ms.devlang: na
-ms.topic: conceptual
+ms.topic: tutorial
 ms.component: canvas
-ms.date: 03/11/2018
+ms.date: 04/24/2018
 ms.author: anneta
-
+#As a business analyst with little or no coding experience, I want to change the data that appears in the default gallery of a generated app and make other changes so that my users can more easily manage information.
 ---
 # Tutorial: Customize a gallery in PowerApps
-In this tutorial, you'll customize the default browse screen, including the gallery, of an app generated in PowerApps. You can manage data by using the default app without customizing it, but it will be much more powerful and easier to use if you make these changes:
+In this tutorial, you'll customize the gallery and make other changes to an app that was generated automatically in Microsoft PowerApps. Users can manage data in the app even if you don't make these changes, but the app will be easier to use if you customize it for your organization's needs:
 
 > [!div class="checklist"]
-> * Change the layout
-> * Change the data that appears
-> * Set the columns for filtering and sorting
-> * Test filtering and sorting
-> * Change the title
-> * Show a scrollbar
+> * Change the layout of the gallery
+> * Change the type of data that appears in the gallery
+> * Change the columns by which users can sort and search the data
+> * Change the screen title
+> * Show a scroll bar
 
-This tutorial starts with an app generated from the [Common Data Service for Apps](../common-data-service/data-platform-intro.md), but the same concepts apply to apps generated from SharePoint, Excel, and other data sources. 
+This tutorial starts with an app that was generated from a specific data source. However, the same concepts apply to any app that you generate in PowerApps from a SharePoint list, an Excel table, or another data source. 
 
 If you don't have a license for PowerApps, you can [sign up for free](../signup-for-powerapps.md).
 
 ## Prerequisites
-Before you start this tutorial, [generate an app](data-platform-create-app.md) from the Common Data Service for Apps.
+You can review this topic for general concepts only, or you can follow each step if you first [generate this app](data-platform-create-app.md).
 
 ## Open the generated app
-1. Sign in to [PowerApps](https://web.powerapps.com), and then click or tap **Apps** near the left edge.
+1. Sign in to [PowerApps](https://web.powerapps.com), and then select **Apps** near the left edge.
 
 	![PowerApps home page](./media/customize-layout-sharepoint/sign-in.png)
 
-1. Find the app that you generated, and then click or tap the ellipsis icon (**...**) for it near the right edge.
-
-	![App list](./media/customize-layout-sharepoint/open-for-edit.png)
-
-1. In the menu that appears, click or tap the option to edit the app. 
+1. Find the app that you generated, select the ellipsis icon (**...**) for it, and then select **Edit**.
 
-## Customize the gallery
-1. On the browse screen, click or tap any item except the first one in the list of accounts.
+## Change the layout
+1. On the browse screen, select the gallery by clicking or tapping any item except the first one in the list of accounts.
 
-	This step selects the **Gallery** control, which shows the list of accounts.
+	When the gallery is selected, a selection box with handles surrounds it.
 
 	![Selected gallery](./media/customize-layout-sharepoint/select-gallery.png)
 
-1. In the right-hand pane, click or tap **Accounts** to the right of the **Data** label.
+1. Near the right edge, select **Accounts** to open the **Data** pane.
 
 	![Open the **Data** pane](./media/customize-layout-sharepoint/open-data-pane.png)
 
-1. In the **Data** pane, click or tap the down arrow to open the list of options under **Layout**.
+1. In the **Data** pane, open the list of options under **Layout**.
 
 	![Show layout options](./media/customize-layout-sharepoint/show-layouts.png)
 
-1. In the list of options, click or tap the option that shows only a title.
+1. In the list of options, select the option that shows only a title.
 
 	![Select title-only layout](./media/customize-layout-sharepoint/choose-layout.png)
 
-1. In the **Data** pane, click or tap the down arrow to open the list of options for the title.
+1. In the **Data** pane, open the list of options for the title.
 
 	![Select title-only layout](./media/customize-layout-sharepoint/show-title-options.png)
 
-1. In the list of options, click or tap **name** to show that data in the **Gallery** control.
+1. In the list of options, select **Account name (name)**, and then close the **Data** pane.
 
-	![Final gallery](./media/customize-layout-sharepoint/final-gallery.png)
+    The gallery shows the name of each account.
 
+	![Final gallery](./media/customize-layout-sharepoint/final-gallery.png)
 
-## Set the sort and search columns
-1. Select the **Gallery** control as the previous section describes.
+## Change the sort and search columns
+1. Select the gallery as the previous section describes.
 
 	![Select gallery](./media/customize-layout-sharepoint/select-gallery-title.png)
 
-2. Near the upper-left corner, ensure that the property list shows **Items**.
+2. Near the upper-left corner, confirm that the property list shows **Items**.
 
 	![Items property](./media/customize-layout-sharepoint/items-property.png)
 
-	The value of this property appears in the formula bar and determines not only the data source for the gallery but also the filter and sort columns.
+	The value of this property appears in the formula bar. You set this property to specify not only the data source for the gallery but also the columns by which users can sort and search the data.
+
+1. Copy this formula, and then paste it in the formula bar.
 
-1. In the formula bar, replace both instances of **emailaddress1** to **name**, and retain the double-quotation marks that surround each instance.
+    ```SortByColumns(Search(Accounts, TextSearchBox1.Text, "name"), "name", If(SortDescending1, Descending, Ascending))```
 
-	The formula should match this example:
+	By using this formula, you ensure that:
 
-	![Formula for the Items property](./media/customize-layout-sharepoint/items-value.png)
+    - If a user types one or more characters in the search bar, the gallery shows only those account names that contain the text that the user typed.
+    - If a user selects the sort icon, the gallery is sorted alphabetically by account name in either ascending or descending order, depending on how many times the user selects the icon.
 
-	The first instance of **name** specifies that the user can filter the list to show only those records for which the account name contains text that the user typed in the search bar. The second instance of **name** specifies that the user can sort the list alphabetically by account name. For more information about these and other functions, see the [formula reference](formula-reference.md).
+    For more information about these and other functions, see the [formula reference](formula-reference.md).
 
 ## Test sorting and searching
-1. Open Preview mode by pressing F5 (or by clicking or tapping the play button near the upper-right corner).
+1. Open Preview mode by pressing F5 (or by selecting the play button near the upper-right corner).
 
 	![Open Preview mode](./media/customize-layout-sharepoint/open-preview.png)
 
-1. Near the upper-right corner of the browse screen, click or tap the sort icon one or more times to change the alphabetical sort order between ascending and descending.
+1. Near the upper-right corner of the browse screen, select the sort icon one or more times to change the alphabetical sort order between ascending and descending.
 
 	![Test the sort icon](./media/customize-layout-sharepoint/sort-button.png)
 
-1. In the search box, type **k** to show only those accounts for which the name contains the letter that you typed.
+1. In the search box, type **k** to show only those account names that contain the letter that you typed.
 
 	![Test the search bar](./media/customize-layout-sharepoint/test-filter.png)
 
-1. Remove all text from the search bar, and then close Preview mode by pressing Esc (or by clicking or tapping the close icon *under* the title bar for PowerApps).
+1. Remove all text from the search bar, and then close Preview mode by pressing Esc (or by selecting the close icon near the upper-right corner).
 
-## Change the title of the screen
-1. Click or tap the title of the screen to select it.
+## Change the screen title
+1. Select the title of the screen by clicking or tapping it.
 
 	![Select screen title](./media/customize-layout-sharepoint/select-title.png)
 
-1. Ensure that the property list shows **Text**, and then type **Browse**, surrounded by double quotation marks, in the formula bar.
+1. Ensure that the property list shows **Text** and then, in the formula bar, replace **Accounts** with **Browse** (retaining the double quotation marks).
 
 	![Update screen title](./media/customize-layout-sharepoint/change-screen-title.png)
 
@@ -120,18 +114,18 @@ Before you start this tutorial, [generate an app](data-platform-create-app.md) f
 	![New screen title](./media/customize-layout-sharepoint/new-screen-title.png)
 
 ## Show a scroll bar
-If your users might not have touch screens or mouse wheels, configure the **Gallery** control to show a scroll bar when the user hovers over it with the mouse. That way, users can show all accounts even if the screen can't show them all at once.
+If your users might have neither touch screens nor mouse wheels, configure the gallery to show a scroll bar when the user hovers over it with the mouse. That way, users can show all accounts even if the screen can't show them all at once.
 
-1. Select the **Gallery** control as the first procedure describes.
+1. Select the gallery as the first procedure describes.
 
 	![Select gallery](./media/customize-layout-sharepoint/select-gallery-sorted.png)
 
-1. On the **Gallery** tab, click or tap **Show scrollbar**, and confirm that the value of that property has changed to **true**. 
+1. On the **Gallery** tab, select **Show scrollbar**, and confirm that the value of that property has changed to **true**. 
 
 	![Show scrollbar](./media/customize-layout-sharepoint/show-scrollbar.png)
 
 ## Next steps
-In this tutorial, you've customized the **Gallery** control and the title of the default browse screen of a generated app. You can also customize the default screens for displaying details and creating or updating accounts. Those screens contain a **Display form** control and an **Edit form** control, and you can change (for example) which types of data they show and in which order.
+In this tutorial, you've customized the gallery and made other changes to the default screen for browsing records in a generated app. You can also customize the default screens for displaying details and creating or updating accounts. As the browse screen contains a gallery, the other two screens in the app contain forms. You can change, for example, which types of data the forms show and in which order.
 
 > [!div class="nextstepaction"]
 > [Customize forms](customize-forms-sharepoint.md)

powerapps-docs/maker/canvas-apps/data-platform-create-app.md

@@ -1,64 +1,59 @@
 ---
-title: Generate an app in PowerApps for the Common Data Service for Apps (quickstart)| Microsoft Docs
-description: Automatically generate an app in PowerApps to manage data in the Common Data Service for Apps
-documentationcenter: na
+title: Quickstart - Generate an app from Common Data Service for Apps | Microsoft Docs
+description: Automatically generate an app in PowerApps to manage data in Common Data Service for Apps
 author: AFTOwen
-manager: kfile
 
 ms.service: powerapps
-ms.devlang: na
 ms.topic: conceptual
 ms.component: canvas
 ms.date: 03/10/2018
 ms.author: anneta
 
 ---
-# Quickstart for generating an app in PowerApps for the Common Data Service for Apps
+# Quickstart: Generate an app from Common Data Service for Apps in PowerApps
 
-In this quickstart, you'll use PowerApps to automatically generate your first app based on a list of sample accounts in the [Common Data Service for Apps](../common-data-service/data-platform-intro.md). In this app, you can browse all accounts, show details of a single account, and create, update, or delete an account.
+In this quickstart, you'll use Microsoft PowerApps to automatically generate an app based on a list of sample accounts in [Common Data Service (CDS) for Apps](../common-data-service/data-platform-intro.md). In this app, you can browse all accounts, show details of a single account, and create, update, or delete an account.
 
-To follow this quickstart, you must switch to an [environment](working-with-environments.md) in which a database in the Common Data Service has been created and contains data. If no such environment exists and you have administrative privileges, you can [create an environment](../../administrator/environments-administration.md#create-an-environment) that meets this requirement.
+To follow this quickstart, you must [switch to an environment](working-with-environments.md) in which a database in CDS for Apps has been created, contains data, and allows updates. If no such environment exists and you have administrative privileges, you can [create an environment](../../administrator/environments-administration.md#create-an-environment) that meets this requirement.
 
 If you don't have a license for PowerApps, you can [sign up for free](../signup-for-powerapps.md).
 
 ## Generate an app
-1. Sign in to [PowerApps](https://web.powerapps.com).
+1. Sign in to [PowerApps](https://web.powerapps.com) and, if necessary, switch environments as specified earlier in this topic.
 
 	![PowerApps home page](./media/data-platform-create-app/sign-in.png)
 
 1. Under **Make apps like these**, hover over **Start from data**, and then select **Make this app**.
 
 	![Option to create an app](./media/data-platform-create-app/make-this-app.png)
 
-1. Under **Start with your data**, select the arrow that points to the right.
+1. On the **Common Data Service** tile, select **Phone layout**.
 
-	![Arrow icon](./media/data-platform-create-app/right-arrow.png)
+	![Connection tile](./media/data-platform-create-app/connection-tile.png)
 
-1. Under **Connections**, select your connection to the Common Data Service.
+1. Under **Choose a table**, select **Accounts**, and then select **Connect**.
 
-1. Type **Accounts** in the search box (near the right edge), select **Accounts** under **Choose a table**, and then select **Connect**.
+1. If the **Welcome to PowerApps Studio** dialog box appears, select **Skip**.
 
-	![Select an entity](./media/data-platform-create-app/select-entity.png)
+Your app opens to the browse screen, which shows a list of accounts. Near the top of the screen, a title bar shows icons for refreshing the list, sorting the list, and creating an account. Under the title bar, a search box provides the option to filter the list based on text that you type or paste. 
 
-After a few minutes, your app opens to the browse screen, which shows a list of accounts. Near the top of the screen, a title bar shows icons for refreshing the list, sorting the list, and creating an account. Under the title bar, a search box provides the option to filter the list based on text that you type or paste. 
-
-By default, the list shows an image, an email address, a city, and an ID for that account. But you can customize the list, which is called a gallery, to show other types of data.
+By default, the list shows an email address, a city, and an ID for that account. But you can customize the list, which is called a gallery, to show other types of data.
 
 ![Browse screen](./media/data-platform-create-app/browse-screen.png)
 
 ## Save the app
 You'll probably want to make more changes before you use this app or share it with others. As a best practice, save your work so far before you proceed.
 
-1. Near the upper-left corner, click or tap the **File** tab.
+1. Near the upper-left corner, select the **File** tab.
 
 1. In the **App settings** page, set the app name to **AppGen**, change the background color to deep red, and change the icon to a checkmark.
 
 	![App settings page](./media/data-platform-create-app/app-settings.png)
 
-1. Near the left edge, click or tap **Save**.
+1. Near the left edge, select **Save** and then, in the lower-left corner, select **Save**.
 
 ## Next steps
-In this quickstart, you created an app to manage sample data about accounts in the Common Data Service for Apps. As a next step, customize the default browse screen to better suit your needs.
+In this quickstart, you created an app to manage sample data about accounts in CDS for Apps. As a next step, customize the gallery and other elements of the default browse screen to better suit your needs.
 
 > [!div class="nextstepaction"]
-> [Customize a default browse screen](customize-layout-sharepoint.md).
+> [Customize a gallery](customize-layout-sharepoint.md).