# tBoxv2List

Ce composant liste les informations concernant les fichiers et/ou les dossiers dans un dossier Box spécifié.

Ce composant liste les métadonnées et le contenu des fichiers et/ou des dossiers d'un dossier Box.

## Propriétés du tBoxv2List Standard

Ces propriétés sont utilisées pour configurer le tBoxv2List s'exécutant dans le framework de Jobs Standard.

Le composant tBoxv2List Standard appartient à la famille Cloud.

Le composant de ce framework est disponible dans tous les produits Talend nécessitant une souscription.

Note InformationsRemarque : Ce composant est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1-R2023-04 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Property type | Peut être Built-in ou Repository .<br><br><ul> <li> <span>Built-in</span>&nbsp;: propriétés utilisées ponctuellement.</li> <li> <span>Repository</span>&nbsp;: sélectionnez le fichier du référentiel dans lequel les propriétés sont stockées. Les champs qui suivent sont automatiquement renseignés via les données récupérées.</li> </ul><br><br>Cette liste déroulante n'est pas disponible si vous cochez la case Use an existing connection. |
| Use an existing connection | Cochez cette case et sélectionnez le composant de connexion adéquat dans la liste Component list pour réutiliser les paramètres d'une connexion que vous avez déjà définie. |
| Authentication type | Sélectionnez le type d'authentification : JWT (JSON Web Token) ou Developer token (Jeton développeur).<br><br>Vous devez fournir les paramètres suivants dans les champs correspondants, pour le type d'authentification JWT.<br><br><ul> <li><span>Client ID</span> et <span>Client secret</span>&nbsp;: saisissez la clé et le secret du client, requis par Box pour accéder à l'API Box. Afin d'obtenir la clé client et le secret du client, vous devez créer un compte sur <a href="https://developers.box.com/" target="_blank">https://developers.box.com/</a> puis créer une application Box sous le compte Box utilisé. La clé client et le Secret du client peuvent être obtenus depuis les paramètres de l'application du compte.</li> <li><span>Public key ID</span></li> <li><span>Private key</span></li> <li><span>Private key passphrase</span></li> <li><span>Enterprise ID</span> ou <span>User ID</span></li> </ul><br><br><br>Pour plus d'informations concernant l'authentification JWT, consultez [JWT Auth](https://developer.box.com/guides/authentication/jwt/) (en anglais).<br><br>Note InformationsRemarque : Pour saisir le secret du client, la clé privée ou la phrase secrète de clé privée, cliquez sur le bouton [...] près du champ correspondant pour ouvrir la boîte de dialogue Enter a new password et, dans le champ de texte, saisissez la clé, puis cliquez sur OK. Vous pouvez saisir la clé comme une chaîne de caractères JSON en mode pure password ou comme une expression Java en mode Java mode. Vous pouvez passer d'un mode à l'autre en cliquant sur switch to Java mode ou switch to pure password mode au-dessus du champ de texte.<br><br>Si vous sélectionnez Developer token dans la liste déroulante, saisissez le jeton développeur dans le champ Developer token. Pour plus d'informations concernant le jeton développeur, consultez [Developer Tokens](https://developer.box.com/guides/authentication/tokens/developer-tokens/) (en anglais).<br><br>La liste déroulante Authentication type est disponible lorsque l'option Use an existing connection n'est pas sélectionnée. |
| Schema et Edit schema | Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.<br><br>Built-in : le schéma est créé et conservé localement pour ce composant seulement.<br><br>Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.<br><br>Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :<br><br><ul> <li> <p> <span>View schema</span>&nbsp;: sélectionnez cette option afin de voir uniquement le schéma.</p> </li> <li> <p> <span>Change to built-in property</span>&nbsp;: sélectionnez cette option pour passer le schéma en mode <span>Built-In</span> et effectuer des modifications locales.</p> </li> <li> <p> <span>Update repository connection</span>&nbsp;: sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs.</p> <p>Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur <span>No</span> et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre <span>Repository Content</span>.</p> </li> </ul> |
| Guess schema | Cliquez sur ce bouton pour récupérer le schéma en fonction de vos paramètres. |
| Box remote path | Saisissez le chemin Box. Les informations concernant les fichiers et les dossiers dans le chemin Box seront listées.<br><br>Vous pouvez également spécifier le chemin Box en cliquant sur le bouton [...] près de ce champ et en navigant jusqu'au dossier.<br><br>Cette option est disponible lorsque l'option Get folder by ID de la vue Advanced settings n'est pas sélectionnée. |
| Box ID | Saisissez l'ID Box du dossier contenant les fichiers desquels lister les informations.<br><br>Vous pouvez également spécifier l'ID Box en cliquant sur le bouton [...] près de ce champ et en navigant jusqu'au dossier.<br><br>Cette option est disponible lorsque l'option Get folder by ID de la vue Advanced settings est sélectionnée. |
| List type | Sélectionnez le type des objets desquels lister les informations : Files, Folders ou Both. |
| Include subfolders | Sélectionnez cette option pour lister également les informations concernant les objets dans les sous-dossiers du dossier Box spécifié. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les données de log au niveau des composants. |
| Fetch more information | Sélectionnez cette option pour récupérer des informations plus détaillées concernant les objets dans le dossier spécifié. Cela s'effectue en ajoutant des colonnes supplémentaires dans le schéma.<br><br>Si cette option n'est pas sélectionnée, le schéma généré par l'option Guess schema contient ces quatre colonnes : ID, NAME, RELATIVE\_PATH et TYPE. Lorsque cette option est sélectionnée, le schéma généré contient les colonnes suivantes : ID, NAME, RELATIVE\_PATH, ABSOLUTE\_PATH, LAST\_MODIFIED, MODIFIED\_BY et SIZE. |
| Get folder by ID (Obtenir un dossier par ID) | Sélectionnez cette option pour spécifier le dossier à l'aide de son ID Box. |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | ERROR\_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.<br><br>Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.<br><br>Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.<br><br>Pour plus d'informations concernant les variables, consultez [Utiliser les contextes et les variables](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/contexts-and-variables). |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Ce composant peut être utilisé en standalone ou avec d'autres composants à l'aide d'un lien de type Iterate ou d'un lien de type Trigger tel que OnSubjobOK. |