Accións de automatización da IU

Importante

Para evitar accesos non autorizados, Power Automate debe executarse cos mesmos privilexios ou superiores que as aplicacións que automatiza. Para utilizar as accións de automatización da IU (excepto a acción Usar escritorio ) para interactuar con aplicacións que se executan con privilexios elevados, executa Power Automate como administrador. Para obter máis información sobre a execución Power Automate como administrador, vai a Executar Power Automate con dereitos elevados.

Power Automate ofrece varias accións de automatización da interface de usuario para permitir aos usuarios interactuar con Windows e aplicacións de escritorio. Algunhas accións de automatización da IU requiren que configures elementos da IU nas súas propiedades para indicar o elemento que queres manexar.

Para engadir un novo elemento da IU, selecciona Engadir elemento da IU a través da acción de automatización da IU implementada ou no panel de elementos da IU do deseñador de fluxos.

Todos os elementos da IU consisten en selectores que indican a estrutura xerárquica dos compoñentes. Os selectores usan a notación > para indicar que cada elemento está contido no elemento da súa esquerda.

Cando creas un elemento da IU dunha xanela de aplicación, o seu selector sempre ten un elemento raíz chamado :desktop.

Se creas un elemento da IU que sinala un compoñente dentro da xanela dunha aplicación, crearanse dous elementos da IU automaticamente. O elemento da IU pai sinala a xanela da aplicación, mentres que o fillo mostra a estrutura xerárquica do compoñente específico dentro da xanela.

Aínda que os selectores créanse automaticamente cando se engaden elementos da IU, algúns escenarios particulares precisan de selectores creados manualmente. Cando se necesita un selector personalizado, pode editar un selector existente ou crear un desde cero.

Para desenvolver fluxos máis dinámicos, substitúe os operadores Iguais a por outros operadores ou expresións regulares. Ademais, se o valor do atributo dun selector depende dos resultados de accións anteriores, use variables en lugar de valores codificados.

Para moitas accións de automatización da IU existen dous modos de execución: físico e simulado. No modo físico, a ferramenta toma o control do rato e do teclado da máquina para realizar a acción fisicamente. No modo simulado, a acción realízase mediante programación sen tomar o control do rato e do teclado e sen esixir que a pantalla do elemento da IU se poña en primeiro plano. É importante ter en conta que a opción simulada pode non ser aplicable a todos os elementos da IU. Para realizar unha acción mediante simulación, active o parámetro Simular acción nalgunhas accións ou desactive o Levar ao frente parámetro noutras accións.

Nota

Para obter máis información sobre o desenvolvemento de fluxos de automatización da IU e a creación de selectores personalizados, vai a Automatizar fluxos de escritorio e Construír un selector personalizado, respectivamente.

Obter detalles da ventá

Obtén unha propiedade dunha ventá, por exemplo, o seu título ou o texto de orixe.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Ventá	No	elemento da interface de usuario		A ventá da que obter detalles
Propiedade da ventá	N/D	Obter o título da xanela, Obter o texto da xanela, Obter a localización e o tamaño da xanela, Obter o nome do proceso	Obter o título da ventá	Escolle que propiedade da ventá se vai extraer
Traer á fronte	N/D	Valor booleano	Verdadeiro	Especifique se a xanela que contén o elemento da IU se mostrará ao frente durante a execución. Se esta opción está desactivada, a acción execútase en segundo plano. Teña en conta que non todos os elementos da IU son compatibles con ter a opción desactivada. Ademais, se a execución da acción require desprazamento, a desactivación desta opción pode non extraer todos os elementos.

Variables producidas

Argumento	Tipo	Descripción
WindowProperty	Valor xeral	A información recuperada da ventá

Excepcións

Excepción	Descripción
Fallo ao recuperar a propiedade da ventá	Indica un problema ao recuperar a propiedade da ventá

Obter detalles dun elemento da interface de usuario na ventá

