Merge pull request #1231 from MicrosoftDocs/pehecke-plugin

Migration of plug-in content from CE to CDS

Author: phecke

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

@@ -66,6 +66,8 @@
   - name: Event Framework
     href: event-framework.md
     items:
+    - name: Understand the execution context
+      href: understand-the-data-context.md
     - name: Behavior of specialized update operations
       href: special-update-operation-behavior.md
   - name: Asynchronous service
@@ -75,10 +77,20 @@
     items:
     - name: Write a plug-in
       href: write-plug-in.md
+    - name: Handle exceptions
+      href: handle-exceptions.md
+    - name: Inpersonate a user
+      href: impersonate-a-user.md
     - name: Register a plug-in
       href: register-plug-in.md
     - name: Debug a plug-in
       href: debug-plug-in.md
+    - name: Tracing and logging
+      href: logging-tracing.md
+    - name: Analyze performance
+      href: analyze-performance.md
+    - name: Access external web resources
+      href: access-web-services.md
     - name: Tutorials
       items:
       - name: Write and register a plug-in
@@ -87,6 +99,12 @@
         href: tutorial-debug-plug-in.md
       - name: Update a plug-in
         href: tutorial-update-plug-in.md
+    - name: Sample code
+      items:
+      - name: "Create a basic plug-in"
+        href: org-service/samples/basic-followup-plugin.md
+      - name: "Web access from a plug-in"
+        href: org-service/samples/web-access-plugin.md
   - name: Workflow extensions
     href: workflow/workflow-extensions.md
   - name: Scalable customization design

powerapps-docs/developer/common-data-service/access-web-services.md

@@ -0,0 +1,35 @@
+---
+title: "Access external web resources (Common Data Service for Apps) | MicrosoftDocs"
+description: "Learn how to access a web resource, for example a web service, from a custom plug-in or workflow activity."
+ms.custom: ""
+ms.date: 2/6/2019
+ms.reviewer: ""
+ms.service: "powerapps"
+ms.topic: "article"
+author: "phecke"
+ms.author: "pehecke"
+manager: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# Access external web resources
+
+Plug-ins and custom workflow activities executing in the sandbox can access the network through the HTTP and HTTPS protocols. This capability provides support for accessing popular web resources like social sites, news feeds, web services, and more. The following web access restrictions apply to this sandbox capability.  
+  
+- Only the HTTP and HTTPS protocols are allowed.
+- Access to localhost (loopback) is not permitted.
+- IP addresses cannot be used. You must use a named web address that requires DNS name resolution.
+- Anonymous authentication is supported and recommended. There is no provision for prompting the logged on user for credentials or saving those credentials.
+- 
+Other methods of accessing web resources include the use of webhooks and the [!INCLUDE [pn_azure_service_bus](../../includes/pn_azure_service_bus.md)]. Refer to the links provided below for more information on those topics.
+
+## See also
+
+[Plug-ins](plug-ins.md)<br />
+[Workflow extensions](workflow/workflow-extensions.md)<br />
+[Azure integration](azure-integration.md)<br />
+[Use Web Hooks](use-webhooks.md)<br />
+[Sample: Web Access from a Sandboxed Plug-in](org-service/samples/web-access-plugin.md)

powerapps-docs/developer/common-data-service/analyze-performance.md

