Get Results アクティビティ

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.

Get Results は、Use Skill activity によって開始されたトランザクションの結果を取得します。Use Skill から Transaction Id を渡すと、このアクティビティは TransactionStatus とドキュメントごとの結果を返します。トランザクションがまだ処理中の場合は、少し待ってからこのアクティビティを再度呼び出してください。Review アクティビティによってトランザクションが一時停止されている場合は、最終結果ではなく手動確認リンクを返します。 分類スキル、Document Skill、または OCR Skill を使用する場合、トランザクションのすべての入力ファイルは 1 つのドキュメントにまとめられます。Process Skill を使用する場合は、複数の結果ドキュメントを取得できます。 既定では、Process Skill では、各入力ファイルが Vantage 内で個別のドキュメントになります。ドキュメントは異なる class に属していてもかまいませんが、同じトランザクション内で処理されます。このアセンブリを変更するには、Process Skill で Assemble アクティビティを設定します。 各ドキュメントは独自の結果を生成します。Document Results 出力プロパティは、トランザクション内のドキュメントごとに 1 つずつ、DocumentResult インスタンスのコレクションを返します。 トランザクションの処理が正常に完了した場合 (つまり、Transaction Status = "Processed") 、結果は出力プロパティに保存されます。 トランザクションがまだ処理中の場合 (つまり、Transaction Status = "New" / "Processing") 、数秒待ってから Get Results アクティビティを再度呼び出してください。 Transaction Status = "Review" となる特別なケースについては、以下で説明します。 Get Results アクティビティで取得できる結果は、ドキュメントに適用された Skill によって異なります。 分類スキル (例: Vantage Classifier) は次を返します:

• Transaction Status
• Document Results (各 DocumentResult): DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (分類結果データを含む JSON ファイル)

Document skill (例: Invoice US) は次を返します:

• Transaction Status
• Document Results (各 DocumentResult): DocumentId, ExtractedData, ResultFiles (結果は 2 つの JSON ファイルに含まれます。1 つ目には文書データ全体が含まれ、2 つ目には抽出されたフィールドの値とルールエラーが含まれます。ファイル名は _fields.json で終わります)

OCR Skill は次を返します。

• Transaction Status
• Document Results (各 DocumentResult): DocumentId, ResultFiles (これらのファイルは、OCR Skill で設定されたエクスポートに対応します), DocumentFullText (Skill で TXT へのエクスポートが有効な場合)

取得される結果は、Process Skill を構成するアクティビティとその設定、特に Output アクティビティの設定によって異なります。Process Skill の詳細については、Process Skill の設定を参照してください。 Process Skill に Classify アクティビティと Extract アクティビティが含まれている場合、上記の結果は分類スキルと Document Skill の両方に対して取得されます。 Process Skill に複数の Classify アクティビティまたは Extract アクティビティが含まれている場合、結果は該当する型の最後のアクティビティに対して取得されます。 Process Skill の Output アクティビティの Exported Data Settings ダイアログで PDF オプションが有効になっている場合、結果には抽出結果を含む JSON ファイルと、テキストレイヤー付きで PDF ファイルにエクスポートされた文書画像が含まれます。トランザクション内の各文書について、Skill で TXT へのエクスポートが有効になっていれば、DocumentFullText パラメーターが取得されます。 Process Skill には Review アクティビティを含めることもできます。このような Skill を文書処理に使用すると、文書で手動確認が必要な場合に処理が一時停止されることがあります。この場合、Get Results アクティビティでは次の情報が取得されます。

• Transaction Status = "Review"
• Review Link

手動確認とトランザクション処理が完了したら、Get Results アクティビティを再度呼び出すことで、上記の結果を取得できます。 トランザクション処理は、さまざまな理由で失敗することがあります (たとえば、入力ファイルが破損している場合や、その形式が ABBYY Vantage でサポートされていない場合など) 。この場合、Get Results アクティビティは例外をスローします。