Incorporating editor's feedback

Author: Luis Cabrera

articles/search/TOC.yml

@@ -235,7 +235,7 @@
       href: search-explorer.md
     - name: Special characters and partial terms
       href: search-query-partial-matching.md
-    - name: Query from PowerApp   
+    - name: Query from Power Apps   
       href: search-howto-powerapps.md  
     - name: Syntax reference
       items:

articles/search/search-howto-powerapps.md

@@ -15,26 +15,27 @@ ms.date: 03/25/2020
 
 This document shows how to create a Power Apps custom connector so that you can retrieve search results from a search index. It also shows how to issue a search query and visualize the results from a Power App. 
 
-## Prerequisites:
-1.    Power Apps account access with the ability to create custom connectors.
-2.    We assume you have already created an Azure Search Index.
+## Prerequisites
+*    Power Apps account access with the ability to create custom connectors.
+*    We assume you have already created an Azure Search Index.
 
-There are two main steps to having a PowerApp that shows Azure Cognitive Search results. First creating a connector that can query the search index, and then updating your power app application to visualize the results returned by the connector.
+## Create a custom connector to query Azure Search
 
-## Create a Custom Connector to Query Azure Search
+There are two main steps to having a PowerApp that shows Azure Cognitive Search results. First, let's create a connector that can query the search index. In the [next section](#visualize-results-from-the-custom-connector) we will update your Power Apps application to visualize the results returned by the connector.
 
