> ## 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.

# Use Skill ツール

> Use Skill は、ドキュメントを処理するための ABBYY Vantage トランザクションを作成し、後続のツールにトランザクション識別子を返します。

**Use Skill** ツールは、ABBYY Vantage の Skill を使用してドキュメントを処理するためのトランザクションを作成します。通常、Alteryx ワークフローで最初に配置する Vantage ツールです。

このツールは、**Input** アンカーに渡す列に応じて 2 つのモードに対応しています。

* **DirectoryPath モード** – 入力ファイルが格納されたフォルダーの場所を渡します。そのフォルダー直下にあるすべてのファイルに対して、ABBYY Vantage にトランザクションを 1 つ作成します。複数の行を渡すと、フォルダーごとに個別のトランザクションが作成されます。
* **Files モード** – 個々のファイルの場所とその Parameter を渡します。このモードでは、トランザクション内のドキュメントごとに個別のファイルParameterを設定できます。

<div id="connection-settings">
  ## 接続設定
</div>

**Use Skill** ツールには、[接続の構成](/ja/vantage/connectors/alteryx/setup#configure-the-connection)で説明されている接続設定のほか、文書処理に使用する Skill を選択するための **Vantage Skill** 設定が用意されています。

<div id="input-anchor">
  ## Input アンカー
</div>

| 列                                   | 型          | 説明                                      |
| ----------------------------------- | ---------- | --------------------------------------- |
| DirectoryPath                       | V\_WString | 1つのトランザクションとして処理するファイルが格納されているフォルダーの場所。 |
| Files                               | V\_WString | 処理するファイルの場所と、その Parameter。              |
| Transaction Registration Parameters | V\_WString | トランザクション登録Parameterのセット。この列はオプションです。    |

<div id="directorypath-mode">
  ### DirectoryPath モード
</div>

**DirectoryPath** 列にフォルダーのパスを指定します。指定したフォルダーの直下にあるすべてのファイルが、1つのグループとしてトランザクションに追加されます。サブフォルダー内のファイルは含まれません。

複数の行を指定すると、フォルダーごとに個別のトランザクションが作成されます。

<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="DirectoryPath の値が C:\Temp\Input と C:\Temp\Input2 の2行を示す Use Skill の入力テーブル" width="193" height="60" data-path="images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png" />
</Frame>

<div id="files-mode">
  ### Files モード
</div>

**Files** 列に、次の形式でファイルパスと Parameter を指定します。

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

セミコロン文字 (`;`) は、複数のファイル間、およびファイルとその Parameter の間の区切り文字として機能します。`FileParamName` を使用すると、Document に名前付きのファイル Parameter を設定できます。

たとえば、`Invoice_01.tif` と `Invoice_02.tif` を、各 Document に **Created** および **Size** Parameter を指定してトランザクションに追加する場合は、次のように記述します。

<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="Use Skill Files column input showing a single row with two file paths and their Created and Size parameters" width="831" height="46" data-path="images/vantage/developer/connectors/alteryx/use-skill-files-input.png" />
</Frame>

<Warning>
  `=` および `;` は既定で区切り文字として扱われるため、ファイルパスや registration Parameter の値には含めないでください。
</Warning>

<div id="transaction-registration-parameters">
  ### トランザクション登録Parameter
</div>

トランザクションレベルのParameterは、**Transaction Registration Parameters** 列に次の形式で指定します。

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

複数のParameterはセミコロン (`;`) で区切ります。たとえば、ソースの型とコンピューター名を渡す場合は次のように指定します。

<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="Use Skill input table with DirectoryPath and TransactionRegistrationParameters columns showing SourceType and PCname values" width="449" height="138" data-path="images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png" />
</Frame>

トランザクションおよびファイルの registration Parameter は Vantage Skill Monitor で確認でき、エクスポートされる JSON ファイルにも含まれます。

<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="JSON output showing CreationTime, SourceFiles with file Id and Name, RegistrationParameters with SourceType and PCname, and Version fields" width="671" height="235" data-path="images/vantage/developer/connectors/alteryx/use-skill-json-params.png" />
</Frame>

<div id="output-anchor">
  ## 出力アンカー
</div>

| Column        | Type       | Description                                                                                             |
| ------------- | ---------- | ------------------------------------------------------------------------------------------------------- |
| TransactionId | V\_WString | 作成されたトランザクションの識別子です。この ID は、トランザクションのステータスと処理結果を取得するために **Get Status** ツールおよび **Get Result** ツールに渡されます。 |
| isSuccess     | Bool       | トランザクションが正常に作成されたかどうかを示します。                                                                             |
| Error         | V\_WString | トランザクションの作成中に発生したエラーメッセージを示します。                                                                         |

出力例:

<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="Use Skill output table showing two rows with TransactionId GUIDs, IsSuccess True, and Error Null" width="477" height="58" data-path="images/vantage/developer/connectors/alteryx/use-skill-output-example.png" />
</Frame>

<Note>
  ABBYY Vantage では、最大 2 GB までのトランザクションをアップロードできます。文書処理を高速化するには、個々のファイルサイズを 30 MB 以下に抑えてください。
</Note>

<div id="related-topics">
  ## 関連トピック
</div>

* [Get Status ツール](/ja/vantage/connectors/alteryx/tools/get-status)
* [Get Result ツール](/ja/vantage/connectors/alteryx/tools/get-result)
* [Parse Fields ツール](/ja/vantage/connectors/alteryx/tools/parse-fields)
