Merge pull request #1391 from MicrosoftDocs/master

Pushing content live

Author: KumarVivek

powerapps-docs/developer/common-data-service/includes/cc-d365ce-note-section.md

@@ -0,0 +1 @@
+Information under this topic and its sub-topics is also applicable to the Dynamics 365 for Customer Engagement apps (online) users because the Customer Engagement apps are built on the Common Data Service platform. If you are Dynamics 365 for Customer Engagement apps (on-premises) user, see the documentation applicable for the on-premises functionality in the Customer Engagement documentation at: 

powerapps-docs/developer/common-data-service/includes/cc-d365ce-note-topic.md

@@ -0,0 +1 @@
+Information in this topic is also applicable to the Dynamics 365 for Customer Engagement apps (online) users because the Customer Engagement apps are built on the Common Data Service platform. If you are Dynamics 365 for Customer Engagement apps (on-premises) user, see the documentation applicable for the on-premises functionality in the Customer Engagement documentation at 

powerapps-docs/developer/common-data-service/xrm-tooling/build-windows-client-applications-xrm-tools.md

@@ -2,7 +2,7 @@
 title: "Build Windows client applications using the XRM tools (Common Data Service)| Microsoft Docs"
 description: "XRM tooling is a set of APIs that provides support for building Windows client applications for Common Data Service"
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 03/27/2019
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -13,7 +13,7 @@ applies_to:
 ms.assetid: e2f22576-1705-4854-a804-a1ca232c0cfc
 caps.latest.revision: 33
 author: "MattB-msft"
-ms.author: "kvivek"
+ms.author: "nabuthuk"
 manager: "kvivek"
 search.audienceType: 
   - developer
@@ -25,13 +25,16 @@ search.app:
 
 XRM tooling is a set of APIs built on top of the Common Data Service assembly APIs (Organization service and Discovery service) that provide support for building Windows client applications for Common Data Service. It provides the following capabilities:  
 
