Zum Inhalt springen

SharePoint Sync

Voraussetzungen

  • AD Admin Rechte
  • Safe AI Plus App Registration mit Sites.Read.All oder Sites.Select Berechtigung
  • Zugriffsrechte auf die SharePoint Site

1. Einrichten App Registration

Es wird angenommen, dass die App Registration bereits erstellt ist.

  1. Zum Azure Portal navigieren und nach der App Registration suchen
  2. Auf die App Registration klicken
  3. Auf "API Permissions" klicken
  4. Auf "Add a permission" klicken
  5. "Sites.Read.All" oder "Sites.Select" auswählen
App Registration API Permissions

2. Einrichten der SharePoint Site für den Zugriff durch die App Registration

2.1 MS Graph Explorer aufrufen

https://developer.microsoft.com/en-us/graph/graph-explorer

2.2 Mit dem Admin-Konto anmelden

Admin Anmeldung

2.3 Graph Explorer die richtigen Berechtigungen geben

"Sites.FullControl.All"

Graph Explorer Berechtigungen

2.4 Site-ID abrufen

Zum Abrufen der Site-ID wird folgende Abfrage verwendet, um ein minimales JSON zu erhalten:

Site-ID Abfrage 
GET | https://graph.microsoft.com/v1.0/sites?select=webUrl,Title,Id&$search="<Name of the site>*"

2.5 Gewähren Sie der App Berechtigung zum Site

Kopieren Sie die ID für den Site, den Sie der App-Berechtigung gewähren möchten, und führen Sie die folgenden Anfragen aus: 

POST | https://graph.microsoft.com/v1.0/sites/<SiteId>/permissions
Body:
{
    "roles": ["read"],
    "grantedToIdentities": [{
        "application": {
            "id": "<ClientId for your app registration>",
            "displayName": "Safe AI Plus App"
        }
    }]
}

2.6 Überprüfen Sie, ob die App Berechtigung zum Site hat

GET | https://graph.microsoft.com/v1.0/sites/<SiteId>/permissions

2.7 Abfragen der Listen ID

GET | https://graph.microsoft.com/v1.0/sites/<SiteId>/lists

Diese ID wird benötigt um die Berechtigung zu gewähren.

3. Konfiguration der Syncintervalle

Ein Sync Job wird anhand von Zeitintervallen ausgeführt. Jeder Sync Job generiert Tasks für die Verarbeitung der Dateien.

Bitte passen Sie die Intervalle den Environment-Einstellungen der Azure Function App an Ihre Bedürfnisse an. Für Cron Expressions: Crontab.guru

Sync Intervalle Konfiguration

4. Sync Jobs

4.1 Einrichten der Sync Jobs

Sync Job Einrichtung

Tragen Sie die Site-ID und die Listen-ID ein. Füllen Sie auch die Workspace ID und die Knowledge Base ID aus.

Sollte der Sync Job nur auf ein Unterverzeichnis der SharePoint Site ausgerichtet sein, können Sie dieses angeben.

Sollten Sie das Cron Expression leer lassen, wird der Job nur jeweils manuell ausgeführt.

Anschließend klicken Sie auf "Testen" und danach auf "Create".

4.2 Anzeigen der Sync Jobs

Sync Jobs Übersicht

4.3 Anzeigen der Tasks

Tasks Übersicht

4.4 Anzeigen der Knowledge Base

Knowledge Base Übersicht