Merge branch 'master' into Nava_pcfcanvas

Author: Nkrb

powerapps-docs/developer/common-data-service/best-practices/business-logic/develop-iplugin-implementations-stateless.md

@@ -13,7 +13,7 @@ ms.devlang: na
 ms.topic: article
 ms.tgt_pltfrm: na
 ms.workload: na
-ms.date: 1/15/2019
+ms.date: 9/05/2019
 ms.author: jowells
 search.audienceType: 
   - developer
@@ -40,7 +40,11 @@ Members of classes that implement the <xref href="Microsoft.Xrm.Sdk.IPlugin?text
 
 ## Guidance
 
-When implementing <xref:Microsoft.Xrm.Sdk.IPlugin>, do not use member fields and properties and write the <xref:Microsoft.Xrm.Sdk.IPlugin.Execute*> method as a stateless operation.  All per invocation state information should be accessed via the execution context only.  Do not attempt to store any execution state data in member fields or properties for use during the current or next plug-in invocation unless that data was obtained from the configuration parameter provided to the overloaded constructor.
+When implementing <xref:Microsoft.Xrm.Sdk.IPlugin>, do not use member fields and properties and write the <xref:Microsoft.Xrm.Sdk.IPlugin.Execute*> method as a stateless operation.  All per invocation state information should be accessed via the execution context only.  
+
+Do not attempt to store any execution state data in member fields or properties for use during the current or next plug-in invocation unless that data was obtained from the configuration parameter provided to the overloaded constructor.
+
+Do not use code that registers to AppDomain events. Plugin logic should not rely on any AppDomain events or properties, since the internal implementation of the plugin infrastructure can change the execution behavior at any point of time. This can cause failures even if the code worked at some point in time.
 
 Read-only, static, and constant members are inherently thread-safe and can also be used reliably within a plug-in class. The following are some examples on how to maintain thread-safe plug-ins:
 

powerapps-docs/developer/common-data-service/build-web-applications-server-server-s2s-authentication.md

@@ -19,7 +19,7 @@ search.app:
 
 Use server-to-server (S2S) authentication to securely and seamlessly communicate with Common Data Service with your web applications and services. S2S authentication is the common way that apps registered on Microsoft AppSource use to access the Common Data Service data of their subscribers.  
 
