Merge branch 'main' into 2920661

Author: nickdoelman

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

@@ -73,6 +73,9 @@ Audit history data is stored in the [Auditing (Audit) table](../reference/entiti
 
 More information: [Retrieve the history of audited data change](retrieve-audit-data.md)
 
+> [!IMPORTANT]
+> Audit history is not available for tables in the mobile app.
+
 ## Delete audit data
 
 You may need to delete audit data because:
@@ -100,4 +103,4 @@ More information: [Delete audit data](delete-audit-data.md)
 [Retrieve the history of audited data changes](retrieve-audit-data.md)<br />
 [Delete audit data](delete-audit-data.md)
 
-[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/data-platform/dataverse-odata-dataflows-migration.md

@@ -1,19 +1,23 @@
 ---
 title: Migrate data between Microsoft Dataverse environments using the dataflows OData connector
 author: denisem-msft
-ms.reviewer: "nabuthuk"
+ms.reviewer: jdaly
 description: Migrate data between Microsoft Dataverse environments using dataflows OData connector.
-ms.date: 11/24/2021
-ms.topic: "article"
+ms.date: 10/03/2022
+ms.topic: article
 ms.subservice: dataverse-developer
 ms.author: demora
 search.app: 
   - PowerApps
+contributors:
+ - JimDaly
 ---
 
 # Migrate data between Microsoft Dataverse environments using the dataflows OData connector
 
-
+> [!NOTE]
+> Consider using the [Power Query Dataverse Connector](/power-query/connectors/dataverse) with Dataflows rather than the OData connector. 
+> Dataflows are the recommended method to migrate data between Dataverse environments. More information [What are dataflows?](/power-query/dataflows/overview-dataflows-across-power-platform-dynamics-365)
 
 Dataverse [Web API](./webapi/overview.md) works with any technology that supports OData and OAuth. There are many options available to move data in and out of Dataverse. OData connector is one of the dataflows, which is designed to support migration and synchronization of large datasets in Dataverse. 
 

powerapps-docs/developer/data-platform/dependent-assembly-plugins.md

@@ -347,6 +347,10 @@ More information:
 
 The following are known issues that should be resolved before dependent assemblies for plug-ins becomes generally available.
 
+### Asynchronous plug-in steps do not work
+
+If you use dependent assemblies for a plug-in registered for an asynchronous step an error with the message `Expected non-empty Guid.` will occur.
+
 ### Plug-in profiler
 
 You cannot use Plug-in Profiler to debug plug-ins that are part of a plug-in package. More information: [Use Plug-in profiler](debug-plug-in.md#use-plug-in-profiler)

powerapps-docs/developer/data-platform/developer-tools.md

@@ -24,7 +24,7 @@ Developers will use the following tools and resources when working with solution
 
 *Power Platform Tools for Visual Studio* - supports the rapid creation, debugging, and deployment of plug-ins. Other capabilities currently in preview include development of custom workflow activities, web resources, integration technologies like Azure Service endpoints and webhooks, and more. To learn more about the tool, install the [extension](tools/devtools-install.md) and try the available [quickstart](tools/devtools-create-project.md) topics.
 
-*Microsoft Power Platform CLI* - a simple, one-stop developer CLI that empowers developers and ISVs to perform various operations in Microsoft Power Platform related to environment lifecycle features, and to authenticate and work with Microsoft Dataverse environments, solution packages, portals, code components, and so on. To learn more about the tool, install the [extension](powerapps-cli.md#install-microsoft-power-platform-cli) or try the available [standalone](powerapps-cli.md#standalone-power-platform-cli) version.
+*Microsoft Power Platform CLI* - a simple, one-stop developer CLI that empowers developers and ISVs to perform various operations in Microsoft Power Platform related to environment lifecycle features, and to authenticate and work with Microsoft Dataverse environments, solution packages, portals, code components, and so on. To learn more about the tool, see [What is Microsoft Power Platform CLI?](powerapps-cli.md).
 
 ## Tools available for download from NuGet
 

powerapps-docs/developer/data-platform/media/quick-start-org-service-console-app-1.png

@@ -4,7 +4,7 @@
   href: overview.md
 - name: Get started
   items:
-  - name: 'Quickstart: Create a console app'
+  - name: 'Quickstart: Execute service request'
     href: quick-start-org-service-console-app.md
   - name: Late and Early-bound programming
     href: early-bound-programming.md

powerapps-docs/developer/data-platform/media/quick-start-org-service-console-app-2.png

@@ -1,8 +1,8 @@
 ---
 title: "IOrganizationService Interface (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
-description: "Learn about the common methods exposed to perform data operations with Microsoft Dataverse." # 115-145 characters including spaces. This abstract displays in the search result.
+description: "Learn about the common web service methods exposed to perform data operations in Microsoft Dataverse." # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: intro-internal
-ms.date: 03/22/2022
+ms.date: 09/30/2022
 ms.reviewer: "pehecke"
 ms.topic: "article"
 author: "divka78" # GitHub ID
@@ -14,32 +14,28 @@ search.app:
   - PowerApps
   - D365CE
 contributors:
-  - PHecke
+  - phecke
   - JimDaly
 ---
 
 # IOrganizationService Interface
 
 [!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
 
-The <xref:Microsoft.Xrm.Sdk.IOrganizationService> interface provides a set of methods used to perform the most common operations on system and custom tables and on the table definitions for your organization.
+The <xref:Microsoft.Xrm.Sdk.IOrganizationService> interface exposes methods used to perform web service operations on system and custom tables and on the table definitions (metadata) for your environment.
 
 ## Client applications
 
-This interface is implemented in a number of classes that you can use in your code when creating client applications.
+This interface is implemented by a couple of classes that you can use in your code when creating client applications.
 
 |Class|Description|
 |--|--|
-|<xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceProxy>|This is the original low-level class which is used by WCF and the Organization service endpoint |
-|<xref:Microsoft.Xrm.Sdk.WebServiceClient.OrganizationWebProxyClient>|This low-level class was created to enable OAuth authentication to the Organization service endpoint|
-|<xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient>|This is the class you should use when creating .NET client applications. |
-
-> [!NOTE]
-> You may find older code or samples using the low-level <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceProxy> or <xref:Microsoft.Xrm.Sdk.WebServiceClient.OrganizationWebProxyClient> classes, but we recommend you use <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> for new .NET Client applications
+|<xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient>|This is the class you should use when creating .NET Framework client applications. |
+|<xref:Microsoft.PowerPlatform.Dataverse.Client.ServiceClient>|This is the class you should use when creating .NET Framework or .NET Core client applications. |
 
 ## Plug-ins
 
-When you write plug-ins, there is also an object returned from the <xref:Microsoft.Xrm.Sdk.IOrganizationServiceFactory>.<xref:Microsoft.Xrm.Sdk.IOrganizationServiceFactory.CreateOrganizationService(System.Nullable{System.Guid})> which implements the <xref:Microsoft.Xrm.Sdk.IOrganizationService> interface but is not any of the types in the classes above.
+When you write plug-ins, there is also an object returned from the <xref:Microsoft.Xrm.Sdk.IOrganizationServiceFactory>.<xref:Microsoft.Xrm.Sdk.IOrganizationServiceFactory.CreateOrganizationService(System.Nullable{System.Guid})> which implements the <xref:Microsoft.Xrm.Sdk.IOrganizationService> interface but is not any of the types in the service client classes above.
 
 ## IOrganizationService Methods
 

powerapps-docs/developer/data-platform/media/quick-start-org-service-console-app-3.png

@@ -1,11 +1,11 @@
 ---
-title: "Quickstart: Organization service sample (C#) (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
-description: "This quickstart will show you how to connect to the organization service of the Microsoft Dataverse" # 115-145 characters including spaces. This abstract displays in the search result.
-ms.date: 04/03/2022
-author: JimDaly
-ms.author: jdaly
+title: "Quickstart: Execute an Organization service request (C#) (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "Demonstrates how to connect to the Organization service of Microsoft Dataverse and execute a request." # 115-145 characters including spaces. This abstract displays in the search result.
+ms.date: 10/05/2022
+author: phecke
+ms.author: pehecke
 manager: kvivek
-ms.reviewer: pehecke
+ms.reviewer: jdaly
 ms.topic: "article"
 search.audienceType: 
   - developer
@@ -16,129 +16,122 @@ contributors:
  - JimDaly
  - phecke
 ---
-# Quickstart: Organization service sample (C#)
 
-[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
+# Quickstart: Execute an Organization service request (C#)
 
-This is where you begin working with the .NET SDK assemblies to work with data using Microsoft Dataverse.
+[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
 
-In this quickstart, you will create a minimum console application to connect to the Organization service using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> class. You will pass  your connection information using a connection string passed to the constructor.
+This topic shows you how to begin using classes in the SDK for .NET assemblies to work with Microsoft Dataverse business data. You will create a minimal console application to connect to your environment's Organization service using the <xref:Microsoft.PowerPlatform.Dataverse.Client.ServiceClient> class and execute a web service operation.
 
-You will use the <xref:Microsoft.Xrm.Sdk.IOrganizationService>.<xref:Microsoft.Xrm.Sdk.IOrganizationService.Execute*> method passing an instance of the <xref:Microsoft.Crm.Sdk.Messages.WhoAmIRequest> class, and you will display the <xref:Microsoft.Crm.Sdk.Messages.WhoAmIResponse>.<xref:Microsoft.Crm.Sdk.Messages.WhoAmIResponse.UserId> value.
+Your application will call the <xref:Microsoft.Xrm.Sdk.IOrganizationService>.<xref:Microsoft.Xrm.Sdk.IOrganizationService.Execute*> method passing an instance of the <xref:Microsoft.Crm.Sdk.Messages.WhoAmIRequest> class. The result returned from the web service is a populated <xref:Microsoft.Crm.Sdk.Messages.WhoAmIResponse>.<xref:Microsoft.Crm.Sdk.Messages.WhoAmIResponse.UserId> value which is the unique identifier of your Dataverse system user account.
 
 > [!NOTE]
-> This quickstart example does not include error handling. This is a minimum example of what you need to connect to and use the Organization service.
+> This quick start example does not include exception handling for brevity. This is a minimum code example of what you need to connect to and use the Organization service.
 
+You can download the complete code sample from GitHub [quickstart-execute-request](https://github.com/microsoft/PowerApps-Samples/blob/master/dataverse/orgsvc/C%23-NETCore/GetStarted/quickstart-execute-request/).
 
 ## Prerequisites
 
- - Visual Studio (2019 recommended)
+ - Visual Studio (2019 or later)
  - Internet connection
- - Valid user account for a Dataverse instance
-    - Your username
-    - Your password
- - Url to the Dataverse environment you want to connect with
+ - Logon credentials of a Dataverse system user account for the target environment
+ - URL address of the Dataverse environment you want to connect with
  - Basic understanding of the Visual C# language
 
 ## Create Visual Studio project
 
-1. Create a new Console App (.NET Framework) project using .NET Framework 4.6.2
+1. Create a new .NET console app project. For this project we are using Visual Studio 2022 and targeting .NET 6, but .NET Framework will also work.
 
     ![Start a console app project.](../media/quick-start-org-service-console-app-1.png)
 
-    > [!NOTE]
-    > This screenshot shows the name `OrgServiceQuickStart`, but you can choose to name the project and solution whatever you want. 
-
 1. In **Solution Explorer**, right-click the project you created and select **Manage NuGet Packages...** in the context menu.
 
     ![Add NuGet package.](../media/quick-start-org-service-console-app-2.png)
 
-1. Browse for the latest version of the  `Microsoft.CrmSdk.XrmTooling.CoreAssembly` NuGet package and install it.
+1. Browse for the latest version of the  `Microsoft.PowerPlatform.Dataverse.Client` NuGet package and install it.
 
-    ![Install Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet package.](../media/quick-start-org-service-console-app-3.png)
+    ![Install Microsoft.PowerPlatform.Dataverse.Client NuGet package.](../media/quick-start-org-service-console-app-3.png)
 
 > [!NOTE]
-> You must select **I Accept** in the **Licence Acceptance** dialog.
+> Your will be prompted to OK the preview changes, and then select **I Accept** in the **Licence Acceptance** dialog.
 
-## Edit Program.cs
+## Add application code
 
-1. Add these using statements to the top of `Program.cs`
+1. In **Solution Explorer**, double-click Program.cs to edit that file. Replace the file's contents with the code shown below.
 
     ```csharp
     using Microsoft.Crm.Sdk.Messages;
-    using Microsoft.Xrm.Tooling.Connector;
-    ```
-
-1. Replace the `Main` method with the following code. The supported values for *AuthType* are listed in [Connection string parameters](../xrm-tooling/use-connection-strings-xrm-tooling-connect.md).
-
-    ```csharp
-    static void Main(string[] args)
-    {            
-        // e.g. https://yourorg.crm.dynamics.com
-        string url = "<your environment url>";
-        // e.g. [email protected]
-        string userName = "<your user name>";
-        // e.g. y0urp455w0rd 
-        string password = "<your password>";
-
-        string conn = $@"
-        Url = {url};
+    using Microsoft.PowerPlatform.Dataverse.Client;
+
+    class Program
+    {
+        // TODO Enter your Dataverse environment's URL and logon info.
+        static string url = "https://yourorg.crm.dynamics.com";
+        static string userName = "[email protected]";
+        static string password = "password";
+
+        // This service connection string uses the info provided above.
+        // The AppId and RedirectUri are provided for sample code testing.
+        static string connectionString = $@"
         AuthType = OAuth;
+        Url = {url};
         UserName = {userName};
         Password = {password};
         AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
         RedirectUri = app://58145B91-0C36-4500-8554-080854F2AC97;
         LoginPrompt=Auto;
         RequireNewInstance = True";
 
-        using (var svc = new CrmServiceClient(conn))
+        static void Main(string[] args)
         {
-
-            WhoAmIRequest request = new WhoAmIRequest();
-
-            WhoAmIResponse response = (WhoAmIResponse)svc.Execute(request);
-
-            Console.WriteLine("Your UserId is {0}", response.UserId);
-
+            using (ServiceClient serviceClient = new(connectionString))
+            {
+                if (serviceClient.IsReady)
+                {
+                    WhoAmIResponse response = 
+                        (WhoAmIResponse)serviceClient.Execute(new WhoAmIRequest());
+
+                    Console.WriteLine("User ID is {0}.", response.UserId);
+                }
+                else
+                {
+                    Console.WriteLine(
+                        "A web service connection was not established.");
+                }
+            }
+
+            // Pause the console so it does not close.
             Console.WriteLine("Press any key to exit.");
             Console.ReadLine();
         }
     }
     ```
 
-1. Edit the following values to add information for your environment. You can find your environment URL in the Web application under **Settings > Customization > Developer Resources**.
+1. Change the values for the environment URL, username, and password as indicated by the TODO code comment.
 
-    ```csharp
-    // e.g. https://yourorg.crm.dynamics.com
-    string url = "<your environment url>";
-    // e.g. [email protected]
-    string userName = "<your user name>";
-    // e.g. y0urp455w0rd
-    string password = "<your password>";
-    ```
+    > [!NOTE]
+    > You can find supported values for *AuthType* listed in [Connection string parameters](../xrm-tooling/use-connection-strings-xrm-tooling-connect.md#connection-string-parameters). You can find your environment URL in the legacy web application under **Settings > Customization > Developer Resources** or in Power Apps **Settings** (gear icon) > **Developer Resources**.
+    >
+    > While this code sample places the username/password information in the code for simplicity, other code samples will use the more recommended approach of prompting for that information or storing it in a separate App.config or appsettings.json file.
 
 ## Run the program
 
-1. Press F5 to run the program. The output should look like this:
+1. Press F5 to run the program. The output should look something like this:
 
     ```bash
-    Your UserId is 969effb0-98ae-478c-b547-53a2968c2e75
+    User ID is 969effb0-98ae-478c-b547-53a2968c2e75
     Press any key to exit.
     ```
 
-### Congratulations!
-
-You have successfully connected to the organization service.
-
 ## Next Steps
 
-These articles will explain how to work with Dataverse tables:
+The console app demonstrates how to connect to the Organization web service using a connection string, execute a web service message request, and access some data in the response. Next, you may want to look at common web service data operations like create, retrieve, update, and delete.
 
-[Entity class operations using the Organization service](entity-operations.md)<br />
-[Create table rows using the Organization Service](entity-operations-create.md)<br />
-[Retrieve a table row using the Organization Service](entity-operations-retrieve.md)<br />
+The following articles will explain how to work with business data in Dataverse tables.  
+[Entity class operations using the Organization service](entity-operations.md)  
+[Create table rows using the Organization Service](entity-operations-create.md)  
+[Retrieve a table row using the Organization Service](entity-operations-retrieve.md)  
 [Update and delete table rows using the Organization Service](entity-operations-update-delete.md)<br />
 [Associate and disassociate table rows using the Organization Service](entity-operations-associate-disassociate.md)
 
-
-[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../../includes/footer-banner.md)]