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

注:

タグ付けされていない 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 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 のセキュリティ オプション

PDF automation may be affected after upgrading Adobe Reader DC to version 22.003.20258 (see Acrobat Reader Release Notes). It is not possible to identify individual elements in PDF documents, instead the entire document is selected. This problem occurs regardless of the version of the UI Automation activity package.

この問題は、Adobe Reader DC で利用可能なセキュリティ オプション [起動時に保護モードを有効にする] が既定で有効化されているために発生する可能性があります。

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

1. Adobe Reader を開きます。
2. [編集] > [環境設定] に移動します。
3. [分類] リストから [セキュリティ (拡張)] を選択します。
4. [サンドボックスによる保護] セクションの [起動時に保護モードを有効にする] チェックボックスをオフにします。
5. 確認を求められます。[はい] をクリックして続行し、[OK] をクリックします。
6. Adobe Reader を再起動します。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。