Box-Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

    • 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 ServiceNow -Instanz und Ihrem Box-Konto dieselben Sprachen ausgewählt sind.

    • Wählen Sie in Ihrer Instanz ServiceNow die erforderliche Sprache aus, indem Sie zu navigieren Benutzerprofil > Einstellungen > Bildschirm.

      Legen Sie die Sprache in der ServiceNow-Instanz fest.

    • Wählen Sie in Ihrem Box-Konto die erforderliche Sprache aus, indem Sie zu navigieren Kontoeinstellungen > Account > Allgemeine Optionen.

      Legen Sie die Sprache im Box-Konto fest.

    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
    Verschieben Sie den Anhang, wenn er erstellt wird, in Box Verschiebt Anhangsdateien 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-Benutzer Erstellt einen Benutzer in Box, wenn Sie einen ServiceNow -Benutzer in der Box-Benutzergruppe erstellen.

    Spoke-Aktionen

    Box-Spoke bietet Aktionen zum Automatisieren von Box-Aufgaben, wenn Events in ServiceNowauftreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Dokumentenmanagement Der Datei Metadaten hinzufügen Gibt benutzerdefinierte 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 gesamten 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.
    • Mitbesitzer
    • Editor
    • Previewer
    • Vorschau-Uploader
    • Uploader
    • Betrachter
    • Viewer Uploader
    Freigegebenen Link erstellen Erstellen Sie 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-Benutzeraccounts.
    Ordner löschen Löscht den angegebenen Ordner in Box.
    Suchordner-ID Ruft die ID des angegebenen Ordners in Box ab.
    Hinweis:
    Elemente, die Box hinzugefügt wurden, benötigen 10 Minuten, um zugänglich zu werden. Wenn beispielsweise eine Aktion einen Ordner erstellt, gibt eine 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, Dateiversion, einem Ordner oder einem Benutzer 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 Bereich 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 Bereich und Vorlagenschlüssel ab.
    Dateien oder Ordner nach Metadaten-Stream abfragen Sucht nach Dateien oder Ordnern mit SQL-ähnlicher Syntax und gibt die übereinstimmenden Ergebnisse zurück.
    Aufbewahrungsrichtlinienverwaltung Aufbewahrungsrichtlinie zuweisen Weist einem Element eine Aufbewahrungsrichtlinie zu.
    Aufbewahrungsrichtlinie erstellen Erstellt eine Aufbewahrungsrichtlinie.
    Suchen Sie nach 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 Benutzer zu Gruppe hinzufügen Fügt den angegebenen Anwender der angegebenen Gruppe in Box hinzu.
    Benutzer erstellen Erstellt einen Anwenderaccount in Box.
    Benutzer löschen Löscht den angegebenen Anwender in Box.
    Anwender deaktivieren Legt den Status des in Box angegebenen Anwenders auf inaktiv fest.
    Anwender aktivieren legt den Status des in Box angegebenen Anwenders auf „Aktiv“ fest.
    Suchen Sie nach Anwender-ID Ruft die ID des in Box angegebenen Anwenders ab.
    Anwender aktualisieren Aktualisiert den angegebenen Anwender in Box mit den angegebenen Rollenänderungen.
    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 Events benachrichtigt werden. Eine Webhook-Registrierung definiert die Bedingungen, die erfüllt sein müssen, damit die ServiceNow-App benachrichtigt wird. Diese Bedingungen basieren auf den Events 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.

    Webhooks erfordern ein separates Setup und können unabhängig verwendet werden, ohne die Spoke-Aktionen zu verwenden. Die Box-Spoke fügt die Box-Spoke-Anwendung zu Ihrer Instanz hinzu und enthält die folgenden Module.
    Tabelle : 1. Box-Modul
    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 Box-Konto

    Box-Spoke erfordert die Erstellung einer benutzerdefinierten App in Ihrem Box-Konto, 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, um Aktionen zu autorisieren.

    Alias für Verbindungen und Anmeldeinformationen Beschreibung Anforderungen für Verbindungsalias
    Box Verbindung mit den Box-APIs für Zusammenarbeit und Dateiverwaltung.
    • Verbindungstyp: HTTP
    • Verbindungs-URL: https://api.box.com
    Box-Upload Verbindung mit dem Box-Upload-Service
    • Verbindungstyp: HTTP
    • Verbindungs-URL: https://upload.box.com

    Um die Spoke-Verbindungsaliasse zu verwenden, erstellen Sie für jeden Alias einen zugeordneten Verbindungsdatensatz und einen zugeordneten Anmeldeinformationsdatensatz. Informationen zum Einrichten der Spoke finden Sie unter Richten Sie die Box-Spoke ein