Obtén o valor do atributo dun elemento da interface de usuario nunha ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		O elemento da interface de usuario da que obter detalles
Nome do atributo	Si	Valor do texto	Texto propio	O atributo cuxo valor se vai recuperar
Traer á fronte	N/D	Valor booleano	Verdadeiro	Especifique se a xanela que contén o elemento da IU se mostrará ao frente durante a execución. Se esta opción está desactivada, a acción execútase en segundo plano. Teña en conta que non todos os elementos da IU son compatibles con ter a opción desactivada. Ademais, se a execución da acción require desprazamento, a desactivación desta opción pode non extraer todos os elementos.

Variables producidas

Argumento	Tipo	Descripción
AtributoValor	Valor do texto	Valor do texto do elemento da interface de usuario

Excepcións

Excepción	Descripción
Fallo ao recuperar o atributo do elemento da interface de usuario	Indica un problema ao recuperar o atributo do elemento da interface de usuario

Obter as caixas de verificación seleccionadas nunha ventá

Recupera os nomes das caixas de verificación seleccionadas nun grupo de caixas de verificación, ou o estado dunha caixa de verificación específica.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		A caixa de verificación ou grupo de caixas de verificación
Operación	N/D	Obter os nomes das caixas de verificación seleccionadas no grupo, Obter o estado da caixa de verificación	Obter nomes das caixas de verificación seleccionadas no grupo	Especifica se recuperar o estado de varias caixas de verificación seleccionadas ou só o dunha
Traer á fronte	N/D	Valor booleano	Verdadeiro	Especifique se a xanela que contén o elemento da IU debe mostrarse á fronte durante a execución. Se esta opción está desactivada, a acción executarase en segundo plano. Teña en conta que non todos os elementos da IU poden ser compatibles con ter a opción desactivada. Ademais, se a execución da acción require desprazamento, a desactivación desta opción pode non extraer todos os elementos.

Variables producidas

Argumento	Tipo	Descripción
Está comprobado	Valor booleano	O estado da caixa de verificación seleccionada
Casillas de verificación seleccionadas	Lista de Valores de texto	Os nomes das caixas de verificación seleccionadas dentro do grupo de caixas de verificación especificado

Excepcións

Excepción	Descripción
Fallo ao recuperar os estados da caixa de verificación	Indica un problema ao recuperar os estados da caixa de verificación especificados

Obter o botón de opción seleccionado nunha ventá

Recupera os nomes do botón de opción seleccionado nun grupo de botóns de opcións, ou o estado dun botón de opción específico.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		O botón de opción ou grupo de botóns de opción
Operación	N/D	Obter o nome do botón de opción seleccionado no grupo, Obter o estado do botón de opción	Obter o nome do botón de opción seleccionado no grupo	Especifica se recuperar o nome do botón de opción seleccionado dentro dun grupo de botóns de opción ou o estado dun só botón de opción
Traer á fronte	N/D	Valor booleano	Verdadeiro	Especifique se a xanela que contén o elemento da IU se mostrará ao frente durante a execución. Se esta opción está desactivada, a acción execútase en segundo plano. Teña en conta que non todos os elementos da IU son compatibles con ter a opción desactivada. Ademais, se a execución da acción require desprazamento, a desactivación desta opción pode non extraer todos os elementos.

Variables producidas

Argumento	Tipo	Descripción
Está seleccionado	Valor booleano	O estado do botón de opción seleccionado
Botón de radio seleccionado	Valor do texto	O botón de opción seleccionado dentro do grupo de radio especificado

Excepcións

Excepción	Descripción
Fallo ao recuperar o estado do botón de opción	Indica un problema ao recuperar o estado do botón de opción especificado

Extraer datos da ventá

Extrae datos de partes específicas dunha ventá en forma de valores individuais, listas, filas ou tabuladores.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Ventá	No	elemento da interface de usuario		A ventá da que se extraen os datos
Almacenar os datos extraídos en	N/D	Unha folla de cálculo de Excel, unha variable	unha folla de cálculo de Excel	Especificar onde almacenar os datos extraídos
Traer á fronte	N/D	Valor booleano	Verdadeiro	Especifique se a xanela que contén o elemento da IU se mostrará ao frente durante a execución. Se esta opción está desactivada, a acción execútase en segundo plano. Teña en conta que non todos os elementos da IU son compatibles con ter a opción desactivada. Ademais, se a execución da acción require desprazamento, a desactivación desta opción pode non extraer todos os elementos.

