SharePoint sync

When the local folder structure is not available, you can pull it from SharePoint using piccione.

Configuration

Create a YAML file with your SharePoint credentials:

site_url: https://liveunibo.sharepoint.com/sites/PE5-Spoke4-CaseStudyAldrovandi
fedauth: <FedAuth_cookie_value>
rtfa: <rtFa_cookie_value>
folders:
  - /Shared Documents/Sala1
  - /Shared Documents/Sala2
  - /Shared Documents/Sala3
  - /Shared Documents/Sala4
  - /Shared Documents/Sala5
  - /Shared Documents/Sala6

The fedauth and rtfa values are authentication cookies. You can extract them from your browser’s developer tools after logging into SharePoint. Open the Network tab, find a request to the SharePoint site, and look for the FedAuth and rtFa cookies in the request headers.

These cookies expire after some time, so you may need to refresh them periodically.

Syncing files

To download the files from SharePoint:

uv run python -m piccione.download.from_sharepoint config.yaml /output/dir

This creates a local copy of the folder tree with all files. You can then run the metadata builder directly on it.