-- Supports all the authentication modes to sign in to Common Data Service.  
-- Provides PowerShell support for authentication and connection to Common Data Service.  
+- Supports all the authentication modes to sign in to Common Data Service instance.  
+- Provides PowerShell support for authentication and connection to Common Data Service instance.  
 - Provides thread safety for actions performed in Common Data Service in a multithreaded environment. More information [Multithreading in Components](https://msdn.microsoft.com/library/vstudio/3es4b6yy.aspx), [Thread-Safe Components](https://msdn.microsoft.com/library/vstudio/a8544e2s.aspx)  
 - Provides a common Windows Presentation Foundation login control for Common Data Service for consistent sign-in experience to Common Data Service from your Windows client applications.  
 - Supports secure storage of the sign-in credentials and reuse of the stored credentials to automatically sign in to Common Data Service after initial sign in.  
 - Provides built-in diagnostic tracing and performance reporting of the actions performed in Common Data Service, which you can configure based on your organization’s requirements.  
-  
+
+> [!NOTE]
+> [!INCLUDE[cc-d365ce-note-section](../includes/cc-d365ce-note-section.md)] [Build Windows client applications using the XRM tools (Customer Engagement)](/dynamics365/customer-engagement/developer/build-windows-client-applications-xrm-tools)
+
 ## Components of XRM tooling  
 
 XRM tooling has the following three components:  
@@ -48,19 +51,12 @@ The following applications in the current version of Common Data Service use the
 
 - Unified Service Desk. More information: [Extend Unified Service Desk](/dynamics365/customer-engagement/unified-service-desk/extend-unified-service-desk)
 
-<!-- TODO: fix links when files added to admin guide
+<!--Package Deployer tool. More information: [Deploy packages using Package Deployer and Windows PowerShell](../../administrator/deploy-packages-using-package-deployer-windows-powershell.md)-->   
 
-- Package Deployer tool. More information: [Deploy packages using Dynamics 365 Package Deployer and Windows PowerShell](../../administrator/deploy-packages-using-package-deployer-windows-powershell.md)   
-
-- Configuration Migration tool. More information [Manage your configuration data](../../administrator/manage-configuration-data.md)  
-
--->
+<!--Configuration Migration tool. More information [Manage your configuration data](../../administrator/manage-configuration-data.md)-->  
 
 ### See also
 
 [Sample: Quick start for XRM Tooling API](sample-quick-start-xrm-tooling-api.md)<br />
-<!-- TODO:
-[Use the Common Data Service Organization service](use-microsoft-dynamics-365-organization-service.md)<br />
-[Discover the URL for Your Organization With IDiscoveryService Web Service](org-service/discover-url-organization-organization-service.md)<br />
-[Write Applications and Server Extensions](extend-dynamics-365-server.md)<br /> -->
-[Blog: PowerShell module for performing data operations and manipulating user and system settings in CRM](http://blogs.msdn.com/b/crm/archive/2015/09/25/powershell-module-for-performing-data-operations-and-manipulating-user-and-system-settings-in-crm.aspx)
+[Blog: PowerShell module for performing data operations and manipulating user and system settings in Common Data Service](http://blogs.msdn.com/b/crm/archive/2015/09/25/powershell-module-for-performing-data-operations-and-manipulating-user-and-system-settings-in-crm.aspx)
+

powerapps-docs/developer/common-data-service/xrm-tooling/configure-tracing-xrm-tooling.md

@@ -2,7 +2,7 @@
 title: "Configure tracing for XRM tooling (Common Data Service)| Microsoft Docs"
 description: "Learn how you can configure tracing for components such as operation calls, warnings, exceptions, and other significant events in XRM Tooling"
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 03/27/2019
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -13,7 +13,7 @@ applies_to:
 ms.assetid: d7586a5a-40da-427e-bbeb-4f8a371a8dcf
 caps.latest.revision: 8
 author: "MattB-msft"
-ms.author: "kvivek"
+ms.author: "nabuthuk"
 manager: "kvivek"
 search.audienceType: 
   - developer
@@ -28,8 +28,7 @@ You can enable tracing to record data related to process milestones across all c
 - A trace source  
 - A trace listener  
 - A trace level other than **Off**. These are the other values that you can specify: **Error**, **Warning**, **Info**, and **Verbose**.  
-  
- Here is the configuration for enabling tracing for a component in XRM tooling. For example, the following configuration only enables tracing for the Microsoft.Xrm.Tooling.CrmConnectControl component:  
+Here is the configuration for enabling tracing for a component in XRM tooling. For example, the following configuration only enables tracing for the Microsoft.Xrm.Tooling.CrmConnectControl component:  
 
 ```xml  
 </configuration>  

powerapps-docs/developer/common-data-service/xrm-tooling/sample-quick-start-xrm-tooling-api.md

@@ -2,7 +2,7 @@
 title: "Sample: Quick start for XRM Tooling API (Common Data Service)| Microsoft Docs"
 description: ""
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 03/27/2019
 ms.reviewer: ""
 ms.service: powerapps
 ms.suite: ""
@@ -13,7 +13,7 @@ applies_to:
 ms.assetid: 060d45bb-b7fd-48bd-ab8f-629c1b8bc1dc
 caps.latest.revision: 20
 author: "MattB-msft"
-ms.author: "kvivek"
+ms.author: "nabuthuk"
 manager: "kvivek"
 search.audienceType: 
   - developer
@@ -25,15 +25,14 @@ search.app:
 
 The QuickStart sample is a .NET Framework managed code sample that shows how to connect to a Common Data Service instance by using the XRM Tooling APIs, and perform basic create, update, retrieve, and delete operations on an entity. For more information about XRM Tooling, see [Build windows client applications using the XRM tools](build-windows-client-applications-xrm-tools.md).
 
-Download the sample: [Work with XRM Tooling API](https://code.msdn.microsoft.com/XRM-Tooling-Sample-24a5c55c)
+Download the sample: [Work with XRM Tooling API](https://github.com/Microsoft/PowerApps-Samples/tree/master/cds/Xrm%20Tooling/Quick%20start%20for%20XRM%20Tooling)
 
-## Prerequisites
+## How to run the sample
 
-[!INCLUDE [sdk-prerequisite](../../../includes/sdk-prerequisite.md)]
-  
-## Requirements
+1. Download and extract the sample from [here](https://github.com/Microsoft/PowerApps-Samples/tree/master/cds/Xrm%20Tooling/Quick%20start%20for%20XRM%20Tooling).  
+1. Open the `Quick start for XRM Tooling\C#\QuickStartXRMToolingWPFClient.sln`  file in Visual Studio.  
+1. Press **F5** to compile and run the program.  
 
-You must have access to a Common Data Service environment.
 
 ## Demonstrates
 
@@ -45,217 +44,8 @@ You must have access to a Common Data Service environment.
 - Login_ErrorLog.log: To report sign-in errors. This file is available at `C:\Users\`*`<username>`*`\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient`.  
 - QuickStartXRMToolingWPFClient.log: To report operational errors. This file is available at the same ___location as the executable, that is in the debug folder of your Visual Studio project.  
 
-## To run the sample
-
-1. Download and extract the sample.  
-1. Open the `Quick start for XRM Tooling\C#\QuickStartXRMToolingWPFClient.sln`  file in Visual Studio.  
-2. Press **F5** to compile and run the program.  
-
-## Example
-
-```csharp  
-using System;  
-using System.Collections.Generic;  
-using System.Linq;  
-using System.Text;  
-using System.Threading.Tasks;  
-using System.Windows;  
-using System.Windows.Controls;  
-using System.Windows.Data;  
-using System.Windows.Documents;  
-using System.Windows.Input;  
-using System.Windows.Media;  
-using System.Windows.Media.Imaging;  
-using System.Windows.Navigation;  
-using System.Windows.Shapes;  
-  
-// This namespace is automatically added for using   
-// components in LoginWindow\CrmLogin.xaml (common login control).  
-using QuickStartXRMToolingWPFClient.LoginWindow;  
-  
-// Add this namespace for performing   
-// various operations in CRM.  
-using Microsoft.Xrm.Tooling.Connector;  
-  
-namespace QuickStartXRMToolingWPFClient  
-{  
-    /// <summary>  
-    /// Demonstrates how to do basic entity operations like create, retrieve,  
-    /// update, and delete using the XRM Tooling APIs and the common login  
-    /// control.</summary>  
-    /// <remarks>  
-    /// At run-time, you will be given the option to delete all the  
-    /// database records created by this program.</remarks>  
-    public partial class MainWindow : Window  
-    {  
-        public MainWindow()  
-        {  
-            InitializeComponent();  
-            btnDelete.Visibility = Visibility.Hidden;  
-        }  
-  
-        #region Class Level Members  
-  
-        private CrmLogin _ctrl = null;  
-        private Guid _accountId;  
-  
-        #endregion Class Level Members  
-  
-        #region How To Sample Code  
-  
-        /// <summary>  
-        /// Connect to Microsoft CRM, and get an instance of CRMServiceClient   
-        /// </summary>  
-  
-        private void LoginButton_Click(object sender, RoutedEventArgs e)  
-        {  
-            // Create an instance of the XRM Tooling common login control  
-            _ctrl = new CrmLogin();  
-  
-            /// Wire event to the CRM sign-in response.   
-            _ctrl.ConnectionToCrmCompleted += ctrl_ConnectionToCrmCompleted;  
-            UpdateStatus("Initiating connection to CRM...");  
-  
-            /// Show the XRM Tooling common login control.   
-            _ctrl.ShowDialog();  
-  
-            /// Validate if you are connected to CRM   
-            if (_ctrl.CrmConnectionMgr != null && _ctrl.CrmConnectionMgr.CrmSvc != null && _ctrl.CrmConnectionMgr.CrmSvc.IsReady)  
-            {  
-                UpdateStatus("Connected to CRM! (Version: " + _ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgVersion.ToString() +   
-                    "; Org: " + _ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgUniqueName.ToString() + ")");  
-                UpdateStatus("***************************************");  
-                UpdateStatus("Click Start to create, retrieve, update, and delete (optional) an account record.");  
-                btnSignIn.IsEnabled = false;  
-                btnCRUD.IsEnabled = true;  
-            }  
-            // If you are not connected to CRM; display the last error and last CRM excption  
-            else  
-            {  
-                UpdateStatus("The connection to CRM failed or was cancelled by the user.");              
-            }              
-        }  
-  
-        private void btnCRUD_Click(object sender, RoutedEventArgs e)  
-        {  
-            // Create an account record  
-            Dictionary<string, CrmDataTypeWrapper> inData = new Dictionary<string, CrmDataTypeWrapper>();  
-            inData.Add("name", new CrmDataTypeWrapper("Sample Account Name", CrmFieldType.String));  
-            inData.Add("address1_city", new CrmDataTypeWrapper("Redmond", CrmFieldType.String));  
-            inData.Add("telephone1", new CrmDataTypeWrapper("555-0160", CrmFieldType.String));  
-            _accountId = _ctrl.CrmConnectionMgr.CrmSvc.CreateNewRecord("account", inData);  
-  
-            // Validate if the account is created, and then retrieve it  
-            if (_accountId != Guid.Empty)  
-            {  
-                UpdateStatus("***************************************");  
-                UpdateStatus(DateTime.Now.ToString() + ": Created an account with the following" + "\n" + "details, and retrieved it:");  
-                Dictionary<string, object> data = _ctrl.CrmConnectionMgr.CrmSvc.GetEntityDataById("account", _accountId, null);  
-                foreach (var pair in data)  
-                {  
-                    if ((pair.Key == "name") || (pair.Key == "address1_city") || (pair.Key == "telephone1"))  
-                    {  
-                        UpdateStatus(pair.Key.ToUpper() + ": " + pair.Value);  
-                    }  
-                }  
-                btnCRUD.IsEnabled = false;  
-            }  
-            else  
-            {  
-                UpdateStatus("***************************************");  
-                UpdateStatus("Could not create the account.");  
-            }  
-  
-            // Update the account record  
-            Dictionary<string, CrmDataTypeWrapper> updateData = new Dictionary<string, CrmDataTypeWrapper>();  
-            updateData.Add("name", new CrmDataTypeWrapper("Updated Sample Account Name", CrmFieldType.String));  
-            updateData.Add("address1_city", new CrmDataTypeWrapper("Boston", CrmFieldType.String));  
-            updateData.Add("telephone1", new CrmDataTypeWrapper("555-0161", CrmFieldType.String));   
-            bool updateAccountStatus = _ctrl.CrmConnectionMgr.CrmSvc.UpdateEntity("account","accountid",_accountId,updateData);  
-  
-            // Validate if the account record was updated successfully, and then display the updated information  
-            if (updateAccountStatus == true)  
-            {  
-                UpdateStatus("***************************************");  
-                UpdateStatus(DateTime.Now.ToString() + ": Updated the account details as follows:");  
-                Dictionary<string, object> data = _ctrl.CrmConnectionMgr.CrmSvc.GetEntityDataById("account", _accountId, null);  
-                foreach (var pair in data)  
-                {  
-                    if ((pair.Key == "name") || (pair.Key == "address1_city") || (pair.Key == "telephone1"))  
-                    {  
-                        UpdateStatus(pair.Key.ToUpper() + ": " + pair.Value);  
-                    }  
-                }  
-            }  
-            else  
-            {  
-                UpdateStatus("***************************************");  
-                UpdateStatus("Could not update the account.");  
-            }  
-  
-            // Prompt the user to delete the account record created in the sample  
-            UpdateStatus("***************************************");  
-            UpdateStatus("To delete the account record created by the sample, click Delete Record.");  
-            UpdateStatus("Otherwise, click Exit to close the sample application.");  
-            btnDelete.Visibility = Visibility.Visible;          
-        }  
-  
-        // Delete the account record created in this sample.  
-        private void btnDelete_Click(object sender, RoutedEventArgs e)  
-        {  
-            btnDelete.IsEnabled = false;  
-            _ctrl.CrmConnectionMgr.CrmSvc.DeleteEntity("account", _accountId);  
-            UpdateStatus("***************************************");  
-            UpdateStatus(DateTime.Now.ToString() + ": Deleted the account record.");  
-            UpdateStatus("Click Exit to close the sample application.");  
-        }  
-  
-        // Exit the sample application  
-        private void btnExit_Click(object sender, RoutedEventArgs e)  
-        {  
-            this.Close();  
-        }  
-  
-        /// <summary>  
-        /// Progressively displays the status messages about the actions  
-        /// performed during the running of the sample.  
-        /// <param name="updateText">Indicates the status string that needs to be   
-        /// displayed to the user.</param>  
-        /// </summary>  
-        public void UpdateStatus(string updateText)  
-        {  
-            if (lblStatus.Content.ToString() != String.Empty)  
-            {  
-                lblStatus.Content = lblStatus.Content + "\n" + updateText;  
-            }  
-            else  
-            {  
-                lblStatus.Content = updateText;  
-            }  
-        }  
-  
-        /// <summary>  
-        /// Raised when the login process is completed.  
-        /// </summary>  
-        private void ctrl_ConnectionToCrmCompleted(object sender, EventArgs e)  
-        {  
-            if (sender is CrmLogin)  
-            {  
-                this.Dispatcher.Invoke(() =>  
-                {  
-                    ((CrmLogin)sender).Close();  
-                });  
-            }  
-        }  
-    }  
-    #endregion How To Sample Code  
-  
-}  
-```
-
 ### See also
 
 [Use the XRM Tooling common login control](use-xrm-tooling-common-login-control-client-applications.md)<br />
 [Build Windows client applications using the XRM tools](build-windows-client-applications-xrm-tools.md)<br />
-<!-- TODO:
-[Tutorials for Learning About Common Data Service Development](../tutorials-resources-sdk.md)<br /> -->
+