検証コントロールの変数

各検証コントロールは、アプリ内に変数を自動的に作成します。この変数はドキュメント データを保持し、アプリやオートメーションの他の部分で使用できます。

変数名は構文 Var<ValidationControlName>_<PageName>に従います (例: VarValidationControl_MainPage)。

検証コントロールの変数を使用すると、検証コントロールからの読み取りと検証コントロールに対する書き込みの両方が可能になります。

Apps では、この変数が自動的に管理されます。

• 検証コントロールをキャンバスに追加するときに変数を作成します。
• コントロールの名前を変更すると、変数の名前が変更されます。
• コントロールを削除すると、変数を削除します。
• この変数は保護されているため、手動で削除または変更できません。
• 変数はアプリスコープであるため、異なるアプリ ページにわたる使用状況を示します。

変数のプロパティ

検証コントロールの変数には、参照またはバインドできるプロパティがいくつか含まれています。

• Taxonomy—ドキュメント スキーマ、フィールド定義、およびラベルを保持します。
• ExtractionResult— 抽出されたフィールド値が、未加工および検証済みのフィールド値が含まれます。
• SelectedDocumentType- コントロールに表示されるアクティブなドキュメントの種類です。
• SelectedField- ユーザーが現在選択しているフィールドです。
• BusinessRules— フィールドレベルの検証ルールのステータス。
• IsValid- コントロールの有効性をオーバーライドする Boolean フラグです。
• DataSource- 元の ContentValidationData オブジェクトを保持します。

データの読み取り

検証コントロールのコンテンツの現在のステートを読み取るには、以下の式を使用します。

• 抽出結果を取得する

  VarValidationControl1_MainPage.ExtractionResult

• 選択したドキュメントの種類を取得する

  VarValidationControl1_MainPage.SelectedDocumentType

• 選択したフィールドとその値を取得する

  VarValidationControl1_MainPage.SelectedField.FieldValue.Value

  VarValidationControl1_MainPage.SelectedField.FieldValue.Confidence

• タクソノミーのフィールドを取得する (ドロップダウンに便利)

  VarValidationControl1_MainPage.Taxonomy.GetFields(VarValidationControl1_MainPage.SelectedDocumentType).ToListSource

• 表フィールドの値を読み取る

  VarValidationControl1_MainPage.ExtractionResult.GetTableFieldValueByTableName("Invoice Items")(0)(0).Value

  ここで、 (0)(0) は、Invoice Items テーブルの最初の列と最初の行が交差するセルを表します。

各クラスの定義とプロパティについては、 Document Understanding のドキュメント をご覧ください。

データの書き込み

検証コントロール内の値を編集するには、[ 変数の値を設定 ] アクティビティを使用して、この変数を参照します。

• [変数] フィールドでフィールド値を設定する

  VarValidationControl1_MainPage.Field("Patient Name").Value

  [値を設定 ] フィールド: John Doe。

• 表のセルの値にフォーカスを設定する

  VarValidationControl1_MainPage.Field("Invoice Items").Field("Description", 0).SetFocus = true

  ここで、 ("Description", 0) は、「Description」列と Invoice Items テーブルの最初の行が交差するセルを表します。

• 信頼度フラグまたは確認フラグを設定する

  VarValidationControl1_MainPage.Field("Patient Name").Confidence = 0.95

  VarValidationControl1_MainPage.Field("Patient Name").Confirm = true

• 複数値フィールドを更新する

  VarValidationControl1_MainPage.Field("Diagnosis Code", 2).Value = "E11.9"

  ここで、 2 は [診断コード] 列の行番号を表します。

• フィールド値を削除する

  VarValidationControl1_MainPage.Field("Vendor Name").DeleteValue

• 表のセルを更新する

  VarValidationControl1_MainPage.Field("Invoice Items").Field("Description", 0).Value = "50.00"

  ここで、 ("Description", 0) は、「Description」列と Invoice Items テーブルの最初の行が交差するセルを表します。