Microsoft Excel

Diese Anleitung zeigt dir, wie du eine Excel-Datei in SharePoint automatisiert befüllst – z. B. Zellen änderst, Tabellen aktualisierst oder neue Daten einfügst. Dazu wird die Microsoft Graph API verwendet, die Zugriff auf Dateien in SharePoint ermöglicht.

---

🧰 Voraussetzungen

Excel-Datei vorbereiten

1. Öffne Excel und erstelle eine neue Datei.

2. Lege eine Tabelle an:

   • Markiere deine Daten

   • Menü „Einfügen → Tabelle“

3. Vergib im Menü „Tabellentools → Entwurf“ einen eindeutigen Namen (z. B. Kundendaten).

Beispiel:

Name	Adresse
Max Mustermann	Musterstraße 123

1. Speichere die Datei und lade sie in eine SharePoint-Dokumentbibliothek hoch.

Verwende Tabellennamen ohne Leerzeichen oder Sonderzeichen, um API-Aufrufe zu vereinfachen.

---

⚙️ 1. Microsoft Graph API Zugriff einrichten

a) Azure App registrieren

1. Öffne das Azure Portal → Azure Active Directory → App-Registrierungen.

2. Klicke auf „Neue Registrierung“ und gib deiner App einen Namen (z. B. Excel-Automation).

3. Notiere dir:

   • Client ID

   • Tenant ID

   • Client Secret (unter Zertifikate & Geheimnisse)

Speichere dein Client Secret sicher – es wird nur einmal vollständig angezeigt!

---

b) API-Berechtigungen hinzufügen

1. In der App-Registrierung → API-Berechtigungen → Berechtigung hinzufügen.

2. Wähle Microsoft Graph → Anwendungsberechtigungen.

3. Füge folgende Berechtigungen hinzu:

   • Sites.ReadWrite.All

   • Files.ReadWrite.All

   • Sites.Read.All

4. Klicke auf „Admin-Zustimmung erteilen“.

Diese Berechtigungen sind erforderlich, damit dein Script Dateien in SharePoint lesen und schreiben darf.

---

🔐 2. Authentifizierung (Client Credentials Flow)

Fordere ein Access Token über den Client-Credentials-Flow an:

POST https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/token
Content-Type: application/x-www-form-urlencoded

client_id={CLIENT_ID}
&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default
&client_secret={CLIENT_SECRET}
&grant_type=client_credentials

Das erhaltene access_token benötigst du in allen weiteren API-Aufrufen.

Access Tokens sind nur zeitlich begrenzt gültig (ca. 1 Stunde). Erstelle in deinem Script eine automatische Token-Erneuerung.

---

🔍 3. Excel-Datei in SharePoint finden

a) SharePoint-Site-ID abrufen

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/sites/{site-name}
Authorization: Bearer {access_token}

Beispiel: hostname = deinefirma.sharepoint.com site-name = marketing

b) Datei-ID abrufen

GET /sites/{site-id}/drive/root:/Pfad/zur/Datei.xlsx
Authorization: Bearer {access_token}

Die Antwort enthält unter anderem die Item-ID (id), die du für Excel-Abfragen benötigst.

Mit der Item-ID identifizierst du eindeutig die Datei im SharePoint-Drive.

---

✏️ 4. Excel-Tabelle befüllen (Hauptteil)

Beispiel: Eine Zeile zur Tabelle Kundendaten hinzufügen

POST /sites/{site-id}/drive/items/{item-id}/workbook/tables/Kundendaten/rows/add
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "values": [
    ["Max Mustermann", "Musterstraße 123"]
  ]
}

Erklärung:

• Kundendaten: Tabellenname in deiner Excel-Datei

• values: Array von Arrays → jede innere Liste entspricht einer Tabellenzeile

Du kannst auch mehrere Zeilen gleichzeitig einfügen, indem du mehrere Arrays innerhalb von "values" definierst.

---

🔄 Optional: Bestimmte Zelle direkt ändern

Beispiel: Zelle A2 direkt überschreiben

PATCH /sites/{site-id}/drive/items/{item-id}/workbook/worksheets/{sheet-id}/range(address='A2')
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "values": [["Neuer Inhalt"]]
}

• sheet-id: Ermittelbar über GET /sites/{site-id}/drive/items/{item-id}/workbook/worksheets

• range(address='A2'): Definiert die Zielzelle

Dieser Ansatz ist nützlich, wenn du einzelne Werte – z. B. Status oder Summen – gezielt aktualisieren möchtest.

---

✅ Zusammenfassung

Mit der Microsoft Graph API kannst du Excel-Dateien in SharePoint automatisiert bearbeiten:

• Tabellenzeilen hinzufügen

• Zellen gezielt ändern

• Daten synchronisieren

Nach erfolgreicher Einrichtung kannst du Excel-Dateien nahtlos in deine Workflows oder automatisierte Reports integrieren – ganz ohne manuelles Öffnen in Excel.