Microsoft SharePoint VFS
Scheme
There is no fixed scheme.
Every SharePoint Connection registers a scheme with its own name, so a connection named m365 gives you:
m365://
The credentials are stored in the connection, never in the path.
Configuration
Create a SharePoint Connection in the metadata perspective.
The application it signs in with needs the Microsoft Graph application permission Sites.Read.All to read files, or Sites.ReadWrite.All to also write them.
Usage and testing
The path follows the address of the site in SharePoint: sites or teams, the site, the document library, then the path of the file or folder in that library.
m365:///sites/<site>/<library>/<folder>/<file>
m365:///teams/<site>/<library>/<folder>/<file>
| Path | What it is |
|---|---|
|
Two fixed folders, |
|
The SharePoint sites whose address is under |
|
The SharePoint sites whose address is under |
|
The document libraries of the site |
|
The root folder of the library |
|
A file in that library |
-
The beginning of the path is what follows the host in the address of the site:
m365:///sites/Financeforhttps://contoso.sharepoint.com/sites/Finance,m365:///teams/Communicationforhttps://contoso.sharepoint.com/teams/Communication. A site under/sitesand a site under/teamscan have the same name, they are two different paths. -
The library is the name of the document library. The default library of a site is named
Documentson an English tenant, even though its URL saysShared Documents. -
Site and library names are not case-sensitive.
-
With the permission
Sites.Selectedthe folderssitesandteamsare empty, because the application can not list the sites. Enter the full path of a site it was granted, such asm365:///sites/Finance. -
The root site of the tenant and subsites are not reachable.
You can browse the sites, libraries and files in the VFS File Explorer or in any file dialog.
Microsoft Teams channels
The files of a Microsoft Teams team are stored in a SharePoint site, so they are reached with the same paths. Where the files of a channel are depends on the type of the channel.
| Channel | Site | Path |
|---|---|---|
Standard |
The site of the team |
|
Private or shared |
A site of its own, usually named |
|
-
A channel is a folder of the library
Documents, never a site or a library by itself. The folder of the default channel is namedGeneral. -
The name of the site of a team is not always the name of the team. To find the exact names, open the Files tab of the channel in Teams and choose Open in SharePoint: the path starts with what follows the host in the URL,
/sites/<site>or/teams/<site>, and the folder is what followsShared Documents/. -
The site of a team is under
/siteson most tenants and under/teamson some, use the one of the URL. -
With the permission
Sites.Selected, the site of a private or shared channel has to be granted to the application separately from the site of the team.
Limitations
-
Sites and document libraries can be listed but not created, renamed or deleted.
-
Appending to a file is not supported.
-
A file or folder can only be renamed or moved inside its document library. Moving it to another library or site copies the content and deletes the original.
-
A file is buffered in a local temporary file while it is written and is sent to SharePoint when it is closed. Files larger than 4 MB are sent in slices through an upload session.