Merge branch 'main' into patch-15

Author: JimDaly

.openpublishing.redirection.json

@@ -1,5 +1,55 @@
 {
   "redirections": [
+    {
+      "source_path": "powerapps-docs/developer/data-platform/walkthrough-registering-configuring-simplespa-application-adal-js.md",
+      "redirect_url": "quick-start-register-configure-simplespa-application-msal-js",
+      "redirect_document_id": false
+    }, 
+    {
+      "source_path": "powerapps-docs/maker/data-platform/azure-synapse-link-copy-sql.md",
+      "redirect_url": "azure-synapse-link-pipelines",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice.md",
+      "redirect_url": "webapiservice",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice-basic-operations.md",
+      "redirect_url": "webapiservice-basic-operations",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice-query-data.md",
+      "redirect_url": "webapiservice-query-data",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice-conditional-operations.md",
+      "redirect_url": "webapiservice-conditional-operations",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/functions-actions-csharp.md",
+      "redirect_url": "webapiservice-functions-and-actions",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice-parallel-operations.md",
+      "redirect_url": "webapiservice-parallel-operations",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice-async-parallel-operations.md",
+      "redirect_url": "webapiservice-tpl-dataflow-parallel-operations",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/org-service/web-service-error-codes.md",
+      "redirect_url": "../reference/web-service-error-codes",
+      "redirect_document_id": false
+    },
     {
       "source_path": "powerapps-docs/developer/data-platform/webapi/web-api-aaduser-samples.md",
       "redirect_url": "../aaduser-entity#aaduser-table-web-api-examples",
@@ -3476,8 +3526,8 @@
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api.md",
-      "redirect_url": "../data-platform/online-management-api",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
@@ -3951,33 +4001,33 @@
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/authentication.md",
-      "redirect_url": "../../data-platform/online-management-api/authentication",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/authentication.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/get-started-online-management-api.md",
-      "redirect_url": "../../data-platform/online-management-api/get-started-online-management-api",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/get-started-online-management-api.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/operations-supported.md",
-      "redirect_url": "../../data-platform/online-management-api/operations-supported",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/operations-supported.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/overview.md",
-      "redirect_url": "../../data-platform/online-management-api/overview",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/overview.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/sample-authentication-helper.md",
-      "redirect_url": "../../data-platform/online-management-api/sample-authentication-helper",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/sample-authentication-helper.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
-      "source_path": "powerapps-docs/developer/common-data-service/online-management-api/sample-quick-start.md",
-      "redirect_url": "../../data-platform/online-management-api/sample-quick-start",
+      "source_path": "powerapps-docs/developer/data-platform/online-management-api/sample-quick-start.md",
+      "redirect_url": "/power-platform/admin/programmability-extensibility-overview#available-tools",
       "redirect_document_id": false
     },
     {
@@ -7164,6 +7214,6 @@
       "source_path": "powerapps-docs/user/customize-insert-email-template.md",
       "redirect_url": "/dynamics365/customer-service/customize-insert-email-template",
       "redirect_document_id": "false"
-    }    
+    }
   ]
-}
+}

README.md

@@ -1,10 +1,10 @@
 # Microsoft Power Apps Documentation
 
