SharePoint / OneDrive files
Watch a file that a report, export or partner drops into SharePoint or OneDrive. TaskBeacon reads only the file's name, size and modification time (never its contents) and shows Missed when the new file didn't come in time.
Rules
- New file by a time, e.g. by 08:00 on weekdays: OK when a file was modified since the previous deadline (12 hours before at the latest), Missed after the deadline otherwise.
- Updated at least every N hours: Missed when the file is older than N hours.
- File name with today's date: sales_{yyyy}-{MM}-{dd}.csv looks for today's file (your time zone). * matches anything; the newest match counts. A folder without a name = its newest file.
- At least … KB: a smaller file shows as Odd data (e.g. an empty export).
1. App registration and permission
Create an app registration as for Power BI (tenant ID, client ID, client secret). Then under API permissions → Add a permission → Microsoft Graph → Application permissions pick one, and an administrator presses Grant admin consent:
- Sites.Selected (recommended, least access): on its own it gives access to nothing. An administrator then grants the app read on the one site, with Microsoft Graph POST /sites/{site-id}/permissions and the body {"roles": ["read"], "grantedToIdentities": [{"application": {"id": "<client id>", "displayName": "TaskBeacon monitor"}}]} (needs Sites.FullControl.All for the person or tool that grants it, e.g. Graph Explorer or PnP PowerShell).
- Files.SelectedOperations.Selected: the same, for single files or folders instead of a whole site.
- Files.Read.All: simpler, but it can read every file in the tenant. Use it only if the selected scopes are not an option.
For a OneDrive, grant Files.SelectedOperations.Selected on the folder, or use Files.Read.All.
2. Connect in TaskBeacon
Jobs → ▾ → Add integration… → SharePoint / OneDrive. Give the site address (e.g. https://contoso.sharepoint.com/sites/Finance) or, for OneDrive, the owner's email. After Test connection and continue, use + Add a file: the path is inside the site's default document library (Documents), e.g. Reports/Daily.
Not yet tested on a real installation — tell us how it went (support@taskbeacon.io).
Use cases: Get an alert when a file doesn't arrive in SharePoint by 8:00. More questions: FAQ.