@@ -0,0 +1,30 @@
+---
+title: "Analyze plug-in performance (Common Data Service for Apps) | Microsoft Docs"
+description: "Learn how to find and analyze data about how your registered plug-ins are performing."
+ms.custom: ""
+ms.date: 1/29/2019
+ms.reviewer: ""
+ms.service: "powerapps"
+ms.topic: "article"
+author: "phecke"
+ms.author: "pehecke"
+manager: "kvivek"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# Analyze plug-in performance
+
+In addition to using a debugger and profiler to learn how your plug-in is performing at the code level, you can obtain metrics as to the overall performance of your registered plug-ins in an organization through [Common Data Service for Apps analytics](/power-platform/admin/analytics-common-data-service).
+
+Through the [Plug-in](/power-platform/admin/analytics-common-data-service#plug-ins) dashboard you can view metrics such as average execution time, failures, most active plug-ins, and more.
+
+![Analytics plug-in dashboard](media/cds-insights-plugins.png)
+
+## See also
+
+[Use plug-ins to extend business processes](plug-ins.md)  
+[Tutorial: Debug a plug-in](tutorial-debug-plug-in.md)  
+[Debug Plug-ins](debug-plug-in.md)

powerapps-docs/developer/common-data-service/apply-business-logic-with-code.md

@@ -22,7 +22,7 @@ search.app:
 
 # Apply business logic using code
 
-Whenever possible, you should first consider applying one of the several declarative process options to define or apply business logic. More information: [Apply business logic in CDS for Apps](../../maker/model-driven-apps/guide-staff-through-common-tasks-processes.md)
+Whenever possible, you should first consider applying one of the several declarative process options to define or apply business logic. More information: [Apply business logic in CDS for Apps](../../maker/common-data-service/cds-processes.md)
 
 When a declarative process doesn’t meet a requirement, as a developer you have several options. This topic will introduce common options to write code.
 

powerapps-docs/developer/common-data-service/best-practices/business-logic/set-keepalive-false-interacting-external-hosts-plugin.md

@@ -290,7 +290,6 @@ This behavior is transparent to end users and traditional logging as the executi
 ### See also
 
 [Sample: Web access from a sandboxed plug-in](../../org-service/samples/web-access-plugin.md)<br />
-[Plug-in isolation, trusts, and statistics](/dynamics365/customer-engagement/developer/plugin-isolation-trusts-statistics)<br />
 [Load Balancing (WCF)](https://msdn.microsoft.com/library/ms730128.aspx)<br />
 [HttpTransportBindingElement.KeepAliveEnabled Property](https://msdn.microsoft.com/library/system.servicemodel.channels.httptransportbindingelement.keepaliveenabled.aspx)<br />
 [HttpWebRequest.KeepAlive Property](https://msdn.microsoft.com/library/system.net.httpwebrequest.keepalive.aspx)<br />

powerapps-docs/developer/common-data-service/best-practices/business-logic/use-invalidpluginexecutionexception-plugin-workflow-activities.md

@@ -156,5 +156,5 @@ Unhandled exceptions of other types should only occur when unexpected errors are
 
 ### See also
 
-[Cancelling an operation](../../write-plug-in.md#cancelling-an-operation)<br/>
+[Cancelling an operation](../../handle-exceptions.md#cancelling-an-operation)<br/>
 [Debug Workflow Activities](../../workflow/workflow-extensions.md#debug-workflow-activities)<br/>

powerapps-docs/developer/common-data-service/best-practices/business-logic/use-itracingservice-plugins.md

@@ -81,5 +81,5 @@ Tracing is especially useful to troubleshoot registered custom code as it is the
 
 ### See also
 
-[Debug a plug-In](/dynamics365/customer-engagement/developer/debug-plugin)<br />
-[Plug-in isolation, trusts, and statistics](/dynamics365/customer-engagement/developer/plugin-isolation-trusts-statistics)<br />
+[Write a plug-in](../../write-plug-in.md)  
+[Tracing and logging](../../logging-tracing.md)

powerapps-docs/developer/common-data-service/browse-your-metadata.md

@@ -90,4 +90,4 @@ You can perform the following actions for a single entity:
 
  [Developer Tools for CDS for Apps](developer-tools.md)<br />
  [Customize Entity Metadata](customize-entity-metadata.md)<br />
- [Analyze Plug-in Performance](/dynamics365/customer-engagement/developer/analyze-plugin-performance)<br />
+ 

powerapps-docs/developer/common-data-service/calculated-rollup-attributes.md

@@ -65,7 +65,7 @@ search.app:
 ## Calculated attributes  
  Calculated attributes are calculated in real-time when they are retrieved. Calculated attributes can be composed using different data types. For example, an Integer calculated attribute may reference values from Decimal or Currency attributes. More information: [Define calculated fields](https://technet.microsoft.com/library/dn832103.aspx).  
 
- Calculated attribute values are available in the retrieve plug-in pipeline. Post image of entity record update or create contains the calculated attribute value in stage 40. More information: [Event Execution Pipeline](/dynamics365/customer-engagement/developer/event-execution-pipeline)  
+ Calculated attribute values are available in the retrieve plug-in pipeline. Post image of entity record update or create contains the calculated attribute value in stage 40. More information: [Event execution pipeline](event-framework.md#event-execution-pipeline) and [Entity Images](understand-the-data-context.md#entity-images)
 
 ### Limitations  
  You can’t use values in calculated attributes that reference a related entity, another calculated attribute, or a *logical value* in the same entity to sort data returned by a query. Although your query can specify that the results should be ordered using a calculated attribute, the sort direction will be ignored and will not throw an error. If the calculated attribute references only simple values in the same record, sorting works normally. You can determine the sources used in a calculated field using the `SourceTypeMask` property on the attribute metadata. More information: [Logical attributes](/dynamics365/customer-engagement/developer/introduction-to-entity-attributes.md#BKMK_LogicalAttributes)  

powerapps-docs/developer/common-data-service/custom-actions.md

@@ -148,6 +148,6 @@ If one of the steps in the action’s real-time workflow is a custom workflow ac
 ### See also  
  [Create real-time workflows](/dynamics365/customer-engagement/developer/create-real-time-workflows)   
  [Use dialogs for guided processes](/dynamics365/customer-engagement/developer/use-dialogs-guided-processes)   
- [Event Execution Pipeline](/dynamics365/customer-engagement/developer/event-execution-pipeline)   
+ [Event execution pipeline](event-framework.md#event-execution-pipeline)   
  [Write Workflows to Automate Business Processes](/dynamics365/customer-engagement/developer/automate-business-processes-customer-engagement)   
  [Customize your system](https://technet.microsoft.com/library/dn531158.aspx)