Variables producidas

Argumento	Tipo	Descripción
ExcelInstance	instancia de Excel	A instancia de Excel cos datos extraídos. Use esta instancia para manipular a folla de cálculo (ou gardala e pechala) mediante as accións de Excel dedicadas.
DataFromWindow	Valor xeral	Os datos extraídos en forma de táboa de datos

Excepcións

Excepción	Descripción
Fallo de extracción	Indica un problema ao extraer datos da ventá especificada

Facer captura de pantalla dun elemento da interface de usuario

Fai unha captura de pantalla dun elemento da IU na xanela.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		Elemento da interface de usuario na ventá que se vai capturar na captura de pantalla
Modo de almacenamento	N/D	Portapapeis, Arquivo	Portapapeis	Especificar se se debe gardar a imaxe nun ficheiro ou almacenala no portapapeis
Camiño do ficheiro de imaxe	No	Arquivo		Configurar o camiño completo do ficheiro que se vai gardar
Formato de ficheiro	N/D	BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF	BMP	Formato do ficheiro de imaxe

Variables producidas

Argumento	Tipo	Descripción
Arquivo de imaxe	Arquivo	Camiño do ficheiro de imaxe da captura de pantalla xerado

Excepcións

Excepción	Descripción
Erro ao recuperar o elemento da interface de usuario	Indica un problema ao recuperar o elemento da IU
Erro ao gardar a imaxe	Indica un problema ao gardar a captura de pantalla tomada
Erro ao facer unha captura de pantalla do elemento da interface de usuario	Indica un problema ao facer unha captura de pantalla do elemento da IU

Centrar campo de texto na ventá

Establece o foco nunha caixa de texto dunha ventá e desprázao á vista.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Campo de texto	No	elemento da interface de usuario		O cadro de texto que se vai enfocar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao configurar o foco de entrada na caixa de texto da ventá	Indica un problema ao configurar o foco no campo de texto da páxina web especificado

Encher campo de texto na ventá

Enche unha caixa de texto nunha ventá co texto especificado.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Caixa de texto	No	elemento da interface de usuario		O cadro de texto que se vai encher
Texto para cubrir	No	Entrada cifrada directa ou Valor de texto		O texto que se vai encher no campo de texto
Simular acción	N/D	Valor booleano	Falso	Simula as pulsacións de tecla mediante programación cando enche texto aos elementos do campo de texto da IU. Esta opción non require que a pantalla do elemento da IU estea enfocada, non o levará automaticamente ao primeiro plano. Teña en conta que esta opción só se pode aplicar á acción do clic co botón esquerdo e é posible que non se aplique a todos os elementos da IU.
Se o campo non está baleiro	Si	Substituír texto, engadir texto	Substituír texto	Especifique se quere substituír o contido existente ou anexalo.
Premer antes de encher	Si	Fai clic co botón esquerdo, fai dobre clic, Non	Fai clic co botón esquerdo	Especifique se se debe premer o botón esquerdo do rato antes de encher o campo de texto ou non.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao escribir na caixa de texto	Indica un problema ao encher o campo de texto especificado

Premer botón na ventá

Preme un botón da ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		O botón que se vai premer

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao premer o botón	Indica un problema ao premer no botón especificado

Seleccionar botón de opción na ventá

Selecciona un botón de opción nunha ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Botón de opción	No	elemento da interface de usuario		O botón de opción que se vai seleccionar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao seleccionar o botón de elemento da interface de usuario	Indica un problema ao seleccionar o elemento da interface de usuario do botón de opción especificado

Definir estado da caixa de verificación na ventá

Marca ou desmarca unha caixa de verificación nun formulario de ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Caixa de verificación	No	elemento da interface de usuario		A caixa de verificación da que se vai definir o estado
Configurar o estado da caixa de verificación en	N/D	Marcado, Desmarcado	Marcada	Especifique se a caixa de verificación estará marcada ou desmarcada

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Erro ao configurar o estado da caixa de verificación	Indica un problema ao configurar o estado da caixa de verificación especificada

Definir valor da lista despregable na ventá

