Overview

This node operation downloads the content of a specific document from a SharePoint document library using the Microsoft Graph API. It is useful for scenarios where you need to retrieve and process the actual file content stored in SharePoint, such as automating document retrieval for further processing, backup, or integration with other systems.

Use Case Examples

1. Downloading a PDF document from a SharePoint library to attach it to an email.
2. Retrieving an image file from SharePoint to use it in a marketing automation workflow.
3. Automating the download of reports stored in SharePoint for archival or analysis.

Properties

Output

Binary

Contains the downloaded document content encoded in base64, with metadata including the MIME type and original file name.

JSON

• operation - The operation performed, here it is 'downloadDocument'.
• siteId - The SharePoint site identifier from which the document was downloaded.
• driveId - The drive (document library) identifier within the SharePoint site.
• documentId - The unique identifier of the downloaded document.
• fileName - The name of the downloaded file.
• timestamp - The timestamp when the document was downloaded.

Dependencies

• Requires Microsoft Graph API access via an API key credential for SharePoint (smartgentMicrosoftSharePointApi).

Troubleshooting

• Authentication errors may occur if the client ID, client secret, or tenant ID are incorrect. Verify credentials and permissions.
• If the document ID is invalid or the document does not exist, the node will throw an error indicating the document could not be found.
• Access denied errors may occur if the API user does not have sufficient permissions to access the document or folder.
• Network or API rate limit issues may cause failures; ensure stable connectivity and appropriate API usage limits.

Links

• Microsoft Graph API - Get DriveItem Content - Official documentation on how to download file content from SharePoint using Microsoft Graph API.