- S2S authentication means you don’t need to use a paid PowerApps user license when you connect to Common Data Service environments. There is no license fee for the special *application user* account you will use with S2S authentication. With S2S authentication a special unlicensed application user account is created and includes information about your application registered with Azure Active Directory (Azure AD). Rather than user credentials, the application is authenticated based on a service principal identified by an Azure AD Object ID value which is stored in the application user record. The application user is associated with a custom security role which controls the kinds of data and operations the application is allowed to perform.  
+S2S authentication means you don’t need to use a paid PowerApps user license when you connect to Common Data Service environments. There is no license fee for the special *application user* account you will use with S2S authentication. However, there are [limits to the number of requests the application user](https://docs.microsoft.com/power-platform/admin/api-request-limits-allocations#non-licensed-usersapplication-users) account can call. With S2S authentication, a special unlicensed application user account is created and includes information about your application registered with Azure Active Directory (Azure AD). Rather than user credentials, the application is authenticated based on a service principal identified by an Azure AD Object ID value which is stored in the application user record. The application user is associated with a custom security role which controls the kinds of data and operations the application is allowed to perform.  
 
  All operations performed by your application or service using S2S will be performed as the application user you provide rather than as the user who is accessing your application. If you want your application to perform data operations on behalf of a specific user, such as the one who is interacting with your application, you can apply impersonation when the custom security role applied to your application service principal has the privileges required. More information: [Impersonate another user](impersonate-another-user.md)  
 

powerapps-docs/developer/common-data-service/virtual-entities/custom-ve-data-providers.md

@@ -1,7 +1,7 @@
 ---
 title: "Custom virtual entity data providers (Common Data Service) | Microsoft Docs"
 description: "Using the Common Data Service Data SDK, .NET Developers have the option of creating custom virtual entity data providers to help integrate external data source types that are not supported by an existing data provider."
-ms.date: 10/31/2018
+ms.date: 09/05/2019
 ms.service: powerapps
 ms.topic: "article"
 applies_to: 
@@ -30,19 +30,12 @@ Using the Common Data Service Data SDK, .NET Developers have the option of creat
 Custom data providers require substantial development resources to create and maintain. You must have fundamental knowledge of the following areas:
 
 - The external data source schema and associated data access techniques.  This ___domain knowledge is specific to the external data source type.
-
-
-<!-- TODO:
-- Common Data Service metadata schema: More information: [The metadata and data models in Microsoft Dynamics 365](../metadata-data-models.md).
-- Common Data Service event system: More information: [Introduction to the event framework](../introduction-event-framework.md). 
-- Common Data Service plug-in architecture and development: More information: [Plug-in development](../plugin-development.md). -->
+- Common Data Service metadata schema: More information: [Work with metadata using code](../metadata-services.md).
+- Common Data Service event framework: More information: [Event Framework](../event-framework.md). 
+- Common Data Service plug-in architecture and development: More information: [Use plug-ins to extend business processes](../plug-ins.md).
 
 The `Microsoft.Xrm.Sdk.Data.dll` assembly is available as a NuGet package: [Microsoft.CrmSdk.Data](https://www.nuget.org/packages/Microsoft.CrmSdk.Data/)
 
-<!-- ## Data Provider Architecture -->
-<!-- TODO: it would be nice to have a more detailed architecture diagram of a data provider and add discussion. -->
-
-
 ## Categories of providers
 
 There are two general categories of data provider you can create using the virtual entity data SDK assemblies: generic or targeted. The table below describes these approaches and matches them to the data provider development model best suited for that approach.
@@ -96,11 +89,6 @@ If for any reason your code cannot achieve the expected result, you must throw t
 |<xref:Microsoft.Xrm.Sdk.Data.Exceptions.ObjectNotFoundException>|The specified record in the external data source does not exist.|
 |<xref:Microsoft.Xrm.Sdk.Data.Exceptions.TimeoutException>|The external operation did not complete within the allowed time; for example, the result of a HTTP status 408 from the external data service.|
 
-<!-- 
-  TODO:
-  To assist you in plug-in development, the Data SDK contains the _Plugin Profiler and Debugger_; for more information see [TBD]TODO: Obtain information on this tool, create subtopic. 
--->
-
 
 ### Plug-in registration
 
@@ -114,6 +102,11 @@ Unlike an ordinary plugin, you will only use the Plugin Registration Tool (PRT)
 
 When the metadata for your virtual entity is configured, your plugins are registered using the PRT and the correct configuration data is set in the **EntityDataProvider** and **EntityDataSource** entities, your virtual entity will start to respond to requests.
 
+### Debugging plug-ins
+
+A custom virtual entity provider is a type of plug-in. Use the information in these topics to debug plug-ins for custom virtual entity providers: [Debug Plug-ins](../debug-plug-in.md) and [Tutorial: Debug a plug-in](../tutorial-debug-plug-in.md).
+
+
 ### See also
 
 [Get started with virtual entities](get-started-ve.md)<br />

powerapps-docs/maker/TOC.yml

@@ -911,6 +911,8 @@
             href: ./model-driven-apps/configure-event-handlers-legacy.md
           - name: How to disable auto-save in a form
             href: ./model-driven-apps/manage-auto-save.md
+          - name: How to add a tab for SharePoint documents
+            href: ./model-driven-apps/add-documents-tab-entity-main-form.md            
       - name: Embed a canvas app on a model-driven form
         href: ./model-driven-apps/embed-canvas-app-in-form.md
         items:
@@ -1155,8 +1157,6 @@
       href: ./common-data-service/data-platform-create-entity.md
     - name: "Create a custom entity that has components"
       href: ./common-data-service/create-custom-entity.md
-    - name: Add data to an entity using Power Query
-      href: ./common-data-service/data-platform-cds-newentity-pq.md
     - name: Entities and metadata
       href: ./common-data-service/create-edit-metadata.md
     - name: Types of entities
@@ -1305,6 +1305,17 @@
       href: ./common-data-service/set-managed-properties-metadata.md
     - name: Publish changes
       href: ./common-data-service/publish-changes-for-use-customer-service-hub.md
+  - name: Work with dataflows
+    href: ./common-data-service/self-service-data-prep-with-dataflows.md
+    items:
+    - name: Create and use dataflows
+      href: ./common-data-service/create-and-use-dataflows.md
+    - name: Add data to an entity using Power Query
+      href: ./common-data-service/data-platform-cds-newentity-pq.md
+    - name: Connect Azure Data Lake for dataflow storage
+      href: ./common-data-service/connect-azure-data-lake-storage-for-dataflow.md      
+    - name: Use an on-premises data gateway      
+      href: ./common-data-service/using-dataflows-with-on-premises-data.md
   - name: License requirements for entities
     href: ./common-data-service/data-platform-entity-licenses.md
     items:

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

@@ -19,7 +19,7 @@ search.app:
 
 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 perform initialization, clear input, and reset values when the **Reset** function runs on the component instances.
 
-## OnReset ##
+## OnReset
 
 With a component selected, select **OnReset** in the drop-down list of properties (on the right side of the formula bar), and then enter one or more formulas.
 

powerapps-docs/maker/canvas-apps/embed-teams-app.md

@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 05/29/2019
+ms.date: 09/09/2019
 ms.author: jimholtz
 search.audienceType: 
   - maker
@@ -123,7 +123,7 @@ For more information, see [Manifest Editor](https://docs.microsoft.com/microsoft
    > [!div class="mx-imgBorder"] 
    > ![Team tab Add](./media/embed-teams-app/team-tab-add.png "Team tab Add")
 
-7. Add your app's configuration URL in the "Configuration URL" input field, using the following format: `https://web.powerapps.com/webplayer/teamsapptabsettings?appid=<PowerApp ID>`
+7. Add your app's configuration URL in the "Configuration URL" input field, using the following format: `https://apps.powerapps.com/teams/settings/<PowerApp ID>`
 
    Replace `<PowerApp ID>` with the App ID GUID you recorded above.
 

powerapps-docs/maker/canvas-apps/gateway-reference.md

@@ -154,7 +154,7 @@ There is currently no single place where tenant administrators  can manage all t
 **Answer:** No. A gateway connects to on-premises data sources only.
 
 **Question:** What is the actual Windows service called?  
-**Answer:** In Services, the gateway is called **Power BI Enterprise Gateway Service**.
+**Answer:** In Services, the gateway is called **On-premises data gateway service**.
 
 **Question:** Are there any inbound connections to the gateway from the cloud?  
 **Answer:** No. The gateway uses outbound connections to Azure Service Bus.

powerapps-docs/maker/common-data-service/configure-connection-roles.md

@@ -12,7 +12,8 @@ applies_to:
   - "Dynamics 365 Version 9.x"
   - "PowerApps"
 ms.author: "matp"
-manager: "brycho"
+manager: "kvivek"
+author: "Mattp123"
 search.audienceType: 
   - maker
 search.app: