Overview
What the SharePoint connector does, who sets it up, and who runs it afterwards.
Edmund synchronises documents from SharePoint. A file placed in a monitored folder appears in the matching Edmund project without anyone uploading it by hand.
Access is read-only. Edmund reads documents; it never writes, moves or deletes anything in SharePoint. Synchronisation is one-way.
Deletion in SharePoint removes the document from Edmund; nothing Edmund does reaches the library.
Every mapped folder shows its own synchronisation state in Edmund, so a folder that has stopped syncing — most often because it was renamed — is visible rather than silent.
Scope of this document
| Part | Covers | Done |
|---|---|---|
| A — Initial setup | Application registration, permissions, site grant, entering the connection in Edmund | Once, by the customer |
| B — Operation | Uploading, updating, deleting, folder structure, mapping, secret rotation | Continuously, by the customer |
Part A is done once, and needs administrator rights in the customer’s Microsoft tenant. Everything in part B the customer administers alone: files and folders in SharePoint, mapping and the client secret in Edmund, where both need the Administrator role.
Division of responsibility
| Task | Customer | Edmund |
|---|---|---|
| Register the application, create the secret, consent the permissions | ● | |
| Grant the application access to the site | ● | |
| Enter the connection values in Edmund | ● | |
| Create, rename or restructure folders | ● | |
| Connect a folder to a project | ● | |
| Replace an expiring client secret | ● | |
| Diagnose a failed synchronisation | ● | ● |
The client secret is entered by the customer’s own administrator and never sent to Edmund.
Where documents come from
Every document in Edmund records how it arrived, shown in the Source column of the document list:
| Source | Meaning |
|---|---|
| SharePoint | Synchronised automatically from a monitored folder |
| Upload | Uploaded through the Edmund interface |
| Admin | Uploaded by Edmund on your behalf |
| Legacy | Present before the source was recorded |
Terms
| Term | Meaning |
|---|---|
| Site | A SharePoint site collection. The connector is granted access to one site |
| Document library | A library within that site. Microsoft Graph calls it a drive |
| Drive ID | The identifier of that library. Edmund needs it to read the library |
| Monitored path | A folder path within the library that feeds an Edmund project |
| Project | The Edmund unit a monitored path maps onto — typically one machine or station |