Spoke Box

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 Store notes de publication relatives à l'historique des versions.

Abonnement à Hub 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.6.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.
Dans votre compte Box, sélectionnez la langue requise en accédant à Paramètres du compte > Compte > Options générales.

Flux de spoke

Fournit Spoke Box des exemples de flux à l’état 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 ServiceNow vers Box lorsqu’un nouvel enregistrement de pièce jointe est ajouté. Met à jour l’enregistrement de déclencheur avec un lien partagé vers le fichier de pièce jointe déplacé sur Box.
Intégration d’utilisateur	Crée un utilisateur dans Box lorsque vous créez un ServiceNow utilisateur dans le groupe d’utilisateurs Box .

Actions du spoke

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 de l’IA Box	Poser une question	Envoie une invite aux modèles d’IA pris en charge à l’aide du contexte fourni et renvoie une réponse brève axée sur la question de l’utilisateur.
	Extraire les métadonnées Forme libre	Envoie une demande contextuelle aux modèles d’IA pris en charge et extrait les métadonnées sous forme de paires clé-valeur structurées.
	Rechercher la configuration par défaut de l’agent IA	Récupère les paramètres de configuration par défaut pour l’agent IA spécifié.
Gestion du concentrateur Box	Rechercher des informations sur le concentrateur Box par ID	Récupère les détails d’un concentrateur Box à l’aide de l’ID de concentrateur spécifié.
	Rechercher le flux d’éléments de concentrateur Box	Récupère tous les éléments associés au concentrateur Box spécifié.
	Rechercher un flux de concentrateurs Box	Récupère tous les concentrateurs Box disponibles pour l’utilisateur demandeur en fonction des informations d’identification Box utilisées pour générer le jeton d’accès.
Gestion de 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 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é dans Box.
	Rechercher un flux d’archives	Récupère toutes les archives disponibles à partir de l’application 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 Aperçu Afficher un aperçu du chargeur Outil de téléchargement Visionneur Téléchargeur du visualiseur
	Créer un lien partagé	Créer 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 dans Box.
Gestion des fichiers	Rechercher des informations sur le fichier	Récupère les informations détaillées du fichier spécifié.
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, l’action Rechercher un ID de dossier ne renvoie les résultats qu’au bout de 10 minutes.
	Rechercher des informations sur le dossier	Récupère les détails du dossier spécifié.
	Rechercher un flux d’éléments de dossier	Récupère tous les éléments du dossier spécifié, y compris les fichiers, les sous-dossiers et les liens Web.
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 en matière 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 nulle.
	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.

Déclencheurs de spoke

ServiceNow prend en charge des événements spécifiques sur Box qui créent des déclencheurs. Vous devez d’abord configurer un flux avec une définition de déclencheur prise en charge. Lorsqu’un événement, par exemple une demande push, se produit sur la Box, il envoie la charge utile via un webhook à l’instance ServiceNow . Ensuite, le flux que vous avez configuré est déclenché sur l’instance ServiceNow pour automatiser un workflow. Les événements pris en charge sont les suivants :


Catégorie	Déclencheur	Description
Gestion des fichiers	Fichier téléchargé	Le flux est déclenché lorsqu’un fichier est téléchargé.
	Fichier verrouillé	Le flux est déclenché lorsqu’un fichier est verrouillé.
	Fichier déplacé	Le flux est déclenché lorsqu’un fichier est déplacé.
	Fichier renommé	Le flux est déclenché lorsqu’un fichier est renommé.
	Fichier déverrouillé	Le flux est déclenché lorsqu’un fichier est déverrouillé.
	Fichier chargé	Le flux est déclenché lorsqu’un fichier est chargé.
Gestion des dossiers	Dossier créé	Le flux est déclenché lorsqu’un dossier est créé.
	Dossier téléchargé	Le flux est déclenché lorsqu’un dossier est téléchargé.
	Dossier déplacé	Le flux est déclenché lorsqu’un dossier est déplacé.
	Dossier renommé	Le flux est déclenché lorsqu’un dossier est renommé.

Pour plus d’informations sur la configuration des déclencheurs du spoke Box, reportez-vous à la section Configurer des déclencheurs pour le spoke Box. Pour en savoir plus sur l’intégration entrante, reportez-vous à la section Intégration entrante conditionnelle et pilotée par événement.

Rôles d’utilisateur de spoke

Les rôles d’utilisateur suivants sont disponibles avec le spoke :

Utilisateur de politique (sn_box_spoke.box_policies_user) : les utilisateurs disposant de ce rôle ont uniquement accès au module Politiques de conservation .
Utilisateur de Politique de conservation légale (sn_box_spoke.legal_hold_policy_user) : les utilisateurs disposant de ce rôle ont uniquement accès au module Politiques de conservation juridique .
Utilisateur du registre du Webhook Box (sn_box_spoke.box_webhook_registry_user) : les utilisateurs disposant de ce rôle ont uniquement accès au module du registre du Webhook Box .

Module de spoke Box

Des webhooks bidirectionnels peuvent être configurés pour être avertis 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 dans Box dont vous souhaitez être notifié. 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 comprend les modules suivants.

Tableau 1. Module Box
Module	Description
Registre du Webhook Box	Créez et affichez les webhooks Box 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 des jetons OAuth, une application personnalisée est nécessaire Spoke Box pour générer une application personnalisée sur votre compte Box. Voir Créer une application OAuth.

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

Hub 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 Box	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.