Zum Inhalt

Setup#

Die Middleware wird von der Stella Helper App aus aufgerufen. Dazu werden essentielle Informationen über die M365 Umgebung benötigt. Diese müssen zuvor in der Konfiguration der Stella Helper App definiert werden:

Feld Beschreibung
Tenant ID * ID des M365 Tenants
Site ID (Root Site) * Vollständige Site ID, siehe Abschnitt Site ID ermitteln
Stella App ID * Die App ID, die bei der Registrierung von Stella CRM in M365 generiert wurde
Stella Client Secret * Das Client Secret dieser App in M365. Achten Sie darauf, dass Sie den Wert und nicht die ID des Secrets wählen!
Teams Template ID muss standard heißen
Folder Name Name des Ordners, der als Vorlage in ein neues Team kopiert werden soll, z.B. Projektakte
Template Drive ID (Root Folder) ID des Root Ordners der Site, siehe Abschnitt Ermitteln der Vorlagen ID
Template ID ID des o.g. Ordners, siehe Abschnitt Ermitteln der Vorlagen ID
Base URL Stella Middleware URL zur Stella M365 Middleware, z.B. http(s)://middleware.local:3000

Tenant ID ermitteln#

Gehen Sie zum Microsoft Entra Admin Center (https://entra.microsoft.com/). Melden Sie sich mit Ihren Admin-Zugangsdaten an. Klicken Sie auf Identität > Übersicht. Die Tenant ID wird unter Basisinformationen angezeigt.

Site ID ermitteln#

Rufen Sie als angemeldeter Nutzer den Microsoft Graph Explorer (https://developer.microsoft.com/en-us/graph/graph-explorer) auf und geben Sie dort folgende URL ein:

https://graph.microsoft.com/v1.0/sites/root

Der Response sieht wie folgt aus:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites/$entity",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET sites('<key>')?$select=displayName,error",
    "createdDateTime": "2020-10-16T22:12:37.283Z",
    "description": "",
    "id": "demo.sharepoint.com,abc86969-d4f3-xxxx-849f-7d737242ce1f,5e243794-c1cf-xxxx-a483-b0c4309a04c1",
    "lastModifiedDateTime": "2025-03-27T11:24:49Z",
    "name": "",
    "webUrl": "https://demo.sharepoint.com",
    "displayName": "Communication site",
    "root": {},
    "siteCollection": {
        "hostname": "demo.sharepoint.com"
    }
}

Im Feld id findet sich die Site ID.

Es kann sein, dass Sie im Tab Modify Permissions die Berechtigungen des Graph Explorers explizit freigeben müssen, um den Request anzufordern.

Hinweis

Können die Berechtigungen hier nicht freigegeben werden, so muss der allgemeine Admin-Consent zur Anwendung "Graph Explorer" gegeben werden. Eine Beschreibung dafür finden Sie hier.

Liste aller Sites#

Sucht man eine bestimmte Site, z.B. um die Site ID im Zusammenhang mit einem Liegenschafts-Ordner zu nutzen, bietet sich die Liste aller Sites an, auf die man Zugriff hat. Im Graph Explorer muss dazu die URL https://graph.microsoft.com/v1.0/sites?search=* aufgerufen werden. Der Response beinhaltet ein Array aller Sites inkl. deren IDs.

Ermitteln der Vorlagen ID#

Die Stella M365 Middleware bietet eine einfache Möglichkeit, diverse Einzelwerte aus dem Tenant automatisch zu ermitteln. Erforderlich dazu sind nur die * markierten Einstellungen. Bei der Site ID wird nur der erste Teil (also <tenant>.sharepoint.com) benötigt.

Option 1: Postman#

Erstellen Sie in Postman einen neuen Request, Typ POST. Die URL ist die Root-URL der Stella Middleware und /setup. Im Request Body sind die o.g. Daten anzugeben:

{
    "tenantId":"xxxxxx-6257-4f05-ad98-xxxxxx",
    "appId":"xxxxxx-570f-4d94-acd9-f41cbfc7f3c5",
    "clientSecret":"xxxxxxxCIo63JI.O51N8b5z",
    "sharepointUrl": "demo.sharepoint.com",
    "templateName": "Projektakte"
}

Option 2: M365 Job ertstellen#

Die alternative und einfachere Methode ist die Erstellung eines M365 Jobs in der Stella Helper App. Gehen Sie dazu in der Anwenung auf Create, bitM365Job.

Füllen Sie die Maske entsprechend aus:

Weitere Angaben sind nicht erforderlich. Warten Sie nun die Abarbeitung des Jobs durch die Stella Helper App ab. Ist dies erledigt, sehen Sie folgende Daten in der Maske:

Der Response findet sich im Feld Response.

Der Response bei beiden Optionen stellt dann bei Erfolg die restlichen Daten in dieser Form dar:

{
    "rootSite": "demo.sharepoint.com,xxxxx-d4f3-4668-849f-xxxxxxx,xxxxx-c1cf-4dd2-a483-xxxxxxx",
    "rootFolder": "b!NtmjzPPabcbabcbaBMGCfkRf4yZfxxxxxxxTHis",
    "templateId": "xxxxxITZEZNU5AQECQNZOB",
    "plannerId": "com.microsoft.teamspace.tab.planner",
    "oneNoteId": "xxxxxx-def2-4297-adad-xxxxxx",
    "status": "ok",
    "message": "Setup data successfully delivered"
}

Übertragen Sie die Werte in die Konfiguration. Dabei gilt folgende Zuordnung:

Feld im Response Feld in der Konfiguration
rootSite Site ID (Root Site)
rootFolder Template Drive ID (Root Folder)
templateId Template ID