Microsoft OneDrive Spoke
Automatisieren Sie die Datei- und Ordnerverwaltung sowie die Zusammenarbeit in Microsoft OneDrive. Fügt Microsoft OneDrive-Daten zu Ihrer ServiceNow-Instanz hinzu.
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 OneDrive-Spoke v2.5.0 ist die neueste Version.
Spoke-Abhängigkeiten
Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
Unterstützte Versionen
API-Version v1.
Spoke-Flows
Microsoft OneDrive-Spoke enthält Beispiel-Flows im Entwurfsstatus, um die Automatisierung von Microsoft OneDrive -Aufgaben zu demonstrieren. Um einen Beispiel-Flow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Folgende Beispiel-Flows sind verfügbar:
| Flow | Beschreibung |
|---|---|
| Abonnements verlängern | Verlängert die abgelaufenen Abonnements durch Aktualisierung des Ablaufdatums des Abonnements. |
Spoke-Subflows
Microsoft OneDrive-Spoke stellt Beispiel-Subflows im Entwurfsstatus bereit, um die Automatisierung von Microsoft OneDrive -Aufgaben zu demonstrieren. Um einen Beispiel-Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Folgende Beispiel-Subflows sind verfügbar:
| Subflow | Beschreibung |
|---|---|
| Laden Sie die neue OneDrive-Datei in ServiceNow herunter | Lädt die neuen Dateien, die in einer Ressource hochgeladen wurden, in einen ServiceNow-Datensatz herunter |
| Abonnieren Sie Webhook | Abonniert eine Listener-Anwendung, um Benachrichtigungen zu erhalten, wenn sich Daten ändern. |
| Changes synchronisieren | Verfolgt Änderungen an einem Laufwerk und seinen untergeordneten Elementen im Zeitablauf nach. |
| Ruft die aktuelle URL des Dokuments ab | Ruft den aktuellen Pfad einer Datei in OneDrive ab und verwendet die Sys-ID des Dokuments als Eingabe. Zur Verwendung dieses Subflows müssen eine entsprechende OneDrive-Verbindung und -Anmeldeinformation erstellt werden, und ein OneDrive-Autorisierungstoken muss verfügbar sein. |
| Verbinden Sie das Dokument erneut mit Microsoft OneDrive | Ruft die aktuelle Web-URL und WebDAV-URL eines Dokuments aus Microsoft OneDrive ab, indem die Sys-ID des Dokuments, die Sys-ID des Anbieterdetails, der Zieltabellenname, die Sys-ID der Zieltabelle und der Dokumentname verwendet werden. Zur Verwendung dieses Subflows müssen eine entsprechende OneDrive-Verbindung und -Anmeldeinformation erstellt werden, und ein OneDrive-Autorisierungstoken muss verfügbar sein. |
Spoke-Aktionen
Microsoft OneDrive-Spoke bietet Aktionen zum Automatisieren von Microsoft OneDrive -Aufgaben, wenn Ereignisse in ServiceNoweintreten. Folgende Aktionen sind verfügbar:
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Laufwerksverwaltung | Laufwerksinformationen suchen | Ruft die Metadaten eines bestimmten Microsoft OneDrive -Laufwerks ab. |
| Ordnerverwaltung | Datei- oder Ordnerelement verschieben | Verschiebt eine Datei oder einen Ordner in Microsoft OneDrive an den Zielspeicherort. |
| Ordner erstellen | Erstellt einen Ordner in Microsoft OneDrive. | |
| Datei- oder Ordnernamen aktualisieren | Aktualisiert den Namen für ein Datei- oder Ordnerelement anhand der ID. | |
| Datei- oder Ordnerelement löschen | Löscht eine Datei oder einen Ordner aus Microsoft OneDrive. | |
| Dateiverwaltung | In Datei prüfen | Checkt ein Laufwerkselement ein und sendet eine Freigabeeinladung. Wenn Sie eine Datei einchecken, können andere Benutzer auf die eingecheckte Datei zugreifen. |
| Datei auschecken | Checkt ein Laufwerkselement aus OneDrive aus. Wenn Sie ein Laufwerkselement auschecken, können andere Benutzer das Dokument nicht bearbeiten. Andere Benutzer können die Änderungen, die Sie am Dokument vorgenommen haben, erst sehen, wenn Sie das Dokument einchecken. | |
| OneDrive-Datei in Anhang kopieren | Kopiert eine Datei in Microsoft OneDrive in einen Anhang in einem Datensatz in einem ServiceNow -Datensatz. | |
| Anhang auf OneDrive kopieren | Kopiert einen Anhangsdatensatz in ServiceNow nach Microsoft OneDrive | |
| Datei- oder Ordnerelement kopieren | Erstellt asynchron eine Kopie eines Microsoft OneDrive -Elements (einschließlich untergeordneter Elemente) unter einem neuen übergeordneten Element oder mit einem neuen Namen. | |
| Elemente suchen | Ruft eine Liste von Laufwerkselementen aus einem Pfad oder der Quelle und Quell-ID eines Laufwerkselements ab. | |
| Sucht Datei- oder Ordnerelementinformationen nach ID | Ruft Datei-Metadateninformationen aus der Datei- oder Ordner-ID in Microsoft OneDriveab. |
|
| Sucht Datei- oder Ordnerelementinformationen nach Pfad | Ruft Datei-Metadateninformationen aus dem Dateipfad in Microsoft OneDriveab. | |
| Anhang über Pfad auf OneDrive kopieren | Kopiert einen Anhangsdatensatz in ServiceNow nach OneDrive. | |
| Kopieren Sie die OneDrive-Datei über den Dateipfad in den Anhang | Kopiert eine Datei unter Verwendung ihres Pfads auf OneDrive in einen Anhang in einem Datensatz in ServiceNow. | |
| Kopieren Sie die OneDrive-Dateiversion in den Anhang | Kopiert eine Datei auf OneDrive in einen Anhang in einem Datensatz in ServiceNow. | |
| Version einer Datei löschen | Löscht die angegebene Version einer Datei aus OneDrive. | |
| Alle Versionen einer Datei suchen | Ruft alle Versionen einer Datei in OneDrive ab. | |
| Dateiversion wiederherstellen | Stellt die angegebene Dateiversion wieder her und macht diese Version zur neuesten. | |
| Datei hochladen und ersetzen | Lädt die aktualisierte Version einer vorhandenen Datei hoch oder ersetzt die vorhandene Datei durch eine neue Datei. Hinweis: Die maximale Größe der Datei darf 4 MB nicht überschreiten. |
|
| Dokumente durchsuchen | Dateien oder Ordnerelemente suchen | Durchsucht die Laufwerkselemente (Dateien oder Ordner) basierend auf Metadatenattributen wie dem Elementnamen. |
| Dokumentfreigabe | Mitarbeitenden hinzufügen | Fügt einer Datei oder einem Ordner einen Mitarbeitenden und seine Berechtigungen hinzu. Sie können den Mitarbeitenden anhand seines Azure AD-Alias oder einer Objekt-ID identifizieren. |
| Mitarbeitende suchen | Listet alle Mitarbeiterdetails auf, die einer Datei oder einem Ordner in Microsoft OneDrivezugeordnet sind. | |
| Mitarbeitenden entfernen | Entfernt einen Mitarbeitenden aus einer Datei oder einem Ordner in Microsoft OneDrive. | |
| Berechtigungsverwaltung | Berechtigung hinzufügen | Sendet eine Freigabeeinladung für ein Laufwerkselement. Eine Freigabeeinladung ermöglicht den Empfängern den Zugriff auf das Laufwerkselement und sendet ihnen optional eine E-Mail mit einem Freigabelink. |
| Freigabelink erstellen | Erstellt einen Freigabelink, mit dem Sie ein Laufwerkselement für andere Anwender freigeben können. | |
| Berechtigung löschen | Entfernt den Zugriff auf ein Laufwerkselement. | |
| Berechtigungen suchen | Ruft die Freigabeberechtigungen für ein Laufwerkselement ab. | |
| Berechtigung aktualisieren | Aktualisiert das Ablaufdatum des Abonnements. | |
| Webhook-Verwaltung | Webhook abonnieren | Erstellt ein Abonnement, das Benachrichtigungen sendet, wenn sich Daten ändern. |
| Webhook abbestellen | Löscht die angegebene Abonnement-ID. | |
| SyncToken für Abonnement abrufen | Ruft das neueste Synchronisierungstoken für die angegebene Abonnement-ID ab. | |
| Abonnements suchen | Ruft die Liste der aktiven Abonnements ab. | |
| Abonnement verlängern | Aktualisiert das Ablaufdatum des Abonnements. | |
| Changes synchronisieren | Verfolgt Änderungen an einem Laufwerk und den untergeordneten Elementen des Laufwerks im Zeitverlauf nach. |
Verfügbare KI-Agenten
Installieren Sie Now Assist für Spokes, und beginnen Sie mit der Verwendung der verfügbaren KI-Agents. Weitere Informationen finden Sie unter Now Assist für Spokes.
- Im ServiceNow Agentic-System können Sie einen Anwendungsfall erstellen, der aus einem Satz von LLM-Anweisungen (Large Language Model) zusammen mit einem oder mehreren eigenständigen KI-Agents besteht, um ein Ziel auszuführen. Unter Create an agentic workflow finden Sie Informationen zum Hinzufügen von KI-Agenten, um Anwendungsfälle gemäß Ihren Anforderungen zu erstellen und die erforderlichen Auslöser bereitzustellen.
Sie können auch nach anderen verfügbaren KI-Agents suchen und sie Ihrem Anwendungsfall hinzufügen. Weitere Informationen finden Sie unter Find AI agents.
- Sie können einen Klon des erforderlichen Spoke-KI-Agents erstellen und ihn an Ihre Anforderungen anpassen. Weitere Informationen zum Erstellen eines Klons finden Sie unter Duplicate an AI agent.
- Informationen zu KI-Agents finden Sie unter Now Assist AI agents.
| KI-Agent | Beschreibung |
|---|---|
| KI-Agent für Microsoft OneDrive-Dokumentfreigabe | Fügt einen Mitarbeitenden hinzu oder entfernt ihn und verwaltet seine Berechtigungen für eine Datei oder einen Ordner in Microsoft OneDrive. Außerdem werden alle Mitarbeiterdetails aufgelistet, die einer Datei oder einem Ordner zugeordnet sind. |
| Microsoft OneDrive Drive Management AI Agent (KI-Agent). | Ruft die Metadaten eines bestimmten Laufwerks in Microsoft OneDriveab. |
| KI-Agent für Microsoft OneDrive-Dateiverwaltung | Verwaltet Dateien, Dateiversionen und Anhänge in Microsoft OneDrive. Ruft außerdem Details der erforderlichen Datei ab. |
| Microsoft OneDrive-Ordnerverwaltungs-Agent | Verwaltet Ordner in Microsoft OneDrive. |
| Microsoft OneDrive-Berechtigungsverwaltungs-Agent | Erstellt einen Freigabelink für ein Laufwerkselement und verwaltet Berechtigungen. |
Möglicherweise sind mit der Anwendung Now Assist KI-Agents installiert, die nicht in Anwendungsfällen verwendet werden. Informationen zum Anzeigen aller für Sie verfügbaren Service Desk-Mitarbeiter finden Sie unter KI-Service Desk-Mitarbeiter suchen.
Spoke-Modul
Bidirektionale Webhooks können eingerichtet werden, um Benachrichtigungen über die erforderlichen Ereignisse zu erhalten. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die ServiceNow-App zu benachrichtigen. Diese Bedingungen basieren auf den Ereignissen in OneDrive, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst eine Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum die OneDrive-Aufgaben automatisiert.
Die bidirektionalen Webhooks erfordern ein separates Setup und können unabhängig voneinander ohne Verwendung der Spoke-Aktionen verwendet werden. Standardmäßig ist die Anwendung OneDrive Webhooks in der OneDrive-Spoke verfügbar und verfügt über die folgenden Module:
| Modul | Beschreibung |
|---|---|
| OneDrive SyncToken | Ermöglicht das Anzeigen von SyncTokens von OneDrive. |
| OneDrive-Webhook-Registrierungen | Ermöglicht Ihnen das Erstellen und Anzeigen der OneDrive-Webhooks in ServiceNow. |
| Richtlinie für OneDrive-Webhook-Weiterleitung | Ermöglicht das Erstellen und Anzeigen der Weiterleitungsrichtlinien für OneDrive-Webhooks in ServiceNow. Sie können die Bedingungen in den Weiterleitungsrichtlinien auch an Ihre Anforderungen anpassen. |
Anforderungen an OneDrive Online-Accounts
Microsoft OneDrive-Spoke erfordert eine anwenderdefinierte App, die Sie in Microsoft Azure erstellen.
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
- Die OneDrive-Spoke enthält den OneDrive-Alias-Datensatz zum Autorisieren von Aktionen in Microsoft OneDrive. Wählen Sie diesen Alias im Mandantendatensatz aus, um Änderungen in Microsoft OneDrive für einen einzelnen Mandanten zu autorisieren.
Informationen zum Einrichten der Spoke finden Sie unter Richten Sie MicrosoftMicrosoft Azure Event Hubs die OneDrive-Spoke ein.
MID-Server-Anforderungen
Diese Aktionen verwenden REST-Aufrufe, die auf einer Instanz oder einem MID-Server ausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem Microsoft OneDrive-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt werden, und um Auswahlattribute für MID-Server festzulegen. Weitere Informationen finden Sie unter MID-Server.