> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outil Use Skill

> Use Skill crée des transactions ABBYY Vantage pour le traitement des documents et renvoie les identifiants de transaction destinés aux outils en aval.

L’outil **Use Skill** crée des transactions permettant de traiter des documents à l’aide d’une compétence ABBYY Vantage. Il constitue généralement le premier outil Vantage d’un workflow Alteryx.

L’outil prend en charge deux modes, selon la colonne transmise à son ancrage **Input** :

* **Mode DirectoryPath** – Indiquez l’emplacement d’un dossier contenant les fichiers d’entrée. L’outil crée une seule transaction dans ABBYY Vantage pour l’ensemble des fichiers situés directement dans ce dossier. Transmettez plusieurs lignes pour créer une transaction distincte par dossier.
* **Mode Files** – Indiquez l’emplacement de chaque fichier ainsi que ses paramètres. Ce mode vous permet de définir des paramètres de fichier distincts pour chaque document de la transaction.

<div id="connection-settings">
  ## Paramètres de connexion
</div>

L'outil **Use Skill** reprend les paramètres de connexion décrits dans [Configurer la connexion](/fr/vantage/connectors/alteryx/setup#configure-the-connection), auxquels s'ajoute le paramètre **Vantage Skill**, qui permet de sélectionner la compétence à utiliser pour le traitement des documents.

<div id="input-anchor">
  ## ancrage Input
</div>

| Colonne                             | Type       | Description                                                                                     |
| ----------------------------------- | ---------- | ----------------------------------------------------------------------------------------------- |
| DirectoryPath                       | V\_WString | L’emplacement du dossier contenant le ou les fichiers à traiter au sein d’une même transaction. |
| Files                               | V\_WString | L’emplacement du ou des fichiers à traiter, ainsi que leurs paramètres.                         |
| Transaction Registration Parameters | V\_WString | Un jeu de paramètres d’enregistrement de transaction. Cette colonne est facultative.            |

<div id="directorypath-mode">
  ### Mode DirectoryPath
</div>

Indiquez un chemin de dossier dans la colonne **DirectoryPath**. Tous les fichiers situés directement dans le dossier spécifié sont ajoutés à la transaction en tant que groupe unique. Les fichiers contenus dans les sous-dossiers ne sont pas inclus.

Renseignez plusieurs lignes pour créer une transaction distincte pour chaque dossier :

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=30e3a667bc8ff9d27a9bcd805bb88158" alt="Tableau d'entrée Use Skill affichant deux lignes avec les valeurs DirectoryPath C:\Temp\Input et C:\Temp\Input2" width="193" height="60" data-path="images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png" />
</Frame>

<div id="files-mode">
  ### Mode Files
</div>

Indiquez les chemins de fichiers et les paramètres dans la colonne **Files** au format suivant :

```text theme={null}
File="<absolute filepath>";<FileParamName>="<file parameter value>"
```

Le caractère point-virgule (`;`) sert de séparateur entre les différents fichiers ainsi qu'entre les fichiers et leurs paramètres. Utilisez `FileParamName` pour définir un paramètre de fichier nommé pour le document.

Par exemple, pour ajouter `Invoice_01.tif` et `Invoice_02.tif` à une transaction avec les paramètres **Created** et **Size** pour chaque document :

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-files-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=3c7ca70ee2c54daefe186aeb9d76f3b6" alt="Saisie dans la colonne Use Skill Files affichant une seule ligne avec deux chemins de fichiers et leurs paramètres Created et Size" width="831" height="46" data-path="images/vantage/developer/connectors/alteryx/use-skill-files-input.png" />
</Frame>

<Warning>
  N'utilisez pas les caractères `=` ou `;` dans les chemins de fichiers ni dans les valeurs des paramètres d'enregistrement, car ces caractères font office de séparateurs par défaut.
</Warning>

<div id="transaction-registration-parameters">
  ### Paramètres d’enregistrement de transaction
</div>

Transmettez les paramètres au niveau de la transaction dans la colonne **Transaction Registration Parameters** au format suivant :

```text theme={null}
TransactionParamName="transaction parameter value"
```

Séparez les différents paramètres par un point-virgule (`;`). Par exemple, pour transmettre le type de source et le nom de l'ordinateur :

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=77f2dbb14cd794492560862a0a2375cb" alt="Tableau d'entrée Use Skill avec les colonnes DirectoryPath et TransactionRegistrationParameters affichant les valeurs SourceType et PCname" width="449" height="138" data-path="images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png" />
</Frame>

Les paramètres d'enregistrement de la transaction et du fichier sont visibles dans Vantage Skill Monitor et sont inclus dans le fichier JSON exporté :

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-json-params.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=421473524f4afc17d9de0474d9cf6fe6" alt="Sortie JSON affichant CreationTime, SourceFiles avec Id et Name du fichier, RegistrationParameters avec SourceType et PCname, ainsi que le champ Version" width="671" height="235" data-path="images/vantage/developer/connectors/alteryx/use-skill-json-params.png" />
</Frame>

<div id="output-anchor">
  ## Ancre de sortie
</div>

| Colonne       | Type       | Description                                                                                                                                                                     |
| ------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TransactionId | V\_WString | L'identifiant de la transaction créée. Cet ID est transmis aux outils **Get Status** et **Get Result** pour obtenir le statut de la transaction et les résultats du traitement. |
| isSuccess     | Bool       | Indique si la transaction a bien été créée.                                                                                                                                     |
| Error         | V\_WString | Indique le message d'erreur survenu lors de la création d'une transaction.                                                                                                      |

Exemple de sortie :

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-output-example.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=d76126f3002f8673bf8173da283c4891" alt="Tableau de sortie Use Skill affichant deux lignes avec des GUID TransactionId, IsSuccess True et Error Null" width="477" height="58" data-path="images/vantage/developer/connectors/alteryx/use-skill-output-example.png" />
</Frame>

<Note>
  ABBYY Vantage permet de téléverser des transactions d'une taille maximale de 2 Go. Pour accélérer le traitement des documents, limitez la taille de chaque fichier à 30 Mo.
</Note>

<div id="related-topics">
  ## Rubriques connexes
</div>

* [Outil Get Status](/fr/vantage/connectors/alteryx/tools/get-status)
* [Outil Get Result](/fr/vantage/connectors/alteryx/tools/get-result)
* [Outil Parse Fields](/fr/vantage/connectors/alteryx/tools/parse-fields)
