検証コントロール

Studio Web アプリ プロジェクトに検証コントロールを追加および設定して、抽出されたドキュメント データをレビューおよび修正するための Document Understanding の検証ステーションを埋め込みます。

Validation Control is a component within Apps in Studio Web that embeds Validation Station from Document Understanding into your apps. This lets you review, correct, or approve data that has been automatically extracted from documents, such as invoices, forms, or emails. Common scenarios include human-in-the-loop automations, especially when data extraction is uncertain or incomplete. For example, if an invoice is scanned and the total amount looks uncertain, the Validation Control allows a human to check and correct it before submission.

検証コントロールを使用すると、特に以下の場合に、Web アプリ内で直接ドキュメントを手動で確認できます。

• データが欠落しているか不明瞭である
• 信頼度レベルが低い
• ビジネス ルールを検証するには人間の判断が必要です

ユーザー シナリオ

検証コントロールのユーザー シナリオの例を次に示します。

• 合計が不確実な請求書を承認する
• 部分的に抽出されたデータを使用した保険金請求の確認
• 書類の品質が低い場合の名前と住所の確認

機能

検証コントロールをアプリに統合すると、以下が可能になります。

• アプリのインターフェイス内で直接ドキュメント全体を表示する。
• 名前、金額、日付などの抽出データを確認します。
• データを編集、確認、削除する。
• ユーザー入力に基づいてビジネス ルールまたはワークフローをトリガーする。
• 複数のドキュメントの種類、表の値、複雑なフィールド構造を検証します。
• ストレージ バケットを使用してドキュメント検証のすべてのコンテンツを保存および取得することで、Automation Cloud を介したデータ交換をセキュリティで保護します。

動作のしくみ

メイン ワークフローは次のとおりです。

1、2、3、4: 抽出用のドキュメントをアップロードします。ロボットが Document Understanding または Communications Mining を使用してドキュメントを処理します。

5: ロボットは 、[ドキュメント検証成果物を作成 ] アクティビティまたは [Communications Mining 検証成果物を作成 ] アクティビティを使用して、 ContentValidationData クラスの出力オブジェクトを作成します。このオブジェクトには、抽出結果、元のドキュメント、およびサポート情報が含まれます。

その後、検証コントロールがドキュメントとその抽出の詳細を表示するために必要なすべての中間データを作成して格納します。このデータは Orchestrator のストレージ バケットに保存され、 ContentValidationData オブジェクトを使用してアクセスできます。

6: データを抽出したロボットによって、検証コントロールを含むアクション アプリがトリガーされます。このアプリケーションは、Action Center タスクとして提示されます。

注:

スタンドアロン アプリを構築する場合は、手順 6 (アプリ タスクを作成) と 7 (アプリ タスク完了まで待機し再開) を追加する代わりに、 ContentValidationData オブジェクトを ContentValidationData 変数に割り当てることができます。この変数を検証コントロールのデータ ソースとして使用できます。

7: ユーザーとして、Action Center でタスクを受信します。Web アプリを開くと、片側にドキュメント、もう片側に抽出されたデータが表示されます。その後、値の修正、データの確認、または誤ったエントリの却下を行うことができます。

8、9、10: 検証済みのデータを送信すると、ロボットは ドキュメント検証成果物を取得 アクティビティまたは Communications Mining 検証成果物を取得 アクティビティを使用して更新された情報を取得し、オートメーションを再開します。これにより、ワークフローでは確認済みおよび承認されたデータのみが使用されるようになります。

制限事項

アプリで検証コントロールを使用する場合は、以下の制限事項に注意してください。

• Automation Cloud でのみ使用できます。オンプレミス環境またはハイブリッド環境はサポートされていません。
• 検証コントロールは、Studio Web アプリ プロジェクトでのみ機能します。VB アプリでは使用できません。
• ドキュメント検証タスクにのみ使用できます。現時点では、ドキュメント分類はサポートされていません。

ContentValidationData オブジェクト

ContentValidationData オブジェクトは、検証コントロールでドキュメントとその抽出の詳細を読み込んでレンダリングするために必要なデータです。これはコントロールのデータ ソースとして機能します。

このオブジェクトは、[ ドキュメント検証成果物を作成 ] アクティビティまたは [Communications Mining 検証成果物を作成 ] アクティビティによって作成され、Orchestrator のストレージ バケットに保存されます。タスクが完了すると、ContentValidationData オブジェクトを ドキュメント検証成果物を取得 アクティビティまたは Communications Mining 検証成果物を取得 アクティビティの入力として使用して、検証済みの情報を取得できます。

