Merge pull request #6464 from MicrosoftDocs/main

Live publish

Author: KumarVivek

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

@@ -408,7 +408,7 @@
       href: isv-app-usage-analytics.md
     - name: Install failures analytics
       href: isv-install-failure-analytics.md
-- name: Create client applications
+- name: Create applications
   href: connect-dataverse.md
   items:
   - name: Authenticate apps and services with Microsoft Dataverse
@@ -420,25 +420,29 @@
       href: authenticate-oauth.md
     - name: Use of Office365 (WS-Trust) authentication
       href: authenticate-office365-deprecation.md
-  - name: "Tutorial: Register an app with Azure Active Directory"
-    href: walkthrough-register-app-azure-active-directory.md
-  - name: "Tutorial: Create an ASP.NET Core Blazor WebAssembly App"
-    href: walkthrough-blazor-webassembly-single-tenant.md
-  - name: Build web applications using Server-to-Server (S2S) authentication
-    href: build-web-applications-server-server-s2s-authentication.md
-    items:
-    - name: Use Multi-Tenant Server-to-server authentication
-      href: use-multi-tenant-server-server-authentication.md
-    - name: Use Single-Tenant Server-to-server authentication
-      href: use-single-tenant-server-server-authentication.md
-  - name: Use OAuth with Cross-Origin Resource Sharing to connect a Single Page Application 
-    href: oauth-cross-origin-resource-sharing-connect-single-page-application.md
-  - name: "Tutorial: Register and configuring a SPA application with adal.js"
-    href: walkthrough-registering-configuring-simplespa-application-adal-js.md
+    - name: Build web applications using Server-to-Server (S2S) authentication
+      href: build-web-applications-server-server-s2s-authentication.md
+      items:
+      - name: Use Multi-Tenant Server-to-server authentication
+        href: use-multi-tenant-server-server-authentication.md
+      - name: Use Single-Tenant Server-to-server authentication
+        href: use-single-tenant-server-server-authentication.md
+    - name: Use OAuth with Cross-Origin Resource Sharing to connect a Single Page Application 
+      href: oauth-cross-origin-resource-sharing-connect-single-page-application.md
   - name: Build Windows client apps using XRM tools
     href: xrm-tooling/
   - name: Discover user organizations
     href: discovery-service.md
+  - name: Tutorials 
+    items:
+    - name: "Tutorial: Register an app with Azure Active Directory"
+      href: walkthrough-register-app-azure-active-directory.md
+    - name: "Tutorial: Create an ASP.NET Core Blazor WebAssembly App"
+      href: walkthrough-blazor-webassembly-single-tenant.md
+    - name: "Tutorial: Register and configuring a SPA application with adal.js"
+      href: walkthrough-registering-configuring-simplespa-application-adal-js.md
+- name: Transition apps to Dataverse ServiceClient
+  href: sdk-client-transition.md
 - name: Best practices
   href: best-practices/index.md
 - name: Online Management API

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

