Como identificar elementos de EU em PDF com opções de acessibilidade

Observação:

A detecção de elementos de EU para arquivos de PDF sem tags não é compatível com as seguintes versões do Adobe Reder 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

Recomendamos usar o Adobe Reder DC 18 ou Adobe Reader DC 19.012.20040 ou superior.

A acessibilidade ativa é uma API que fornece um maior suporte de leitura para os indivíduos com dificuldades físicas ou cognitivas. Quando habilitado em programas, como o Adobe Reder, o acesso, a identificação ou a manipulação de elementos de IU podem ser difíceis ou propensos a erros.

No Studio, significa que os elementos em uma página de um arquivo PDF são identificados como um todo, em vez de individualmente.

Abaixo temos alguns exemplos de problemas de identificação de EU em arquivos PDF que você pode encontrar e como resolvê-los.

Iniciando com o pacote Quipata.UIAutomation.Activities v19.5.0.0.0, a janela Alterar opções de leitura do documento atual será aberta automaticamente e as opções apropriadas selecionadas ao indicar no tela. Se você ainda encontrar problemas durante a seleção do elemento, é recomendável ajustar as opções de acessibilidade manualmente conforme o descrito abaixo.

Documentos PDF com tags

In this scenario, the PDF file contains meta-information inside the page content. This means that Accessibility options read the embedded information (as a whole, instead of visible page elements) and present it to UI Explorer. This interferes with the detection of individual elements on the page itself:

Adobe Reader 2024

To set the Read the entire document option, follow these steps in Adobe Reader 2024:

1. Go to Menu > Preferences.
2. From the Categories list, select Reading.
3. Under Page vs Document, select the Read the entire document option from the drop-down menu.
4. Under Reading Order Options, select the Override the reading order in tagged documents checkbox.
   
   

   

   
   
5. To save the changes, select OK.

Adobe Reder DC 19

The selection of UI elements inside untagged PDF files is only possible for Adobe Reader DC 19.012.20040 or greater. You need to tag PDF files for interactive UI element selection to function.

Após os arquivos PDF receberem tags, é necessário selecionar a seguinte opção:

1. No Adobe Reder, abra o menu Editar e clique na opção Alterar opções de leitura no submenu Acessibilidade. A janela Alterar opções de leitura do documento atual é exibida.
2. No menu suspenso Ordem de leitura, selecione a opção Ordem de leitura com tags. Isso instrui o Adobe Reder para ignorar a acessibilidade ativa ao ler o documento.
3. Na seção Opções de modo de leitura, selecione a opção Ler o documento inteiro.
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

Adobe Reder DC 18

Para corrigir isso, a ordem de leitura de acessibilidade do documento precisa ser alterada, seguindo estas etapas:

1. No Adobe Reder, abra o menu Editar e clique na opção Alterar opções de leitura no submenu Acessibilidade. A janela Alterar opções de leitura do documento atual é exibida.
2. No menu suspenso Ordem de leitura, selecione a opção Inferir ordem de leitura do documento. Isso instrui o Adobe Reder para ignorar a acessibilidade ativa ao ler o documento.
3. Na seção Opções de modo de leitura, selecione a opção Ler o documento inteiro.
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

Objeto visível único na página

Aqui, o documento contém um único objeto de acessibilidade ativo que está visível em uma página, composto de vários elementos, como texto e fotos. No entanto, ao ser impresso ou lido por opções de acessibilidade, o objeto será decomposto em elementos individuais. O problema aqui é o mesmo, como é possível ver:

De novo, a correção é alterar a ordem de leitura de acessibilidade do documento, da seguinte maneira:

1. No Adobe Reder, abra o menu Editar e clique na opção Alterar opções de leitura no submenu Acessibilidade. A janela Alterar opções de leitura do documento atual é exibida.
2. No menu suspenso Ordem de leitura, selecione a opção Usar a ordem de leitura no fluxo de impressão bruto. Isso instrui o Adobe Reder para ignorar a acessibilidade ativa ao ler o documento.
3. Em Opções de modo de leitura, selecione a opção Ler o documento inteiro.

4. Clique no botão Iniciar. O Inexplorável agora pode ser usado para identificar os elementos de EU individuais na página.

   
   

   

   
   

Security option in Adobe Reader DC

Note: This issue has been fixed in UiPath.UIAutomation.Activities version 22.12.

A automação de PDFs funciona mesmo se a opção de segurança Modo Protegido estiver habilitada.

Para o UiPath.UIAutomation.Activities versão 22.10 ou mais antiga e Adobe Reader DC versão 22.003.20258 (consulte Notas de versão do Acrobat Reader), a automação de PDFs pode ser afetada. Não é possível identificar elementos individuais em documentos PDF e, como resultado, o documento inteiro é selecionado.

Esse problema é causado por uma opção de segurança disponível no Adobe Reader DC, Ativar modo protegido na inicialização, que é ativada por padrão.

Para corrigir isso, desabilite a opção de segurança usando as etapas abaixo:

1. Abra o Adobe Reader.
2. Go to Menu > Preferences.
3. Na lista Categorias, selecione Segurança (aprimorada).
4. Na seção Sandbox Protections, desmarque a caixa de seleção Ativar modo protegido na inicialização.
   
   

   

   
   
5. Será solicitada uma confirmação. Clique em Sim para continuar e, em seguida, clique em OK.
6. Restart Adobe Reader. UI Explorer can now be used to identify individual UI elements on the page.