Add README.md with project documentation
This commit is contained in:
39
README.md
Normal file
39
README.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# SharePoint Folder Download Tool
|
||||
|
||||
Dette script gør det muligt at downloade specifikke mapper fra et SharePoint dokumentbibliotek til din lokale computer ved hjælp af Microsoft Graph API. Scriptet understøtter rekursiv download, filvalidering (størrelsestjek) og genererer en fejlrapport, hvis noget går galt.
|
||||
|
||||
## Funktioner
|
||||
|
||||
* **Rekursiv Download:** Downloader alle undermapper og filer i de valgte mapper.
|
||||
* **Fejlrapportering:** Genererer en CSV-fil med detaljer om eventuelle fejl undervejs.
|
||||
* **Dataintegritet:** Sammenligner lokal filstørrelse med SharePoint-størrelsen for at sikre korrekt overførsel.
|
||||
* **Entra ID Integration:** Benytter MSAL for sikker godkendelse via Client Credentials flow.
|
||||
|
||||
## Installation
|
||||
|
||||
1. Sørg for at have Python 3 installeret.
|
||||
2. Installer de nødvendige biblioteker:
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
## Konfiguration
|
||||
|
||||
Indstil dine forbindelsesoplysninger i `connection_info.txt`:
|
||||
* `TENANT_ID`, `CLIENT_ID`, `CLIENT_SECRET` (Fra Microsoft Entra admin center).
|
||||
* `SITE_URL`: URL til din SharePoint site.
|
||||
* `DOCUMENT_LIBRARY`: Navnet på dokumentbiblioteket (f.eks. "22 Studies").
|
||||
* `FOLDERS_TO_DOWNLOAD`: Liste over mapper adskilt af komma.
|
||||
* `LOCAL_PATH`: Hvor filerne skal gemmes lokalt.
|
||||
|
||||
## Anvendelse
|
||||
|
||||
Kør scriptet med:
|
||||
```bash
|
||||
python download_sharepoint.py
|
||||
```
|
||||
|
||||
Efter kørsel vil en CSV-rapport (f.eks. `download_report_20260326.csv`) være tilgængelig, hvis der er opstået fejl.
|
||||
|
||||
## Sikkerhed
|
||||
Husk at `.gitignore` er sat op til at ignorere `connection_info.txt`, så dine adgangskoder ikke uploades til Git.
|
||||
Reference in New Issue
Block a user