Establece ou borra as opcións seleccionadas para unha lista despregábel nun formulario de xanela.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Lista despregable	No	elemento da interface de usuario		A lista despregable cuxo valor se vai establecer
Operación	N/D	Borrar as opcións seleccionadas, Seleccionar opcións polo nome, Seleccionar opcións por índice	Borrar as opcións seleccionadas	Especifica se queres seleccionar un valor por nome ou por posición ordinal (1 2 3 ...) ou limpar o valor seleccionado da lista despregable
Nomes das opcións	No	Lista de Valores de texto		Introduza unha opción ou unha lista de opcións para seleccionar na lista despregable. As opcións múltiples só teñen sentido cando se traballa con listas de selección múltiple. Se a lista é de selección única, só se utilizará a primeira opción da lista especificada.
Usar expresións regulares	N/D	Valor booleano	Falso	Especifique se a os valores dos nomes das opcións se deben interpretar como unha expresión regular
Índices de opcións	No	Lista de Valores numéricos		Introduza un índice ou unha lista de índices para seleccionar na lista despregable. As opcións múltiples só teñen sentido cando se traballa con listas de selección múltiple. Se a lista é de selección única, só se utilizará a primeira opción da lista especificada.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Produciuse un erro ao seleccionar as opcións especificadas na lista despregable	Indica un problema ao seleccionar as opcións especificadas na lista despregable

Obter ventá

Obtén unha ventá en execución para automatizar aplicacións de escritorio.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Obter ventá	N/D	Ventá específica, xanela en primeiro plano	Ventá específica	Especificar se a busca se fai usando un selector ou a ventá de primeiro plano
Elemento da interface de usuario	No	elemento da interface de usuario		O selector da ventá que se vai obter
Trae a ventá ao fronte	N/D	Valor booleano	Falso	Especificar se traerá a ventá ao primeiro plano automaticamente ao adquirila
Fallar se non se atopa a ventá	N/D	Valor booleano	Verdadeiro	Especificar se debe esperar indefinidamente para que apareza a ventá ou se falla se a ventá non aparece nun período de tempo establecido
Tempo de espera	No	Valor numérico		O tempo de espera en segundos

Variables producidas

Argumento	Tipo	Descripción
Título da fiestra	Valor do texto	O título da ventá de primeiro plano
Ventá de automatización	Instancia de fiestra	A instancia de ventá específica para usar con accións posteriores de automatización da interface de usuario

Excepcións

Excepción	Descripción
Fallo ao obter a ventá	Indica un problema ao obter a ventá

Enfocar ventá

Activa e trae ao primeiro plano unha ventá específica.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai enfocar
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela a usar.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
Non se pode enfocar a ventá	Indica un problema ao enfocar a ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Definir estado de ventá

Restaura, maximiza ou minimiza unha ventá específica.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá da que se vai definir o estado
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela a usar.
Estado da ventá	N/D	Restaurado, Maximizado, Minimizado	Restaurada	Escolle en que estado mostrar a ventá

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
Non se pode definir o estado de ventá	Indica un problema ao configurar o estado de ventá da ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Definir a visibilidade da ventá

Mostra unha ventá oculta ou oculta unha ventá visible.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá da que se vai definir a visibilidade
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela a usar.
Visibilidade	N/D	Visible, Oculto	Oculto	Escolle en que estado establecer a visibilidade da ventá

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
Non se pode definir a visibilidade da ventá	Indica un problema ao configurar a visibilidade da ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Mover ventá

Define a posición dunha ventá específica.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai mover
Clase de ventá	Si	Valor do texto		Se tes dúas fiestras co mesmo título, Window Class pode axudar a diferencialas. Neste caso, introduza a clase da xanela a usar.
Posición X	No	Valor numérico		A posición X da ventá
Posición Y	No	Valor numérico		A posición Y da ventá

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
A ventá non se pode mover	Indica un problema ao mover a ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Redimensionar ventá

Define o tamaño dunha ventá específica.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai redimensionar
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduce a clase da ventá a usar
Largura	No	Valor numérico		A nova largura, en píxeles
Altura	No	Valor numérico		A nova altura, en píxeles

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
Non se pode redimensionar a ventá	Indica un problema ao redimensionar a ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Pechar ventá

