メインコンテンツへスキップ

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.

Map Fields アクティビティは、抽出したfieldの値をUiPath変数に保存するために使用します。Designer パネルでは、ABBYY VantageのfieldをUiPath変数にマッピングできます。

アクティビティのプロパティ

グループプロパティ説明
Connection SettingsSkill NameStringVantage Document skill の名前です。
InputExtracted DataString抽出データを含む JSON 文字列を受け取ります。このプロパティには、Get Results アクティビティで受け取った該当の DocumentResultExtractedData プロパティの値を渡します。プロパティ間で値を受け渡すには、UiPath 変数を使用します。
Map Fields アクティビティは、設定済みの Vantage Scope アクティビティ内でのみ使用できます。
アクティビティを設定する際は、コネクタが Skill の一覧を取得できるように、Vantage Scope アクティビティで Password または Client Secret プロパティ (認証フローに応じて異なります) を設定します。ワークフローの設定が完了したら、Secure Password または Secure Client Secret プロパティに切り替えてください — Vantage Scope アクティビティ を参照してください。 実行時には、Extracted Data プロパティに、この Map Fields アクティビティの設定対象である Document skill に対して Get Results が返した DocumentResultExtractedData 値を渡す必要があります。 データを Map Fields に渡す前に、次のことを確認してください。
  • 文書の Document skill が、Map Fields で設定されているものと一致していることを確認します。文書タイプを識別するには、DocumentResultClassName プロパティを使用します。
  • ClassName を設定するには、Process skill の Extract アクティビティで class と skill のマッピングを設定します。このとき、class 名は Document skill 名と一致している必要があります。
Extract アクティビティの設定について詳しくは、Map Document skills to classes を参照してください。 ABBYY Vantage field を UiPath 変数にマッピングするには、次の手順を実行します。
1

Map Fields アクティビティを開く

Designer パネルで Map Fields アクティビティを開き、利用可能な Skill の一覧をロードするため、Skill Name の下にあるドロップダウンリストの右側のボタンをクリックします。
2

Document skill を選択する

Skill Name ドロップダウンリストを展開し、抽出されたフィールド値を UiPath 変数に保存する Document skill を選択します。
選択できるのは Document skill のみです。
3

フィールドツリーを更新する

Refresh ボタンをクリックします。Vantage Extracted Field 列にフィールドツリーが表示されます。
4

field を UiPath 変数にマッピングする

ツリーを展開し、マッピングする field の横にある Plus ボタンをクリックします。UiPath Variable 列に、UiPath 変数名と型が表示されます。既定では、変数名は Vantage field の名前と同じですが、必要に応じて変更できます。
Map Fields アクティビティで指定する UiPath 変数名が、UiPath プロセスで設定された Variables Naming Convention と一致していることを確認してください。変数名が命名規則に従っていない場合、UiPath 変数リストでは警告記号付きで表示されます。Variables Naming Convention の詳細については、UiPath documentation を参照してください。
Vantage Extracted Field ツリーと UiPath Variable 列を示す Map Fields アクティビティ
5

残りの field をマッピングする

マッピングが必要な他の field について、前の手順を繰り返します。既存の UiPath 変数を指定することもできます。その場合は、変数の型が以下の表で推奨されているものと一致していることを確認してください。
6

マッピングを適用する

文書の field を UiPath 変数にマッピングしたら、変更を保存するために Apply をクリックします。実行時に Map Fields アクティビティが呼び出されると、変数の値に抽出データが設定されます。
指定した UiPath 変数は、Map Fields アクティビティに最も近い Sequence 内 (たとえば Flowchart 内) に作成されます。
Skill Name パラメーターは、UiPath の String 変数を受け取ります。ドロップダウンリストから Document skill を選択すると、新しい値がその変数に書き込まれます。式や他の変数への参照はサポートされていません。
以下の表は、各 ABBYY Vantage field の型に対応する UiPath 変数の型を示しています。
ABBYY Vantage Field TypeUiPath Variable Type
TextString
DateString
NumberString
MoneyString
BarcodeString
CheckmarkBoolean
チェックマークグループ (個別の チェックマーク として取得可能)FieldList
GroupFieldList
Group (繰り返しグループの場合)FieldList[]
テーブルFieldList[]
繰り返しのリーフ fields (Text など) とテーブル columns は String[] にマッピングされます。繰り返しグループ (他の繰り返しグループ内にネストされているものを含む) は FieldList[] にマッピングされます。繰り返しグループ内では、個々の子 fields を単純型にマッピングすることもできます。
マッピングされたグループと繰り返しフィールドを含む、Vantage Extracted Field ツリーと UiPath Variable 列を表示する Map Fields アクティビティ

GroupItem

GroupItem は、繰り返し object (field または field のグループ) の 1 つのインスタンスを含む構造です。
Method/PropertyParameterTypeDescription
KeysIEnumerable<string>key 値。各値は特定のネスト レベルの名前です。
ValuesIEnumerable<IReadOnlyList<FieldList>>ネスト レベルの field values のセット。
CountIntegerネストされた field の数。
ContainsKeyKey: StringBooleanネストされた field が存在するかどうかを示します。
TryGetValueKey: String, Value: IReadOnlyList<FieldList>Boolean値が存在するかどうかを示します。値がある場合は True とその値を返し、ない場合は False を返します。
this[]Name: StringIReadOnlyList<FieldList>指定したネストされた field の値を返します。
FindName: StringIEnumerable<FieldList>指定した名前を持つ、任意のネスト レベルのすべてのネストされた field を検索します。
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>述語を満たす、任意のネスト レベルのすべてのネストされた field を検索します。
DescendentsNameItems: Params String[]IEnumerable<FieldList>名前が nameItems パラメーターに一致する、任意のネスト レベルのすべてのネストされた field を検索します。

FieldList

FieldList は、field または field のグループ (同じ名前の repeating fields または繰り返しグループ) に対応する構造で、field またはグループの値 (複数のインスタンスを含む場合があります) を保持します。
Method/PropertyParameterTypeDescription
ValuesIEnumerable<Object>スカラー field 値のセット。
CountIntegerネストされた GroupItems の数。
FindName: StringIEnumerable<FieldList>指定した名前を持つ、任意のネスト レベルのすべてのネストされた field を検索します。
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>述語を満たす、任意のネスト レベルのすべてのネストされた field を検索します。
this[]Num: IntegerGroupItemnum パラメーターで指定した位置にある、ネストされた field を持つ GroupItem (存在する場合) を返します。
Sample Process には、FieldList[] 型の変数の使用例があります (LineItems テーブルの Description 列がログ メッセージに表示されます) 。
Group field 型の詳細については、Group field を参照してください。

Vantage Scope アクティビティ

配下の Vantage アクティビティに、ABBYY Vantage の接続設定を渡します。

Use Skill アクティビティ

Skill を使ってドキュメントを処理するための Vantage トランザクションを作成します。

Get Results アクティビティ

ABBYY Vantage から処理結果を取得します。