@@ -39,13 +39,13 @@ The following tools are distributed in NuGet packages. The [Developer Guide: Dow
 |Plug-in Registration tool `PluginRegistration.exe`|A tool used to subscribe .NET assembly plug-in classes to data transaction events. <br />More information: <br />[Create a plug-in](apply-business-logic-with-code.md#create-a-plug-in)<br />[Register a plug-in](register-plug-in.md)|
 |SolutionPackager tool `SolutionPackager.exe`|A tool that can reversibly decompose a Dataverse compressed solution file into multiple XML files and other files so that these files can be easily managed by a source control system.<br /> More information: <br />[Team development](/power-platform/alm/team-development-alm)<br />[Use the SolutionPackager tool to compress and extract a solution file](/dynamics365/customer-engagement/developer/compress-extract-solution-file-solutionpackager)|
 
-## .NET SDK Assemblies
+## Dataverse SDK for .NET
 
-The following are assemblies .NET developers can use. The latest versions are available to download in the corresponding NuGet packages.
+The following describes available Dataverse SDK assemblies for .NET code development. The latest versions are available to download in the corresponding NuGet packages.
 
 ### Work with data
 
-Use these assemblies to interact with the Organization service and Discovery services.
+Use these assemblies to interact with the Organization service and Discovery service.
 
 More information: [Use the Dataverse Organization service](/dynamics365/customer-engagement/developer/use-microsoft-dynamics-365-organization-service)
 

powerapps-docs/developer/data-platform/sdk-client-transition.md

@@ -0,0 +1,97 @@
+---
+title: "Transition client applications to Dataverse ServiceClient | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "Learn about the benefits of and the changes needed to transitions your client application to use Dataverse ServiceClient class for web service connections." # 115-145 characters including spaces. This abstract displays in the search result.
+ms.custom: ""
+ms.date: 06/01/2022
+ms.reviewer: "pehecke"
+ms.topic: "article"
+author: "phecke" # GitHub ID
+ms.service: powerapps
+ms.subservice: dataverse-developer
+ms.author: "pehecke" # MSFT alias of Microsoft employees only
+manager: "kvivek" # MSFT alias of manager or PM counterpart
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+
+# Transition apps to Dataverse ServiceClient
+
+We are transitioning from [Microsoft Dataverse SDK for .NET](developer-tools.md#dataverse-sdk-for-net) to include a new web service client that uses MSAL for authentication. This article contains the information you need to understand why we are making these changes, what is impacted, and how to update your client applications so they continue to function as expected.
+
+> [!NOTE]
+> All our existing developer documentation and sample code use the Dataverse SDK APIs found in the [CoreAssemblies](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) NuGet package. Only this article that you are reading describes the newer [Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) NuGet package and the changes required to make use of it. More documentation and sample code updates are coming.
+
+## Why the change?
+
+There are quite a few good reasons for the changes to the Dataverse SDK for .NET. A few are called out below.
+
+### Cross-platform application support
+
+The new Dataverse [ServiceClient](xref:Microsoft.PowerPlatform.Dataverse.Client.ServiceClient) class supports .NET Core development. Navigate to [Microsoft.PowerPlatform.Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) and select the **Frameworks** tab to see what build targets are supported.
+
+### MSAL authentication
+
+Microsoft Azure Active Directory Authentication Library (ADAL) support ends soon. Microsoft Authentication Library (MSAL) is the recommended authentication API going forward. Our new [ServiceClient](xref:Microsoft.PowerPlatform.Dataverse.Client.ServiceClient) API use MSAL while our older [CrmServiceClient](xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient) API uses ADAL.
+
+### Performance and functional benefits
+
+The Dataverse `ServiceClient` class supports a smaller interface surface, inline authentication by instance, and `ILogger`. As for inline authentication, you can pass a custom authentication handler function to the `ServiceClient` constructor. In this way you can have one authentication handler per web service connection instead of just one per process.
+
+## What is impacted?
+
+Below is a quick summary of the impact to certain types of coding projects.
+
+- Plug-ins or custom workflow activities - no changes, just business as usual
+
+- New or existing online applications - this article is definitely for you
+
+- On-premise applications - this article is not for you, yet
+
+## What do you need to do?
+
+The good news is that the class member signatures of `ServiceClient` and `CrmServiceClient` are the same, except for the class names themselves being slightly different. Application code should not need any significant changes.
+
+### .NET Framework based (online) application projects
+
+To update your application projects, follow these steps.
+
+1. Remove the older [CoreAssemblies](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) (and related) NuGet packages from your project.
+1. Add the newer [Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) NuGet package to your project.
+1. Change every mention of the [CrmServiceClient](xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient) class to [ServiceClient](xref:Microsoft.PowerPlatform.Dataverse.Client.ServiceClient) in your code.
+1. Fix any namespace mismatch as the new `ServiceClient` class is now in the `Microsoft.PowerPlatform.Dataverse.Client` namespace.
+
+### .NET Core based (online) projects
+
+Simply add the [Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) NuGet package to your projects, add code to call the Dataverse SDK APIs, and build.
+
+### Plug-ins or custom workflow activities
+
+Nothing really for you to do here. Continue using the [Microsoft.CrmSdk.CoreAssemblies](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) (and related) NuGet packages with .NET Framework 4.6.2.
+
+### On-premise clients
+
+Leave your application projects and code as is. Continue using the Microsoft.CrmSdk.CoreAssemblies NuGet package and `CrmServiceClient`class. However, plan to update your projects from using any custom service clients to instead use the `CrmServiceClient` or `ServiceClient` in the near future. See the planned [timeline](#timeline) for 2011 SOAP endpoint shutdown below.
+
+> [!NOTE]
+> If you are using custom authentication with `CrmServiceClient`, you can continue to use your custom authentication code with `ServiceClient`.
+
+## Timeline
+
+The following table lists some important dates to keep in mind.
+
+| Timeframe | Event |
+| --- | --- |
+|June 2022|GA release of the [Microsoft.PowerPlatform.Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client/) NuGet package|
+|Fall 2022|Planned shutdown of the 2011 SOAP endpoint for access by client applications not using our service clients (`CrmServiceClient` or `ServiceClient`)|
+|December 2022|Microsoft support for ADAL ends|
+
+### See also
+
+[ServiceClient code samples](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23-NETCore/ServiceClient)  
+[Overview of the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview)  
+[Migrate applications to the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-migration)  
+
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/maker/TOC.yml

@@ -1208,7 +1208,7 @@
           href: ./canvas-apps/map-component-input-fields.md
         - name: Add multimedia to a component
           href: ./canvas-apps/component-multimedia.md
-        - name: Behavior formulas
+        - name: Behavior formulas (experimental)
           href: ./canvas-apps/component-behavior.md
   - name: Performance and optimization
     items:

powerapps-docs/maker/canvas-apps/app-from-image.md

@@ -4,7 +4,7 @@ description: Learn about how to use your own designs saved in image formats and
 author: norliu
 ms.topic: article
 ms.custom: canvas
-ms.date: 05/24/2022
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: norliu
 ms.reviewer: tapanm
@@ -32,6 +32,7 @@ With the **Image to app** feature, you can now create an app from a visual desig
 > [!NOTE]
 > - The styling of the components in the app, such as fonts and colors, will be based on the **Office Blue** theme in Power Apps.
 > - If you want the exact design styles to be preserved when you create your app, consider creating a [canvas app from Figma](figma/overview.md).
+> - Power Apps doesn't persist the image that you upload. The uploaded image is only processed in-memory to generate the app.
 
 ## Prerequisites
 
@@ -57,7 +58,7 @@ With the **Image to app** feature, you can now create an app from a visual desig
 1. Upload your own image. If you don't have an image ready, you can also use one of the available sample images.
 
     > [!NOTE]
-    > When using your own image, ensure the image meets the image requirements mentioned in the prerequisites.
+    > When using your own image, ensure the image meets the image requirements mentioned in [Image requirements](#image-requirements).
 
     For example, here are two sample images with acceptable and unacceptable qualities:
 
@@ -129,11 +130,19 @@ With the **Image to app** feature, you can now create an app from a visual desig
 
 1. [Save and publish](save-publish-app.md) the app.
 
+## Image requirements
+
+- The image you want to upload must have the file extension of .jpg or .png. If you have a design image with another file extension, save the image file with .jpg or .png file extension in order to use it with this feature.
+- Image size must be less than 4 MB.
+- If you're using screenshots or digital sketches, alter the background to light, pure-color if white is not available.
+- If you're taking a picture, use higher contrast or make it brighter. Make sure the part you want to tag is clear and bright.
+- If you're taking a picture using a camera or phone, use higher contrast to favor light backgrounds. You can use any available photo editing apps to edit the picture contrast.
+- If you're using hand-drawn images, try to use **white** sketch pad without any lines on it.
+
 ## Limitations
 
 - Supported components: [Button](controls/control-button.md), [Check box](controls/control-check-box.md), [Data cards](working-with-cards.md), [Date picker](controls/control-date-picker.md), [Drop down](controls/control-drop-down.md), [Edit form](controls/control-form-detail.md), [Label](controls/control-text-box.md), [Radio](controls/control-radio.md), [Rating](controls/control-rating.md), [Slider](controls/control-slider.md), [Text input](controls/control-text-input.md), [Toggle](controls/control-toggle.md)
 - Only canvas apps are supported.
-- Only images with the file extension of .jpg or .png are supported. If you have a design image with another file extension, save the image file with .jpg or .png file extension in order to use it with this feature.
 - You can upload only one image at a time to create an app.
 - Complex forms, forms with colored backgrounds, multi-page forms, and forms with underlined input boxes aren't supported.
 - Support for styles is limited. The styling of the components in the app, such as fonts and colors will be based on the **Office Blue** theme in Power Apps.

powerapps-docs/maker/canvas-apps/component-behavior.md

@@ -1,5 +1,5 @@
 ---
-title: Behavior formulas for components
+title: Behavior formulas for components (experimental)
 description: Do one or more tasks in canvas app when a component-based action occurs.
 author: hemantgaur
 ms.subservice: canvas-developer
@@ -16,12 +16,20 @@ contributors:
   - tapanm-msft
 ---
 
-# Behavior formulas for components
+# Behavior formulas for components (experimental)
 
-Specify one or more [behavior formulas](working-with-formulas-in-depth.md) that run when an event triggers a change in component instances. 
+[This article is pre-release documentation and is subject to change.]
+
+> [!IMPORTANT]
+> This is an experimental feature. For more information, see [Experimental and preview features](working-with-experimental-preview.md).
+
+Specify one or more [behavior formulas](working-with-formulas-in-depth.md) that run when an event triggers a change in component instances.
 
 For example, set a component's **OnReset** property to one or more formulas that do initialization and clear input. Reset values when the **Reset** function runs on the component instances.
 
+> [!NOTE]
+> The feature to create custom behavioral properties is currently experimental. However, you can use the default **OnReset** property that is available on all components in your production environment.
+
 ## OnReset
 
 With a component master selected, select **OnReset** in the drop-down list of properties (on the left side of the formula bar), and then enter one or more formulas.