Pecha unha ventá específica.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Atopar o modo ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Ventá	No	Elemento UI		O elemento da interface de usuario da ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai pechar
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela a usar.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou a ventá	Indica que non se atopou a ventá especificada
Non se pode pechar a ventá	Indica un problema ao pechar a ventá especificada
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo

Se a ventá contén

Marca o inicio dun bloque condicional de accións dependendo de se existe unha peza específica de texto ou elemento UI nunha ventá.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Comprobar se a ventá	N/D	Contén elemento UI, Non contén elemento UI, Contén texto, Non contén texto	Contén un elemento da interface de usuario	Comprobar se existe un texto ou un elemento da interface de usuario nunha ventá
Comprobar o estado do elemento da interface de usuario	N/D	Valor booleano	Falso	Comprobar se un elemento da interface de usuario específico está activado ou desactivado
Mensaxe de texto	No	Valor do texto		O texto que hai que comprobar
Elemento da interface de usuario	No	Elemento UI		O elemento da interface de usuario que se vai comprobar
Ventá	No	Elemento UI		A ventá na que se vai comprobar se o texto está activado
Estado	N/D	Habilitación, minusválidos	Activada	O estado do elemento da interface de usuario que se vai comprobar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Esta acción non inclúe ningunha excepción.

Agardar polo contido da ventá

Suspende a execución da automatización até que apareza ou desapareza unha ventá específica de texto ou un elemento da interface de usuario.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Agardar até que a ventá	N/D	Contén elemento UI, Non contén elemento UI, Contén texto, Non contén texto	Contén un elemento da interface de usuario	Se cómpre agardar a que apareza un texto ou un elemento da interface de usuario específico nunha ventá
Comprobar o estado do elemento da interface de usuario	N/D	Valor booleano	Falso	Comprobar se un elemento da interface de usuario específico está activado ou desactivado
Mensaxe de texto	No	Valor do texto		O texto que hai que comprobar
Elemento da interface de usuario	No	Elemento UI		O elemento da interface de usuario que se vai comprobar
Ventá	No	Elemento UI		A ventá na que se vai comprobar se o texto está activado
Estado	N/D	Habilitación, minusválidos	Activada	O estado do elemento da interface de usuario que se vai comprobar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo na espera do contido da ventá	Indica que fallou a operación de espera

Se a imaxe

Esta acción marca o inicio dun bloque condicional de accións dependendo de se unha imaxe seleccionada se atopa na pantalla ou non.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Se a imaxe	N/D	Existe, non existe	existe	Se para comprobar a existencia ou ausencia da imaxe seleccionada
Image	No	Lista de imaxes		A imaxe ou imaxes que comprobará a dita acción, se has houbese
Buscar imaxe en	N/D	Pantalla completa, só fiestra en primeiro plano	Pantalla completa	Se buscar a imaxe especificada na ventá principal só ou toda a pantalla visible. Ningunha das dúas opcións atopará a imaxe se non se ve claramente na pantalla
Modo de busca	N/D	Busca na pantalla enteira ou na xanela en primeiro plano, busca na subrexión especificada da pantalla ou na xanela en primeiro plano	Busca a pantalla completa ou a ventá de primeiro plano	Indicar se se analiza toda a pantalla (ou ventá) para atopar o texto fornecido ou só unha subrexión reducida do mesmo
Busca todas as imaxes da lista	N/D	Valor booleano	Falso	Comprobe se existen ou non todas as imaxes da lista
X1	Si	Valor numérico		A coordenada X inicial da subrexión para buscar o texto fornecido
X2	Si	Valor numérico		A coordenada X final da subrexión para buscar o texto fornecido
Y1	Si	Valor numérico		A coordenada Y inicial da subrexión para buscar o texto fornecido
Y2	Si	Valor numérico		A coordenada Y final da subrexión para buscar o texto fornecido
Tolerancia	Si	Valor numérico	1,0	Especifica canto poden diferir a imaxe ou imaxes buscadas das imaxes escollidas orixinalmente
Algoritmo de busca de coincidencias de imaxes	N/D	Básico, avanzado	Básica	Que algoritmo de imaxe utilizar ao buscar imaxe

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non pode comprobar a imaxe en modo noninteractivo	Indica que non se pode identificar unha imaxe en modo non interactivo
Coordenadas de subrexión non válidas	Indica que as coordenadas da subrexión sinalada non eran válidas

