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-Spokev 2.6.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
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 Zeitablauf nach. |
| Aktuelle URL des Dokuments abrufen | 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 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
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 nach Microsoft OneDriveZum Zielstandort. |
| Ordner erstellen | Erstellt einen Ordner in Microsoft OneDrive. | |
| Datei- oder Ordnernamen aktualisieren | Aktualisiert den Namen für ein Datei- oder Ordnerelement nach 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 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. | |
| OneDrive-Datei in Anhang kopieren | Kopiert eine Datei in Microsoft OneDriveZu einem Anhang in einem Datensatz in einem ServiceNow Datensatz. | |
| Anhang auf OneDrive kopieren | Kopiert einen Anhangsdatensatz in ServiceNow Bis Microsoft OneDrive | |
| Datei- oder Ordnerelement kopieren | Erstellt asynchron eine Kopie von Microsoft OneDriveElement (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. | |
| Suchen Sie Datei- oder Ordnerelementinformationen nach ID | Ruft Dateimetadaten-Informationen aus der Datei- oder Ordner-ID in ab Microsoft OneDrive. |
|
| Suchen Sie Datei- oder Ordnerelementinformationen nach Pfad | Ruft Dateimetadaten-Informationen aus dem Dateipfad in ab Microsoft OneDrive. | |
| Anhang über Pfad auf OneDrive kopieren | Kopiert einen Anhangsdatensatz in ServiceNow auf OneDrive. | |
| Kopieren Sie die OneDrive-Datei mithilfe des Dateipfads in den Anhang | Kopiert eine Datei mit ihrem Pfad in 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 auf 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 | Durchsuchen Sie Dateien oder Ordnerelemente | 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 mitarbeitenden Details auf, die einer Datei oder einem Ordner in zugeordnet sind Microsoft OneDrive. | |
| 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. Mit einer Freigabeeinladung können die Empfänger auf das Laufwerkselement zugreifen und optional eine E-Mail mit einem Freigabelink senden. |
| 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 eines Laufwerkselements 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 Laufwerken im Laufe der Zeit. |
Verfügbare KI-Agents
Installieren 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.
- In ServiceNow Agentic-System können Sie einen agentischen Workflow erstellen, der aus einem Satz von Anweisungen für ein großes Sprachmodell (LLM) zusammen mit einem oder mehreren eigenständigen KI-Agents besteht, um ein Ziel auszuführen. Siehe Create an agentic workflow Informationen zum Hinzufügen von KI-Agents zum Erstellen von agentischen Workflows gemäß Ihren Anforderungen und zum Bereitstellen des erforderlichen Auslösers.
Sie können auch nach anderen verfügbaren KI-Agents suchen und sie Ihrem agentischen Workflow hinzufügen. Weitere Informationen finden Sie unter Find AI agents.
- Sie können einen Klon des erforderlichen Spoke-KI-Agents erstellen und entsprechend Ihren Anforderungen anpassen. Siehe Duplicate an AI agent Weitere Informationen zum Erstellen eines Klons.
- Siehe Now Assist AI agents Für Informationen zu KI-Agents.
| KI-Agent | Beschreibung |
|---|---|
| Microsoft OneDrive KI-Agent für Freigabeverwaltung | 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. |
| Microsoft OneDrive Laufwerkmanagement-KI-Agent | Ruft die Metadaten eines bestimmten Laufwerks in ab Microsoft OneDrive. |
| Microsoft OneDrive KI-Agent für Dateiverwaltung | Verwaltet Dateien, Dateiversionen und Anhänge in Microsoft OneDrive. Ruft außerdem Details der erforderlichen Datei ab. |
| Microsoft OneDrive Ordnerverwaltung – KI-Agent | Verwaltet Ordner in Microsoft OneDrive. |
| Microsoft OneDrive Berechtigungsmanagement-KI-Agent | Erstellt einen Freigabelink für ein Laufwerkselement und verwaltet Berechtigungen. |
- Möglicherweise sind KI-Agenten mit installiert Now AssistAnwendung, die nicht in Agenten-Workflows verwendet wird. Informationen zum Anzeigen aller in Ihrer Instanz verfügbaren Agenten finden Sie unter Suchen Sie KI-Agenten .
- Um Agenten zu finden, die möglicherweise nicht auf Ihrer Instanz installiert sind, besuchen Sie die KI-Agenten-Marktplatz Auf ServiceNow Store.
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 Anwendung OneDrive Webhooks 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. |
| Richtlinie für OneDrive-Webhook-Weiterleitung | 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. 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 auf Microsoft OneDrive. 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 Microsoft OneDrive-Spoke.
MID-Server-Anforderungen
Diese Aktionen verwenden REST-Aufrufe, die entweder auf einer Instanz oder optional über 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 werden, und geben Sie bei Bedarf an MID-Server Auswahlattribute. Weitere Informationen finden Sie unter MID-Server.
Zum Einrichten von MID-ServerInformationen zu dieser Spoke finden Sie unter Einrichten MID-Server Für eine Spoke.