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, quando a atividade Take Screenshot é colocada dentro dos cartões Use Application/Browser aninhados.

• 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.

• Indicar destino na tela — indique o elemento de interface gráfica a ser usado como destino. Este botão só fica disponível quando a opção Elemento é selecionada como o contêiner Captura de tela. Depois de indicar o destino, clique no menu de hambúrguer ao lado da captura de tela informativa para acessar as seguintes opções:

  • Indicar destino — indique o destino novamente. Se o Descritor estiver definido no Repositório de Objetos, você deverá desvinculá-lo do Repositório de Objetos, se quiser especificar um Descritor apenas para a atividade atual.
  • 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.
  • Alterar captura de tela – Altera 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. Esta opção só é exibida quando o objeto ainda não tiver sido adicionado ao Repositório de Objetos.
  • Mostrar no Repositório de Objetos - Abre o painel Repositório de Objetos com o Descritor selecionado. Essa opção só é exibida quando o objeto tiver sido adicionado ao Repositório de Objetos.
  • Desvincular do Repositório de Objetos - Desvincular o Descritor do Repositório de Objetos. Essa opção só é exibida quando o objeto tiver sido adicionado ao Repositório de Objetos.

• Saída em (disponível apenas para projetos do 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

Destino Esta seção só fica disponível quando a opção Elemento é selecionada como o contêiner Captura de tela.

• Botão Expandir propriedades de destino/Recolher propriedades de destino - Exibe/oculta o contêiner de destino e suas propriedades de âncora.
• 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 do menu suspenso e pelo menos um método de segmentação deve ser selecionado:
  • Seletor restrito
  • Seletor difuso
  • Imagem (disponível apenas para projetos do Windows)
  • Texto nativo (não disponível apenas para projetos do Windows)
  • Computer Vision
  • Seletor semântico
• 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.
• Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica. Exibido apenas se o método de segmentação Restrito Selecto tiver sido selecionado.
• Seletor difuso - Os parâmetros para o seletor difuso. Só é exibido se o método de segmentação Seletor difuso tiver sido selecionado.
• Precisão da imagem - Indica o nível de precisão para correspondência de imagens. O valor padrão é 0,8. Ela só é exibida se o método de segmentação por Imagem tiver sido selecionado.
• Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas. Ela só é exibida se o método de segmentação por Imagem tiver sido selecionado.
• Texto nativo - O texto que é usado para identificar o elemento de interface gráfica. Só será exibido se o método de segmentação Nativo tiver sido selecionado.
• Ocorrência de texto nativo - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas. Só será exibido se o método de segmentação Nativo tiver sido selecionado.
• Texto nativo com diferenciação de maiúsculas e minúsculas - Indica que a correspondência de texto do clima diferencia maiúsculas de minúsculas. Só será exibido se o método de segmentação Nativo tiver sido selecionado.
• Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision. Exibido apenas se o método de segmentação de Visão Computacional tiver sido selecionado.
• CV Text - Indica o texto identificado usando o Computer Vision. Exibido apenas se o método de segmentação de Visão Computacional tiver sido selecionado.
• Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR. O valor padrão é 0,7. Exibido apenas se o método de segmentação de Visão Computacional tiver sido selecionado.
• Ocorrência de CV Text - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas. Exibido apenas se o método de segmentação de Visão Computacional tiver sido selecionado.
• Seletor semântico – Uma descrição semântica que define o destino. Só é exibido se o método de segmentação semântica tiver sido selecionado.
• 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.
• 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.
• Sites responsivos - Habilitar o layout de sites responsivos.
• Destino - Região de Recorte - Especifica uma região de recorte, que pode ser configurada ainda mais. Pode ser usado para estabelecer uma região menor/maior do elemento de interface gráfica encontrado no runtime usando o Seletor de Destino ou fornecido diretamente por meio da propriedade Elemento de Entrada de Destino.
  • Ponto de ancoragem - Descreve o ponto inicial do cursor ao qual ele se desloca das propriedades Deslocamento X e Deslocamento Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro (selecionado por padrão).
  • Deslocamento X - Deslocamento horizontal da região de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
  • Deslocamento Y - Deslocamento vertical da região de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
  • Largura do deslocamento - Largura da região do deslocamento.
  • Altura do deslocamento - Altura da região de deslocamento.

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.

  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • 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.

• 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.

Entrada/Saída

• Arquivo de captura de tela - A captura de tela salva como um arquivo .png .
• 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.
• 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.

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.

• 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.