Menü der Dokumentation

Einrichten von d.velop contracts for Microsoft 365

Bereitstellen der Instanzkonfiguration 

Pro SharePoint-Mandant können mehrere Instanzen von d.velop contracts for Microsoft 365 bereitgestellt werden. Eine Instanz entspricht dabei einer Websitesammlung in SharePoint Online.

Die Bereitstellung einer Instanzkonfiguration erfolgt durch die d.velop AG. Folgende Informationen müssen dem d.velop-Support mitgeteilt werden:

  • Mandanten-ID von Microsoft Entra ID

  • URL der Websitesammlung (siehe Kapitel Systemvoraussetzungen)

  • Schema für die automatische Generierung einer internen VertragsId, für eine VertragsId nach dem Schema CM00001 müssen folgende Werte angegeben werden:

    • Startwert, z.B. 1.

    • Schrittgröße, z.B. 1.

    • Anzahl der Ziffern, z.B. 5.

    • Präfix für die VertragsID, z.B. CM.

  • Name des SharePoint-Mandanten

    • Bei der SharePoint-URL https://<mytenant>.sharepoint.com wäre dies mytenant.

  • Gewünschte ID der Instanz

    • Bei der URL https://contracts.d-velop365.com/<mystanceid> wäre dies myinstanceid.

Erteilen der Berechtigung für die Microsoft Entra ID-Unternehmensanwendungen 

Im Kontext eines globalen Administrators des Microsoft 365-Mandanten muss den Berechtigungsanforderungen zugestimmt werden.

Entsprechend dem Kapitel Systemarchitektur sind dies die Anwendungen:

  • d.velop 365

  • d.velop 365 service user

Erteilen der Administrationszustimmung zu den d.velop-Apps - So geht's 

  1. Öffnen Sie https://onboarding.d-velop365.com.

  2. Klicken Sie auf Login.

  3. Melden Sie sich mit Ihrem berechtigten Benutzerkonto an.

  4. Wählen Sie d.velop contracts for Microsoft 365 aus.

  5. Klicken Sie unter Benutzerberechtigungen auf Administrationszustimmung für fehlende Benutzerberechtigungen geben.

  6. Klicken Sie auf auf Ihr Benutzerkonto oder klicken Sie auf Anderes Konto verwenden, um sich mit einem anderen berechtigten Benutzerkonto anzumelden.

  7. Klicken Sie auf Akzeptieren.

  8. Klicken Sie auf Status prüfen, um zu ermitteln, ob Microsoft die Administratorzustimmung bereits verarbeitet hat. Die Aktualisierung kann bis zu drei Minuten dauern. Wiederholen Sie diesen Schritt, bis alle Berechtigungen mit einem grünen Haken versehen sind.

  9. Wiederholen Sie die Schritte 4-7 für Serviceaccountberechtigungen.

Die Zustimmung gilt für den Mandanten.

Wenngleich die Zustimmung für d.velop contracts durch jeden einzelnen Benutzer möglich ist, empfehlen wir die zentrale Zustimmung durch einen Administrator.

Einrichten des Dienstkontos für Hintergrundprozesse 

Für den Betrieb von d.velop contracts for Microsoft 365 wird ein dediziertes Dienstkonto benötigt. Das Dienstkonto muss als SharePoint-Websiteadministrator in der verwendeten SharePoint-Site berechtigt sein. Dabei ist es wichtig, dass das Dienstkonto explizit über die Seite Websiteberechtigungen der jeweiligen SharePoint Site berechtigt wird. Sie gelangen über die folgende URL zur Seite Websiteberechtigungen:

Beispiel für URL 

https://yourtenant.sharepoint.com/sites/yoursite/_layouts/15/user.aspx

Ersetzen Sie in der URL "yourtenant" sowie "yoursite" durch ihre Daten.

  1. Öffnen Sie die Seite Konfigurationsseite https://contracts-config.d-velop365.com/.

  2. Melden Sie sich mit einem Benutzeraccount an, der zuvor als Anwendungsadministrator berechtigt wurde.

  3. Sehen Sie nach der Anmeldung keine aufgelisteten Konfigurationen, loggen Sie sich einmal aus und erneut ein.

  4. Führen Sie die folgenden Schritte für JEDE der angezeigten Konfigurationen aus

    1. Wählen Sie eine Konfiguration.

    2. Kopieren Sie den Link unter Link zum Starten der Service-Account Einrichtung zum Starten der Service-Account Einrichtung in die Zwischenablage.

    3. Öffnen Sie in Ihrem Browser ein neues InPrivate-Fenster (anonymes Fenster). So stellen Sie sicher, dass Sie nicht versehentlich Ihr aktuelles Benutzerkonto als Dienstkonto einrichten.

    4. Fügen Sie den zuvor kopierten Link aus Ihrer Zwischenablage ein und rufen Sie diesen auf.

    5. Wählen Sie die Schaltfläche Service-Account Anmeldung starten.

    6. Melden Sie sich mit den Benutzerdaten des Dienstkontos an.

    7. Nachdem Sie die Bestätigung sehen, schließen Sie das InPrivate-Fenster.

    8. Aktualisieren Sie die vormals geöffnete Konfigurationsseite. Sie sehen nun einen Status zur Hinterlegung unter dem Punkt Service-Account Status sowie zum SharePoint-Site-Administrator Status unter dem Punkt Service-Account ist Site-Administrator.

Erstellen der SharePoint-Struktur 

Die Erstellung der SharePoint-Struktur wird durch die d.velop AG initiiert sobald die Berechtigung für die Microsoft Entra ID-Unternehmensanwendungen erteilt und das Dienstkonto für die Hintergrundprozesse eingerichtet wurde.

Die Ausführung erfolgt im Kontext des Dienstkonto für Hintergrundprozesse.

Zugriff auf d.velop contracts for Microsoft 365 

Nach erfolgreicher Konfiguration kann d.velop contracts for Microsoft 365 über den Webbrowser aufgerufen werden.

Die Umgebung kann von allen Benutzern entsprechend Ihrer Berechtigungen innerhalb der Websitesammlung aufgerufen werden.

Die ID Ihrer Instanz wird Ihnen durch die d.velop AG mitgeteilt.

Aufruf von d.velop contracts for Microsoft 365

  • Öffnen Sie die Webseite https://contracts.d-velop365.com/<ID der Instanz>