Usar escritorio

Realiza operacións relacionadas co escritorio e a barra de tarefas.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Elemento da interface de usuario	No	Elemento UI		O elemento da interface de usuario no que premer cun clic
Tipo de clic	N/D	Preme á esquerda, preme co botón dereito, preme dúas veces	Preme á esquerda	O tipo de clic que se vai facer
Inicia unha nova aplicación ao facer clic co botón esquerdo na barra de tarefas	N/D	Valor booleano	Verdadeiro	Cando este parámetro está configurado para "verdadeiro", asegura que se creará unha nova xanela dunha aplicación ao facer clic á esquerda na súa icona na barra de "lanzamento rápido", tamén coñecida como barra de tarefas de Windows 7 ou superior. Desmarque esta opción para poñer en primeiro plano unha instancia xa en execución da aplicación.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo na operación da barra de tarefas	Indica que fallou a operación da barra de tarefas

Seleccionar separador na ventá

Selecciona un separador dun grupo de separadores.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Tabulador	No	Elemento UI		O separador que se vai seleccionar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Erro ao seleccionar o separador	Indica un problema ao seleccionar o separador especificado

Agardar pola imaxe

Esta acción agarda até que apareza unha imaxe específica na pantalla ou na ventá de primeiro plano.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Esperar a que a imaxe	N/D	Aparecer, desaparecer	Aparecer	Comprobar se cómpre agardar a que apareza ou desapareza a imaxe ou imaxes
Imaxe pola que agardar	No	Lista de imaxes		A imaxe ou imaxes que comprobará a dita acción, se has houbese
Buscar imaxe en	N/D	Pantalla completa, só fiestra en primeiro plano	Pantalla completa	Se buscar a imaxe especificada na ventá principal só ou toda a pantalla visible. Ningunha das dúas opcións atopará a imaxe se non se ve claramente na pantalla
Modo de busca	N/D	Busca na pantalla enteira ou na xanela en primeiro plano, busca na subrexión especificada da pantalla ou na xanela en primeiro plano	Busca a pantalla completa ou a ventá de primeiro plano	Indicar se se analiza toda a pantalla (ou ventá) para atopar o texto fornecido ou só unha subrexión reducida do mesmo
Agardar por todas as imaxes	N/D	Valor booleano	Falso	Se cómpre agardar a que aparezan (desaparezan) todas as imaxes da lista ou só unha delas
X1	Si	Valor numérico		A coordenada X inicial da subrexión para buscar o texto fornecido
X2	Si	Valor numérico		A coordenada X final da subrexión para buscar o texto fornecido
Y1	Si	Valor numérico		A coordenada Y inicial da subrexión para buscar o texto fornecido
Y2	Si	Valor numérico		A coordenada Y final da subrexión para buscar o texto fornecido
Tolerancia	Si	Valor numérico	1,0	Especifica canto poden diferir a imaxe ou imaxes buscadas das imaxes escollidas orixinalmente
Algoritmo de busca de coincidencias de imaxes	N/D	Básico, avanzado	Básica	Que algoritmo de imaxe utilizar ao buscar imaxe
Fallar cun erro do tempo de espera	N/D	Valor booleano	Falso	Especifique se quere que a acción agarde indefinidamente ou que se produza un erro tras un período de tempo establecido

Variables producidas

Argumento	Tipo	Descripción
X	Valor numérico	A coordenada X do punto onde se atopou o texto na pantalla. Se o texto foi buscado na ventá do primeiro plano, este valor é relativo á esquina superior esquerda da xanela.
Y	Valor numérico	A coordenada Y do punto onde se atopou o texto na pantalla. Se o texto foi buscado na ventá do primeiro plano, este valor é relativo á esquina superior esquerda da xanela.

Excepcións

