Identificación de elementos de la interfaz de usuario en PDF con opciones de accesibilidad

Nota:

La detección de elementos de la interfaz de usuario para archivos PDF no etiquetados no es compatible con las siguientes versiones de 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 Recomendamos utilizar Adobe Reader DC 18, Adobe Reader DC 19.012.20040 o posterior.

La accesibilidad activa es una API que proporciona un mayor apoyo a la lectura para aquellas personas con dificultades físicas o cognitivas. Cuando se habilita en programas, como Adobe Reader, el acceso, la identificación o la manipulación de los elementos de la interfaz de usuario pueden resultar difíciles o estar expuestos a errores.

En Studio, significa que los elementos de una página de un archivo PDF son identificados como un todo, en vez de individualmente.

A continuación se presentan un par de ejemplos de problemas de identificación de elementos de interfaz de usuario en archivos PDF a los que pueden recurrir, así como la forma de resolverlos.

Al comenzar con el paquete UiPath.UIAutomation.Activities v19.5.0, la ventana Cambiar opciones de lectura del documento actual se abre de forma automática y se seleccionan las opciones adecuadas cuando se indica en la pantalla. Sin embargo, si todavía encuentras problemas durante la selección de elementos, se recomienda ajustar manualmente las opciones de Accesibilidad, como se describe a continuación.

Documentos PDF etiquetados

En este caso, el archivo PDF contiene metainformación dentro del contenido de la página. Esto significa que las opciones de accesibilidad leen la información incrustada (como un todo, en lugar de elementos visibles de la página) y la presentan a UI Explorer. Esto interfiere con la detección de elementos individuales en la propia página:

Adobe Reader 2024

Para establecer la opción Leer todo el documento, sigue estos pasos en Adobe Reader 2024:

1. Ve a Menú > Preferencias.

2. En la lista Categorías, selecciona Lectura.

3. En Página vs Documento, selecciona la opción Leer todo el documento en el menú desplegable.

4. En Opciones de orden de lectura, selecciona la casilla de verificación Anular el orden de lectura en documentos etiquetados.

   

5. Para guardar los cambios, selecciona Aceptar.

Adobe Reader DC 19

La selección de elementos de interfaz de usuario dentro de archivos PDF sin etiquetar solo es posible para Adobe Reader DC 19.012.20040 o posterior. Es necesario etiquetar los archivos PDF para que funcione la selección interactiva de elementos de IU.

Después de que los archivos PDF estén etiquetados, debes seleccionar la siguiente opción:

1. En Adobe Reader, abre el menú Edición y haz clic en la opción Cambiar opciones de lectura del submenú Accesibilidad. Se mostrará la ventana Cambiar opciones de lectura de documento actual.

2. En el menú desplegable Orden de lectura, selecciona la opción Orden de lectura etiquetado. Esto le indica a Adobe Reader que ignore la Accesibilidad Activa al leer el documento.

3. En la sección Opciones de modo de lectura, selecciona la opción Leer todo el documento.

4. Haz clic en el botón Inicio. Ahora puede utilizarse UIExplorer para identificar elementos individuales de la interfaz de usuario en la página.

   

Adobe Reader DC 18

Para solucionarlo, es necesario cambiar el orden de lectura de la Accesibilidad del documento, siguiendo estos pasos:

1. En Adobe Reader, abre el menú Edición y haz clic en la opción Cambiar opciones de lectura del submenú Accesibilidad. Se mostrará la ventana Cambiar opciones de lectura de documento actual.

2. Desde el menú desplegable Orden de lectura, selecciona la opción Inferir el orden de lectura a partir del documento. Esto le indica a Adobe Reader que ignore la Accesibilidad Activa al leer el documento.

3. En la sección Opciones de modo de lectura, selecciona la opción Leer todo el documento.

4. Haz clic en el botón Inicio. Ahora puede utilizarse UIExplorer para identificar elementos individuales de la interfaz de usuario en la página.

   

Un solo objeto visible en la página

Aquí, el documento contiene un único objeto de Accesibilidad Activa visible en una página, que se compone de múltiples elementos, como texto e imágenes. Sin embargo, al imprimirlo o leerlo mediante las opciones de Accesibilidad, el objeto se descompone en elementos individuales. El problema aquí es el mismo, como puedes ver:

Una vez más, la solución está en cambiar el orden de lectura de la Accesibilidad del documento, de la siguiente manera:

1. En Adobe Reader, abre el menú Edición y haz clic en la opción Cambiar opciones de lectura del submenú Accesibilidad. Se mostrará la ventana Cambiar opciones de lectura de documento actual.

2. En el menú desplegable Orden de lectura, selecciona la opción Usar el orden de lectura en el flujo de impresión sin formato. Esto le indica a Adobe Reader que ignore la Accesibilidad Activa al leer el documento.

3. En las Opciones de modo de lectura, selecciona la opción Leer todo el documento.

4. Haz clic en el botón Inicio. Ahora puede utilizarse UIExplorer para identificar elementos individuales de la interfaz de usuario en la página.

   

Security option in Adobe Reader DC

Nota:

El problema se ha corregido en la versiVersión Versión 22.12 de UiPath.UIAutomation.Activities. PDF automatión funciona incluso si se habilita la opción de seguridad Modo protegido.

Para UiPath.UIAutomation.Activities 22.10 y anteriores y Adobe Reader DC versión 22.003.20258 (consulta Notas de la versión de Acrobat Reader), la automatización de PDF puede verse afectada. No es posible identificar elementos individuales en documentos PDF, en su lugar se selecciona el documento completo.

This issue is caused by a security option available in Adobe Reader DC, Enable Protected Mode at startup, which is enabled by default.

Para solucionar esto, deshabilita la opción de seguridad utilizando los pasos siguientes:

1. Abrir Adobe Reader.

2. Ve a Menú > Preferencias.

3. From the Categories list, select Security (Enhanced).

4. En la sección Protecciones de Sandbox, borra la casilla Habilitar el modo protegido al inicio.

   

5. A confirmation is requested. Click Yes to continue, then click OK.

6. Reinicia Adobe Reader. Ahora puede utilizarse UIExplorer para identificar elementos individuales de la interfaz de usuario en la página.