ContentValidationData JSON 構造

ログ アクティビティを有効化すると、ワークフロー ログから JSON 形式で ContentValidationData オブジェクトにアクセスできます。この JSON は、ドキュメントとその抽出データを表示するために必要なすべてのファイルがストレージ バケット内のどこにあるかを検証コントロールに正確に伝えます。JSON 形式でシリアル化された ContentValidationData オブジェクトの例を次に示します。

{
"BucketName":"DUValidationStationTestSb",
"BucketId":186140,
"FolderId":756377,
"FolderKey":"c2751834-1f05-4f4e-9cb8-509406f6faac",
"DocumentId":"4e32cef6-d4ee-4eac-a382-e80a2640de8a",
"DocumentPath":"v1\\4e32cef6-d4ee-
4eac-a382-e80a2640de8a\\CMS 1500.zip",
"EncodedDocumentPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\encoded.zip",
"TextPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\text.zip",
"DocumentObjectModelPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\dom.zip",
"TaxonomyPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\taxonomy.zip",
"AutomaticExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\input_results.zip",
"ValidatedExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\output_results.zip",
"ExtractorPayloadsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\extractor_payloads.zip",
"ShowOnlyRelevantPageRange":false,
"AdditionalDataPath":"",
"OriginalDocumentFileName":"CMS 1500.pdf",
"CustomizationInfoPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\customization_info.zip"
}

場所：

• BucketName および BucketId- これらのプロパティは、ドキュメント検証に関連するすべてのファイルが格納されているストレージ バケットを示します。
• FolderId と FolderKey- ドキュメントとその関連ファイルがあるストレージ バケット内の特定のフォルダーを示します。
• DocumentId- 検証される特定のドキュメントの一意の識別子です。
• DocumentPath- ストレージ バケット内の元のドキュメント ファイルへのフル パスです。
• EncodedDocumentPath、 TextPath、 DocumentObjectModelPath、 TaxonomyPath—これらは、同じくバケットに格納されているさまざまな中間ファイルへのパスです。これらのファイルは、検証コントロールでドキュメントを正しくレンダリングするために不可欠です。これには、ドキュメント レイアウト情報 (DocumentObjectModelPath) やフルテキスト (TextPath) などのデータが含まれます。
• AutomaticExtractionResultsPath- ロボットによって自動的に抽出されたデータを含むファイルへのパスです。
• ValidatedExtractionResultsPath—整合チェックの完了後に、整合チェックされた最終的なデータがここに保存されます。
• OriginalDocumentFileName- 元のファイルの名前です。

ContentValidationData をデータ ソースとして使用する

[ ドキュメント検証成果物を作成 ] アクティビティを使用する場合、生成される ContentValidationData オブジェクトを 検証コントロール にデータ ソースとして直接割り当てることができます。これを行うには、次のことを行う必要があります。

1. プロジェクトにアクション アプリを追加します。

2. ActionSchema の [入力プロパティ] で、[+ プロパティを追加] を選択します。

3. ContentValidationData オブジェクトを検索して選択し、名前を指定します。たとえば、「cvd」です。

4. 検証コントロールの [データ ソース] フィールドをアクション入力プロパティ ("cvd") に設定します。これにより、AcctionProperties.cvd が検証コントロールのデータ ソースとして設定されます。

   

   

ただし、JSON オブジェクトを手動で作成する場合、 検証コントロールで直接使用することはできません。まず、この式を、 BucketId、 FolderKey、 DocumentIdなどの簡略化されたプロパティ セットを持つ Visual Basic (VB) 式に変換する必要があります。

例:

New UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData With { 
.BucketId = 186140, 
.FolderKey =
new Guid("c2751834-1f05-4f4e-9cb8-509406f6faac"), 
.DocumentId = "4e32cef6-d4ee-4eac-a382-e80a2640de8a",
.DocumentObjectModelPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/dom.zip", 
.TaxonomyPath = "v1/4e32cef6-
d4ee-4eac-a382-e80a2640de8a/taxonomy.zip", 
.TextPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/text.zip",
.EncodedDocumentPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/encoded.zip", 
.AutomaticExtractionResultsPath
= "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/input_results.zip",
.CustomizationInfoPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/customization_info.zip"
}

注:

この方法は、Action Center タスクを作成せずにアプリのトラブルシューティングを行う高度な方法として使用できます。