--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Box Spoke # Box Spoke {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 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 {#box-spoke__section_gw5_x2f_mjb} Visitez le site Web [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 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](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#box-spoke__inline-send-to-store} ## Abonnement à Hub d'intégration {#box-spoke__section_rsf_yvb_l3b} 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](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). ## Version de spoke {#box-spoke__section_yf2_tdv_bsb} Spoke Box La version3.2.2 est la dernière version.{#box-spoke__box-ver} ## Versions prises en charge {#box-spoke__section_zjt_sh4_zgb} Version d'API v2. ## Exigences relatives au spoke {#box-spoke__section_tb5_ymx_p1c} Assurez-vous que les mêmes langues sont sélectionnées dans votre instance et dans votre ServiceNow compte Box. * Dans votre ServiceNow instance, sélectionnez la langue requise en accédant à Profil d'utilisateurPréférencesAffichage. * Dans votre compte Box, sélectionnez la langue requise en accédant à Paramètres du compteCompteOptions générales. {#box-spoke__ul_khm_znx_p1c} ## Flux de spoke {#box-spoke__section_y1q_3h4_gfb} Le Spoke Box fournit 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. Les exemples de flux disponibles sont les suivants : {#box-spoke__table_q45_mh4_gfb__entry__2} | Flux | Description | |-|-| | Déplacer la pièce jointe lorsqu'elle est créée dans Box | Déplace les fichiers en pièce jointe de vers Box lorsqu'un nouvel enregistrement de ServiceNow pièce jointe est ajouté. Met à jour l'enregistrement du déclencheur avec un lien partagé vers le fichier de pièce jointe déplacé sur Box. | | Utilisateur de l'intégration | Crée un utilisateur dans Box lorsque vous créez un ServiceNow utilisateur dans le groupe d'utilisateurs Box . | [ ] {#box-spoke__table_q45_mh4_gfb} ## Actions du spoke {#box-spoke__section_zqb_zzn_gfb} Fournit Spoke Box des actions permettant d'automatiser les tâches Box lorsque des événements se produisent dans ServiceNow. Les actions disponibles sont les suivantes : {#box-spoke__table_qpz_ktb_x2b__entry__3} | Catégorie | Action | Description | |-|-|-| | Gestion des documents | Ajouter des métadonnées au fichier | Spécifie des données personnalisées pour un fichier ou un dossier particulier. | | Gestion des documents | Joindre un fichier Box à l'enregistrement | Copie un fichier de Box et le joint à l'enregistrement spécifié ServiceNow . | | Gestion des documents | ID de fichier de recherche | Récupère l'ID du fichier spécifié dans Box. | | Gestion des documents | 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é. | | Gestion des documents | Supprimer le fichier | Supprime le fichier spécifié de Box. | | Gestion des documents | 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. | | Gestion des documents | Charger un fichier | Charge le fichier spécifié dans 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 * Prévisualiser le téléchargeur * Outil de téléchargement * Visionneuse * Téléchargeur du visualiseur {#box-spoke__ul_ybd_n5b_x2b} | | Partage de documents | Créer un lien partagé | Créez un lien direct et en lecture seule vers un fichier ou un dossier dans Box. | | Partage de documents | Rechercher des collaborateurs du dossier par ID | Récupère tous les collaborateurs associés à l'ID de dossier spécifié. | | Partage de documents | Retirer un collaborateur | Supprime la collaboration spécifiée d'un fichier ou d'un dossier dans Box. | | Gestion des dossiers | Créer un dossier | Crée un dossier dans Box pour le compte d'utilisateur Box spécifié. | | Gestion des dossiers | Supprimer un dossier | Supprime le dossier spécifié dans Box. | | Gestion des dossiers | 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 être accessibles. Par exemple, si une action crée un dossier, une action Rechercher l'ID du dossier ne renvoie pas de résultats avant que 10 minutes ne se soient écoulées. | | Gestion des groupes | Créer un groupe | Crée un groupe dans Box avec les préférences d'invitation spécifiées. | | Gestion des groupes | Supprimer le groupe | Supprime le groupe spécifié dans Box. | | Gestion des groupes | 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. | | Gestion de la conservation juridique | Créer une politique de conservation légale | Crée une politique en matière de conservation légale. | | Gestion de la conservation juridique | 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. | | Gestion de la conservation juridique | 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é. | | Gestion de la conservation juridique | Rechercher un flux d'affectations de politique de conservation juridique | Récupère une liste des éléments affectés à une politique en matière de conservation légale. | | Gestion de la conservation juridique | 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é. | | Gestion de la conservation juridique | Retirer la politique de conservation légale | Supprime une politique existante en matière de conservation légale. | | Gestion de la conservation juridique | Annuler l'affectation de la politique en matière de conservation légale | Supprime l'affectation d'un élément à une conservation légale. | | Gestion de la conservation juridique | 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é. | | Gestion des métadonnées | 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 spécifié et la clé de modèle. | | Gestion des métadonnées | 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 l'ID de dossier est égal à zéro. | | Gestion des métadonnées | 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 la clé de modèle et le périmètre spécifiés. | | Gestion des métadonnées | 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. | | Gestion de la politique de conservation | Créer une politique de rétention | Crée une politique de conservation. | | Gestion de la politique de conservation | Rechercher des politiques de conservation | Récupère toutes les politiques de conservation d'une entreprise. | | Gestion de la politique de conservation | Rechercher une affectation de politique de conservation par ID | Récupère la politique de conservation avec l'ID spécifié. | | Gestion de la politique de conservation | 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. | | Gestion de la politique de conservation | Rechercher une politique de conservation par ID | Récupère la politique de conservation avec l'ID spécifié. | | Gestion de la politique de conservation | 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. | | Gestion des utilisateurs | Créer un utilisateur | Crée un compte utilisateur dans Box. | | Gestion des utilisateurs | Supprimer l'utilisateur | Supprime l'utilisateur spécifié dans Box. | | Gestion des utilisateurs | Désactiver l'utilisateur | Définit l'état de l'utilisateur spécifié dans Box sur inactif. | | Gestion des utilisateurs | Activer l'utilisateur | définit l'état de l'utilisateur spécifié dans Box sur actif. | | Gestion des utilisateurs | Rechercher un ID d'utilisateur | Récupère l'ID de l'utilisateur spécifié dans Box. | | Gestion des utilisateurs | 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. | | Gestion des Webhook | Rechercher un webhook par ID | Récupère le webhook avec l'ID spécifié. | | Gestion des Webhook | Rechercher un flux de webhooks | Récupère tous les webhooks définis pour l'application spécifiée. | | Gestion des Webhook | Supprimer le webhook | Supprime un webhook. | | Gestion des Webhook | Mettre à jour un webhook | Met à jour un webhook. | [ ] {#box-spoke__table_qpz_ktb_x2b} ## Module de spoke Box {#box-spoke__section_v4c_1f5_fpb} Des webhooks bidirectionnels peuvent être configurés pour être informé 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 pour lesquels 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 distincte 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.{#box-spoke__table_oqb_kf5_fpb__entry__2} | 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. | [Tableau 1. Module Box] {#box-spoke__table_oqb_kf5_fpb} ## Exigences relatives au compte Box {#box-spoke__section_fgv_rxg_gfb} Il est nécessaire de Spoke Box créer une application personnalisée sur votre compte Box pour générer des jetons OAuth 2.0. Consultez [Créer une application OAuth](https://servicenow-prod.fluidtopics.net/_vx4nQbOf~YooDY1GbMtNA#configure-box-account "Créez une application OAuth personnalisée à partir de votre compte Box pour activer l'authentification OAuth 2.0 avec le spoke Box."). ## Exigences en matière d'alias de connexion et d'informations d'identification {#box-spoke__section_plx_qxg_gfb} 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 les actions. {#box-spoke__table_nnk_g2h_gfb__entry__3} | Alias de connexion et d'informations d'identification | Description | Exigences relatives à l'alias de connexion | |-|-|-| | Diagramme à boîtes | Connexion aux API de collaboration et de gestion de fichiers Box. | * Type de connexion : HTTP * URL de connexion : https://api.box.com {#box-spoke__ul_atz_rsl_kfb} | | Chargement de la zone | Connexion au service de téléchargement Box. | * Type de connexion : HTTP * URL de connexion : https://upload.box.com {#box-spoke__ul_z2p_xsl_kfb} | [ ] {#box-spoke__table_nnk_g2h_gfb} Pour utiliser les alias de connexion de spoke, créez un enregistrement de connexion associé et un enregistrement d'informations d'identification associé pour chaque alias. Pour en savoir plus sur la configuration du spoke, consultez [Configurer le spoke Box](https://servicenow-prod.fluidtopics.net/_vx4nQbOf~YooDY1GbMtNA#setup-box-spoke "Intégrez votre ServiceNow instance et les API Box pour automatiser les actions des spokes Box. Par exemple, vous pouvez configurer un flux qui supprime un fichier de votre compte Box. Lorsque vous configurez le spoke Box, ce flux est automatisé.").