Microsoft SharePoint Online Spoke
Die Microsoft SharePoint Online -Spoke integriert Ihre ServiceNow® -Instanz in Microsoft SharePoint Online, sodass Sie verschiedene vordefinierte Aktionen als Teil einer Workflow-Instanz automatisieren können. Sie können beispielsweise einen Ordner in Microsoft SharePoint Online umbenennen, wenn ein Datensatz in der Datenbank aktualisiert wird.
Apps im Store anfordern
Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.
IntegrationHub-Abonnement
Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.
Spoke-Version
Microsoft SharePoint Online Spoke v2.7.0 ist die neueste Version.
Hinweis:
Die Microsoft SharePoint Online-Spokes bieten keine Unterstützung für SharePoint – lokal.
Spoke-Abhängigkeiten
Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- Komplexes Objekt (com.glide.cobject)
- ServiceNow Workflow-Studio Dynamische Eingaben (com.glide.hub.dynamic_inputs)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Aktionsvorlage – Datenstrom (com.glide.hub.action_type.datastream)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
Hinweis:
Einige dieser Plugins sind lizenzierbare Funktionen und erfordern eine entsprechende Lizenz, wenn sie außerhalb der Spoke-Implementierung verwendet werden. Informationen zu Lizenzen erhalten Sie von Ihrem Account Manager.
Unterstützte Versionen
Microsoft SharePoint Application Programming Interface (API) Version v1.
Spoke-Abläufe
Die Microsoft SharePoint Online -Spoke stellt Beispiel-Flows im Entwurfsstatus bereit, um die Automatisierung der Microsoft SharePoint Online -Aufgaben zu demonstrieren. Um einen Beispielablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Die folgende Tabelle zeigt die verfügbaren Beispiel-Flows.
| Flow | Beschreibung |
|---|---|
| Neuer Anhang in Datensatz erstellt Ordner und kopiert Anhang | Wenn in einer Datenbanktabelle ein Anhang erstellt wird, wird in der Spoke Microsoft SharePoint Online ein Ordner für einen Wissensdatensatz erstellt. Dann wird der Anhang in den Ordner kopiert. |
| Site für Knowledge Base erstellen | Wenn in der Datenbanktabelle eine Knowledge Base erstellt wird, erstellt der Flow eine Site dafür unter Microsoft SharePoint Online |
Hinweis:
- Wenn Single Sign-on (SSO) eingerichtet ist, können Sie die Aktion Anwenderinformationen nach Anmeldename suchen verwenden und überprüfen, ob Sie zur Ausführung der Spoke-Aktionen berechtigt sind.
- Flow-Designer und Aktionsdesigner müssen sicherstellen, dass die Prüfungen der Benutzerberechtigung durchgeführt werden, bevor der Flow oder die Aktion ausgeführt wird.
Spoke-Unterabläufe
Die Microsoft SharePoint Online -Spoke stellt einen Beispiel-Subflow im Entwurfsstatus bereit, um die Automatisierung von Microsoft SharePoint Online -Aufgaben zu demonstrieren. Um den Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich.
| Subflow | Beschreibung |
|---|---|
| Entfernen Sie einen Anwender, und fügen Sie ihn dann einer Gruppe hinzu | Entfernt einen Anwender aus einer Gruppe Microsoft SharePoint Online und fügt einen neuen Anwender hinzu. |
| Moderne Website löschen (ohne O365-Gruppe) | Löscht die moderne Website, die der Nicht-O365-Gruppe (Kommunikationswebsite) zugeordnet ist. |
| Moderne Website (mit O365-Gruppe) zur Löschung einreichen |
Sendet eine moderne Website (mit O365-Gruppe) zur Löschung.
Hinweis: Es kann bis zu 30 Minuten dauern, bis die Website in den Abschnitt „Gelöschte Websites“ des SharePoint-Administratorportals verschoben wird. |
Hinweis:
Flow-Designer und Aktionsdesigner müssen sicherstellen, dass Prüfungen der Benutzerberechtigung durchgeführt werden, bevor der Flow oder die Aktion ausgeführt wird.
Spoke-Aktionen
Die Microsoft SharePoint Online -Spokebietet Aktionen zur Automatisierung verschiedener Microsoft SharePoint Online ]-Aufgaben, die auf den Auslösern in der ServiceNow ]-Instanz basieren.
Einige Aktionen können Sie mithilfe der SharePoint Online-Verbindung und die verbleibenden Aktionen mithilfe der SharePoint Graph-Verbindung ausführen.
Die Aktionen in der folgenden Tabelle verwenden die SharePoint Online-Verbindung und den Aliasdatensatz für Anmeldeinformationen.
| Aktionen, die den Aliasdatensatz für SharePoint Online -Verbindungen und -Anmeldeinformationen verwenden | ||
|---|---|---|
| Kategorie | Aktion | Beschreibung |
| Site-Verwaltung | Erstellen Sie einen modernen Standort | Erstellt eine moderne Website der Typen Kommunikationsstandorte und Nicht-Gruppe zugeordnete Teamstandorte. |
| Erstellen Sie eine Unterwebsite | Erstellt eine Unterwebsite in SharePoint Online. Der Mandant bestimmt den Stammspeicherort. | |
| Löschen Sie die moderne Site | Löscht die moderne Website, die der Nicht-O365-Gruppe (Kommunikationswebsite) zugeordnet ist. | |
| Löschen Sie die moderne Website mit der O365-Gruppe | Senden Sie die moderne Website, die der O365-Gruppe (Teamwebsite) zugeordnet ist, zur Löschung. Es löscht die zugeordnete 0365-Gruppe, die die Site löscht. Hinweis: Nach der Ausführung kann es bis zu 30 Minuten dauern, bis eine Site gelöscht wird. |
|
| Löschen Sie die Unterwebsite | Entfernt eine Unterwebsite aus SharePoint Online. Die verwendete Verbindungs-URL bestimmt den Stammspeicherort. | |
| Sucht nach Informationen zu modernen Site-Gruppen | Ruft die zugehörigen O365-Gruppendetails eines modernen Standorts (Teamstandort) ab. | |
| Sucht nach Informationen zum modernen Standort | Ruft die Details einer modernen Site ab. | |
| Changes für Website suchen | Ruft die Changes für eine Site basierend auf den Abfragebedingungen ab. | |
| Rollenzuweisungen suchen | Ruft alle Rollenzuweisungen ab, die für die Site definiert sind. | |
| Websitesammlungs-ID suchen | Sucht nach einer bestimmten Site-ID. | |
| Unterwebsite-Details suchen | Sucht nach Informationen zu einer Unterwebsite. | |
| Websiteinformationen aktualisieren | Aktualisiert eine Microsoft SharePoint Online -Site. | |
| Ordnerverwaltung | Ordner erstellen | Erstellt einen Ordner in einer Dokumentbibliothek auf einer Website Microsoft SharePoint Online. |
| Ordner löschen | Löscht einen Ordner in Microsoft SharePoint Online. Hinweis: Sie erhalten keine Warnung oder Benachrichtigung, bevor der Ordner entfernt wird. |
|
| Dateien in einem Ordner auflisten | Ruft eine Liste von Dateien in einem Ordner ab. | |
| Ordner in einem Ordner auflisten | Ruft eine Liste der Ordner in einem Ordner ab. | |
| Ordner suchen | Sucht nach einem Ordner in Microsoft SharePoint Online und gibt seine Eigenschaften zurück. Beispielsweise kann die Ausgabe die Eigenschaft „Relative URL“ enthalten. | |
| Einen Ordner umbenennen | Benennt einen Ordner in Microsoft SharePoint Onlineum. | |
| Ordner für Gruppe freigeben | Gibt einen Ordner für eine Gruppe in Microsoft SharePoint Onlinefrei . Die Gruppe muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Ordner für Anwender freigeben | Gibt einen Ordner für einen Anwender inMicrosoft SharePoint Onlinefrei . Der -Benutzer muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Freigabe des Ordners für Gruppe aufheben | Entfernt den Zugriff auf einen Ordner aus einer Gruppe. Die Gruppe muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Ordnerfreigabe für Anwender aufheben | Entfernt den Zugriff auf einen Ordner von einem Anwender. Der -Benutzer muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Dateiverwaltung | SharePoint-Datei an einen Datensatz anhängen | Hängt eine Microsoft SharePoint Online -Datei an einen ServiceNow -Datensatz an. |
| Datei einchecken | Legt eine Datei in Microsoft SharePoint Online mit dem Status „Eingecheckt“ fest. Um die Versionsnummer einer Datei zu finden, nachdem ihr Status auf „Eingecheckt“ festgelegt wurde, verwenden Sie die Aktion „Dateidetails suchen“, Hinweis: Die Datei wurde bereits hochgeladen, und die Aktion aktualisiert nur den Status der einzucheckenden Datei. |
|
| Datei auschecken | Legt eine Datei in Microsoft SharePoint Online mit dem Status „Ausgecheckt“ fest. Um die Versionsnummer einer Datei zu finden, nachdem ihr Status auf „Ausgecheckt“ festgelegt wurde, verwenden Sie die Aktion „Dateidetails suchen“, Hinweis: Die Datei wurde bereits heruntergeladen, und die Aktion aktualisiert nur den Status der Datei auf „Ausgecheckt“. |
|
| Anhang in Ordner kopieren | Kopiert einen ServiceNow -Anhang in einen Microsoft SharePoint Online -Ordner. | |
| Datei kopieren | Kopiert eine Datei mit einem neuen Namen. | |
| Textdatei erstellen | Erstellt eine Textdatei mit den von Ihnen angegebenen Informationen. | |
| Datei löschen | Löscht eine Datei in Microsoft SharePoint Online. | |
| Dateidetails suchen | Sucht nach den Dateidetails in Microsoft SharePoint Online. | |
| Datei verschieben | Verschiebt eine Datei an einen anderen Speicherort in Microsoft SharePoint Online. | |
| Datei für Gruppe freigeben | Gibt eine Datei für eine Gruppe inMicrosoft SharePoint Onlinefrei . Die Gruppe muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Datei für Anwender freigeben | Gibt eine Datei für den Anwender Microsoft SharePoint Online frei. Der -Benutzer muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Freigabe der Datei für Gruppe aufheben | Entfernt den Zugriff auf eine Datei aus einer Gruppe Microsoft SharePoint Online. Die Gruppe muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Dateifreigabe für Anwender aufheben | Entfernt den Zugriff auf eine Datei von einem Microsoft SharePoint Online -Anwender. Der -Benutzer muss zum Mandantenkonto Microsoft SharePoint Online gehören. | |
| Anwenderverwaltung | Anwenderinformationen nach Anmeldename | Durchsucht eine Microsoft SharePoint Online -Site nach Informationen zu einem Anwender und gibt die Informationen zurück. |
| Anwenderinformationen nach E-Mail suchen | Durchsucht die angegebene Website Microsoft SharePoint Online nach einem bestimmten Anwender und gibt SharePoint-Informationen zu diesem Account zurück. | |
| SharePoint-Gruppen des Anwenders suchen | Durchsucht die Website Microsoft SharePoint Online nach Informationen zu allen Gruppen, in denen ein Benutzer Mitglied ist, und gibt die Informationen zurück. | |
| Suchverwaltung | Stream mit Suchabfrageergebnissen suchen | Durchsucht die SharePoint-Stammwebsite und ruft das Ergebnis basierend auf der angegebenen Suchabfrage ab. |
| Gruppenverwaltung | Rolle zu Website hinzufügen | Fügt einem Anwender oder einer Gruppe Microsoft SharePoint Online eine Rolle hinzu. |
| Anwender zu Gruppe hinzufügen | Fügt einen Anwender zu einer Site-Gruppe Microsoft SharePoint Online hinzu. | |
| Gruppe erstellen | Erstellt eine Gruppe an einer Website Microsoft SharePoint Online. | |
| Gruppe löschen | Löscht eine Gruppe an einer Site Microsoft SharePoint Online. | |
| Gruppe nach Name suchen | Sucht nach einer Gruppe anhand ihres Namens an einem Standort in Microsoft SharePoint Online. Wenn kein Standortspeicherort angegeben ist, durchsucht die Aktion den Stammstandort des Mandanten. | |
| Rolle von Site entfernen | Entfernt Berechtigungen von einer Gruppe oder einem Anwender. | |
| Anwender aus Gruppe entfernen | Entfernt einen Anwender aus einer Site-Gruppe Microsoft SharePoint Online. | |
| Gruppenbesitzer aktualisieren (Anwender) | Aktualisiert einen Anwender als Gruppenbesitzer. | |
| Sucht M365-Mitglieder anhand der Site-Gruppe | Ruft eine Liste der Anwender und M365-Gruppen ab, die einer Site-Gruppe Microsoft SharePoint Online zugeordnet sind. | |
| Listenverwaltung | Liste erstellen | Erstellt eine Liste in einer Website Microsoft SharePoint Online mit Titel und Beschreibung. |
| Listenabonnement erstellen | Erstellt ein Webhook-Abonnement für eine Liste. | |
| Liste nach ID löschen | Löscht eine Liste in einer Website Microsoft SharePoint Online anhand ihrer ID. | |
| Listendetails nach ID suchen | Sucht anhand der ID nach einer Liste auf einer Website Microsoft SharePoint Online. | |
| Listen-ID nach Titel suchen | Sucht anhand des Titels nach einer Liste in Microsoft SharePoint Online. | |
| Aktualisiert die Liste in einer Website anhand der ID | Aktualisiert eine Liste in einer Website Microsoft SharePoint Online anhand ihrer ID. | |
| Listenelementverwaltung | Listenelement erstellen | Erstellt ein Listenelement in einer Liste. |
| Listenelement nach ID löschen | Löscht ein Listenelement anhand der Listen-ID und der Listenelement-ID. | |
| Listenelement nach ID suchen | Sucht ein Listenelement anhand der Listen-ID und der Listenelement-ID. | |
| Listenelemente in einer Liste suchen | Ruft eine Liste von Elementen aus einer Liste in verschiedenen Formaten ab. | |
| Listenelement nach ID aktualisieren | Aktualisiert den Titel eines Listenelements anhand seiner ID. | |
Hinweis:
Flow-Designer und Aktionsdesigner müssen sicherstellen, dass Prüfungen der Benutzerberechtigung durchgeführt werden, bevor der Flow oder die Aktion ausgeführt wird.
Diese Aktionen verwenden den Aliasdatensatz für SharePoint Graph-Verbindungen und -Anmeldeinformationen:
| Aktionen, die den Aliasdatensatz für SharePoint Graph -Verbindungen und -Anmeldeinformationen verwenden | ||
|---|---|---|
| Kategorie | Aktion | Beschreibung |
| Change-Management | Änderungsabfrageeigenschaften abrufen | Ruft die Änderungsabfrageeigenschaften ab, die zum Definieren einer Abfrage verwendet werden, die für das Änderungsprotokoll ausgeführt wird. |
| Delta-Link-Token für Laufwerk abrufen | Ruft das neueste Delta-Link-Token für ein Laufwerk ab. | |
| Nächstes Token abrufen | Ruft das nächste Link-Token aus der Tabelle „Nächstes Link-Token der SharePoint-Ressource“ ab. | |
| Dateiverwaltung | Link zum Herunterladen der Datei abrufen | Ruft die Download-URL der Datei ab. |
| Dateiberechtigungen suchen | Ruft die Berechtigungen für eine Datei ab. | |
| Dateien suchen | Ruft alle Dateien auf einem Laufwerk ab. | |
| Listenverwaltung | Listenabonnement erstellen | Erstellt ein Webhook-Abonnement für eine Liste. |
| Listenabonnement verlängern | Verlängert ein Webhook-Abonnement für eine Liste. | |
| Listenabonnement löschen | Löscht das Webhook-Abonnement für eine Liste. | |
| Liste abrufen | Ruft die Details einer Liste aus dem SharePoint-Mandanten ab. | |
| Laufwerke suchen | Ruft alle Laufwerke für eine Site ab. | |
| Site-Verwaltung | Websitesammlungen suchen | Ruft alle Websitesammlungen ab. |
| Unterwebsites suchen | Ruft Details aller Unterwebsites für eine Website ab. | |
| Root-Site-Abonnement erstellen | Erstellt ein Webhook-Abonnement für eine Stammwebsite. | |
| Websiteberechtigungen suchen | Ruft alle Berechtigungen für eine Site ab. | |
| Website abrufen | Ruft die Site-Details ab. | |
Anforderungen an SharePoint Online-Accounts
Die Microsoft SharePoint Online -Spoke erfordert, dass Sie eine anwenderdefinierte App in Ihrem SharePoint Online-Konto erstellen, um OAuth 2.0-Token zu generieren. Weitere Informationen finden Sie unter Konfigurieren Sie die OAuth-Anwendung in Microsoft Azure.
Alias-Anforderungen für Verbindungen und Anmeldeinformationen
IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.
- Einzelmandant
- Diese Spoke enthält den MicrosoftSharepointOnline-Aliasdatensatz zum Autorisieren von Aktionen für Microsoft SharePoint Online. Wählen Sie diesen Alias im Mandantendatensatz aus, um Änderungen in Microsoft SharePoint Online für einen einzelnen Mandanten zu autorisieren.
- Mehrere Mandanten
- Diese Spoke enthält den MicrosoftSharepointOnline-Aliasdatensatz zum Autorisieren von Aktionen für Microsoft SharePoint Online. Erstellen Sie einen Aliasdatensatz für Verbindungen und Anmeldeinformationen für jede zusätzliche Mandantenwebsite, die Sie unterstützen möchten. Wählen Sie den richtigen Alias im Mandantendatensatz aus, um Änderungen in Microsoft SharePoint Online zu autorisieren. Erstellen Sie einen Aliasdatensatz für Verbindungen und Anmeldeinformationen für jede zusätzliche Mandantenwebsite, die Sie unterstützen möchten. Wählen Sie den richtigen Alias im Mandantendatensatz aus, um Änderungen in Microsoft SharePoint Online zu autorisieren. Siehe Aliasse für mehrere Mandanten erstellen.
Hinweis:
Standardmäßig sind drei Aliasdatensätze mit der -Spoke verfügbar. SharePoint Online, SharePoint Graph und SharePoint Graph Root Site Subscription. Jedem Aliasdatensatz muss ein Mandant zugeordnet werden. Wenn Sie alle SharePoint Online-, Graph- und Stammabonnementaktionen in der Spoke verwenden möchten, müssen Sie sicherstellen, dass Sie in den Mandantentabellen der Microsoft SharePoint Online-Spoke drei Mandantendatensätze erstellt haben, sodass jeder Mandantendatensatz dem entsprechenden Alias zugeordnet ist Datensatz
- Wenn Sie eine Integration für einen einzelnen Mandanten konfigurieren, verwenden Sie den vorhandenen MicrosoftSharepointOnline -Aliasdatensatz.
- Sie können mehrere Mandanten nur mit dem Microsoft SharePoint Graph- Verbindungsalias verwenden.