{"id":320,"date":"2022-01-19T10:20:15","date_gmt":"2022-01-19T10:20:15","guid":{"rendered":"https:\/\/blog.citrus-lime.com\/crmc\/?p=320"},"modified":"2022-01-19T10:31:19","modified_gmt":"2022-01-19T10:31:19","slug":"addinf-docdrive365-app-to-dynamics-365","status":"publish","type":"post","link":"https:\/\/blog.citrus-lime.com\/crmc\/addinf-docdrive365-app-to-dynamics-365\/","title":{"rendered":"Adding DocDrive365 App to Dynamics 365"},"content":{"rendered":"\n

Since we started developing DocDrive there was always a challenge to how quickly we can install and release to a Customer.<\/p>\n\n\n\n

We wanted to get away from the bad old world of \u2018big integrations\u2019 that could cost a large chunk of Consultancy Time and limit the agility for how a Customer\u2019s handles their Document Management.<\/p>\n\n\n\n

We aimed to deliver half of this requirement by building a very flexible rules engine that would allow any Entity in Dynamics to work with any SharePoint Structure of Site Collections, Sites. Libraries and Folders.<\/p>\n\n\n\n

The other half was building a quick way a Customer could plug their use of Dynamics into DocDrive and start using SharePoint for Document Management in minutes rather than Hours or Days.<\/p>\n\n\n\n

It takes time, effort and dedication to build this type of \u2018self sign-up\u2019 wizard, and a good infrastructure behind the scenes, but we\u2019ve launched our DocDrive365 Wizard<\/a> recently to go alongside our promotion of DocDrive in the US<\/a>.<\/p>\n\n\n\n

We can open the DocDrive365 Wizard here<\/a>, and use the following steps to add DocDrive to a Dynamics 365 Tenant.<\/p>\n\n\n\n

Step 1 \u2013 Tell us a bit about yourself<\/h2>\n\n\n\n

As a starter for ten, we ask a new Customer for their Name, Company and Email Address.<\/p>\n\n\n\n

\"image\"<\/a><\/figure>\n\n\n\n

With these details supplied, we can click NEXT.<\/p>\n\n\n\n

This is used to create the main Connection Record in our Multi-Tenant Tracking System. (which is itself stored using the Microsoft Common Data Service)<\/p>\n\n\n\n

Step 2 \u2013 Authenticate your Azure AD with DocDrive<\/h2>\n\n\n\n

Your using Dynamics 365 in the Cloud, then you are using Azure Active Directory to manage your Users and Permission Levels.<\/p>\n\n\n\n

DocDrive is a multi-tenant App within Azure that needs your permission to connect to your Company\u2019s Azure AD and use this for Authentication.<\/p>\n\n\n\n

Clicking into Step 2 will redirect to a page in Microsoft Azure asking you to authenticate the DocDrive 365 App with your Azure AD \u2013 and this will require you to log in to your use of the Microsoft Cloud as an Admin User. (or at least a User with sufficient rights to grant your Organisation to communicate with the DocDrive App)<\/p>\n\n\n\n

\"Azure<\/a><\/figure>\n\n\n\n

Once done, you will be taken back to Step 2 of the Wizard and able to click NEXT.<\/p>\n\n\n\n

\"Step2\"<\/a><\/figure>\n\n\n\n

How does this work?  Well there is a great article here on building a new Azure AD Multi-Tenant App \u2013 and the DocDrive Service then uses this to manage the requests between your use of Dynamics and SharePoint in the Cloud.<\/p>\n\n\n\n

Step 3 \u2013 Service Account to communicate with Dynamics and SharePoint<\/h2>\n\n\n\n

Here we supply the URL for our instance of Dynamics, alongside a Username and Password for how DocDrive will communicate with Dynamics \u2013 and, crucially, how it will deploy the Managed Solutions that make up the DocDrive Customisations.<\/p>\n\n\n\n

To obtain our Dynamics URL, we can copy and paste the URL for how we access Dynamics 365.<\/p>\n\n\n\n

\"CRM_URL\"<\/a><\/figure>\n\n\n\n

NOTE: <\/strong>We don\u2019t need to worry about whether we include the \/main.aspx<\/strong> or any here Request String Details \u2013 the wizard will chop out what it needs.<\/p>\n\n\n\n

We advise doing this for a Sandbox or UAT Build of Dynamics initially so you can trial and evaluate the DocDrive way of integrating Dynamics and SharePoint before adding into your Live Environment.<\/p>\n\n\n\n

\"Step3\"<\/a><\/figure>\n\n\n\n

Clicking NEXT here will then run a Test Connection to check we can communicate with Dynamics and then move on to handling SharePoint.<\/p>\n\n\n\n

Why do I have to supply an Account here?  <\/strong>As an App, DocDrive can create a brand new Application User Account in your Azure AD, however this is currently not as automatable as we would like \u2013 so we instead opt to use a particular User or Service Account to deploy the Managed Solutions and App into your use of Dynamics.<\/p>\n\n\n\n

Step 4 \u2013 Pick SharePoint<\/h2>\n\n\n\n

The Wizard will read Dynamics to look at which SharePoint Site is potentially already configured to work with Dynamics,<\/p>\n\n\n\n

Often your Subscription to the Microsoft Cloud will include a Subscription to SharePoint and this will already be setup in Dynamics as a Default SharePoint Site.<\/p>\n\n\n\n

If so, then you will see the Default Site listed here and can simply click NEXT to continue.<\/p>\n\n\n\n

\"Step4\"<\/a><\/figure>\n\n\n\n

If not, the Wizard will offer you the option to supply your SharePoint URL and will set this up in Dynamics \u2013 this can be any SharePoint Top-Level or Individual Site URL.<\/p>\n\n\n\n

\"SharePoint_URL\"<\/a><\/figure>\n\n\n\n

This is being read from the list of SharePoint Sites stored in the Document Management area of the Dynamics 365 Settings \u2013 for convenience, the wizard is simply defaulting to the SharePoint Site setup as your default in Dynamics, however DocMan presents a range of options for what is possible here, including the ability to bring multiple Sites or Site Collections together.<\/p>\n\n\n\n

Step 5 \u2013 Deploy and Finish<\/h2>\n\n\n\n

The next step will start deploying the Managed Solutions and Default Configuration into your instance of Dynamics to get started.<\/p>\n\n\n\n

This takes place in the background via our Release Management Engine \u2013 and so we can either simply close the Wizard, as we will receive an email when the deployment is complete, or we can click REFRESH to see updates on the Deployment.<\/p>\n\n\n\n

Once the Deployment has finished, you will receive an Email stating that DocDrive is ready for use in your instance of Dynamics.<\/p>\n\n\n\n

As part of the Deployment, we add a new PowerApp to your use of Dynamics that gives an initial tour of DocDrive \u2013 the Email will contain a link to open this App and start evaluating your new Integration from SharePoint to Dynamics.<\/p>\n\n\n\n

That\u2019s it, all done \u2013 as next steps, we have a number of guides and videos on how to start reviewing or using DocDrive , which we can start here with our Day 1 Guide on Accounts and Folders<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Since we started developing DocDrive there was always a challenge to how quickly we can install and release to a Customer. We wanted to get away from the bad old world of \u2018big integrations\u2019 that could cost a large chunk of Consultancy Time and limit the agility for how a Customer\u2019s handles their Document Management.<\/p>\n","protected":false},"author":43,"featured_media":321,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_price":"","_stock":"","_tribe_ticket_header":"","_tribe_default_ticket_provider":"","_tribe_ticket_capacity":"0","_ticket_start_date":"","_ticket_end_date":"","_tribe_ticket_show_description":"","_tribe_ticket_show_not_going":false,"_tribe_ticket_use_global_stock":"","_tribe_ticket_global_stock_level":"","_global_stock_mode":"","_global_stock_cap":"","_tribe_rsvp_for_event":"","_tribe_ticket_going_count":"","_tribe_ticket_not_going_count":"","_tribe_tickets_list":"[]","_tribe_ticket_has_attendee_info_fields":false,"footnotes":""},"categories":[4],"tags":[],"class_list":{"0":"post-320","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-docdrive365"},"featured_image_src":"https:\/\/blog.citrus-lime.com\/crmc\/wp-content\/uploads\/sites\/30\/2022\/01\/Contact-header-scaled.jpg","author_info":{"display_name":"jadesmith","author_link":"https:\/\/blog.citrus-lime.com\/crmc\/author\/jadesmith\/"},"_links":{"self":[{"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/posts\/320","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/users\/43"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/comments?post=320"}],"version-history":[{"count":2,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/posts\/320\/revisions"}],"predecessor-version":[{"id":323,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/posts\/320\/revisions\/323"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/media\/321"}],"wp:attachment":[{"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/media?parent=320"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/categories?post=320"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.citrus-lime.com\/crmc\/wp-json\/wp\/v2\/tags?post=320"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}