-1. Go to [make.powerapps.com](http://make.powerapps.com) and **Sign In**
-2. Search for **Data** > **Custom Connectors**
+
+1. Go to [make.powerapps.com](http://make.powerapps.com) and **Sign In**.
+1. Search for **Data** > **Custom Connectors**
 
     ![Custom connector menu](./media/search-howto-powerapps/1-2-custom-connector.png "Custom connector menu")
 
-3. Click  **+ New custom connector**  and then select **Create from blank**
+1. Click  **+ New custom connector**  and then select **Create from blank**.
 
     ![Create from blank menu](./media/search-howto-powerapps/1-3-create-blank.png "Create from blank menu")
 
-4. Give your custom connector a name. (that is, *AzureSearchQuery*), and then click **Continue**. This will bring up a wizard to create your new connector.
+1. Give your custom connector a name. (that is, *AzureSearchQuery*), and then click **Continue**. This will bring up a wizard to create your new connector.
 
-5. Enter information in the General Page.
+1. Enter information in the General Page.
 
     - Icon background color (for instance, #007ee5)
     - Description (for instance, "A connector to Azure Cognitive Search")
@@ -43,15 +44,15 @@ There are two main steps to having a PowerApp that shows Azure Cognitive Search
 
     ![General information dialogue](./media/search-howto-powerapps/1-5-general-info.png "General information dialogue")
 
-6. In the Security Page, set *API Key* as the **Authentication Type**, set the parameter label, and parameter name fields as *api-key*. For **Parameter location**, select *Header* as shown below.
+1. In the Security Page, set *API Key* as the **Authentication Type**, set the parameter label, and parameter name fields as *api-key*. For **Parameter location**, select *Header* as shown below.
 
     ![Authentication type options](./media/search-howto-powerapps/1-6-authentication-type.png "Authentication type options")
 
-7. In the Definitions Page, select **+ New Action** to create an action that will query the index. Enter the value "Query" for the summary and the name of the operation ID. Enter a description like *"Queries the search index"*.
+1. In the Definitions Page, select **+ New Action** to create an action that will query the index. Enter the value "Query" for the summary and the name of the operation ID. Enter a description like *"Queries the search index"*.
 
     ![New action options](./media/search-howto-powerapps/1-7-new-action.png "New action options")
 
-8. Press the **+ Import from sample** button to define the parameters and headers. Next, you will define the query request.  
+1. Press the **+ Import from sample** button to define the parameters and headers. Next, you will define the query request.  
 
     * Select the verb `GET`
     * For the URL enter a sample query for your search index, for instance:
@@ -63,12 +64,12 @@ There are two main steps to having a PowerApp that shows Azure Cognitive Search
 
     ![Import from sample](./media/search-howto-powerapps/1-8-1-import-from-sample.png "Import from sample")
 
-9.  Click **Import** to automatically pre-fill the Request dialog.
+1.  Click **Import** to automatically pre-fill the Request dialog.
 
     ![Import from sample](./media/search-howto-powerapps/1-8-2-import-from-sample.png "Import from sample")
 
 
-10. Complete setting the parameter metadata by clicking the **…** symbol next to each of the parameters.
+1. Complete setting the parameter metadata by clicking the **…** symbol next to each of the parameters.
 
     - For *search*: Set `*` as the **default value**, set **required** as *false* and set the **visibility** to *none*. 
 
@@ -92,55 +93,54 @@ There are two main steps to having a PowerApp that shows Azure Cognitive Search
             x-ms-visibility: internal}
     ```
 
-11. On the Response section, click **"Add default response"**. This is critical because it will help **Power Apps** understand the schema of the response. Paste a sample response.
+1. On the Response section, click **"Add default response"**. This is critical because it will help **Power Apps** understand the schema of the response. Paste a sample response.
 
     > [!TIP] 
     > There is a character limit to the JSON response you can enter, so you may want to simplify the JSON so that it before pasting it. The important aspect schema/format of the response. The actual values in the sample response are less important and can be simplified to reduce the character count.
     
 
-12.    Click the **Create connector** button on the top right of the screen before you can Test it.
+1.    Click the **Create connector** button on the top right of the screen before you can Test it.
 
-13.    In the Test Page, click the **+ New Connection**, and enter your search service query key as the value for *api-key*.
+1.    In the Test Page, click the **+ New Connection**, and enter your search service query key as the value for *api-key*.
 
 This step may take you to the out of the wizard and into the Connections page. You may want to go back to the Custom Connections editor to actually test the connection. Go to **Custom Connector** > Select the newly created Connector > … > **View Properties** > **Edit** > **4. Test** to get back to the test page.
 
-14.    Now click **Test operation** to make sure that you are getting results from your index. If you were successful you should see a 200 status, and in the body of the response you should see JSON that describes your search results.
+1.    Now click **Test operation** to make sure that you are getting results from your index. If you were successful you should see a 200 status, and in the body of the response you should see JSON that describes your search results.
 
 
 
 
-## Visualize Results from the Custom Connector we just created
+## Visualize results from the custom connector
 The goal of this tutorial is not to show you how to create fancy user experiences with power apps, so the UI layout will be minimalistic. Let's create a PowerApp with a search box, a search button and display the results in a gallery control.  The PowerApp will connect to our recently created custom connector to get the data from Azure Search.
 
-1. Create new Power App
-Go to the **Apps** section, click on **+ New app**, and select **Canvas**
+1. Create new Power App. Go to the **Apps** section, click on **+ New app**, and select **Canvas**.
 
      ![Create canvas app](./media/search-howto-powerapps/2-1-create-canvas.png "Create canvas app")
 
-2. Select the type of application you would like. For this tutorial create a **Blank App** with the **Phone Layout**. The **Power Apps Studio** will appear.
+1. Select the type of application you would like. For this tutorial create a **Blank App** with the **Phone Layout**. The **Power Apps Studio** will appear.
 
-3. Once in the studio, select the **Data Sources**  tab, and click on the new Connector you have just created. In our case, it is called *AzureSearchQuery*. Click **Add a connection**.
+1. Once in the studio, select the **Data Sources**  tab, and click on the new Connector you have just created. In our case, it is called *AzureSearchQuery*. Click **Add a connection**.
 
   
     ![Connect connector](./media/search-howto-powerapps/2-3-connect-connector.png "connect connector")
 
-Now *AzureSearchQuery* is a data source that is available to be used from your application.
-
-4. Navigate to the **Insert tab**, so that we can add a few controls to our form.
+    Now *AzureSearchQuery* is a data source that is available to be used from your application.
+    
+1. Navigate to the **Insert tab**, so that we can add a few controls to our form.
 
     ![Insert controls](./media/search-howto-powerapps/2-4-add-controls.png "Insert controls")
 
-5.  Insert the following elements:
--   A Text Label with the value "Query:"
--   A Text Input element (call it *txtQuery*, default value: "*")
--   A button with the text "Search" 
--   A Vertical Gallery called (call it *galleryResults*)
-
+1.  Insert the following elements:
+    -   A Text Label with the value "Query:"
+    -   A Text Input element (call it *txtQuery*, default value: "*")
+    -   A button with the text "Search" 
+    -   A Vertical Gallery called (call it *galleryResults*)
+    
     Your form should look something like this:
 
     ![Controls layout](./media/search-howto-powerapps/2-5-controls-layout.png "Controls layout")
 
-6. To make the **Search button** issue a query, select the button, and Paste the following action to take on **OnSelect**:
+1. To make the **Search button** issue a query, select the button, and Paste the following action to take on **OnSelect**:
 
     ```
     If(!IsBlank(txtQuery.Text),
@@ -151,28 +151,28 @@ Now *AzureSearchQuery* is a data source that is available to be used from your a
  
     This action will cause the button to update a new collection called *azResult* with the result of the search query, using the text in the *txtQuery* text box as the query term.
     
-7.  As a next step, we will link the vertical gallery we created to the *azResult* collection. Select the gallery control, and perform the following actions in the properties pane.
+1.  As a next step, we will link the vertical gallery we created to the *azResult* collection. Select the gallery control, and perform the following actions in the properties pane.
 
     -  Set **DataSource** to *azResult*.
     
-    -  Select a **Layout** that works for you based on the type of data in your index.
+    -  Select a **Layout** that works for you based on the type of data in your index. In this case, we used the *Title, subtitle and body* layout.
     
     -  **Edit Fields**, and select the fields you would like to visualize.
 
-    Since we provided a sample result when we defined the connector, Power Apps is aware of the fields available in your index.
+    Since we provided a sample result when we defined the connector, the app is aware of the fields available in your index.
     
     ![Gallery Fields](./media/search-howto-powerapps/2-7-gallery-select-fields.png "Gallery Fields")
  
-8.  Press **F5** to preview the PowerApp.  
+1.  Press **F5** to preview the app.  
 
-      Remember that the fields can be set to calculated values. For the example below, I calculated the full path of my images as the concatenation of the root path for the data and the name of the file as an example.
+      Remember that the fields can be set to calculated values. For the example below, the full path to the image files is calculated as the concatenation of the root path for the data and the file name.
  
      ![calculated field](./media/search-howto-powerapps/2-8-1-calculated-field.png "Calculated field")
 
 
      ![Final app](./media/search-howto-powerapps/2-8-2-final.png  "Final app")
 
-## Next Steps
+## Next steps
 
-To learn more about creating your own PowerApps, check the [PowerApps Learning Catalog](https://docs.microsoft.com/powerapps/learning-catalog/get-started)
+For more information and online training, see [Power Apps Learning Catalog](https://docs.microsoft.com/powerapps/learning-catalog/get-started).