{"id":25498,"date":"2020-11-09T10:31:36","date_gmt":"2020-11-09T10:31:36","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=25498"},"modified":"2020-11-09T10:49:39","modified_gmt":"2020-11-09T10:49:39","slug":"using-xrm-tooling-login-control-in-your-wpf-applications","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2020\/11\/using-xrm-tooling-login-control-in-your-wpf-applications\/","title":{"rendered":"Using XRM Tooling Login Control in your WPF Applications"},"content":{"rendered":"

For designing any application for Dynamics 365 CRM that is not a web resource but rather a standalone application, the first thing that is required is designing an interface to accept details to connect with Dynamics 365.<\/p>\n

Back in the old days, we used to include a couple of text boxes for user id and password and the domain usually was North American Data Center or a few others that were available back then. Since then however much has changed, data centers have been added, there are different methodologies to connect as well. With the enhancements in mind, it is no longer advisable to design your own interface for login control but rather use the one that has been thoughtfully provided as part of the Dynamics 365 CRM SDK assemblies.<\/p>\n

Let us look at how we could add this within our application and leverage its functionality to easily get a connection object for CRM that we could use further on in our application. Using this method, we do not have to bother about implementing the logic for establishing control it is already taken care of by the control.<\/p>\n

    \n
  1. The first step is to include the references to the assembly in the project. The assembly in question is Microsoft.CrmSdk.Xrm.Tooling.WpfControls<\/strong>\"Using<\/a><\/li>\n
  2. Next, let us add this assembly in the toolbox so we could add the CRMConnectControl aka the login control to our page<\/li>\n<\/ol>\n
      \n
    1. Right click the toolbox to add new items to the toolbox and select choose items
      \n      \"Using<\/a><\/li>\n<\/ol>\n
        \n
      1. This will bring up the following window, choose Browse and select the CRMConnectControl assembly from the debug folder of your application
        \n        \"Using<\/a><\/li>\n<\/ol>\n
          \n
        1. Once selected, it will list all controls available in the assembly, we are interested in the CRMServerLogin control so check that one
          \n          \"Using<\/a><\/li>\n<\/ol>\n
            \n
          1. Click OK to see the control added to the toolbox
            \n            \"Using<\/a><\/li>\n
          2. You can now double click on this control to add it to your page
            \n            \"Using<\/a><\/li>\n
          3. As soon as it is added you will see the design of the control that includes all components necessary for accepting connection details.<\/li>\n
          4. This control is a fully functional control that does not require you to add any code for establishing connection. You only need to implement the various events that have been made available by the control to perform operations required at each stage.<\/li>\n
          5. This control works in conjunction with the CrmConnectionManager class that is available within the same assembly that we added reference of earlier.<\/li>\n
          6. Write the following code to initialize the Connection Manager class<\/li>\n<\/ol>\n

            \/\/ make an object of the connection manager<\/p>\n

            mgr = new CrmConnectionManager();<\/p>\n

            \/\/ Since WS-Trust is no longer supported \u2013 provided creds for OAuth authentication<\/p>\n

            mgr.ClientId = “2ad88395-b77d-4561-9441-d0e40824f9bc”;<\/p>\n

            mgr.RedirectUri = new Uri(“app:\/\/5d3e90d6-aa8e-48a8-8f2c-58b45cc67315”);<\/p>\n

            \/\/Set Login control as the parent of the connection manager<\/p>\n

            mgr.ParentControl = CrmLoginCtrl;<\/p><\/blockquote>\n

              \n
            1. Beginning October 2020, Organization Service Proxy will no longer be supported for establishing a connection as stated here.<\/a>\n

              OAuth authentication requires Client ID and Redirect URL to be provided. Usually, this information is obtained from the Azure AD Application that you have to create in Azure AD. However per the documentation here<\/a>, the client ID and redirect URL provided in the code is globally available across all CRM online tenants and could be used in our code.<\/li>\n<\/ol>\n

                \n
              1. \n

                Now when you run the application and enter all the details and hit Login
                \n                \"Using<\/a>It will internally try to establish a connection using the details provided without you having to write any code for connection.It will raise the following events in the process:<\/p>\n

                \/\/ this wires an event that is raised when the login button is pressed.<\/p>\n

                CrmLoginCtrl.ConnectionCheckBegining += new
                \nEventHandler(CrmLoginCtrl_ConnectionCheckBegining);<\/p>\n

                \/\/ this wires an event that is raised when an error in the connect process occurs.<\/p>\n

                CrmLoginCtrl.ConnectErrorEvent += new
                \nEventHandler<ConnectErrorEventArgs>(CrmLoginCtrl_ConnectErrorEvent);<\/p>\n

                \/\/ this wires an event that is raised when a status event is returned.<\/p>\n

                CrmLoginCtrl.ConnectionStatusEvent += new
                \nEventHandler<ConnectStatusEventArgs>(CrmLoginCtrl_ConnectionStatusEvent);<\/p>\n

                \/\/ this wires an event that is raised when the user clicks the cancel button.<\/p>\n

                CrmLoginCtrl.UserCancelClicked += new
                \nEventHandler(CrmLoginCtrl_UserCancelClicked);<\/p><\/blockquote>\n

                  \n
                1. In the ConnectionStatusEvent, check if connection is established and the connection manager will return reference to the CRMServiceClient that could be used going forward in your code to perform operations in CRM application.
                  \n
                  \nCrmServiceClient CrmSvc = mgr.CrmSvc;
                  \n
                  \nLeverage this Login Control to benefit from the connection logic already implemented in this control and also to make sure you stay up to date with all the changes added to the login logic over a period of time. Being part of the CRM SDK this will most likely be updated with every update to the login methods and then all you need to do is to add a reference to the latest library and you are good to go.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

                  For designing any application for Dynamics 365 CRM that is not a web resource but rather a standalone application, the first thing that is required is designing an interface to accept details to connect with Dynamics 365. Back in the old days, we used to include a couple of text boxes for user id and\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[16,19,24],"tags":[545,592,1854,1855,1856],"class_list":["post-25498","post","type-post","status-publish","format-standard","hentry","category-dynamics-365","category-dynamics-crm","category-dynamics-crm-2016","tag-dynamics-365-crm","tag-dynamics-crm","tag-xrm","tag-xrm-dynamics-crm","tag-xrm-tooling"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/25498","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/comments?post=25498"}],"version-history":[{"count":0,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/25498\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/media?parent=25498"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/categories?post=25498"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/tags?post=25498"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}