Merge branch 'master' into users/tahoon/ime-mode-obsolete

Author: Mattp123

.acrolinx-config.edn

@@ -1,5 +1,6 @@
 {:allowed-branchname-matches ["^master$"]
  :allowed-filename-matches ["powerapps-docs"]
+ :guidance-profile "dc59e3ef-24fd-46d7-9156-0491aaae6bef" ;; Profile ID for "BAG-specific" 
  :acrolinx-check-settings
  {
   "languageId" "en"

.openpublishing.publish.config.json

@@ -38,10 +38,6 @@
           "ConceptualTOC": "powerapps-docs/developer/common-data-service/org-service/toc.yml",
           "ReferenceTOCUrl": "/dotnet/api/ce-9-general/toc.json"
         },
-        {
-          "ConceptualTOC": "powerapps-docs/developer/common-data-service/package-deployer/toc.yml",
-          "ReferenceTOCUrl": "/dotnet/api/ce-9-packagedeployer/toc.json"
-        },
         {
           "ConceptualTOC": "powerapps-docs/developer/common-data-service/workflow/toc.yml",
           "ReferenceTOCUrl": "/dotnet/api/ce-9-workflow/toc.json"

.openpublishing.redirection.json

@@ -1,10 +1,125 @@
 {
   "redirections": [
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/maintain-managed-solutions.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/maintain-managed-solutions",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/organize-solutions.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/organize-solutions",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/create-patches-simplify-solution-updates.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/create-patches-simplify-solution-updates",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/when-edit-customization-file.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/when-edit-customization-file",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/create-export-import-unmanaged-solution.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/solution-api",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/uninstall-delete-solution.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/solution-api",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/work-solutions.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/solution-api",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/create-install-update-managed-solution.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/solution-api",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/create-solutions-support-multiple-languages.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/create-solutions-support-multiple-languages",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/use-managed-properties.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/use-managed-properties",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/organize-team-develop-solutions.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/team-development-alm",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/dependency-tracking-solution-components.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/dependency-tracking-solution-components",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/removing-dependencies.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/removing-dependencies",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/maker/canvas-apps/dev-appsource-test-drive.md",
+      "redirect_url": "dev-enterprise-intro",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/compress-extract-solution-file-solutionpackager.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/solution-packager-tool",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/use-source-control-solution-files.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/use-source-control-solution-files",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/overview.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/overview",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/analyze.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/analyze",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/check-status.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/check-status",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/retrieve-rules.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/retrieve-rules",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/retrieve-rulesets.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/retrieve-rulesets",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/checker/webapi/upload-file.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/checker-api/upload-file",
+      "redirect_document_id": "false"
+    }, 
+    {
+      "source_path": "powerapps-docs/developer/common-data-service/package-deployer/create-packages-package-deployer.md",
+      "redirect_url": "https://docs.microsoft.com/power-platform/alm/package-deployer-tool",
+      "redirect_document_id": "false"
+    }, 
     {
       "source_path": "powerapps-docs/maker/common-data-service/create-edit-entities.md",
       "redirect_url": "data-platform-create-entity",
       "redirect_document_id": "false"
-    }, 
+    },
     {
       "source_path": "powerapps-docs/maker/common-data-service/solution-patches.md",
       "redirect_url": "https://docs.microsoft.com/power-platform/alm/update-solutions-alm#create-solution-patches",

powerapps-docs/chatbots.md

@@ -0,0 +1,25 @@
+---
+title: Create chatbots from Power Apps | Microsoft Docs
+description: Provides information about how you can use AI Builder in Power Apps.
+author: iaanw
+ms.service: powerapps
+ms.topic: conceptual
+ms.custom: 
+ms.date: 06/26/2020
+ms.author: iawilt
+ms.reviewer: mvakoc
+ms.custom: pva, power-apps
+---
+# Create chatbots from Power Apps
+
+Power Virtual Agents allows you to quickly create and maintain intelligent chatbots using a no-code interface. App makers can create and manage their chatbots directly from [Power Apps](https://make.powerapps.com). 
+
+![Chatbots from Power Apps](media/chatbots.png "Chatbots from Power Apps")
+
+You can create and manage your chatbots using the **Chatbots** option in the left navigation pane.
+
+- To create a chatbot, select **Chatbots**, then **Create**, and then select **New chatbot**. This will take you directly to the Power Virtual Agents portal where you can create your chatbot. For more information, see [Create a bot in Power Virtual Agents](https://docs.microsoft.com/power-virtual-agents/authoring-first-bot)
+
+- After you have chatbots in your environment, you'll be able to view them by selecting **Chatbots** and then **List**. You can navigate directly to the Power Virtual Agents portal to update your bot or view analytics.
+
+More information: [Power Virtual Agents docs](https://docs.microsoft.com/power-virtual-agents)

powerapps-docs/developer/common-data-service/TOC.yml

@@ -27,6 +27,10 @@
       href: use-fetchxml-left-outer-join-query-records-not-in.md
     - name: Page large result sets with FetchXML
       href: org-service/page-large-result-sets-with-fetchxml.md
+    - name: Paging behaviors and ordering
+      href: org-service/paging-behaviors-and-ordering.md
+    - name: Use column comparison in queries
+      href: column-comparison.md
   - name: "Use SQL to query data (Preview)"
     href: cds-sql-query.md
   - name: Saved Queries
@@ -300,62 +304,10 @@
     href: customize-labels-support-multiple-languages.md
   - name: Best Practices
     href: best-practices/work-with-metadata/index.md
-- name: Package and distribute extensions using solutions
+- name: Introduction to solutions
+  href: introduction-solutions.md
+- name: Publish and monitor your (ISV) app
   items:
-  - name: Introduction to solutions
-    href: introduction-solutions.md
-    items:
-    - name: Dependency tracking for solution components
-      href: dependency-tracking-solution-components.md
-    - name: Removing dependencies
-      href: removing-dependencies.md
-    - name: Maintain managed solutions
-      href: maintain-managed-solutions.md
-    - name: Organize your solutions
-      href: organize-solutions.md
-    - name: Organize your team to develop solutions
-      href: organize-team-develop-solutions.md
-    - name: Use managed properties
-      href: use-managed-properties.md
-    - name: Understand how managed solutions are merged
-      href: understand-managed-solutions-merged.md
-    - name: Create solutions that support multiple languages
-      href: create-solutions-support-multiple-languages.md
-    - name: How to manage solutions
-      items:
-      - name: Create, export, or import an unmanaged solution
-        href: create-export-import-unmanaged-solution.md
-      - name: Uninstall or delete a solution
-        href: uninstall-delete-solution.md
-      - name: Work with solutions
-        href: work-solutions.md
-      - name: Create, install, and update a managed solution
-        href: create-install-update-managed-solution.md
-      - name: Create patches to simplify solution updates
-        href: create-patches-simplify-solution-updates.md
-      - name: When to edit the customizations file
-        href: when-edit-customization-file.md
-  - name: SolutionPackager tool
-    href: compress-extract-solution-file-solutionpackager.md
-    items:
-    - name: Source control with solution files
-      href: use-source-control-solution-files.md       
-  - name: Package Deployer tool
-    href: package-deployer/create-packages-package-deployer.md
-  - name: Verify quality of solutions and packages
-    items:
-    - name: Use the Power Apps checker web API 
-      href: checker/webapi/overview.md
-    - name: Invoke the analysis
-      href: checker/webapi/analyze.md
-    - name: Check for analysis status
-      href: checker/webapi/check-status.md
-    - name: Retrieve the list of rules
-      href: checker/webapi/retrieve-rules.md
-    - name: Retrieve the list of rulesets
-      href: checker/webapi/retrieve-rulesets.md
-    - name: Upload a file for analysis
-      href: checker/webapi/upload-file.md
   - name: Publish your app on AppSource
     href: publish-app-appsource.md
     items:

powerapps-docs/developer/common-data-service/appendix-app-certification-checklist.md

@@ -46,9 +46,9 @@ The following checklist provides the list of validations performed by Microsoft
 <li>Runtime errors: May occur once the app is opened in Run mode to view. Any issues found will be reported through email.</li>
 <li>Accessibility errors and warnings: All Accessibility errors should be resolved as per Solution Checker guidelines.</li>
 </ul></li>
-<li>Code Validation for Common Data Service solution will be done utilizing <a href="https://docs.microsoft.com/powerapps/developer/common-data-service/checker/webapi/overview">Power Apps Checker</a>.</li>
+<li>Code Validation for Common Data Service solution will be done utilizing <a href="https://.docs.microsoft.com/power-platform/alm/checker-api/overview">Power Apps Checker</a>.</li>
 <li>Issues reported from Power Apps Checker will be manually validated for correctness and false positive issues will be reduced to low severity.</li>
-<li>The quality of the solution and packages are validated against the AppSource certification <a href="https://docs.microsoft.com/powerapps/developer/common-data-service/checker/webapi/retrieve-rulesets">ruleset</a>. 
+<li>The quality of the solution and packages are validated against the AppSource certification <a href="https://docs.microsoft.com/power-platform/alm/checker-api/retrieve-rulesets">ruleset</a>. 
 <li>Generated report is shared with the publisher through email.</li>
 </ul>
 </td>
@@ -57,7 +57,7 @@ The following checklist provides the list of validations performed by Microsoft
 <td>Deployment Validation</td>
 <td>
 <ul>
-<li>Solution will be installed to a Power Apps studio using <a href="https://docs.microsoft.com/powerapps/developer/common-data-service/package-deployer/create-packages-package-deployer">Package Deployer</a>. Installed canvas apps will be manually located in the solution as well as on Apps section after installation and will make sure the app is opened in edit and run mode. Canvas App will be manually deleted from Power Apps studio to validate successful uninstallation</li>
+<li>Solution will be installed to a Power Apps studio using <a href="https://docs.microsoft.com/power-platform/alm/package-deployer-tool">Package Deployer</a>. Installed canvas apps will be manually located in the solution as well as on Apps section after installation and will make sure the app is opened in edit and run mode. Canvas App will be manually deleted from Power Apps studio to validate successful uninstallation</li>
 <li>Check the canvas app successfully connects through the connectors provided by the publishers. For example, Common Data Service or any other connections.</li>
 <li>Check all Common Data Service components (entities, web resources, plug-ins and other components) are available in the solution.</li>
 <li>Manually uninstall the solution and check if all the components associated to the managed solution is removed.</li>

powerapps-docs/developer/common-data-service/authenticate-oauth.md

@@ -1,7 +1,7 @@
 ---
 title: "Use OAuth with Common Data Service (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Learn how to authenticate using OAuth with Common Data Service" # 115-145 characters including spaces. This abstract displays in the search result.
-ms.custom: ""
+ms.custom: has-adal-ref
 ms.date: 10/31/2018
 ms.reviewer: "pehecke"
 ms.service: powerapps

powerapps-docs/developer/common-data-service/best-practices/business-logic/do-not-duplicate-plugin-step-registration.md

@@ -56,7 +56,7 @@ Deleting and recreating a step in the source instance (test, dev, preprod) will
 
 ![Duplicate Plug-in Step Registration](../media/duplicate-plugin-registration-step.png)
 
-Manually creating the `SDKMessageProcessingSteps` with a new GUID or updating the existing GUID within the `customizations.xml` file will result in a duplicate step being registered. These types of tasks are unsupported as outlined in [When to edit the customizations file](/powerapps/developer/model-driven-apps/when-edit-customization-file).
+Manually creating the `SDKMessageProcessingSteps` with a new GUID or updating the existing GUID within the `customizations.xml` file will result in a duplicate step being registered. These types of tasks are unsupported as outlined in [When to edit the customizations file](/power-platform/alm/when-edit-customization-file).
 
 <a name='additional'></a>
 

powerapps-docs/developer/common-data-service/best-practices/business-logic/optimize-assembly-development.md

@@ -4,8 +4,8 @@ description: "Consider merging separate plug-ins/custom workflow activities into
 services: ''
 suite: powerapps
 documentationcenter: na
-author: jowells
-manager: austinj
+author: JimDaly
+manager: sunilg
 editor: ''
 tags: ''
 ms.service: powerapps
@@ -14,7 +14,7 @@ ms.topic: article
 ms.tgt_pltfrm: na
 ms.workload: na
 ms.date: 1/15/2019
-ms.author: jowells
+ms.author: phecke
 search.audienceType: 
   - developer
 search.app: 
@@ -33,26 +33,30 @@ search.app:
 
 When developing custom assemblies, there are a couple of considerations to take in:
 
+1. Assemblies with a large number of custom workflow activities can take a long time to upload when being registered.
 1. Multiple different custom assemblies
     - Increased maintainability complexity
     - Potential increase plug-in execution length
+1. Sandbox assembly size constraint is 16 MB in Common Data Service.
 
-2. Sandbox assembly size constraint is 16 MB in Common Data Service.
 
 <a name='guidance'></a>
 
 ## Guidance
 
-> [!NOTE]
-> Further Guidance clarification is under development regarding specific details in optimizing assembly development, such as, how to merge separate plug-ins into a single custom assembly and suggestions to minimize the assembly size.
+### Limit the number of Custom Workflow Activities in a Single assembly
+
+When an assembly that contains custom workflow activities is uploaded during plug-in registration, additional checks are required for custom workflow activities.
+
+While an assembly with hundreds of ordinary plug-in types may be uploaded very quickly, an assembly with more than 100 custom workflow activities may take several minutes or even time out when being registered or updated. We recommend including no more than 50 custom workflow activities in a single assembly.
 
 ### Consolidate Plug-ins or Custom Workflow Activities into a Single Assembly
 
 Plug-ins and custom workflow activities developed for a Common Data Service solution should exist with others in a single Visual Studio project. Consider merging separate plug-ins/custom workflow activities into a single Visual Studio project/assembly unless the plug-ins fall into the following exceptions:
 
 1. A plug-in/custom workflow activity needs to be selectively deployed to one environment but not to others.
-
-2. The physical assembly size is near or greater than 16 MB for a Common Data Service instance.
+1. The physical assembly size is near or greater than 16 MB for a Common Data Service instance.
+1. There will be more than 50 custom workflow activities in the assembly, as mentioned in [Limit the number of Custom Workflow Activities in a Single assembly](#limit-the-number-of-custom-workflow-activities-in-a-single-assembly)
 
 
 ### Move Plug-ins/Custom Workflow Activities into Multiple Assemblies
@@ -63,7 +67,12 @@ Power Apps and Dynamics 365 (online) has an assembly size constraint of 16 MB wh
 
 ## Problematic patterns
 
+### Assemblies take a long time to upload when being registered
+
+When a custom workflow activity type plug-in is uploaded while being registered, each type requires additional validation checking. When an assembly contains more than a hundred custom workflow activity type plug-ins, it could require several minutes to complete the checks and is at risk of timing out.
+
 ### Multiple assemblies
+
 Having multiple assemblies has a couple of areas that can be impacted:
 
 1. Performance - each assembly has a lifecycle that is managed by Common Data Service.  This includes loading, caching, and unloading the assemblies.  Having more than one assembly causes more work to be done on the server, loading and caching an assembly, and could affect the overall plug-in/custom workflow activity execution length.

powerapps-docs/developer/common-data-service/best-practices/work-with-data/index.md

@@ -31,4 +31,4 @@ This list below contains all of the best practices and guidance around integrati
 |[Service Protection API Limits (Common Data Service)](../../api-limits.md)     |Understand the limits for API requests.         |
 
 ### See Also
-[Work with data using code in Common Data Service (PowerApps)](../../work-with-data-cds.md)<br />
+[Work with data using code in Common Data Service (Power Apps)](../../work-with-data-cds.md)<br />