Take Screenshot

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Description

Faz uma captura de tela de um elemento de interface gráfica selecionado ou aplicativo e salva como arquivo de imagem.

Esta atividade pode ser usada dentro e fora de uma atividade Use Application/Browser .

Se adicionado dentro de uma atividade Use Application/Browser , apenas o aplicativo de destino é capturado. Se adicionado fora de um cartão de aplicativo, já que não há nenhum destino especificado, toda a área de trabalho será capturada.

Esta atividade é compatível com o Repositório de Objetos.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• Trabalho no escopo - Escolha a guia do navegador que renderiza o aplicativo da Web para automatizar.

• Indicar destino na tela

  • Indica o elemento de interface gráfica a ser usado como destino. Depois de indicar o destino, selecione o botão de adição para acessar as seguintes opções:
  • Indicate target on screen - Indicate the target again.
  • Editar destino - Abra o modo de seleção para configurar o destino.

• Contêiner de captura de tela – Selecione entre Página inteira e Elemento para fazer uma captura de tela de toda a página ou de um único elemento. A opção padrão é Página inteira.

• Saída para (para Windows) - Use os botões de opção para escolher o tipo de saída:

  • Arquivo - Salva a captura de tela em arquivo em um local especificado. A opção padrão.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.

• Nome do arquivo - O nome do arquivo em que a captura de tela do elemento de interface gráfica especificado é salva.

• Incremento automático - Define o que anexar ao nome do arquivo em caso de conflitos de nomes de arquivos. Escolha uma opção no menu suspenso:

  • Nenhum (substituir) — o nome do arquivo será exatamente como especificado e, caso já exista outro arquivo com o mesmo nome, ele será substituído. Esse é o valor padrão.
  • Índice – Se um ou vários arquivos que correspondem ao padrão Filename (XX) já existirem, um novo arquivo será criado com o nome Filename (N+1), onde N é o índice máximo dos arquivos existentes.
  • AAAA.MM.DD às HH.MM.SS — se já existir um arquivo com o nome especificado, um novo arquivo será criado com o nome Filename YYYY.MM.DD at HH.MM.SS. Se um arquivo com o nome de arquivo Filename YYYY.MM.DD at HH.MM.SS já existir e o índice for adicionado, semelhante ao caso de Índice, resultando em um arquivo chamado Filename YYYY.MM.DD at HH.MM.SS (1).

Painel de Propriedades

Entrada/Saída

• Arquivo de captura de tela - A captura de tela salva como um arquivo .png .
• Elemento de entrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto ElementoDaUI . Esse campo é compatível apenas com objetos ElementoDaUI . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.
• Elemento de saída - Gera um elemento de interface gráfica de destino e o armazena em um objeto ElementoDaUI , que pode ser usado ainda mais para direcionar o mesmo elemento com outras atividades.

Opções

• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.

  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo aceita apenas valores Boolean (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Horários

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

Windows - Configuração legada

• Selecione Indicar no aplicativo/navegador para indicar o elemento de interface gráfica a ser usado como destino.

Depois de indicar o destino, selecione o Menu botão para acessar as seguintes opções:

• Indicate target on screen - Indicate the target again.
• Editar destino - Abra o modo de seleção para configurar o destino.
• Remover captura de tela informativa – Remove a captura de tela do aplicativo de destino ou página da Web.
• Adicionar ao Repositório de Objetos - Adicione o elemento de interface gráfica atual a um projeto de biblioteca, de onde ele pode ser reutilizado em todo seu processo de automação.

• Saída em — use os botões de opção para escolher o tipo de saída:
  • Arquivo - Salva a captura de tela em arquivo em um local especificado. A opção padrão.
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.
• Nome do arquivo - O nome do arquivo em que a captura de tela do elemento de interface gráfica especificado é salva. Clique em Procurar arquivo, navegue até a pasta onde salvar a captura de tela e especifique o nome e a extensão do arquivo a serem usados.
• Auto increment - Select what to append to the filename when saving the screenshot in case of filename conflicts. For example, if a file with the same name as the one you save already exists, choosing Index keeps the file name, creating a new file for each screenshot and adding an index number to each, consecutively.
  • None (overwrite) - If a file with the same name already exists, replace it.
  • Index - Add a number to the filename, for example screenshot (1).png.
  • YYYY.MM.DD at HH.MM.SS - Add the date and time when the screenshot is taken to the filename, for example screenshot 2020.06.22 at 10:22:32.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo aceita apenas valores Boolean (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Nome de exibição — o nome exibido da atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

• Incremento automático — consulte Incremento automático no painel Designer.

• Nome do arquivo — consulte Nome do arquivo no painel do Designer.

• Destino — o elemento de destino. Defina o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Depois que o destino for indicado, todas as propriedades relacionadas ao elemento que foi indicado são exibidas.

  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Indica o texto identificado usando o Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
  • Sites responsivos - Habilitar o layout de sites responsivos.
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
  • Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
    • Nenhum
    • Seletor restrito
    • Seletor difuso
    • Imagem
    • Texto nativo
    • Computer Vision - Para usar o Computer Vision como um método de segmentação, você precisa acessar Configurações do projeto > Computer Vision e certificar-se de definir o ponto de extremidade do servidor correto. Você pode deixar esse campo como está e usar o UiPath Cloud, que é preenchido por padrão, ou você pode inserir outro valor selecionando qualquer um dos outros pontos de extremidade públicos específicos de uma região do servidor ou seu próprio servidor no local. Outra maneira de usar o Computer Vision como um método de segmentação é definir Usar Servidor Local como True. Isso indica que o pacote UiPath.ComputerVision.LocalServer está instalado em seu projeto. Quando o Servidor local é habilitado, o valor do servidor é substituído. No entanto, o Servidor local não está disponível em projetos multiplataforma.
    • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Verificação de visibilidade - Verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando elementos invisíveis que existem no DOM, mas que estão ocultos.
    • Totalmente visível
      • Verifica se o elemento de interface gráfica está visível ou não.
  • Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no menu suspenso:
    • Nenhum - Não aguarda que o destino esteja pronto.
    • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
    • Completo - Aguarda até que todo o aplicativo seja carregado.
  • Seletor de janela (Instância do aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.

• Elemento de saída - Gera um elemento de interface gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse campo é compatível apenas com valores Boolean (True, False). O valor padrão é False.

• Saved file path - The full path to the file where to save the screenshot, including the appended suffix, if applicable. This also dictates where the Auto increment property saves the indexed screenshot files.

• Imagem salva - A captura de tela salva como Imagem; usado quando a Saída é definida como image.