Merge branch 'main' into phecke-plugin-updates

Author: phecke

.openpublishing.redirection.json

@@ -1,7 +1,7 @@
 ---
 title: Build and package plug-in code
 description: Learn about building plug-in code into assemblies and packages for later registration and upload to the Microsoft Dataverse service.
-ms.date: 02/29/2024
+ms.date: 03/18/2024
 ms.reviewer: pehecke
 ms.topic: article
 author: divkamath
@@ -118,6 +118,8 @@ If you're adding another project to the Visual Studio solution, say a class libr
 1. You should see the line `<Project Sdk="Microsoft.NET.Sdk">` in the project file. Change the TargetFramework property to be `<TargetFramework>net462</TargetFramework>` and save the file.
 1. Verify your solution builds, and you're done.
 
+More information: [.NET Project SDKs](/dotnet/core/project-sdk/overview#project-files)
+
 ### Don't depend on System.Text.Json
 
 Because the Microsoft.CrmSdk.CoreAssemblies NuGet package has a [dependency](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies#dependencies-body-tab) on System.Text.Json, you're able to refer to [System.Text.Json](xref:System.Text.Json) types at design time. However, the System.Text.Json.dll file in the sandbox run-time can't be guaranteed to be the same version that you reference in your project. If you need to use `System.Text.Json`, you should use the dependent assembly feature and explicitly include it in your NuGet package.

powerapps-docs/developer/data-platform/build-and-package.md

@@ -33,7 +33,7 @@ There are several different ways to create a custom API:
 |---------|---------|
 |[Plug-in registration tool](create-custom-api-prt.md)|An easy-to-use GUI tool integrated with tools used to develop plug-ins.|
 |[Power Apps](create-custom-api-maker-portal.md)|Using forms to enter data. You don't need to install a separate tool, you must create a separate record for each part of the custom API.|
-|[With Code](create-custom-api-with-code.md)|After you understand the data model, you can create custom API quickly using Postman. Or you can build your own experience to create custom API.|
+|[With Code](create-custom-api-with-code.md)|After you understand the data model, you can create custom API quickly using an API Client like Postman or [Insomnia](webapi/insomnia.md). Or you can build your own experience to create custom API.|
 |[With solution files](create-custom-api-solution.md)|When you use Application Lifecycle Management (ALM) tools, you can create or modify custom API definitions with XML files in a solution that is included in your source code repository. The custom API is created when you import the solution generated from your source code.|
 
 > [!NOTE]
@@ -186,7 +186,7 @@ A custom API creates a new message that can be invoked via the Web API or Datave
 
 ### Invoking custom APIs from the Web API
 
-While testing, you can invoke your API using PostMan. Use the steps described in [Set up a Postman environment](webapi/setup-postman-environment.md) to set up a PostMan environment that generates the access token you need. Then, apply the steps described in [Use Web API actions](webapi/use-web-api-actions.md) if your API is an action. If it's a function, use the steps in [Use Web API functions](webapi/use-web-api-functions.md).
+While testing, you can invoke your API using an API client like Postman or Insomnia. Use the steps described in [Use Insomnia with Dataverse Web API](webapi/insomnia.md) to set up a Insomnia environment that generates the access token you need. Then, apply the steps described in [Use Web API actions](webapi/use-web-api-actions.md) if your API is an action. If it's a function, use the steps in [Use Web API functions](webapi/use-web-api-functions.md).
 
 See the following examples:
 

powerapps-docs/developer/data-platform/custom-api.md

@@ -76,7 +76,7 @@ The JSON results will be returned to your browser like so:
 ```
 
 > [!TIP]
-> This works best if you install a browser plug-in that will format the returned JSON. Or you may want to use Postman. More information: [Use Postman with the Web API](webapi/use-postman-web-api.md)
+> This works best if you install a browser plug-in that will format the returned JSON. Or you may want to use an API client like Postman or [Insomnia](webapi/insomnia.md), or you may want to use [VS Code with PowerShell](webapi/quick-start-ps.md).
 > 
 > You may prefer to use the [XrmToolbox Plugin Trace Viewer](https://www.xrmtoolbox.com/plugins/Cinteros.XrmToolBox.PluginTraceViewer/). This community tool is not supported by Microsoft. If you have questions pertaining to this tool, contact the publisher.
 

powerapps-docs/developer/data-platform/debug-plug-in.md

@@ -1,7 +1,7 @@
 ---
 title: "Discover user organizations (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Your client application may connect to multiple Dataverse environments. Use the Global Discovery Service to find which environments the user of your application can access."
-ms.date: 07/18/2022
+ms.date: 03/14/2024
 ms.reviewer: pehecke
 ms.topic: article
 author: ImadYanni # GitHub ID
@@ -63,41 +63,39 @@ If the calling user has access to no instances, the response simply returns an e
 
 ## Authentication
 
-The calling user must aquire an OAuth 2.0 token from Microsoft Entra ID, and then add that token in the Authorization header of the API calls. More information: [Use OAuth authentication with Microsoft Dataverse](authenticate-oauth.md).
+The calling user must acquire an OAuth 2.0 token from Microsoft Entra ID, and then add that token in the Authorization header of the API calls. More information: [Use OAuth authentication with Microsoft Dataverse](authenticate-oauth.md).
 
 ### CORS support
 
 The Discovery Service supports the CORS standard for cross-origin access. For more information about CORS support see [Use OAuth with Cross-Origin Resource Sharing to connect a Single-Page Application](oauth-cross-origin-resource-sharing-connect-single-page-application.md).
 
-### Use Postman to connect to the Global Discovery Service
+### Use Insomnia to connect to the Global Discovery Service
 
-You can use the same approach described for the Dataverse Web API here: [Set up a Postman environment](webapi/setup-postman-environment.md), but instead of the environment variables described in that topic, use the following to access the commercial cloud.
+You can use the same approach described for the Dataverse Web API here: [Use Insomnia with Dataverse Web API](webapi/insomnia.md), but instead of the environment variables described in that topic, use the following to access the commercial cloud.
+
+```json
+{
+   "cloudUrl": "https://globaldisco.crm.dynamics.com",
+   "globalDiscoUrl": "{{cloudUrl}}/api/discovery/v2.0/",
+   "redirecturl": "https://localhost",
+   "authurl": "https://login.microsoftonline.com/common/oauth2/authorize?resource={{cloudUrl}}",
+   "clientid": "51f81489-12ee-4a9e-aaae-a2591f45987d"
+}
+```
 
-|Variable  |Initial Value  |
-|---------|---------|
-|`cloudUrl`|`https://globaldisco.crm.dynamics.com`|
-|`globalDiscoUrl`|`{{cloudUrl}}/api/discovery/v2.0/`|
-|`clientid`|`51f81489-12ee-4a9e-aaae-a2591f45987d`|
-|`authurl`|`https://login.microsoftonline.com/common/oauth2/authorize?resource={{cloudUrl}}`|
 
-Then, in the Postman **Authorization** tab, set or verify the following values:
+Then, in the **Authorization** tab, choose **OAuth 2** and set or verify the following values:
 
 |Field  |Value  |
 |---------|---------|
-|**Type**|OAuth 2.0|
-|**Add authorization data to** |Request Headers|
-|**Header Prefix**|Bearer|
-|**Grant Type**|Implicit|
-|**Callback URL**|`http://localhost`|
-|**Auth URL**|`{{authurl}}`|
-|**Client ID**|`{{clientid}}`|
-|**Client Authentication**|Send as Basic Auth header|
-
-Use `{{globalDiscoUrl}}` as the **Request URL** and in the **Authorization** tab, click **Get New Access Token**.
+|**GRANT TYPE**|Implicit|
+|**AUTHORIZATION url**|`_.authurl`|
+|**CLIENTID**|`_.clientid`|
+|**REDIRECT URL**|`_.redirecturl`|
 
-You should now be able to query the Global Discovery Service using Postman.
+Use `GET _.globalDiscoUrl` as the **Request URL** and select **Send**.
 
-More information: [YouTube: Get started using Postman with Microsoft Dataverse Web API](https://youtu.be/HpUj11yU0fY)
+You should now be able to query the Global Discovery Service using Insomnia.
 
 ## Service Documents
 

powerapps-docs/developer/data-platform/discovery-service.md

@@ -188,7 +188,7 @@ You can use either the Web API or the Dataverse SDK for .NET to use the `sample_
 
 ### [Web API](#tab/webapi)
 
-To use the `sample_ExportDataUsingFetchXmlToAnnotation` custom API with the Web API, send a `POST` request to the API endpoint. You can use Postman to send this request. More information: [Set up a Postman environment](../../webapi/setup-postman-environment.md)
+To use the `sample_ExportDataUsingFetchXmlToAnnotation` custom API with the Web API, send a `POST` request to the API endpoint. You can use Insomnia to send this request. [Use Insomnia with Dataverse Web API](../../webapi/insomnia.md)
 
  **Request:**
 
@@ -272,7 +272,7 @@ You can use either the Web API or the Dataverse SDK for .NET to use the `sample_
 
 ### [Web API](#tab/webapi)
 
-To use the `sample_CleanupExportedDataAnnotations` custom API with the Web API, send a `POST` request to the API endpoint. You can use Postman to send this request. More information: [Set up a Postman environment](../../webapi/setup-postman-environment.md)
+To use the `sample_CleanupExportedDataAnnotations` custom API with the Web API, send a `POST` request to the API endpoint. You can use Insomnia to send this request. [Use Insomnia with Dataverse Web API](../../webapi/insomnia.md)
 
  **Request:**
 

powerapps-docs/developer/data-platform/org-service/samples/export-data-fetchxml-annotation-custom-api-sample.md

@@ -75,7 +75,7 @@ This custom API is defined with the following data:
 }
 ```
 
-You can use this data to create the custom API using Postman and the Web API by following the example here: [Create a custom API with code](../../create-custom-api-with-code.md).
+You can use this data to create the custom API using [Insomnia and the Web API](../../webapi/insomnia.md) by following the example here: [Create a custom API with code](../../create-custom-api-with-code.md).
 
 For information about the values passed see these topics: [CustomAPI tables](../../custom-api-tables.md)
 

powerapps-docs/developer/data-platform/org-service/samples/issystemadmin-customapi-sample-plugin.md

@@ -82,9 +82,9 @@ There are also two operations you can use to understand whether search is enable
 |`searchstatistics`<br />[searchstatistics Function](xref:Microsoft.Dynamics.CRM.searchstatistics)<br />`/api/search/v2.0/statistics`|Provides organization storage size and document count.<br /> See [Dataverse Search statistics](statistics-status.md#statistics)|
 |`searchstatus`<br />[searchstatus Function](xref:Microsoft.Dynamics.CRM.searchstatus)<br />`/api/search/v2.0/status`|Search status of an Organization.<br /> See [Dataverse Search Status](statistics-status.md#status) |
 
-## Use Postman with Dataverse search
+## Use Insomnia with Dataverse search
 
-If you have used Postman with Dataverse Web API, you know how useful it's to try using the APIs. We have some instructions about setting up a Postman environment to authenticate with the Dataverse Web API here: [Set up a Postman environment](../webapi/setup-postman-environment.md).
+If you have used Insomnia with Dataverse Web API, you know how useful it's to try using the APIs. We have some instructions about setting up a Insomnia environment to authenticate with the Dataverse Web API here: [Use Insomnia with Dataverse Web API](../webapi/insomnia.md)
 
 You can use the same instructions with the search operations using Web API functions and actions. If you want to use the native search 2.0 endpoint, change these two environment variables:
 
@@ -93,33 +93,6 @@ You can use the same instructions with the search operations using Web API funct
 |`version`|`9.2`|`2.0`|
 |`webapiurl`|`{{url}}/api/data/v{{version}}/`|`{{url}}/api/search/v{{version}}/`|
 
-### Extract response JSON with Postman
-
-Each of the search operations returns JSON that has a `response` property. The `response` property is an escaped string that contains JSON data. It's difficult to read this string value, but you can use the [Postman Visualize feature](https://learning.postman.com/docs/sending-requests/visualizer/) to transform this string value into readable JSON.
-
-1. In your Postman request select the **Tests** tab and enter the following script:
-
-   ```javascript
-   let responseString = JSON.stringify(JSON.parse(pm.response.json().response),null,1);
-   
-   template = '<pre>{{response}}</pre>';
-   
-   pm.visualizer.set(template, {
-       response: responseString
-   });
-   ```
-
-1. Execute your request and select the **Visualize** button.
-
-You can now see the unescaped JSON data returned in the `response` property.
-
-:::image type="content" source="../media/postman-query-visualize-script.png" alt-text="Postman query with test script to extract JSON from escaped string":::
-
-More information:
-
-- [Postman Learning Center: Visualizing responses](https://learning.postman.com/docs/sending-requests/visualizer/)
-- [Postman Learning Center: Visualizing responses > Rendering HTML](https://learning.postman.com/docs/sending-requests/visualizer/#rendering-html)
-
 
 ## Detect if search is enabled
 

powerapps-docs/developer/data-platform/search/overview.md

@@ -93,14 +93,8 @@
     href: web-api-metadata-operations-sample.md
   - name: Web API table schema operations sample (C#)
     href: samples/webapiservice-metadata-operations.md
-- name: Use Postman with Web API
-  items:
-  - name: Get started with Postman
-    href: use-postman-web-api.md
-  - name: Setup a Postman environment
-    href: setup-postman-environment.md
-  - name: Use Postman to perform operations
-    href: use-postman-perform-operations.md
+- name: Use Insomnia with Web API
+  href: insomnia.md
 - name: Use PowerShell and Visual Studio Code with Web API
   href: use-ps-and-vscode-web-api.md
 - name: Client-side JavaScript using Web API in model-driven apps

powerapps-docs/developer/data-platform/webapi/TOC.yml

@@ -29,6 +29,6 @@ To learn more, please explore the [Web API Samples (C#)](web-api-samples-csharp.
 
 [Perform operations using the Web API](perform-operations-web-api.md)  
 [Web API Samples (C#)](web-api-samples-csharp.md)  
-[Set up a Postman environment](setup-postman-environment.md)
+[Use Insomnia with Dataverse Web API](insomnia.md)
 
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]