Excepción	Descripción
Fallo na espera da imaxe	Indica que fallou a operación de espera
Non pode comprobar a imaxe en modo noninteractivo	Indica que non se pode identificar unha imaxe en modo non interactivo
Coordenadas de subrexión non válidas	Indica que as coordenadas da subrexión sinalada non eran válidas

Apuntar o rato sobre un elemento da interface de usuario na ventá

Hover o rato sobre calquera elemento de UI na ventá.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Elemento da interface de usuario	No	Elemento UI		Seleccionar o elemento da interface de usuario na ventá para apuntar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Erro ao apuntar sobre o elemento	Indica que o sobrevoo sobre o elemento fallou

Premer no elemento da interface de usuario da ventá

Clics en calquera elemento da interface de usuario dunha ventá.

Parámetros de entrada

Argumento	Opcional	Aceptacións	Valor predefinido	Descripción
Elemento da interface de usuario	No	Elemento UI		O elemento da interface de usuario no que facer clic
Tipo de clic	N/D	Botón esquerdo, Botón dereito, Dobre clic, Botón medio, Botón esquerdo para abaixo, Botón esquerdo para arriba, Botón dereito para abaixo, Botón dereito para arriba	Fai clic co botón esquerdo	O tipo de clic que se vai facer
Simular acción	N/D	Valor booleano	Falso	Especifique se se simula o movemento do cursor do rato sobre o elemento antes de facer clic. Esta opción non require que a pantalla do elemento da IU estea enfocada, non o levará automaticamente ao primeiro plano. Teña en conta que esta opción só se pode aplicar á acción do clic co botón esquerdo e é posible que non se aplique a todos os elementos da IU.
Posición do rato en relación ao elemento da interface de usuario	N/D	Arriba á esquerda, Arriba ao centro, Arriba á dereita, Medio esquerdo, Medio centro, Medio á dereita, Abaixo á esquerda, Abaixo ao centro, Abaixo á dereita	Centro medio	Especifica en que sección do elemento da interface de usuario se moverá o rato antes de facer clic
Desprazamento X	Si	Valor do texto	0	Despraza o rato desde a posición até esta cantidade de píxeles cara a dereita
Desprazamento Y	Si	Valor do texto	0	Despraza o rato desde a posición até esta cantidade de píxeles cara abaixo

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao facer clic	Indica que houbo un fallo no clic

Seleccionar unha opción de menú na ventá

Selecciona unha opción nun menú dunha ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		A opción de menú que se vai seleccionar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao seleccionar a opción	Indica un problema ao seleccionar a opción de menú especificada

Arrastrar e soltar un elemento da interface de usuario na ventá

Arrastra e solta un elemento da interface de usuario dunha ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
O elemento da interface de usuario que se vai arrastrar	No	elemento da interface de usuario		O elemento da interface de usuario que vai arrastrar
Elemento da interface de usuario que vai depositar	No	elemento da interface de usuario		Elemento da interface de usuario que vai depositar
Tipo de clic	N/D	Fai clic co botón esquerdo, fai clic co botón dereito	Fai clic co botón esquerdo	Especificar que botón do rato se vai usar para manter premido o rato para arrastrar o elemento da interface de usuario até o seu destino
Desprazamento X do rato cara abaixo	Si	Valor do texto	0	Desprazar o clic do rato cara abaixo para arrastrar o elemento da interface de usuario esta cantidade de píxeles cara a dereita
Desprazamento Y do rato cara abaixo	Si	Valor do texto	0	Desprazar o clic do rato cara abaixo para arrastrar o elemento da interface de usuario esta cantidade de píxeles cara abaixo
Posición do rato cara abaixo con respecto ao elemento da interface de usuario de destino que se vai arrastrar	N/D	Arriba á esquerda, Arriba ao centro, Arriba á dereita, Medio esquerdo, Medio centro, Medio á dereita, Abaixo á esquerda, Abaixo ao centro, Abaixo á dereita	Centro medio	Especificar en que sección do elemento da interface de usuario se soltará o rato antes de facer clic
Desprazamento X do rato cara arriba	Si	Valor do texto	0	Desprazar o clic do rato cara arriba para arrastrar o elemento da interface de usuario esta cantidade de píxeles cara a dereita
Desprazamento Y do rato cara arriba	Si	Valor do texto	0	Desprazar o clic do rato cara arriba para arrastrar o elemento da interface de usuario esta cantidade de píxeles cara abaixo
Posición do rato cara arriba con respecto ao elemento da interface de usuario de destino que se vai soltar	N/D	Arriba á esquerda, Arriba ao centro, Arriba á dereita, Medio esquerdo, Medio centro, Medio á dereita, Abaixo á esquerda, Abaixo ao centro, Abaixo á dereita	Centro medio	Especificar a sección do elemento da interface de usuario á que se vai arrastrar o rato despois de facer clic

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se atopou ningún elemento para arrastrar	Indica que non se atopou o elemento da interface de usuario que se arrastrou
Non se atopou ningún elemento de destino de colocación	Indica que non se atopou o elemento da interface de usuario de destino de colocación
Fallo ao arrastrar e soltar	Indica un problema ao arrastrar e soltar o elemento da IU especificado

