Skip to content

Commit a16c1c3

Browse files
author
Luis Cabrera
committed
adding gray borders and removing orphaned image (non-blocking changes)
1 parent 00886c2 commit a16c1c3

File tree

2 files changed

+22
-24
lines changed

2 files changed

+22
-24
lines changed
Binary file not shown.

articles/search/search-howto-powerapps.md

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,15 @@ This document shows how to create a Power Apps custom connector so that you can
2323

2424
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.
2525

26-
2726
1. Go to [make.powerapps.com](http://make.powerapps.com) and **Sign In**.
27+
2828
1. Search for **Data** > **Custom Connectors**
2929

30-
![Custom connector menu](./media/search-howto-powerapps/1-2-custom-connector.png "Custom connector menu")
30+
:::image type="content" source="./media/search-howto-powerapps/1-2-custom-connector.png" alt-text="Custom connector menu" border="true":::
3131

3232
1. Click **+ New custom connector** and then select **Create from blank**.
3333

34-
![Create from blank menu](./media/search-howto-powerapps/1-3-create-blank.png "Create from blank menu")
34+
:::image type="content" source="./media/search-howto-powerapps/1-3-create-blank.png" alt-text="Create from blank menu" border="true":::
3535

3636
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.
3737

@@ -42,15 +42,16 @@ There are two main steps to having a PowerApp that shows Azure Cognitive Search
4242
- In the Host, you will need to enter your search service URL (for instance, `<yourservicename>.search.windows.net`)
4343
- For Base URL, simply enter "/"
4444

45-
![General information dialogue](./media/search-howto-powerapps/1-5-general-info.png "General information dialogue")
45+
:::image type="content" source="./media/search-howto-powerapps/1-5-general-info.png" alt-text="General information dialogue" border="true":::
4646

4747
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.
4848

49-
![Authentication type options](./media/search-howto-powerapps/1-6-authentication-type.png "Authentication type options")
49+
:::image type="content" source="./media/search-howto-powerapps/1-6-authentication-type.png" alt-text="Authentication type option" border="true":::
5050

5151
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"*.
5252

53-
![New action options](./media/search-howto-powerapps/1-7-new-action.png "New action options")
53+
:::image type="content" source="./media/search-howto-powerapps/1-7-new-action.png" alt-text="New action options" border="true":::
54+
5455

5556
1. Press the **+ Import from sample** button to define the parameters and headers. Next, you will define the query request.
5657

@@ -62,23 +63,22 @@ There are two main steps to having a PowerApp that shows Azure Cognitive Search
6263

6364
**Power Apps** will use the syntax to extract parameters from the query. Notice we explicitly defined the search field.
6465

65-
![Import from sample](./media/search-howto-powerapps/1-8-1-import-from-sample.png "Import from sample")
66-
66+
:::image type="content" source="./media/search-howto-powerapps/1-8-1-import-from-sample.png" alt-text="Import from sample" border="false":::
67+
6768
1. Click **Import** to automatically pre-fill the Request dialog.
6869

69-
![Import from sample](./media/search-howto-powerapps/1-8-2-import-from-sample.png "Import from sample")
70+
:::image type="content" source="./media/search-howto-powerapps/1-8-2-import-from-sample.png" alt-text="Import from sample dialogue" border="false":::
7071

7172

7273
1. Complete setting the parameter metadata by clicking the **** symbol next to each of the parameters.
7374

7475
- For *search*: Set `*` as the **default value**, set **required** as *false* and set the **visibility** to *none*.
7576

76-
![Search parameter metadata](./media/search-howto-powerapps/1-10-1-parameter-metadata-search.png "Search parameter metadata")
77-
77+
:::image type="content" source="./media/search-howto-powerapps/1-10-1-parameter-metadata-search.png" alt-text="Search parameter metadata" border="true":::
7878

7979
- For *api-version*: Set `2019-05-06-Preview` as the **default value**, set the **visibility** as internal and set **required** to *True*.
8080

81-
![Version parameter metadata](./media/search-howto-powerapps/1-10-2-parameter-metadata-version.png "Version parameter metadata")
81+
:::image type="content" source="./media/search-howto-powerapps/1-10-2-parameter-metadata-version.png" alt-text="Version parameter metadata" border="true":::
8282

8383
- Similarly, for *api-key*, set it as **required**, with *internal* **visibility**. Enter your search service API key as the **default value**.
8484

@@ -115,20 +115,19 @@ The goal of this tutorial is not to show you how to create fancy user experience
115115
116116
1. Create new Power App. Go to the **Apps** section, click on **+ New app**, and select **Canvas**.
117117
118-
![Create canvas app](./media/search-howto-powerapps/2-1-create-canvas.png "Create canvas app")
118+
:::image type="content" source="./media/search-howto-powerapps/2-1-create-canvas.png" alt-text="Create canvas app" border="true":::
119119
120120
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.
121121
122122
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**.
123123
124-
125-
![Connect connector](./media/search-howto-powerapps/2-3-connect-connector.png "connect connector")
124+
:::image type="content" source="./media/search-howto-powerapps/2-3-connect-connector.png" alt-text="connect connector" border="true":::
126125
127126
Now *AzureSearchQuery* is a data source that is available to be used from your application.
128127
129128
1. Navigate to the **Insert tab**, so that we can add a few controls to our form.
130129
131-
![Insert controls](./media/search-howto-powerapps/2-4-add-controls.png "Insert controls")
130+
:::image type="content" source="./media/search-howto-powerapps/2-4-add-controls.png" alt-text="Insert controls" border="true":::
132131
133132
1. Insert the following elements:
134133
- A Text Label with the value "Query:"
@@ -138,16 +137,16 @@ The goal of this tutorial is not to show you how to create fancy user experience
138137
139138
Your form should look something like this:
140139
141-
![Controls layout](./media/search-howto-powerapps/2-5-controls-layout.png "Controls layout")
140+
:::image type="content" source="./media/search-howto-powerapps/2-5-controls-layout.png" alt-text="Controls layout" border="true":::
142141
143142
1. To make the **Search button** issue a query, select the button, and Paste the following action to take on **OnSelect**:
144143
145144
```
146145
If(!IsBlank(txtQuery.Text),
147146
ClearCollect(azResult, AzureSearchQuery.Get({search: txtQuery.Text}).value))
148147
```
149-
150-
![Button OnSelect](./media/search-howto-powerapps/2-6-search-button-event.png "Button OnSelect")
148+
149+
:::image type="content" source="./media/search-howto-powerapps/2-6-search-button-event.png" alt-text="Button OnSelect" border="true":::
151150
152151
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.
153152
@@ -161,15 +160,14 @@ The goal of this tutorial is not to show you how to create fancy user experience
161160
162161
Since we provided a sample result when we defined the connector, the app is aware of the fields available in your index.
163162
164-
![Gallery Fields](./media/search-howto-powerapps/2-7-gallery-select-fields.png "Gallery Fields")
163+
:::image type="content" source="./media/search-howto-powerapps/2-7-gallery-select-fields.png" alt-text="Gallery fields" border="true":::
165164
166165
1. Press **F5** to preview the app.
167166
168-
Remember that the fields can be set to calculated values.
169-
For the example, setting using the *"Image, Title and Subtitle"* layout and specifying the *Image* function as the concatenation of the root path for the data and the file name (for instance, `"https://mystore.blob.core.windows.net/multilang/" & ThisItem.metadata_storage_name`) will produce the result below.
170-
167+
Remember that the fields can be set to calculated values.
168+
For the example, setting using the *"Image, Title and Subtitle"* layout and specifying the *Image* function as the concatenation of the root path for the data and the file name (for instance, `"https://mystore.blob.core.windows.net/multilang/" & ThisItem.metadata_storage_name`) will produce the result below.
171169
172-
![Final app](./media/search-howto-powerapps/2-8-2-final.png "Final app")
170+
:::image type="content" source="./media/search-howto-powerapps/2-8-2-final.png" alt-text="Final app" border="true":::
173171
174172
## Next steps
175173

0 commit comments

Comments
 (0)