-This is the GitHub repository for the technical product documentation for **Power Apps**. This documentation is published to  [https://docs.microsoft.com/powerapps](https://docs.microsoft.com/powerapps).
+This is the GitHub repository for the technical product documentation for **Power Apps**. This documentation is published at [Microsoft Power Apps documentation](https://docs.microsoft.com/powerapps).
 
 ## How to contribute
 
-Thanks for your interest in contributing to [docs.microsoft.com](https://docs.microsoft.com/), home of technical content for Microsoft products and services.
+Thanks for your interest in [contributing](https://docs.microsoft.com/), home of technical content for Microsoft products and services.
 
 To learn how to make contributions to the content in this repository, start with our [Docs contributor guide](https://docs.microsoft.com/contribute). If you are a Microsoft employee, please visit the [internal version](https://aka.ms/contributors-guide) of this guide (only accessible to Microsoft employees).
 

powerapps-docs/developer/component-framework/community-resources.md

@@ -3,7 +3,6 @@ title: Community resources (Power Apps Component Framework) | Microsoft Docs
 description: Access to community resources
 ms.author: noazarur
 author: noazarur-microsoft
-manager: lwelicki
 ms.date: 05/27/2022
 ms.reviewer: jdaly
 ms.topic: article
@@ -60,7 +59,7 @@ The following is the list of blogs created by Power Apps community.
 - [Add style to code component in Power Apps component framework](https://nishantrana.me/2019/06/06/how-to-add-style-to-custom-component-in-powerapps-component-framework/)
 - [Beyond the Power Apps component framework](https://www.itaintboring.com/dynamics-crm/beyond-the-powerapps-component-framework)
 - [Beyond the citizen developer: Why pros see promise in Microsoft's Power Apps component framework](https://msdynamicsworld.com/story/beyond-citizen-developer-why-pros-see-promise-microsofts-powerapps-component-framework)
-- [Create code components](https://debajmecrm.com/2019/04/26/in-depth-end-end-walkthrough-develop-your-custom-controls-using-power-apps-component-framework-and-use-it-on-your-crm-interface/)
+- [Create code components](https://debajmecrm.com/create-pcf-control-step-by-step/)
 - [Dianamics Lady (Multiple topics)](https://dianabirkelbach.wordpress.com/category/pcf/)
 - [Editing the DOM with supported code components](https://www.magnetismsolutions.com/blog/adammurchison/2019/05/29/editing-the-dom-with-supported-dynamics-365-custom-controls)
 - [How to configure Node.js and Typescript into your environment](https://capuanodanilo.com/2019/06/11/how-to-configure-node-js-and-typescript-into-your-environment-to-develop-powerapps-component-frameworks-pcf)

powerapps-docs/developer/component-framework/component-framework-for-canvas-apps.md

@@ -46,13 +46,13 @@ To add code components to an app, you need to enable the Power Apps component fr
 
 3. On the left pane, select **Environments**, select the environment where you want to enable this feature, and then select **Settings**.
 
-4. On the **Products** tab, select **Features**.
+4. Expand **Product**, and select **Features**.   
+
+5. From the list of available features, turn on **Power Apps component framework for canvas apps**, and then select **Save**.
 
    > [!div class="mx-imgBorder"]
    > ![Enable Power Apps component framework.](media/enable-pcf-feature.png "Enable Power Apps component framework")
 
-5. From the list of available features, turn on **Power Apps component framework for canvas apps**, and then select **Save**.
-
 ## Implementing code components
 
 After you enable the Power Apps component framework feature in your environment, you can start implementing the logic for code components. For a step-by-step tutorial, go to [Create your first code component](implementing-controls-using-typescript.md).

powerapps-docs/developer/component-framework/customize-editable-grid-control.md

@@ -89,6 +89,16 @@ The template control is included in the [PowerApps-Samples](https://github.com/m
 1. Test your customizer by opening the main grid for the customized entity.
 1. Repeat steps 6-11 for any other entities whose grid needs a grid customizer control.
 
+## Best practices
+
+- Cell renderers and editors are user interface components. Do not use them to mutate data or metadata of the grid.
+- The customizer controls should be lightweight and fast so as to not affect overall grid performance.
+- To maintain the design consistency, follow [Fluent design principals](https://www.microsoft.com/design/fluent/#/) and use [Fluent controls](https://developer.microsoft.com/en-us/fluentui#/controls/web) in your customizers.
+- Make sure your custom renderer or editor is accessible.
+- The customizer function should be pure since the grid will call it multiple times to get customized elements and will expect the return value to be consistent.
+- The grid may dispose a customizer element at any time and call to get a new one at any time. Make sure to dispose of any internal state on unmount to prevent memory leaks.
+- Do not use renderers to override the values in the grid since the new values will not be used by the server to do filtering or sorting.
+
 ## Example
 
 You can find an example of a customized editable grid control here: [Customized editable grid](sample-controls/customized-editable-grid-control.md).
@@ -100,4 +110,4 @@ You can find an example of a customized editable grid control here: [Customized
 [Learn Power Apps component framework](/learn/paths/use-power-apps-component-framework)
 
 
-[!INCLUDE [footer-banner](../../includes/footer-banner.md)]
+[!INCLUDE [footer-banner](../../includes/footer-banner.md)]

powerapps-docs/developer/component-framework/faq.yml

@@ -1,6 +1,6 @@
 ### YamlMime:FAQ
 metadata:
-  title: Power App component framework FAQs
+  title: Power Apps component framework FAQs
   description: Get answers to frequently asked questions about Power Apps component framework.
   author: ghurlman
 

powerapps-docs/developer/component-framework/implementing-controls-using-typescript.md

@@ -3,7 +3,6 @@ title: "Create your first component using Power Apps Component Framework in Micr
 description: "Learn how to implement code components using Power Apps component framework"
 ms.author: noazarur
 author: noazarur-microsoft
-manager: lwelicki
 ms.date: 05/27/2022
 ms.reviewer: jdaly
 ms.topic: article
@@ -412,7 +411,7 @@ To add the code component to a portal, follow the steps in the article [Use code
 [Download sample components](https://github.com/microsoft/PowerApps-Samples/tree/master/component-framework)<br/>
 [Learn Power Apps component framework](/learn/paths/use-power-apps-component-framework)<br/>
 [Update existing Power Apps component framework components](updating-existing-controls.md)<br/>
-[Microsoft Power Platform Build Tools](/powerapps/developer/data-platform/build-tools-overview)<br/>
+[Overview of tools and apps used with ALM](/power-platform/alm/tools-apps-used-alm)<br/>
 [Power Apps component framework API reference](reference/index.md)<br/>
 [Power Apps component framework overview](overview.md)<br/>
 [Debug code components](debugging-custom-controls.md)

powerapps-docs/developer/component-framework/reference/ImageObject.md

@@ -0,0 +1,63 @@
+---
+title: ImageObject | Microsoft Docs
+description: Provides access to all the properties of an image.
+ms.author: noazarur
+author: noazarur-microsoft
+ms.date: 08/31/2022
+ms.reviewer: jdaly
+ms.topic: reference
+ms.subservice: pcf
+contributors:
+  - JimDaly
+---
+
+# ImageObject
+
+[!INCLUDE [imageobject-description](includes/imageobject-description.md)]
+
+## Available for
+
+Canvas apps
+
+## Properties
+
+### fileContent
+
+Contents of the file.
+
+**Type**: `string`
+
+### fileName
+
+Name of the file.
+
+**Type**: `string`
+
+### fileSize
+
+Size of the file in KB.
+
+**Type**: `number`
+
+### mimeType
+
+File MIME type.
+
+**Type**: `string`
+
+### thumbnailUrl
+
+URL pointing to the thumbnail version of the image, if available.
+
+**Type**: `string`
+
+## Sample controls
+
+[Image upload component](../sample-controls/image-upload-control.md)
+
+## Related topics
+
+[Power Apps component framework API reference](../reference/index.md)<br/>
+[Power Apps component framework overview](../overview.md)
+
+[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/component-framework/reference/client.md

@@ -9,7 +9,7 @@ ms.reviewer: jdaly
 ms.topic: reference
 ms.subservice: pcf
 contributors:
- - JimDaly
+  - JimDaly
 ---
 
 # Client
@@ -20,7 +20,7 @@ contributors:
 
 `context.client;`
 
-## Available for 
+## Available for
 
 Model-driven apps, canvas apps, & portals.
 
@@ -34,13 +34,14 @@ Disables the scrolling capabilities for the components. This property is support
 
 ## Methods
 
-|Method | Description |Available for|
-| ------------- |-------------|------|
-|[getClient](client/getclient.md)|[!INCLUDE [getclient-description](client/includes/getclient-description.md)]|Model-driven and canvas apps|
-|[getFormFactor](client/getformfactor.md)|[!INCLUDE [getformfactor-description](client/includes/getformfactor-description.md)]|Model-driven and canvas apps|
-|[isOffline](client/isoffline.md)|[!INCLUDE [isoffline-description](client/includes/isoffline-description.md)]|Model-driven apps|
+| Method                                             | Description                                                                                    | Available for                |
+| -------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------- |
+| [getClient](client/getclient.md)                   | [!INCLUDE [getclient-description](client/includes/getclient-description.md)]                   | Model-driven and canvas apps |
+| [getFormFactor](client/getformfactor.md)           | [!INCLUDE [getformfactor-description](client/includes/getformfactor-description.md)]           | Model-driven and canvas apps |
+| [isOffline](client/isoffline.md)                   | [!INCLUDE [isoffline-description](client/includes/isoffline-description.md)]                   | Model-driven apps            |
+| [isNetworkAvailable](client/isnetworkavailable.md) | [!INCLUDE [isnetworkavailable-description](client/includes/isnetworkavailable-description.md)] | Model-driven apps            |
 
-## Example 
+## Example
 
 ```TypeScript
 private createHTMLTableElement(): HTMLTableElement {
@@ -63,4 +64,4 @@ private createHTMLTableElement(): HTMLTableElement {
 [Power Apps component framework API reference](../reference/index.md)<br/>
 [Power Apps component framework overview](../overview.md)
 
-[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/component-framework/reference/client/includes/isNetworkAvailable-description.md

@@ -0,0 +1 @@
+Returns information whether the network is available or not