Box-Spoke
Verschieben Sie Anlagen nach Box, wo sie als freigegebene Dokumente verwaltet werden können.
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
Box-Spoke v3.2.2 ist die neueste Version.
Unterstützte Versionen
API-Version v2.
Spoke-Anforderungen
Stellen Sie sicher, dass in Ihrer Instanz ServiceNow und im Box-Konto dieselben Sprachen ausgewählt sind.
- Wählen Sie in Ihrer Instanz ServiceNow die gewünschte Sprache aus, indem Sie zu navigieren .
- Wählen Sie in Ihrem Box-Konto die gewünschte Sprache aus, indem Sie zu navigieren .
Spoke-Abläufe
Box-Spoke stellt Beispiel-Flows im Entwurfsstatus bereit, um die Automatisierung von Box-Aufgaben zu demonstrieren. Um einen Beispielablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispielabläufe umfassen Folgendes:
| Flow | Beschreibung |
|---|---|
| Anhang bei Erstellung in Box verschieben | Verschiebt Anhangdateien aus ServiceNow nach Box, wenn ein neuer Anhangsdatensatz hinzugefügt wird. Aktualisiert den Auslöserdatensatz mit einem freigegebenen Link zur verschobenen Anhangdatei in Box. |
| Onboarding des Benutzers | Erstellt einen Box-Anwender, wenn Sie einen ServiceNow -Anwender in der Box-Anwendergruppe erstellen. |
Spoke-Aktionen
Box-Spoke bietet Aktionen zum Automatisieren von Box-Aufgaben, wenn in ServiceNowEreignisse eintreten. Folgende Aktionen sind verfügbar:
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Dokumentenmanagement | Der Datei Metadaten hinzufügen | Gibt anwenderdefinierte Daten für eine bestimmte Datei oder einen bestimmten Ordner an. |
| Boxdatei an Datensatz anhängen | Kopiert eine Datei aus Box und hängt sie an den angegebenen Datensatz ServiceNow an. | |
| Suchdatei-ID | Ruft die ID der angegebenen Datei in Box ab. | |
| Element im Besitz verschieben | Verschiebt alle Elemente im Besitz des angegebenen Anwenders in Box in den angegebenen Ordner. | |
| Datei entfernen | Entfernt die angegebene Datei aus Box. | |
| Inhalts-Stream durchsuchen | Sucht nach Dateien, Ordnern, Web-Links und freigegebenen Dateien im Inhalt des Benutzers oder im gesamten Unternehmen. | |
| Datei hochladen | Lädt die angegebene Datei in Box hoch. | |
| Dokumentfreigabe | Mitarbeitenden hinzufügen | Gewährt einem Benutzer oder einer Gruppe eine bestimmte Zugriffsebene für eine bestimmte Datei oder einen bestimmten Ordner. Mitarbeitende haben eine dieser Zugriffsebenen.
|
| Freigegebenen Link erstellen | Erstellt einen direkten und schreibgeschützten Link zu einer Datei oder einem Ordner in Box. | |
| Mitarbeitende am Ordner anhand ID suchen | Ruft alle Mitarbeitenden ab, die der angegebenen Ordner-ID zugeordnet sind. | |
| Mitarbeitenden entfernen | Entfernt die angegebene Zusammenarbeit aus einer Datei oder einem Ordner in Box. | |
| Ordnerverwaltung | Ordner erstellen | Erstellt einen Ordner in Box im Namen des angegebenen Box-Anwenderaccounts. |
| Ordner löschen | Löscht den angegebenen Ordner in Box. | |
| Suchordner-ID | Ruft die ID des angegebenen Ordners in Box ab. Hinweis: Es dauert 10 Minuten, bis Elemente, die der Box hinzugefügt wurden, zugänglich sind. Wenn beispielsweise eine Aktion einen Ordner erstellt, gibt die Aktion „Ordner-ID suchen“ erst nach 10 Minuten Ergebnisse zurück. |
|
| Gruppenverwaltung | Gruppe erstellen | Erstellt eine Gruppe in Box mit den angegebenen Einladungseinstellungen. |
| Gruppe löschen | Löscht die angegebene Gruppe in Box. | |
| Gruppe aktualisieren | Aktualisiert die angegebene Gruppe in Box mit den angegebenen Einstellungen. | |
| Verwaltung der Aufbewahrung für juristische Zwecke | Richtlinie zur Aufbewahrung für juristische Zwecke zuweisen | Weist einer Datei, einer Dateiversion, einem Ordner oder einem Anwender eine Richtlinie zur Aufbewahrung für juristische Zwecke zu. |
| Richtlinie zur Aufbewahrung für juristische Zwecke erstellen | Erstellt eine Richtlinie zur Aufbewahrung für juristische Zwecke. | |
| Stream für alle Richtlinien zur Aufbewahrung für juristische Zwecke suchen | Ruft eine Liste der Richtlinien zur Aufbewahrung für juristische Zwecke eines Unternehmens ab. | |
| Zuweisung der Richtlinie zur Aufbewahrung für juristische Zwecke nach ID suchen | Ruft eine Zuweisung einer Richtlinie zur Aufbewahrung für juristische Zwecke für die angegebene ID ab. | |
| Stream für Zuweisungen der Richtlinie zur Aufbewahrung für juristische Zweck suchen | Ruft eine Liste von Elementen ab, die einer Richtlinie zur Aufbewahrung für juristische Zwecke zugewiesen sind. | |
| Richtlinie zur Aufbewahrung für juristische Zwecke nach ID suchen | Ruft eine Richtlinie zur Aufbewahrung für juristische Zwecke für die angegebene ID ab. | |
| Richtlinie zur Aufbewahrung für juristische Zwecke entfernen | Löscht eine vorhandene Richtlinie zur Aufbewahrung für juristische Zwecke. | |
| Zuweisung der Richtlinie zur Aufbewahrung für juristische Zwecke aufheben | Entfernt die Zuweisung eines Elements zu einer gesetzlichen Aufbewahrungspflicht. | |
| Richtlinie zur Aufbewahrung für juristische Zwecke aktualisieren | Aktualisiert eine Richtlinie zur Aufbewahrung für juristische Zwecke. | |
| Metadatenverwaltung | Metadateninstanz in Datei nach Datei-ID suchen | Ruft die Metadateninstanz der Datei mit der angegebenen Datei-ID ab. |
| Metadaten-Instanz in Datei nach Umfang und Vorlagenschlüssel suchen | Ruft die Metadateninstanz eines Ordners mit dem angegebenen Umfang und Vorlagenschlüssel ab. | |
| Metadateninstanz in Ordner nach Ordner-ID suchen | Ruft alle Metadaten des Ordners mit der angegebenen Ordner-ID ab. Hinweis: Verwenden Sie diese Aktion nicht für einen Stammordner, dessen Ordner-ID-Wert NULL ist. |
|
| Metadaten-Instanz in Ordner nach Umfang und Vorlagenschlüssel suchen | Ruft alle Metadaten eines Ordners mit dem angegebenen Umfang und Vorlagenschlüssel ab. | |
| Dateien oder Ordner nach Metadaten-Stream abfragen | Sucht mit SQL-ähnlicher Syntax nach Dateien oder Ordnern und gibt die entsprechenden Ergebnisse zurück. | |
| Aufbewahrungsrichtlinienverwaltung | Aufbewahrungsrichtlinie zuweisen | Weist einem Element eine Aufbewahrungsrichtlinie zu. |
| Aufbewahrungsrichtlinie erstellen | Erstellt eine Aufbewahrungsrichtlinie. | |
| Sucht Aufbewahrungsrichtlinien | Ruft alle Aufbewahrungsrichtlinien eines Unternehmens ab. | |
| Aufbewahrungsrichtlinienzuweisung nach ID suchen | Ruft die Aufbewahrungsrichtlinie mit der angegebenen ID ab. | |
| Stream mit Aufbewahrungsrichtlinienzuweisungen suchen | Gibt eine Liste aller Aufbewahrungsrichtlinienzuweisungen zurück, die einer angegebenen Aufbewahrungsrichtlinie zugeordnet sind. | |
| Aufbewahrungsrichtlinie nach ID suchen | Ruft die Aufbewahrungsrichtlinie mit der angegebenen ID ab. | |
| Aufbewahrungsrichtlinie aktualisieren | Aktualisiert eine Aufbewahrungsrichtlinie. | |
| Anwenderverwaltung | Anwender zu Gruppe hinzufügen | Fügt den angegebenen Anwender der angegebenen Gruppe in Box hinzu. |
| Anwender erstellen | Erstellt ein Anwenderaccount in Box. | |
| Anwender löschen | Löscht den angegebenen Anwender in Box. | |
| Anwender deaktivieren | Legt den Status des angegebenen Anwenders in Box auf „Inaktiv“ fest. | |
| Anwender aktivieren | legt den Status des angegebenen Anwenders in Box auf „Aktiv“ fest. | |
| Anwender-ID suchen | Ruft die ID des angegebenen Anwenders in Box ab. | |
| Anwender aktualisieren | Aktualisiert den angegebenen Anwender in Box mit den angegebenen Rollen-Changes. | |
| Webhook-Verwaltung | Webhook erstellen | Erstellt einen Webhook. |
| Webhook nach ID suchen | Ruft den Webhook mit der angegebenen ID ab. | |
| Stream mit Webhooks suchen | Ruft alle definierten Webhooks für die angegebene Anwendung ab. | |
| Webhook entfernen | Entfernt einen Webhook. | |
| Webhook aktualisieren | Aktualisiert einen Webhook. |
Box-Spoke-Modul
Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Ereignisse benachrichtigt werden. Eine Webhook-Registrierung definiert die Bedingungen, die erfüllt sein müssen, um die ServiceNow-App zu benachrichtigen. Diese Bedingungen basieren auf den Ereignissen in Box, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst der angegebene Auslösername den zugehörigen Subflow aus, der wiederum die Box-Aufgaben automatisiert.
| Modul | Beschreibung |
|---|---|
| Box-Webhook-Registrierung | Erstellen Sie die Plivo-Webhooks in ServiceNow, und zeigen Sie sie an. |
| Richtlinien zur Aufbewahrung für juristische Zwecke | Zeigen Sie die Liste der verfügbaren Box-Rechtsrichtlinien an. |
| Aufbewahrungsrichtlinien | Zeigen Sie die Liste der verfügbaren Box-Aufbewahrungsrichtlinien an. |
Anforderungen an Boxkonto
Für Box-Spoke müssen Sie eine anwenderdefinierte App in Ihrem Box-Konto erstellen, um OAuth 2.0-Token zu generieren. Weitere Informationen finden Sie unter Erstellen Sie eine OAuth-Anwendung.
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.
Diese Spoke verwendet die folgenden Aliasdatensätze zum Autorisieren von Aktionen.
| Alias für Verbindungen und Anmeldeinformationen | Beschreibung | Anforderungen für den Verbindungsalias |
|---|---|---|
| Kastendiagramm | Verbindung mit den Box-APIs für Zusammenarbeit und Dateiverwaltung. |
|
| Box-Upload | Verbindung mit dem Box-Upload-Service |
|
Um die Spoke-Verbindungsaliasse zu verwenden, erstellen Sie für jeden Alias einen zugehörigen Verbindungsdatensatz und einen zugehörigen Anmeldeinformationsdatensatz. Informationen zum Einrichten der Spoke finden Sie unter Richten Sie die Box-Spoke ein.