Merge pull request #216760 from diberry/diberry/1101-search-dotnet

Cognitive Search - add search to website - .NET

Author: LJSpiller

articles/search/includes/tutorial-add-search-website-load-index-copy-resource-name.md

@@ -8,4 +8,4 @@ ms.service: cognitive-search
 Note your **Search resource name**. You'll need this to connect the Azure Function app to your search resource. 
 
 > [!CAUTION]
-> While you may be tempted to use your search admin key in the Azure Function, that isn't following the principle of least privilege. The Azure Function will use the query key to conform to least privilege. 
+> While you may be tempted to use your search admin key in the Azure Function, that isn't following the principle of least privilege. The Azure Function will use the query key to conform to least privilege.

articles/search/includes/tutorial-add-search-website-load-index-review.md

@@ -13,5 +13,4 @@ Once the upload completes, the search index is ready to use. Review your new ind
     :::image type="content" source="../media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-resource.png" alt-text="Screenshot of Visual Studio Code using the search extension.":::
 
 1. Expand Indexes, then Documents, then `good-books`, then select a doc to see all the document-specific data.
- 
     :::image type="content" source="../media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-docs.png" lightbox="../media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-docs.png" alt-text="Expandable screenshot of Visual Studio Code showing documents listed in an index.":::

articles/search/tutorial-csharp-create-load-index.md

@@ -7,16 +7,17 @@ author: diberry
 ms.author: diberry
 ms.service: cognitive-search
 ms.topic: tutorial
-ms.date: 08/30/2022
+ms.date: 11/01/2022
 ms.custom: devx-track-csharp
 ms.devlang: csharp
 ---
 
 # 2 - Create and load Search Index with .NET
 
 Continue to build your Search-enabled website by:
-* Creating a Search resource with the VS Code extension
-* Creating a new index and importing data with .NET using the sample script and Azure SDK [Azure.Search.Documents](https://www.nuget.org/packages/Azure.Search.Documents/).
+* Create a Search resource with the VS Code extension
+* Create a new index
+* Import data with .NET using the sample script and Azure SDK [Azure.Search.Documents](https://www.nuget.org/packages/Azure.Search.Documents/).
 
 ## Create an Azure Search resource 
 
@@ -26,7 +27,7 @@ Create a new Search resource with the [Azure Cognitive Search](https://marketpla
 
 1. In the Side bar, **right-click on your Azure subscription** under the `Azure: Cognitive Search` area and select **Create new search service**.
 
-    :::image type="content" source="./media/tutorial-javascript-create-load-index/visual-studio-code-create-search-resource.png" alt-text="In the Side bar, right-click on your Azure subscription under the **Azure: Cognitive Search** area and select **Create new search service**.":::
+    :::image type="content" source="./media/tutorial-javascript-create-load-index/visual-studio-code-create-search-resource.png" alt-text="Screenshot of Visual Studio code showing the Azure explorer bar, right-click on your Azure subscription under the Azure: Cognitive Search area and select Create new search service.":::
 
 1. Follow the prompts to provide the following information:
 
@@ -45,9 +46,9 @@ Get your Search resource admin key with the Visual Studio Code extension.
 
 1. In Visual Studio Code, in the Side bar, right-click on your Search resource and select **Copy Admin Key**.
 
-    :::image type="content" source="./media/tutorial-javascript-create-load-index/visual-studio-code-copy-admin-key.png" alt-text="In the Side bar, right-click on your Search resource and select **Copy Admin Key**.":::
+    :::image type="content" source="./media/tutorial-javascript-create-load-index/visual-studio-code-copy-admin-key.png" alt-text="Screenshot of Visual Studio code showing the Azure explorer bar, right-click on your Search resource and select Copy Admin Key.":::
 
-1. Keep this admin key, you will need to use it in [a later section](#prepare-the-bulk-import-script-for-search). 
+1. Keep this admin key, you'll need to use it in [a later section](#prepare-the-bulk-import-script-for-search). 
 
 ## Prepare the bulk import script for Search
 
@@ -56,22 +57,22 @@ The script uses the Azure SDK for Cognitive Search:
 * [NuGet package Azure.Search.Documents](https://www.nuget.org/packages/Azure.Search.Documents/)
 * [Reference Documentation](/dotnet/api/overview/azure/search)
 
-1. In Visual Studio Code, open the `Program.cs` file in the subdirectory,  `search-website/bulk-insert`, replace the following variables with your own values to authenticate with the Azure Search SDK:
+1. In Visual Studio Code, open the `Program.cs` file in the subdirectory,  `search-website-functions-v4/bulk-insert`, replace the following variables with your own values to authenticate with the Azure Search SDK:
 
     * YOUR-SEARCH-RESOURCE-NAME
     * YOUR-SEARCH-ADMIN-KEY
 
-    :::code language="csharp" source="~/azure-search-dotnet-samples/search-website/bulk-insert/Program.cs" highlight="16-19" :::
+    :::code language="csharp" source="~/azure-search-dotnet-samples/search-website-functions-v4/bulk-insert/Program.cs" highlight="16-19, 21-23, 32, 49" :::
 
-1. Open an integrated terminal in Visual Studio Code for the project directory's subdirectory, `search-website/bulk-insert`, then run the following command to install the dependencies. 
+1. Open an integrated terminal in Visual Studio Code for the project directory's subdirectory, `search-website-functions-v4/bulk-insert`, then run the following command to install the dependencies. 
 
     ```bash
     dotnet restore
     ```
 
 ## Run the bulk import script for Search
 
-1. Continue using the integrated terminal in Visual Studio for the project directory's subdirectory, `search-website/bulk-insert`, to run the following bash command to run the `Program.cs` script:
+1. Continue using the integrated terminal in Visual Studio for the project directory's subdirectory, `search-website-functions-v4/bulk-insert`, to run the following bash command to run the `Program.cs` script:
 
     ```bash
     dotnet run
@@ -82,30 +83,14 @@ The script uses the Azure SDK for Cognitive Search:
 
 ## Review the new Search Index
 
-Once the upload completes, the Search Index is ready to use. Review your new Index.
-
-1. In Visual Studio Code, open the Azure Cognitive Search extension and select your Search resource.  
-
-    :::image type="content" source="media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-resource.png" alt-text="In Visual Studio Code, open the Azure Cognitive Search extension and open your Search resource.":::
-
-1. Expand Indexes, then Documents, then `good-books`, then select a doc to see all the document-specific data.
- 
-    :::image type="content" source="media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-docs.png" lightbox="media/tutorial-javascript-create-load-index/visual-studio-code-search-extension-view-docs.png" alt-text="Expand Indexes, then `good-books`, then select a doc.":::
-
-## Copy your Search resource name
-
-Note your **Search resource name**. You will need this to connect the Azure Function app to your Search resource. 
-
-> [!CAUTION]
-> While you may be tempted to use your Search admin key in the Azure Function, that isn't following the principle of least privilege. The Azure Function will use the query key to conform to least privilege. 
+[!INCLUDE [tutorial-load-index-review-index](includes/tutorial-add-search-website-load-index-review.md)]
 
 ## Rollback bulk import file changes
 
-Use the following git command in the VS Code integrated terminal at the `bulk-insert` directory, to rollback the changes. They are not needed to continue the tutorial and you shouldn't save or push these secrets to your repo. 
+[!INCLUDE [tutorial-load-index-rollback](includes/tutorial-add-search-website-load-index-rollback-changes.md)]
 
-```git
-git checkout .
-```
+## Copy your Search resource name
+[!INCLUDE [tutorial-load-index-copy](includes/tutorial-add-search-website-load-index-copy-resource-name.md)]
 
 ## Next steps
 

articles/search/tutorial-csharp-deploy-static-web-app.md

@@ -7,118 +7,14 @@ author: diberry
 ms.author: diberry
 ms.service: cognitive-search
 ms.topic: tutorial
-ms.date: 08/30/2022
+ms.date: 11/01/2022
 ms.custom: devx-track-csharp
 ms.devlang: csharp
 ---
 
 # 3 - Deploy the search-enabled .NET website
 
-Deploy the search-enabled website as an Azure Static web app. This deployment includes both the React app and the Function app.  
-
-The Static Web app pulls the information and files for deployment from GitHub using your fork of the samples repository.  
-
-## Create a Static Web App in Visual Studio Code
-
-1. Select **Azure** from the Activity Bar, then open **Resources** from the Side bar. 
-
-1. Right-click **Static Web Apps** and then select **Create Static Web App (Advanced)**.
-
-    :::image type="content" source="media/tutorial-javascript-create-load-index/visual-studio-code-create-static-web-app-resource-advanced.png" alt-text="Right-click **Static Web Apps** and then select **Create Static Web App (Advanced)**":::
-
-1. If you see a pop-up window in VS Code asking which branch you want to deploy from, select the default branch, usually **master** or **main**. 
-
-    This setting means only changes you commit to that branch are deployed to your static web app. 
-
-1. If you see a pop-up window asking you to commit your changes, do not do this. The secrets from the bulk import step should not be committed to the repository. 
-
-    To rollback the changes, in VS Code select the Source Control icon in the Activity bar, then select each changed file in the Changes list and select the **Discard changes** icon.
-
-1. Follow the prompts to provide the following information:
-
-    |Prompt|Enter|
-    |--|--|
-    |Enter the name for the new Static Web App.|Create a unique name for your resource. For example, you can prepend your name to the repository name such as, `joansmith-azure-search-dotnet-samples`. |
-    |Select a resource group for new resources.|Use the resource group you created for this tutorial.|
-    |Select a SKU| Select the free SKU for this tutorial.|
-    |Choose build preset to configure default project structure.|Select **Custom**|
-    |Select the location of your application code|`search-website`<br><br>This is the path, from the root of the repository, to your Azure Static web app. |
-    |Select the location of your Azure Function code|`search-website/api`<br><br>This is the path, from the root of the repository, to your Azure Function app. |
-    |Enter the path of your build output...|`build`<br><br>This is the path, from your Azure Static web app, to your generated files.|
-    |Select a location for new resources.|Select a region close to you.|
-
-1. The resource is created, select **Open Actions in GitHub** from the Notifications. This opens a browser window pointed to your forked repo. 
-
-    The list of actions indicates your web app, both client and functions, were successfully pushed to your Azure Static Web App. 
-
-    Wait until the build and deployment complete before continuing. This may take a minute or two to finish.
-
-## Get Cognitive Search query key in Visual Studio Code
-
-1. In Visual Studio Code, open the [Activity bar](https://code.visualstudio.com/docs/getstarted/userinterface), and select the Azure icon. 
-
-1. In the Side bar, select your Azure subscription under the **Azure: Cognitive Search** area, then right-click on your Search resource and select **Copy Query Key**. 
-
-    :::image type="content" source="./media/tutorial-javascript-create-load-index/visual-studio-code-copy-query-key.png" alt-text="In the Side bar, select your Azure subscription under the **Azure: Cognitive Search** area, then right-click on your Search resource and select **Copy Query Key**.":::
-
-1. Keep this query key, you will need to use it in the next section. The query key is able to query your Index. 
-
-## Add configuration settings in Azure portal
-
-The Azure Function app won't return Search data until the Search secrets are in settings. 
-
-1. Select **Azure** from the Activity Bar. 
-1. Right-click on your Static web app resource then select **Open in Portal**.
-
-    :::image type="content" source="media/tutorial-javascript-static-web-app/open-static-web-app-in-azure-portal.png" alt-text="Right-click on your JavaScript Static web app resource then select Open in Portal.":::
-
-1. Select **Configuration** then select **+ Add**.
-
-    :::image type="content" source="media/tutorial-javascript-static-web-app/add-new-application-setting-to-static-web-app-in-portal.png" alt-text="Select Configuration then select Add for your JavaScript app.":::
-
-1. Add each of the following settings:
-
-    |Setting|Your Search resource value|
-    |--|--|
-    |SearchApiKey|Your Search query key|
-    |SearchServiceName|Your Search resource name|
-    |SearchIndexName|`good-books`|
-    |SearchFacets|`authors*,language_code`|
-
-    Azure Cognitive Search requires different syntax for filtering collections than it does for strings. Add a `*` after a field name to denote that the field is of type `Collection(Edm.String)`. This allows the Azure Function to add filters correctly to queries.
-
-1. Select **Save** to save the settings. 
-
-    :::image type="content" source="media/tutorial-javascript-static-web-app/save-new-application-setting-to-static-web-app-in-portal.png" alt-text="Select Save to save the settings for your JavaScript app..":::
-
-1. Return to VS Code. 
-1. Refresh your Static web app to see the Static web app's application settings. 
-
-    :::image type="content" source="media/tutorial-javascript-static-web-app/visual-studio-code-extension-fresh-resource.png" alt-text="Refresh your JavaScript Static web app to see the Static web app's application settings.":::
-
-## Use search in your Static web app
-
-1. In Visual Studio Code, open the [Activity bar](https://code.visualstudio.com/docs/getstarted/userinterface), and select the Azure icon.
-1. In the Side bar, **right-click on your Azure subscription** under the `Static web apps` area and find the Static web app you created for this tutorial.
-1. Right-click the Static Web App name and select **Browse site**.
-    
-    :::image type="content" source="media/tutorial-javascript-create-load-index/visual-studio-code-browse-static-web-app.png" alt-text="Right-click the Static Web App name and select **Browse site**.":::    
-
-1. Select **Open** in the pop-up dialog.
-1. In the website search bar, enter a search query such as `code`, _slowly_ so the suggest feature suggests book titles. Select a suggestion or continue entering your own query. Press enter when you've completed your search query. 
-1. Review the results then select one of the books to see more details. 
-
-## Clean up resources
-
-To clean up the resources created in this tutorial, delete the resource group.
-
-1. In Visual Studio Code, open the [Activity bar](https://code.visualstudio.com/docs/getstarted/userinterface), and select the Azure icon. 
-
-1. In the Side bar, **right-click on your Azure subscription** under the `Resource Groups` area and find the resource group you created for this tutorial.
-1. Right-click the resource group name then select **Delete**.
-    This deletes both the Search and Static web app resources.
-1. If you no longer want the GitHub fork of the sample, remember to delete that on GitHub. Go to your fork's **Settings** then delete the fork. 
-
+[!INCLUDE [tutorial-deploy](includes/tutorial-add-search-website-create-app.md)]
 
 ## Next steps