Extraer datos estructurados

UiPath.Core.Activities.ExtractData

Extrae datos de una página web indicada. Puede especificar la información a extraer proporcionando una cadena XML en el campo ExtraerMetadatos, en el panel de Propiedades. Esto se puede generar fácilmente con todas las propiedades establecidas mediante el asistente de instalación de Extracción de datos.

Propiedades

Entrada

• ExtractMetadata : una cadena XML que te permite definir qué datos extraer de la página web indicada.
• Target.Selector : propiedad de texto utilizada para encontrar un elemento de IU concreto cuando se ejecuta la actividad. En realidad, es un fragmento XML que especifica atributos del elemento GUI que está buscando y de algunos de sus elementos principales.
• Target.TimeoutMS : especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 000 milisegundos (30 segundos).

• Destino.EsperaListo : antes de realizar las acciones, espera a que el destino esté listo. Están disponibles las siguientes opciones:

  • Ninguno: no espera a que exista nada, excepto el elemento de interfaz de usuario de destino, antes de ejecutar la acción. Por ejemplo, puedes utilizar esta opción si quieres recuperar solo el texto de una página web o hacer clic en un botón concreto, sin tener que esperar a que se carguen todos los elementos de la interfaz de usuario. Ten en cuenta que esto puede tener consecuencias no deseadas si el botón depende de elementos que aún no están cargados, como los scripts.

  • Interactivo / Completo : espera que existan todos los elementos de IU de la aplicación de destino antes de ejecutar la acción.

    Para evaluar si una aplicación está en estado Interactivo o Completo, se verifican las siguientes etiquetas:

  • Aplicaciones de escritorio: se envía un mensaje wm_null para comprobar la existencia de las etiquetas <wnd>, <ctrl>, <java> o <uia>.Si existen, se ejecuta la actividad.
  • Aplicaciones web:
  1. Internet Explorer: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML es Completo. Además, el Ocupado tiene que estar en "Falso".
  2. Otros: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML está Completo.
  • Aplicaciones SAP: primero se verifica la presencia de la etiqueta <wnd>, después se utiliza una API específica de SAP para detectar si la sesión está ocupada o no.
• ElementoDeDestino : usa la variable ElementoDeIU devuelta por otra actividad. Esta propiedad no se puede utilizar junto con la propiedad Selector. Este campo solo admite variables de Elemento de IU.
• Destino.Región de recorte: define el rectángulo de recorte, en píxeles, en relación con el Elemento de IU, en las siguientes direcciones: izquierda, arriba, derecha y abajo. Admite números positivos y negativos.

Opciones

• RetardoEntreMSDePáginas: la cantidad de tiempo, en milisegundos, que hay que esperar hasta que se cargue la siguiente página. (Si el tiempo de carga de la página es mayor, este valor debería ser más alto).
• NúmeroMáximoDeResultados: número máximo de resultados que se van a extraer. Si el valor es 0, todos los elementos identificados se añaden a la salida. El valor predeterminado es 100.
• SelectorDeEnlaceSiguiente: el selector que identifica el enlace/botón utilizado para navegar a la siguiente página. Debe ser relativo a la propiedad ElementoDeIUExistente.
• EnviarMensajesDeWindows: si se selecciona, en el caso de que los datos que se desean extraer abarquen varias páginas, el clic que cambia de página se ejecuta enviando un mensaje específico a la aplicación de destino. Este método de entrada puede funcionar en segundo plano, es compatible con la mayoría de las aplicaciones de escritorio, pero no es el más rápido de los métodos. De forma predeterminada, esta casilla de verificación no está seleccionada. Si no se seleccionan ni esta casilla ni la de SimularClic, el método por defecto simula el clic utilizando el controlador de hardware. El método predeterminado es el más lento, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
• SimularClic: si se selecciona, en el caso de que los datos que se desean extraer abarquen varias páginas, simula el clic que cambia de página utilizando la tecnología de la aplicación de destino. Este método de entrada es el más rápido de los tres y funciona en segundo plano. De forma predeterminada, esta casilla de verificación no está seleccionada. Si no se selecciona esta casilla de verificación ni los cuadros de EnviarMensajesDeWindows, el método por defecto realiza el clic utilizando el controlador de hardware. El método predeterminado es el más lento, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.

Salida

• DataTable : la información extraída de la página web indicada. Este campo solo admite variables de DataTable.

Común

• NombreParaMostrar: el nombre de la actividad para ser mostrado.

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

  Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.