Expandir/contraer o nó da árbore na ventá

Expande ou contrae un nó dunha vista de árbore nunha ventá.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Elemento da interface de usuario	No	elemento da interface de usuario		O nó de árbore que se vai expandir/contraer
Camiño dos cartafoles	Si	Valor do texto		Un camiño separado por barra inclinada composto por nomes de cartafoles que fan que o nó da árbore se expanda ou contraia
Usar expresións regulares	N/D	Valor booleano	Falso	Especifica se cómpre interpretar o nome de cada cartafol que hai no camiño como unha expresión regular
Operación	N/D	Expandir, contraer	Expandir	Especifica se expandir ou contraer o nó da árbore

Nota

Power AutomateO motor de expresións regulares é .NET. Para atopar máis información sobre expresións regulares, vai a Linguaxe de expresións regulares - Referencia rápida.

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Fallo ao establecer o nó de árbore no estado especificado	Indica un problema ao establecer o nó de árbore no estado especificado

Se a ventá

Esta acción marca o inicio dun bloque condicional de accións dependendo de se unha xanela está aberta ou non ou se unha xanela é a xanela enfocada (en primeiro plano).

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Obter ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai comprobar
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela que se vai utilizar.
Comprobar se a ventá	N/D	Está aberto, Non está aberto, Está enfocado, Non está enfocado	Está aberto	O estado da ventá a comprobar

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Esta acción non inclúe ningunha excepción.

Agardar pola ventá

Suspende a execución ou o proceso até que se abra ou se peche unha ventá específica ou até que se obteña ou se perda o foco nela.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Atopar a ventá	N/D	Por elemento da IU da xanela, Por instancia/control da xanela, Por título e/ou clase	Por elemento da interface de usuario da ventá	Especificar se buscará a ventá usando un elemento da interface de usuario ou unha combinación de título/clase de ventá
Título da ventá	Si	Valor do texto		O título da xanela. Pódense usar comodíns, como '?' ou '*'.
Ventá	No	elemento da interface de usuario		O elemento da interface de usuario da ventá
Instancia da ventá	No	Valor numérico		A instancia ou identificador da ventá que se vai comprobar
Clase de ventá	Si	Valor do texto		Se hai dúas fiestras co mesmo título, a clase de fiestras pode axudar a diferencialas. Neste caso, introduza a clase da xanela que se vai utilizar
Esperar a que a ventá	N/D	Abrir, pechar, concentrarse, perder o foco	Aberto	Se cómpre agardar a que se abra unha ventá específica, a que se peche, a que se enfoque (é dicir, convértase na ventá de primeiro plano) ou a que se desenfoque (é dicir, deixe de ser a ventá de primeiro plano).
Enfocar a ventá despois de que se abra	N/D	Valor booleano	Falso	Traer a ventá á fronte despois de que se abra, para que as accións posteriores se dirixan a esta ventá

Variables producidas

Esta acción non produce ningunha variable.

Excepcións

Excepción	Descripción
Non se pode enfocar a ventá	Indica un problema ao enfocar a ventá especificada
Fallo na espera da ventá	Indica que fallou a operación de espera
Non se pode realizar accións relacionadas coa fiestra no modo non interactivo	Indica un problema ao realizar accións relacionadas coa ventá en modo non interactivo