Document Locations
If you enable Sharepoint document integration in your model driven apps, you can define for which entities the possibility to upload documents to sharepoint shall be offered and you can define a folder structure.Possible folder structures can either be based on account or contact, which means if you create child items (e.g. opportunities, activities, ...) sub folders are created below.
If an entity is enabled for document management a "Files" tab is added to the form of your model driven app and as soon as you click on that tab a folder is automatically generated on Sharepoint.
Once the folder has been created you have options to create new or upload existing file or to open the document location (folder) on Sharepoint:
What happens behind the scenes is, as soon as you click on the files tab your model driven app checks, weither a "document location" for this item already exists, or not.
The document location is an own entity in CDS, that acts as the connecting part between CRM and Sharepoint:
It stores information like the regarding record, the relative url (= folder) and the parent document location (= parent folder):
So if you have e.g. a structure based on account, you would have multiple document locations, like:
parent site > account > account name _ guid > opportunity > topic _ guid ... and all of them just store the relative url.
Identify absolute URL
But what happens under the hood if you click on "Open document location"? How does Dynamics generate the absolute URL of the underlying Sharepoint location?For that purpose an own Web API function called RetrieveAbsoluteAndSiteCollectionUrl exists. This function returns the absolute Sharepoint url and the url of the site collection.
Power Automate - Get absolute Sharepoint URL
Some time ago I blogged about how to upload e-mail attachments from CRM to Sharepoint using Power Automate / Flow: http://crmaddicted.blogspot.com/2020/01/working-with-email-attachments-in-power.htmlWhat I did not describe back then was, how to setup the necessary document locations in CRM or identify the absolute URL of existing sharepoint locations, e.g. if you have to move certain folders on Sharepoint.
This is something I've been working on the last days and it looks like that:
I check using a "List records action" weither a document location already exists for an opportunity, or not:
If the folder exists, I invoke an http request and call the web api function RetrieveAbsoluteAndSiteCollectionUrl to get the absolute URL of the underlying Sharepoint folder, like that:
<CRM URL>/api/data/v9.1/sharepointdocumentlocations(<GUID of documentlocation>)/Microsoft.Dynamics.CRM.RetrieveAbsoluteAndSiteCollectionUrl()
Then I parse the JSON and get the absolute URL and site collection URL:
Based on that information I can work out the url of the sharepoint site, the document library or the folder, depending on what input your sharepoint action needs (e.g. create file, move folder, ...):
I really enjoy the blog article.Much thanks again.
ReplyDeleteMuleSoft training
MuleSoft online training