Microsoft Word

Diese Anleitung zeigt dir, wie du ein in SharePoint gespeichertes Word-Dokument, das Content Controls (z. B. Textfelder mit Tags wie {{Name}}) enthält, automatisch per API befüllen kannst. Damit kannst du Vorlagen, Formulare oder Vertragsdokumente dynamisch generieren.

🧰 Voraussetzungen

📄 Word-Dokument mit Content Controls

1. Öffne dein Word-Dokument.

2. Aktiviere den Reiter „Entwicklertools“ (über Datei → Optionen → Menüband anpassen).

3. Füge ein Text-Content-Control ein (⚠️ kein einfacher Platzhalter-Text {{Name}}!).

4. Klicke das Content Control an → Rechtsklick → Eigenschaften.

5. Setze das Tag (z. B. Name oder Adresse).

Beispiel:

Tag	Bedeutung
Name	Name des Kunden
Adresse	Anschrift des Kunden

Verwende sprechende Tags (z. B. Kundenname, Bestellnummer), um die API-Zuordnung später klar zu halten.

---

☁️ Microsoft Azure: App-Registrierung

1. Öffne das Azure-Portal: https://portal.azure.com

2. Navigiere zu Azure Active Directory → App-Registrierungen → Neue Registrierung.

3. Gib der App einen Namen (z. B. SharePointWordWriter).

4. Wähle als Kontotyp meist „Nur dieser Mandant“.

5. Nach der Registrierung notiere dir:

   • Anwendungs-ID (Client ID)

   • Verzeichnis-ID (Tenant ID)

---

🔑 API-Berechtigungen hinzufügen

1. Unter deiner App → Menü „API-Berechtigungen“.

2. Klicke auf „Berechtigung hinzufügen“.

3. Wähle Microsoft Graph → Anwendungsberechtigungen.

4. Füge folgende Berechtigungen hinzu:

   • Sites.ReadWrite.All

   • Files.ReadWrite.All

   • Sites.Read.All

5. Klicke auf „Admin-Zustimmung erteilen“.

Diese Berechtigungen erlauben das Lesen und Schreiben von Dateien und Sites in SharePoint.

---

🧩 Client-Geheimnis erstellen

1. Unter deiner App → „Zertifikate & Geheimnisse“ → „Neues Geheimnis“.

2. Gib eine Beschreibung ein (z. B. Word-API-Access).

3. Notiere dir den erzeugten Secret-Wert – du siehst ihn nur einmal!

Bewahre das Secret sicher auf! Es wird für die Token-Authentifizierung benötigt.

---

🔐 Authentifizierung (Client Credentials Flow)

Fordere dein Access Token mit folgendem Request 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

Antwort:

{
  "access_token": "eyJ0eXAiOiJKV1QiLC..."
}

Das Access Token ist ca. 1 Stunde gültig – plane eine automatische Erneuerung in deinem Script ein.

---

🔍 Schritt 1: SharePoint site-id und item-id ermitteln

a) SharePoint-Site abrufen

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

Beispiel:

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/Dokumente

➡️ Antwort: enthält die id der Site.

b) Datei abrufen

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

➡️ Antwort: enthält die id der Datei (item-id), die du zum Schreiben benötigst.

Die Kombination aus site-id und item-id identifiziert dein Dokument eindeutig.

---

✏️ Schritt 2: Content Controls befüllen

Jetzt kommt der eigentliche Teil – das automatische Befüllen der Content Controls im Word-Dokument.

PATCH /sites/{site-id}/drive/items/{item-id}/workbook/contentControls
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "items": [
    { "tag": "Name", "text": "Max Mustermann" },
    { "tag": "Adresse", "text": "Musterstraße 123" }
  ]
}

Erklärung:

• tag: entspricht dem in Word vergebenen Tag-Namen

• text: der einzufügende Inhalt

Du kannst mehrere Content Controls gleichzeitig ersetzen, indem du sie alle im items-Array aufführst.

---

✅ Ergebnis

Wenn alles korrekt eingerichtet ist, wird das Dokument direkt in SharePoint aktualisiert. Die Content Controls werden mit den angegebenen Werten überschrieben.

Dein Word-Dokument wurde erfolgreich befüllt! Alle Änderungen sind sofort im SharePoint sichtbar.

---

⚠️ Wichtige Hinweise

• Das Dokument darf nicht ausgecheckt sein (oder du benötigst Schreibrechte).

• Die Content Controls müssen echte Textfeld-Controls mit Tags sein – keine Platzhalter oder Lesezeichen.

• Die API funktioniert nur mit .docx-Dateien, nicht mit älteren .doc-Formaten.

Falls du beim Schreiben einen „403 Forbidden“-Fehler erhältst, prüfe die Berechtigungen deiner Azure-App oder ob das Dokument derzeit ausgecheckt ist.