SharePoint

primedocs lässt sich direkt in Microsoft SharePoint-Dokumentbibliotheken integrieren. Die SharePoint App fügt einen primedocs-Button in die SharePoint-Toolbar ein, über den Benutzer Dokumente aus primedocs Vorlagen erstellen und direkt in der Dokumentbibliothek ablegen können.

Übersicht

Ein Klick auf den Toolbar-Button öffnet die primedocs web-Applikation innerhalb von SharePoint. Nach der Vorlagenauswahl, dem Ausfüllen des Formulars und der Bestätigung wird das generierte Dokument automatisch in der SharePoint-Dokumentbibliothek gespeichert, aus der die Schaltfläche geöffnet wurde.

Voraussetzungen

• Es wird eine Office 365 / Entra ID (Azure Active Directory)-Authentifizierung benötigt. Dokumente werden im Namen des angemeldeten Benutzers in SharePoint gespeichert.
• Die Entra ID App Registration benötigt die Delegate Permissions Sites.ReadWrite.All und Files.ReadWrite.All.
• Es werden ausschliesslich webfähige primedocs Vorlagen unterstützt.

Funktionsweise

1. Die SharePoint App wird über ein .sppkg-Paket im SharePoint Admin Center installiert.
2. Im Root der SharePoint Site wird eine Liste primedocsSettings erstellt mit einem Eintrag TemplatePickerUrl, der auf https://{INSTANCE-NAME}/app/web/sharepoint zeigt.
3. Beim Klick auf den Toolbar-Button hängt die App der TemplatePickerUrl sechs Query-Parameter an, damit primedocs das Dokument in der richtigen Bibliothek ablegen kann.

URL-Parameter

Die App liest die Werte aus dem SharePoint-Seitenkontext und übergibt sie an primedocs Web:

Parameter	Wert	Bedeutung
saveLocationSharePointSiteId	GUID	ID der SharePoint-Site (Site Collection), in der die Bibliothek liegt.
saveLocationSharePointSiteName	Anzeigename	Titel der Site (nur zur Anzeige).
saveLocationSharePointFolderPath	Server-relativer Teilpfad	Aktueller Ordner relativ zur Bibliothek (Bibliotheks-Wurzel abgeschnitten). Im Wurzelordner leer.
saveLocationSharePointListId	GUID	ID der Dokumentbibliothek (SharePoint-Liste).
saveLocationSharePointListName	Anzeigename	Titel der Dokumentbibliothek (nur zur Anzeige).
saveLocationSharePointUrl	Absolute URL (URL-kodiert)	Adresse der SharePoint-Bibliotheksseite, von der aus geöffnet wurde (für den «Zurück»-Link).

Zum Speichern des Dokuments verwendet primedocs die drei Parameter saveLocationSharePointSiteId, saveLocationSharePointListId und saveLocationSharePointFolderPath (Ablage über Microsoft Graph). Die übrigen drei (…SiteName, …ListName, …Url) dienen nur der Anzeige im Browser.

Beispiel-URL (Werte gekürzt):

https://{INSTANCE-NAME}/app/web/sharepoint?saveLocationSharePointSiteId=a1b2c3d4-…&saveLocationSharePointFolderPath=/Vertraege/2026&saveLocationSharePointListId=f9e8d7c6-…&saveLocationSharePointSiteName=Legal&saveLocationSharePointListName=Dokumente&saveLocationSharePointUrl=https%3A%2F%2Fcontoso.sharepoint.com%2F…

Installation

Detaillierte Installationsanweisungen finden sich unter Microsoft SharePoint App-Installation.