Microsoft OneDrive Spoke
Automatisieren Sie die Datei- und Ordnerverwaltung und -Zusammenarbeit in Microsoft OneDrive. Fügt Hinzu Microsoft OneDriveDaten zu Ihrem ServiceNowInstanz.
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-Spokev 2.5.0 Ist die neueste Version.
Spoke-Abhängigkeiten
Wenn Sie Probleme bei der Installation der App haben, stellen Sie sicher, dass diese abhängigen Plugins installiert sind:
- ServiceNow IntegrationHub-Aktionsschritt – REST (com.Glide.Hub.action_STEP.Rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
Unterstützte Versionen
API-Version v1.
Spoke-Flows
Die Microsoft OneDrive-SpokeGibt Beispiel-Flows im Entwurfsstatus an, um die Automatisierung zu demonstrieren Microsoft OneDriveAufgaben. Um einen Beispiel-Flow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Flows:
| Flow | Beschreibung |
|---|---|
| Abonnements Verlängern | Verlängert die abgelaufenen Abonnements, indem das Ablaufdatum des Abonnements aktualisiert wird. |
Spoke-Subflows
Die Microsoft OneDrive-SpokeStellt Beispiel-Subflows im Entwurfsstatus bereit, um die Automatisierung zu demonstrieren Microsoft OneDriveAufgaben. Um einen Beispiel-Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Subflows:
| 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 |
| Webhook abonnieren | Abonniert eine Listener-Anwendung, um Benachrichtigungen zu erhalten, wenn sich Daten ändern. |
| Changes Synchronisieren | Verfolgt Änderungen an einem Laufwerk und seinen untergeordneten Elementen im Laufe der Zeit. |
| Ruft die neueste URL des Dokuments ab | Ruft den neuesten Pfad einer Datei in OneDrive mithilfe der SYS-ID des Dokuments als Eingabe ab. 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 über Microsoft OneDrive | Ruft die neueste Web-URL und webdav-URL eines Dokuments aus Microsoft OneDrive ab, indem die Dokument-SYS-ID, die Anbieterdetails-SYS-ID, der Zieltabellenname, die Zieltabellen-SYS-ID 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
Die Microsoft OneDrive-SpokeStellt Aktionen zur Automatisierung bereit Microsoft OneDriveAufgaben, wenn Ereignisse in auftreten ServiceNow. Folgende Aktionen sind verfügbar:
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Laufwerksverwaltung | Laufwerksinformationen suchen | Ruft die Metadaten eines bestimmten ab Microsoft OneDriveLaufwerk. |
| Ordnerverwaltung | Datei- Oder Ordnerelement Verschieben | Verschiebt eine Datei oder einen Ordner in Microsoft OneDriveZum Zielstandort. |
| Ordner erstellen | Erstellt einen Ordner in Microsoft OneDrive. | |
| Aktualisieren Sie Den Datei- Oder Ordnernamen | Aktualisiert den Namen für ein Datei- oder Ordnerelement nach ID. | |
| Löschen Sie Datei- Oder Ordnerelement | Löscht eine Datei oder einen Ordner aus Microsoft OneDrive. | |
| Dateiverwaltung | Datei Einchecken | Checkt ein Laufwerkselement ein und sendet eine Freigabeeinladung. Wenn Sie eine Datei einchecken, können andere Anwender auf die eingecheckte Datei zugreifen. |
| Datei Auschecken | Checkt ein Laufwerkselement aus OneDrive aus. Wenn Sie ein Laufwerkselement auschecken, können andere Anwender das Dokument nicht bearbeiten. Andere Anwender können auch die Änderungen, die Sie im Dokument vorgenommen haben, erst sehen, wenn Sie das Dokument eingecheckt haben. | |
| Kopieren Sie die OneDrive-Datei in den Anhang | Kopiert eine Datei in Microsoft OneDriveZu einem Anhang in einem Datensatz in einem ServiceNowDatensatz. | |
| Kopieren Sie den Anhang auf OneDrive | Kopiert einen Anhangsdatensatz in ServiceNowBis Microsoft OneDrive | |
| Kopieren Sie Datei- Oder Ordnerelement | Erstellt asynchron eine Kopie von Microsoft OneDriveElement (einschließlich untergeordneter Elemente), unter einem neuen übergeordneten Element oder mit einem neuen Namen. | |
| Suchen Sie nach Elementen | Ruft eine Liste von Laufwerkselementen aus einem Pfad oder der Quell- und Quell-ID eines Laufwerkselements ab. | |
| Suchen Sie Datei- oder Ordnerelementinformationen nach ID | Ruft Dateimetadateninformationen aus der Datei- oder Ordner-ID in ab Microsoft OneDrive. |
|
| Suchen Sie Datei- oder Ordnerelementinformationen nach Pfad | Ruft Dateimetadateninformationen aus dem Dateipfad in ab Microsoft OneDrive. | |
| Kopieren Sie den Anhang mithilfe des Pfads auf OneDrive | Kopiert einen Anhangsdatensatz in ServiceNow nach OneDrive. | |
| Kopieren Sie die OneDrive-Datei mithilfe des Dateipfads in den Anhang | Kopiert eine Datei mithilfe ihres Pfads in OneDrive in einen Anhang in einem Datensatz in ServiceNow. | |
| Kopieren Sie die OneDrive-Dateiversion in den Anhang | Kopiert eine Datei in OneDrive in einen Anhang in einem Datensatz in ServiceNow. | |
| Löschen Sie die Version einer Datei | Löscht die angegebene Version einer Datei aus OneDrive. | |
| Sucht nach allen Versionen einer Datei | Ruft alle Versionen einer Datei in OneDrive ab. | |
| Dateiversion Wiederherstellen | Stellt die angegebene Dateiversion wieder her, und machen Sie 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 durchsuchen | Durchsucht die Laufwerkselemente (Dateien oder Ordner) basierend auf Metadatenattributen wie dem Elementnamen. |
| Dokumentfreigabe | Fügen Sie Einen Mitarbeitenden Hinzu | 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. |
| Suchen Sie nach Mitarbeitenden | Listet alle Mitarbeitenden-Details auf, die einer Datei oder einem Ordner in zugeordnet sind Microsoft OneDrive. | |
| Entfernen Sie Den Mitarbeitenden | Entfernt einen mitarbeitenden aus einer Datei oder einem Ordner in Microsoft OneDrive. | |
| Berechtigungsverwaltung | Berechtigung Hinzufügen | Sendet eine Freigabeeinladung für ein Laufwerkselement. Mit einer Freigabeeinladung können die Empfänger auf das Laufwerkselement zugreifen und senden ihnen optional eine E-Mail mit einem Freigabelink. |
| Erstellen Sie Einen Freigabelink | Erstellt einen Freigabelink, mit dem Sie ein Laufwerkselement für andere Anwender freigeben können. | |
| Berechtigung Löschen | Entfernt den Zugriff auf ein Laufwerkselement. | |
| Sucht nach Berechtigungen | Ruft die Freigabeberechtigungen eines Laufwerkselements ab. | |
| Aktualisieren Sie Die Berechtigung | 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. | |
| Sucht nach Abonnements | 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 Laufe der Zeit. |
Verfügbare KI-Agenten
Installieren Sie Now Assist für Spokes, und verwenden Sie die verfügbaren KI-Agenten. Weitere Informationen finden Sie unter Now Assist Für Spokes.
- Im ServiceNow-Agenten-System können Sie einen Anwendungsfall erstellen, der aus einem Satz von Anweisungen für ein großes Sprachmodell (LLM) zusammen mit einem oder mehreren eigenständigen KI-Agenten besteht, um ein Ziel auszuführen. Siehe Create an agentic workflowFür Informationen zum Hinzufügen KI-AgentenUm Anwendungsfälle gemäß Ihren Anforderungen zu erstellen und den erforderlichen Auslöser bereitzustellen.
Sie können auch nach anderen verfügbaren KI-Agenten suchen und sie Ihrem Anwendungsfall hinzufügen. Weitere Informationen finden Sie unter Find AI agents.
- Sie können einen Klon des erforderlichen Spoke-KI-Agenten erstellen und ihn an Ihre Anforderungen anpassen. Siehe Duplicate an AI agentWeitere Informationen zum Erstellen eines Klons.
- Siehe Now Assist AI agentsFür Informationen zu KI-Agenten.
| 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. Listet außerdem alle Mitarbeitenden-Details auf, die einer Datei oder einem Ordner zugeordnet sind. |
| KI-Agent für Microsoft OneDrive-Laufwerkverwaltung | Ruft die Metadaten eines bestimmten Laufwerks in ab Microsoft OneDrive. |
| KI-Agent für Microsoft OneDrive-Dateiverwaltung | Verwaltet Dateien, Dateiversionen und Anhänge in Microsoft OneDrive. Ruft außerdem Details der erforderlichen Datei ab. |
| KI-Agent für Microsoft OneDrive-Ordnerverwaltung | Verwaltet Ordner in Microsoft OneDrive. |
| KI-Agent für Microsoft OneDrive-Berechtigungsmanagement | Erstellt einen Freigabelink für ein Laufwerkselement und verwaltet Berechtigungen. |
Möglicherweise sind KI-Agenten mit installiert Now AssistAnwendung, die nicht in Anwendungsfällen verwendet wird. Informationen zum Anzeigen aller für Sie verfügbaren Service Desk-Mitarbeiter finden Sie unter KI-Agenten 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 verwendet werden, ohne die Spoke-Aktionen zu verwenden. Standardmäßig ist die OneDrive-Webhooks-Anwendung in der OneDrive-Spoke verfügbar und verfügt über die folgenden Module:
| Modul | Beschreibung |
|---|---|
| OneDrive-SyncToken | Ermöglicht Ihnen das Anzeigen von SyncTokens von OneDrive. |
| OneDrive-Webhook-Registrierungen | Ermöglicht Ihnen das Erstellen und Anzeigen der OneDrive-Webhooks in ServiceNow. |
| OneDrive-Webhook-Weiterleitungsrichtlinie | Ermöglicht Ihnen das Erstellen und Anzeigen der Weiterleitungsrichtlinien für die OneDrive-Webhooks in ServiceNow. Sie können die Bedingungen in den Weiterleitungsrichtlinien auch Ihren Anforderungen entsprechend anpassen. |
OneDrive-Online-Account-Anforderungen
Die Microsoft OneDrive-SpokeErfordert 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. Durch die Verwendung eines Alias müssen bei der Verwendung mehrerer Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie keine Aktionen aktualisieren, die die Verbindung verwenden.
- Einzelner Mandant
- Die OneDrive-Spoke enthält den OneDrive-Alias-Datensatz, um Aktionen auf Microsoft OneDrive zu autorisieren. Wählen Sie diesen Alias im Mandantendatensatz aus, um Änderungen in zu autorisieren Microsoft OneDriveFür einen einzelnen Mandanten.
Informationen zum Einrichten der Spoke finden Sie unter Einrichten MicrosoftMicrosoft Azure Event HubsOneDrive-Spoke.
MID-Server Anforderungen
Diese Aktionen verwenden REST-Aufrufe, die auf einer Instanz oder ausgeführt werden können MID-Server. Verwenden Sie den Verbindungsdatensatz, der dem Microsoft OneDrive-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt und festgelegt werden MID-ServerAuswahlattribute. Weitere Informationen finden Sie unter MID-Server .