Skip to content

Getting Started

Voraussetzungen

Für die Nutzung der SharePoint Activities mit Serviceverbindungen wird eine Entra-App-Registrierung benötigt.
Im Guide Entra-App-Registrierung erstellen wird Schritt für Schritt erklärt, wie du eine Entra-App-Registrierung erstellst.

Schnellstart

In diesem Abschnitt richtest du eine Serviceverbindung für die SharePoint Activities ein und nimmst den Beispiel-Workflow LABTAGON_SHAREPOINT_Example_ComputerExport in Betrieb.

Vorbereitung der Serviceverbindung

Die SharePoint Activities werden über Serviceverbindungen genutzt. Dabei wird ein delegierter Microsoft Entra ID Service verwendet.
Die bereitgestellte Serviceverbindungsprovider-Funktionalität Microsoft Graph - SharePoint (Delegated) enthält bereits den erforderlichen Berechtigungs-Umfang.

Note

Die Serviceverbindung erzeugt automatisch ein Refresh-Token, um die Verbindung nach Ablauf des Zugriffstokens wiederherzustellen.

Tenant anlegen

  1. Öffne die Applikation Administration.
  2. Navigiere zu Integration > Serviceverbindungen > Tenants.
  3. Erstelle einen neuen Tenant.
  4. Vergib einen beliebigen Namen.
  5. Wähle als Service Microsoft Entra ID.
  6. Trage die Werte deiner Entra-App-Registrierung ein:
  7. Speichere den Tenant.

image

Serviceverbindung erstellen

  1. Wechsle zur Ansicht Integration > Serviceverbindungen.
  2. Erstelle eine neue Serviceverbindung (keine Matrix42-Serviceverbindung).
  3. Wähle als Service Microsoft Entra ID (Microsoft Graph - SharePoint (Delegated)).
  4. Wähle unter Anwendung den erstellten Tenant aus.
  5. Starte über den Button Authentifizierung einrichten im Dialog die Authentifizierung.
  6. Melde dich mit einem Benutzer an, der Zugriff auf die Entra-App-Registrierung hat.
  7. Speichere die Serviceverbindung.

Warning

Der Benutzer, mit dem du dich in der Serviceverbindung authentifiziert hast, wird für die API-Aufrufe an Microsoft Graph verwendet.

image

Beispiel-Workflow nutzen

Der Beispiel-Workflow LABTAGON_SHAREPOINT_Example_ComputerExport synchronisiert Computer aus dem Matrix42 ESM System mit einer SharePoint-Liste namens Computer.

Funktionsweise des Workflows

Der Workflow arbeitet objektbasiert und führt folgende Schritte aus:

  • Baut eine Verbindung zu SharePoint auf
  • Durchläuft alle ausgewählten Computer
  • Erstellt einen neuen Listeneintrag, wenn:
    • kein Eintrag mit der ComputerId existiert und
    • der Status nicht Verschrottet ist
  • Aktualisiert einen bestehenden Eintrag, wenn:
    • der Computer nicht Verschrottet ist und
    • ein Eintrag bereits existiert
  • Löscht den Eintrag, wenn:
    • der Status Verschrottet ist und
    • ein Eintrag existiert

Workflow anpassen

  1. Öffne das Workflow Studio. Dies kannst du über die Administration unter Dienste & Prozesse > Workflow Studio über die Aktion Workflow Studio auf der angezeigten Home Page aufrufen. image
  2. Wähle Datei > Neu > Workflow von....
  3. Suche unter Workflows nach Labtagon.
  4. Wähle LABTAGON_SHAREPOINT_Example_ComputerExport aus und klicke auf Erstellen. image
  5. Vergib einen neuen Namen für den Workflow und speichere ihn.
  6. Der Workflow-Editor öffnet sich automatisch.
SharePoint-Verbindung konfigurieren
  1. Öffne die Activity Establish SharePoint Connection.
  2. Passe unter Edit Credentials die URL an. Abhängig davon, wo sich die SharePoint-Liste befindet, muss die URL um /sites/{sitename} ergänzt werden, damit auf die korrekte Site zugegriffen wird.
  3. Stelle den Authentifizierungstyp auf Service Connection um.
  4. Wähle die zuvor erstellte Serviceverbindung aus.
  5. Speichere die Änderungen.

image

SharePoint Activities anpassen

Passe in allen folgenden Activities die verwendete SharePoint-Liste an oder erstelle die Liste Computer, falls sie noch nicht existiert. Microsoft stellt auf der Learn-Seite eine kurze Schritt-für-Schritt-Anleitung zur Erstellung von SharePoint-Listen bereit: Erstellen einer neuen Liste

SharePoint-Liste vorbereiten

Stelle sicher, dass die SharePoint-Liste folgende Text-Felder enthält:

  • Title (Text)
  • Domain (Text)
  • ComputerId (Text)
  • Betriebssystem (Text)
  • Status (Text)

Workflow veröffentlichen

  1. Checke den Workflow ein.
  2. Veröffentliche den Workflow.

image

Aktion zum Ausführen des Workflows erstellen

Da der Workflow einen Integrationskontext: Aktionen verwendet, muss er über eine Aktion ausgeführt werden.

  1. Öffne die Applikation Administration.
  2. Navigiere zu Benutzeroberfläche > Aktionen.
  3. Klicke auf Pandora Aktion hinzufügen.
  4. Vergib einen Titel und einen internen Namen.
  5. Wähle unter Implementierung > Workflow starten den erstellten Workflow aus.
  6. Konfiguriere unter Auf Objekte anwenden:
    • Ziel: Mehrere Objekte
    • Filter: Nach Konfigurationselement filtern
    • Typenfilter: Nur ausgewählte
    • Konfigurationselemente: SPSComputerType
  7. Speichere die Aktion.

image

Workflow ausführen

  1. Öffne die Applikation Assets.
  2. Navigiere zu Infrastruktur > Server.
  3. Wähle die gewünschten Computer aus.
  4. Führe die erstellte Aktion aus, um:
    • Computer in SharePoint anzulegen
    • Einträge zu aktualisieren
    • oder zu löschen

image