Spoke Box

  • Rversion finale: Zurich
  • Mis à jour 1 sept. 2025
  • 11 minutes de lecture
  • Déplacez les pièces jointes vers Box où elles peuvent être gérées en tant que documents partagés.

    Demander des applications dans l'App Store

    Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

    Abonnement à Centre d'intégration

    Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

    Version de spoke

    Spoke Box v3.4.0 est la dernière version.

    Versions prises en charge

    Version d’API v2.

    Exigences relatives au spoke

    Assurez-vous que les mêmes langues sont sélectionnées dans votre instance et votre ServiceNow compte Box.

    • Dans votre ServiceNow instance, sélectionnez la langue requise en accédant à Profil d'utilisateur > Préférences > Affichage.

      Définir la langue dans l’instance ServiceNow.

    • Dans votre compte Box, sélectionnez la langue souhaitée en accédant à Paramètres du compte > Compte > Options générales.

      Définir la langue dans le compte Box.

    Flux de spoke

    Fournit Spoke Box des exemples de flux à l’état de brouillon pour illustrer l’automatisation des tâches Box. Pour personnaliser un exemple de flux, copiez-le dans un nouveau périmètre de l’application. Exemples de flux disponibles :

    Flux Description
    Déplacer la pièce jointe lors de sa création dans Box Déplace les fichiers de pièce jointe de vers Box lorsqu’un nouvel enregistrement de ServiceNow pièce jointe est ajouté. Met à jour l’enregistrement de déclenchement avec un lien partagé vers le fichier de pièce jointe déplacé sur Box.
    Intégration de l’utilisateur Crée un utilisateur dans Box lorsque vous créez un ServiceNow utilisateur dans le groupe d’utilisateurs Box .

    Actions du spoke

    Le fournit Spoke Box des actions pour automatiser les tâches Box lorsque des événements se produisent dans ServiceNow. Les actions disponibles sont les suivantes :

    Catégorie Action Description
    Gestion des documents Ajouter des métadonnées au fichier Stocke les informations d’attributs fournies en les ajoutant comme métadonnées pour les fichiers Box.
    Joindre un fichier Box à l'enregistrement Copie un fichier à partir de Box et le joint à l’enregistrement spécifié ServiceNow .
    Rechercher un ID de fichier Récupère l’ID du fichier spécifié dans Box.
    Déplacer un élément propriétaire Déplace tous les éléments appartenant à l’utilisateur spécifié dans Box vers le dossier spécifié.
    Supprimer le fichier Supprime le fichier spécifié de Box.
    Rechercher un flux de contenu Recherche des fichiers, des dossiers, des liens Web et des fichiers partagés dans le contenu de l’utilisateur ou dans l’ensemble de l’entreprise.
    Charger un fichier Télécharge le fichier spécifié sur Box.
    Partage de documents Ajouter un collaborateur Accorde à un utilisateur ou à un groupe un niveau spécifié d’accès à un fichier ou à un dossier particulier. Les collaborateurs disposent de l’un de ces niveaux d’accès.
    • Copropriétaire
    • Éditeur
    • Prévisualiseur
    • Afficher un aperçu de l’outil de téléchargement
    • Outil de téléchargement
    • Visionneuse
    • Téléchargeur du visualiseur
    Créer un lien partagé Créez un lien direct et en lecture seule vers un fichier ou un dossier dans Box.
    Rechercher des collaborateurs du dossier par ID Récupère tous les collaborateurs associés à l’ID du dossier spécifié.
    Retirer un collaborateur Supprime la collaboration spécifiée d’un fichier ou d’un dossier Box.
    Gestion des dossiers Créer un dossier Crée un dossier dans Box pour le compte d’utilisateur Box spécifié.
    Supprimer un dossier Supprime le dossier spécifié dans Box.
    ID de dossier de recherche Récupère l’ID du dossier spécifié dans Box.
    Remarque :
    Les éléments ajoutés à Box nécessitent 10 minutes pour devenir accessibles. Par exemple, si une action crée un dossier, une action de recherche d’ID de dossier ne renvoie les résultats qu’au bout de 10 minutes.
    Gestion des groupes Créer un groupe Crée un groupe dans Box avec les préférences d’invitation spécifiées.
    Supprimer le groupe Supprime le groupe spécifié dans Box.
    Mettre à jour le groupe Met à jour le groupe spécifié dans Box avec les préférences spécifiées.
    Gestion de la conservation juridique Affecter la politique en matière de conservation légale Affecte une politique de conservation légale à un fichier, à une version de fichier, à un dossier ou à un utilisateur.
    Créer une politique de conservation légale Crée une politique en matière de conservation légale.
    Rechercher le flux de toutes les politiques de conservation légale Récupère une liste des politiques en matière de conservation légale d’une entreprise.
    Rechercher une affectation de politique de conservation juridique par ID Récupère une affectation de politique en matière de conservation légale pour l’ID spécifié.
    Rechercher un flux d'affectations de politique de conservation juridique Récupère une liste d’éléments affectés à une politique en matière de conservation légale.
    Rechercher une politique de conservation légale par ID Récupère une politique en matière de conservation légale pour l’ID spécifié.
    Retirer la politique de conservation légale Supprime une politique existante en matière de conservation légale.
    Annuler l'affectation de la politique en matière de conservation légale Supprime l’affectation d’un élément à une conservation légale.
    Mettre à jour la politique de conservation légale Met à jour une politique en matière de conservation légale.
    Gestion des métadonnées Rechercher une instance de métadonnées d'après un ID fichier par fichier Récupère l’instance de métadonnées du fichier avec l’ID de fichier spécifié.
    Rechercher une instance de métadonnées dans un fichier par clé de modèle et périmètre Récupère l’instance de métadonnées d’un dossier avec le périmètre et la clé de modèle spécifiés.
    Rechercher une instance de métadonnées d'après un ID dossier par dossier Récupère toutes les métadonnées du dossier avec l’ID de dossier spécifié.
    Remarque :
    N’utilisez pas cette action sur un dossier racine dont la valeur d’ID de dossier est zéro.
    Rechercher une instance de métadonnées dans un dossier par clé de modèle et périmètre Récupère toutes les métadonnées d’un dossier avec le périmètre et la clé de modèle spécifiés.
    Fichiers ou dossiers de requête par flux de métadonnées Recherche des fichiers ou des dossiers à l’aide d’une syntaxe de type SQL et renvoie les résultats correspondants.
    Gestion de la politique de conservation Affecter une politique de conservation Affecte une politique de conservation à un élément.
    Créer une politique de rétention Crée une politique de conservation.
    Rechercher des politiques de conservation Récupère toutes les politiques de conservation d’une entreprise.
    Rechercher une affectation de politique de conservation par ID Récupère la politique de conservation avec l’ID spécifié.
    Rechercher un flux d'affectations de politique de conservation Renvoie une liste de toutes les affectations de politique de conservation associées à une politique de conservation spécifiée.
    Rechercher une politique de conservation par ID Récupère la politique de conservation avec l’ID spécifié.
    Mettre à jour une politique de rétention Met à jour une politique de conservation.
    Gestion des utilisateurs Ajouter un utilisateur au groupe Ajoute l’utilisateur spécifié au groupe spécifié dans Box.
    Créer un utilisateur Crée un compte utilisateur dans Box.
    Supprimer l'utilisateur Supprime l’utilisateur spécifié dans Box.
    Désactiver l'utilisateur Définit l’état de l’utilisateur spécifié dans Box sur inactif.
    Activer l'utilisateur Définit l’état de l’utilisateur spécifié dans Box sur actif.
    Rechercher un ID d’utilisateur Récupère l’ID de l’utilisateur spécifié dans Box.
    Mettre à jour un utilisateur Met à jour l’utilisateur spécifié dans Box avec les changements de rôle spécifiés.
    Gestion des Webhook Créer un webhook Crée un webhook.
    Rechercher un webhook par ID Récupère le webhook avec l’ID spécifié.
    Rechercher un flux de webhooks Récupère tous les webhooks définis pour l’application spécifiée.
    Supprimer le webhook Supprime un webhook.
    Mettre à jour un webhook Met à jour un webhook.

    Agents IA disponibles

    Installez Now Assist pour Spokes et commencez à utiliser les agents IA disponibles. Pour plus d'informations, consultez Now Assist pour les spokes.

    Ce spoke fournit des agents IA autonomes qui imitent une intelligence de type humain pour effectuer des tâches dans votre ServiceNow instance.
    • Dans le ServiceNow système agentique, vous pouvez créer un workflow agentique qui comprend un ensemble d’instructions de grand modèle de langage (LLM) ainsi qu’un ou plusieurs agents IA autonomes pour exécuter un objectif. Consultez Create an agentic workflow pour plus d’informations sur l’ajout d’agents IA pour créer des workflows agentiques selon vos besoins et fournir le déclencheur requis.

      Vous pouvez également rechercher d’autres agents IA disponibles et les ajouter à votre workflow agentique. Consultez Find AI agents pour plus d'informations.

    • Vous pouvez créer un clone de l’agent IA de spoke requis et le personnaliser selon vos besoins. Consultez Duplicate an AI agent pour plus d’informations sur la création d’un clone.
    • Consultez la rubrique Now Assist AI agents pour plus d’informations sur les agents IA.
    Les agents IA disponibles sont les suivants :
    Agent IA Description
    Agent IA de gestion des utilisateurs Box Gère les tâches de gestion des utilisateurs (c’est-à-dire ajoute un utilisateur à un groupe, active un utilisateur, crée un utilisateur, supprime un utilisateur, met à jour l’utilisateur, recherche un ID d’utilisateur, désactive l’utilisateur) dans Box.
    Agent IA de gestion des dossiers Box Gère les tâches de gestion des dossiers (c’est-à-dire créer un dossier, rechercher l’ID du dossier, supprimer un dossier) dans Box.
    Agent IA de partage de documents Box

    Gère les tâches de partage de documents (c’est-à-dire supprimer un collaborateur, ajouter un collaborateur, créer un lien partagé, rechercher les collaborateurs du dossier par ID) dans Box.

    Agent IA de gestion des groupes Box Gère les tâches de gestion des groupes (c’est-à-dire mettre à jour un groupe, créer un groupe, supprimer un groupe) dans Box.
    Agent IA de gestion des métadonnées Box Gère les tâches de récupération des métadonnées (c’est-à-dire rechercher une instance de métadonnées dans un fichier par clé de périmètre et de modèle, rechercher une instance de métadonnées dans un dossier par ID de dossier, rechercher une instance de métadonnées dans un dossier par clé de périmètre et de modèle, rechercher une instance de métadonnées dans un fichier par ID de fichier) dans Box.
    Agent IA de gestion des politiques de conservation Box Gère les tâches de gestion de la politique de conservation (c’est-à-dire mettre à jour une politique de conservation, rechercher un flux de politiques de conservation, rechercher une affectation de politique de conservation par ID, rechercher une politique de conservation par ID, rechercher un flux d’affectations de politique de conservation) dans Box.
    Agent IA de gestion des documents Box Gère les tâches de gestion des documents (supprimer un fichier, joindre un fichier Box à un enregistrement, charger un fichier, déplacer un élément possédé, rechercher un flux de contenu, rechercher un ID de fichier, ajouter des métadonnées à un fichier) dans Box.
    Agent IA de gestion de la conservation juridique Box Gère les tâches de gestion de la conservation légale (création d’une politique de conservation légale, recherche d’une affectation de politique de conservation légale par ID, mise à jour d’une politique de conservation légale, recherche de flux de toutes les politiques de conservation légale, recherche d’une politique de conservation légale par ID, annulation de l’affectation d’une politique de conservation légale, suppression d’une politique de conservation légale, recherche d’un flux d’affectations de politique de conservation légale) dans Box.
    Vous recherchez un agent IA ?
    • Il peut y avoir des agents IA installés avec l’application qui ne sont pas utilisés dans les Now Assist workflows agentiques. Pour savoir comment afficher tous les agents disponibles sur votre instance, consultez Rechercher des agents IA.
    • Pour rechercher des agents qui ne sont peut-être pas installés sur votre instance, visitez AI Agent Marketplace sur le ServiceNow Store.
    Remarque :
    Assurez-vous que l’utilisateur exécutant un agent IA dispose des rôles et autorisations requis pour accéder aux données ou effectuer des opérations sur les données de la table associée à l’agent IA.

    Module de spoke Box

    Des webhooks bidirectionnels peuvent être configurés pour être averti des événements requis. Un registre Webhook définit les conditions qui doivent être remplies pour notifier l’application ServiceNow. Ces conditions sont basées sur les événements de Box dont vous souhaitez être informé. Lorsque les conditions sont remplies, le nom de déclencheur spécifié déclenche le flux secondaire associé, qui à son tour automatise les tâches Box.

    Les webhooks nécessitent une configuration séparée et peuvent être utilisés indépendamment sans utiliser les actions de spoke. Le spoke Box ajoute l’application de spoke Box à votre instance et inclut les modules suivants.
    Tableau 1. Module Box
    Module Description
    Registre du Webhook Box Créez et affichez les webhooks Plivo dans ServiceNow.
    Politiques en matière de conservation juridique Consultez la liste des politiques juridiques Box disponibles.
    Politiques de conservation Consultez la liste des politiques de conservation Box disponibles.

    Exigences relatives au compte Box

    Pour générer Spoke Box des jetons OAuth 2.0, vous devez créer une application personnalisée sur votre compte Box. Consultez Créer une application OAuth.

    Exigences en matière d'alias de connexion et d'informations d'identification

    Centre d'intégration utilise des alias pour gérer les informations de connexion et d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

    Ce spoke utilise les enregistrements d’alias suivants pour autoriser des actions.

    Alias de connexion et d’informations d’identification Description Exigences en matière d’alias de connexion
    Box Connexion aux API de collaboration et de gestion de fichiers Box.
    • Type de connexion : HTTP
    • URL de connexion : https://api.box.com
    Chargement de la zone Connexion au service de téléchargement Box.
    • Type de connexion : HTTP
    • URL de connexion : https://upload.box.com

    Pour utiliser les alias de connexion de spoke, créez un enregistrement de connexion et un enregistrement d’informations d’identification associés pour chaque alias. Pour en savoir plus sur la configuration du spoke, consultez Configurer le spoke Box.