アクセシビリティ オプションが有効な PDF 内の UI 要素を識別する

タグなしの PDF ファイルでの UI 要素の検出をサポートしない Adobe Reader DC のバージョンのリファレンスです。影響を受けるバージョン番号も含みます。

注:

タグ付けされていない PDF ファイルの UI 要素の検出は、Adobe Reader DC の以下のバージョンではサポートされていません。

• 19.012.20036
• 19.012.20035
• 19.012.20034
• 19.010.20100
• 19.010.20099
• 19.010.20098
• 19.010.20091
• 19.010.20069
• 19.010.20064
• 19.008.20081
• 19.008.20080
• 19.008.20074
• 19.008.20071

Adobe Reader DC 18 または Adobe Reader DC 19.012.20040 以降を使用することを推奨します。

Active Accessibility は、運動障害や視覚障害のある方が簡単に文書を読めるようにする API です。Adobe Reader などのプログラムでこれを有効化すると、UI 要素へのアクセス、識別、操作が難しくなったり、エラーが発生しやすくなります。

Studio では、PDF ファイルのページ上の要素が個別ではなく、ひとまとまりで識別されてしまいます。

一般的な問題

以下に、PDF ファイルに含まれる UI 要素の識別に関して発生し得る問題とその解決方法をまとめました。

UiPath.UIAutomation.Activities パッケージ v19.5.0 以降では、[現在の文書の読み上げオプションを変更] ウィンドウが自動的に開き、画面上で示すと適切なオプションが選択されます。ただし、要素の選択中に問題が引き続き発生する場合は、以下で説明するように、アクセシビリティ オプションを手動で調整することをお勧めします。

タグ付けされた PDF 文書

このシナリオでは、PDF ファイルのページ コンテンツの内部にメタ情報が含まれています。そのため、アクセシビリティの各種オプションにより、埋め込まれた情報が (可視ページ要素としてではなく、ひとまとまりとして) 読み取られ、UI Explorer で表示されます。これにより、下図に示すように、ページ自体の個別の要素の検出が妨げられてしまいます。

Adobe Reader 2024

[文書全体を読み上げる] オプションを設定するには、Adobe Reader 2024 で次の手順を実行します。

1. [メニュー] > [環境設定] に移動します。

2. [分類] リストから [読み上げ] を選択します。

3. [ページあるいは文書] で、ドロップダウン メニューから [文書全体を読み上げる] オプションを選択します。

4. [読み上げ順序オプション] で、[タグ付き文書の読み上げ順序を上書き] チェックボックスをオンにします。

   

5. 変更を保存するために、[OK] を選択します。

Adobe Reader DC 19

タグ付けされていない PDF ファイル内の UI 要素の選択は、Adobe Reader DC 19.012.20040 以降のみで可能です。対話型の UI 要素選択を機能させるには、PDF ファイルにタグを付ける必要があります。

PDF ファイルをタグ付けすると、次のオプションを選択しなければなりません。

1. Adobe Reader で [編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションの変更] オプションを選択します。[ 現在のドキュメントの読み取りオプションを変更 ] ウィンドウが表示されます。

2. [読み上げ順序] ドロップダウンから、[タグ付けされた読み上げ順序] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。

3. [読み上げモードオプション] セクションで [文書全体を読み上げる] オプションを選択します。

4. [ 開始 ] ボタンを選択します。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。

   

Adobe Reader DC 18

この問題を修正するには、ドキュメントのアクセシビリティの読み取り順序を変更する必要があります。これには次の手順を行います。

1. Adobe Reader で [編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションの変更] オプションを選択します。[ 現在のドキュメントの読み取りオプションを変更 ] ウィンドウが表示されます。

2. [読み上げ順序] ドロップダウン リストから、[文書の読み上げ順序を推測] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。

3. [読み上げモードオプション] セクションで [文書全体を読み上げる] オプションを選択します。

4. [ 開始 ] ボタンを選択します。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。

   

ページに可視オブジェクトが 1 つしかない場合

この文書では、1 つのページに、テキストや画像など複数の要素からなる Active Accessibility の可視オブジェクトが 1 つだけ存在します。しかし、アクセシビリティの各種オプションに従って印刷または読み上げられると、このオブジェクトが個別の要素に分解されてしまいます。こちらにも同様の問題が見られます。

ここでも、文書のアクセシビリティの読み上げ順序を変更することが解決策となります。

1. Adobe Reader で [編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションの変更] オプションを選択します。[ 現在のドキュメントの読み取りオプションを変更 ] ウィンドウが表示されます。

2. [読み上げ順序オプション] ドロップダウン リストから、[印刷ストリーミングの読み上げ順序を使用] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。

3. [読み上げモードオプション] で [文書全体を読み上げる] オプションを選択します。

4. [ 開始 ] ボタンを選択します。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。

   

Adobe Reader DC のセキュリティ オプション

注:

この問題は v22.12 の UiPath.UIAutomation.Activities で修正されました。 PDF 操作の自動化は、セキュリティ オプション [起動時に保護モードを有効にする] が有効化されていても機能します。

v22.10 以前の UiPath.UIAutomation.Activities と v22.003.20258 の Adobe Reader DC (Acrobat Reader のリリース ノートを参照) において、PDF 操作の自動化が影響を受ける場合があります。その場合、PDF ドキュメント内の個々の要素は識別されず、代わりにドキュメント全体が選択されます。

この問題は、Adobe Reader DC のセキュリティ オプション [起動時に保護モードを有効にする] が既定で有効化されていることが原因で発生します。

この問題を修正するには、以下の手順を使用して、このセキュリティ オプションを無効化します。

1. Adobe Reader を開きます。

2. [メニュー] > [環境設定] に移動します。

3. [分類] リストから [セキュリティ (拡張)] を選択します。

4. [サンドボックスによる保護] セクションの [起動時に保護モードを有効にする] チェックボックスをオフにします。

   

5. 確認が求められます。[ はい ] を選択して続行し、[ OK] を選択します。

6. Adobe Reader を再起動します。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。