This guide will help organization that needs the capability to open PDF files with Drawboard PDF from OneDrive for Business.
The official documentation could be found here https://learn.microsoft.com/en-us/onedrive/developer/file-handlers/?view=odsp-graph-online
Below is the detailed guide:
1. Create a new service principal in Microsoft Entra
Navigate to Microsoft Entra in Azure portal, under App registrations, click on New registration
Assign a name and select Accounts in this organization directory only
IMPORTANT: Please keep this application accessible internally only as it can affect external users’ experience if accessible by external organizations
2. Add custom action
Open created application Manifest under Manage, and update addIns as below:
NOTE: Please generate and apply new GUID on id field
--------------------------------------------------------------------------------------------------------------------
"addIns": [
{
"id": "6ca9408b-7a5b-4f1d-8052-b01d31319aab",
"type": "FileHandler",
"properties": [
{
"key": "version",
"value": "2"
},
{
"key": "appIcon",
"value": "{\"svg\":\"https://dbpdfimages.b-cdn.net/Drawboard_PDF_Icon.svg\",\"png1x\":\"https://dbpdfimages.b-cdn.net/Drawboard_PDF_Icon.svg\"}"
},
{
"key": "actionMenuDisplayName",
"value": "Drawboard PDF (Internal)"
},
{
"key": "actions",
"value": "[{\"type\":\"open\",\"url\":\"https://us-prod-prod.dbpdf.drawboard.com/api/v1/documents/onedrive/open\",\"displayName\":\"Open in Drawboard (Internal)\",\"shortDisplayName\":\"Open in Drawboard (Internal)\",\"icon\":{\"png1x\":\"https://dbpdfimages.b-cdn.net/Drawboard_PDF_Icon.svg\"},\"availableOn\":{\"file\":{\"extensions\":[\".pdf\",\"png\",\"tif\",\"tiff\",\"jpg\",\"jpeg\",\"bmp\",\"gif\"]},\"web\":{}}}]"
}
]
}
],
--------------------------------------------------------------------------------------------------------------------
Click Save to apply
3. Grant admin consent
Open API permissions under Manage, and click on Grant admin consent
Once completed, custom file handler action will be added for your organization’s users. However, it may take up to 48 hours for this new action to be applied.