Studio ガイド

最終更新日時 2024年12月19日

アクセシビリティオプションが有効な 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 2024 (英語)

[ ドキュメント全体を読む ] オプションを設定するには、Adobe Reader 2024 で次の手順を実行します。

[ メニュー] > [設定] に移動します。
[ カテゴリ] リストから [ 読書] を選択します。
[ ページ vs ドキュメント] で、ドロップダウンメニューから [ ドキュメント全体を読み込み ] オプションを選択します。
「 読み上げ順序オプション」で、「 タグ付けされた文書の読み上げ順序を上書き する」チェックボックスを選択します。
変更を保存するには、 [ OK] を選択します。

Adobe Reader DC 19

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

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

Adobe Reader で、[編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションを変更] オプションを選択します。[現在の文書の読み上げオプションを変更] ウィンドウが表示されます。
[読み上げ順序] ドロップダウンから、[タグ付けされた読み上げ順序] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。
[読み上げモードオプション] セクションで [文書全体を読み上げる] オプションを選択します。
[開始] ボタンをクリックします。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。

Adobe Reader DC 18

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

Adobe Reader で、[編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションを変更] オプションを選択します。[現在の文書の読み上げオプションを変更] ウィンドウが表示されます。
[読み上げ順序] ドロップダウンリストから、[文書の読み上げ順序を推測] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。
[読み上げモードオプション] セクションで [文書全体を読み上げる] オプションを選択します。
[開始] ボタンをクリックします。これで、UI Explorer でページ上の UI 要素が個別に識別されるようになりました。

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

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

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

Adobe Reader で、[編集] メニューを開き、[アクセシビリティ] サブメニューから [読み上げオプションを変更] オプションを選択します。[現在の文書の読み上げオプションを変更] ウィンドウが表示されます。
[読み上げ順序オプション] ドロップダウンリストから、[印刷ストリーミングの読み上げ順序を使用] オプションを選択します。これにより、Adobe Reader は文書を読み上げる際に、Active Accessibility を無視するようになります。
[読み上げモードオプション] で [文書全体を読み上げる] オプションを選択します。
[開始] ボタンをクリックします。これで、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 のセキュリティオプション [起動時に保護モードを有効にする] が既定で有効化されていることが原因で発生します。

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