Take Screenshot

UiPath.UIAutomationNext.Activities.NTakeScreenshot

Description

Obtém uma captura de tela de um elemento de interface gráfica, aplicativo ou área de trabalho inteira especificado e as salva como um 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 e não houver um destino especificado, toda a área de trabalho será capturada.

Observação:

A partir do UIAutomation v25.10.32, uma opção de Área de trabalho dedicada foi adicionada ao menu suspenso do contêiner Captura de tela , permitindo a captura de tela cheia mesmo quando a atividade é usada dentro de um Cartão de Aplicativo.

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 - Selecione a guia do navegador ou a janela do aplicativo que hospeda o aplicativo a ser automatizado, quando a atividade é colocada dentro de atividades Use Application/Browser aninhadas.

• Contêiner de captura de tela - Especifica o escopo da interface gráfica para a captura de tela. Selecione uma das seguintes opções:

  • Janela principal - Captura uma captura de tela da janela principal ativa do aplicativo anexado.
  • Elemento - Captura uma tela do elemento indicado.
  • Área de trabalho - Captura uma captura de tela de toda a área de trabalho.

  O valor padrão é Janela principal.

• 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, primeiro você deve 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 - Adiciona o elemento de interface gráfica atual ao Repositório de Objetos, de onde ele pode ser reutilizado em todo o 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. Essa propriedade só está disponível quando a opção Arquivo é selecionada como a Saída para.

• Incremento automático - define o que anexar ao nome do arquivo em caso de conflitos de nome de arquivo. Essa propriedade só está disponível quando a opção Arquivo é selecionada como a Saída para. 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 está selecionada como o contêiner da 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. Esta propriedade pode ser definida como qualquer combinação 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 (disponível apenas para projetos do Windows)

  • Computer Vision

  • Seletor semântico

    Observação:

    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 Use Local Server 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 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. Ele só é exibido se o método de segmentação do seletor Restrito tiver sido selecionado.

• Seletor difuso - Os parâmetros para o seletor difuso. Só é exibido se o método de segmentação de Seletor Difuso tiver sido selecionado.

• Imagem - Essas propriedades estão disponíveis apenas quando o método de segmentação Imagem é selecionado.

  • Precisão da imagem – Especifica o limite de confiança usado para correspondência de imagens. O valor padrão é 0,8.
  • Ocorrência de imagem - Especifica qual correspondência deve ser usada quando várias imagens correspondentes são encontradas.

• Nativo - Essas propriedades estão disponíveis apenas quando o método de segmentação Nativo é selecionado.

  • Texto nativo - Especifica o texto usado para identificar o elemento de interface gráfica.
  • Ocorrência de texto nativo - Especifica qual ocorrência usar quando várias correspondências são encontradas.
  • Texto nativo com diferenciação de maiúsculas e minúsculas — especifica se a correspondência de texto diferencia maiúsculas de minúsculas.

• Computer Vision - Essas propriedades estão disponíveis apenas quando o método de segmentação de Computer Vision é selecionado.

  • Tipo de controle de CV - Especifica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Especifica o texto identificado usando o Computer Vision.
  • Precisão do texto CV - Especifica o limite de confiança usado para correspondência de texto OCR. O valor padrão é 0,7.
  • Ocorrência de CV Text - Especifica qual ocorrência usar quando várias correspondências são encontradas.

• Seletor semântico - Uma descrição semântica que define o destino. Essa propriedade está disponível apenas quando o método de Segmentação semântica é selecionado.

  Grandes Modelos de Linguagem (LLMs) são usados para gerar descrições funcionais padrão e legíveis por humanos de elementos de interface gráfica. Essas descrições são altamente resilientes a alterações na interface gráfica e ajudam a melhorar a confiabilidade da automação quando os seletores tradicionais são insuficientes ou falham.

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

Destino - Âncora (n)

• Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Esta propriedade pode ser definida como qualquer combinação 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 (disponível apenas para projetos do Windows)
  • Computer Vision
• Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica. Ele só é exibido se o método de segmentação do seletor Restrito tiver sido selecionado.
• Seletor difuso - Os parâmetros para o seletor difuso. Só é exibido se o método de segmentação de Seletor Difuso tiver sido selecionado.
• Imagem - Essas propriedades estão disponíveis apenas quando o método de segmentação Imagem é selecionado.
  • Precisão da imagem – Especifica o limite de confiança usado para correspondência de imagens. O valor padrão é 0,8.
  • Ocorrência de imagem - Especifica qual correspondência deve ser usada quando várias imagens correspondentes são encontradas.
• Nativo - Essas propriedades estão disponíveis apenas quando o método de segmentação Nativo é selecionado.
  • Texto nativo - Especifica o texto usado para identificar o elemento de interface gráfica.
  • Ocorrência de texto nativo - Especifica qual ocorrência usar quando várias correspondências são encontradas.
  • Texto nativo com diferenciação de maiúsculas e minúsculas — especifica se a correspondência de texto diferencia maiúsculas de minúsculas.
• Computer Vision - Essas propriedades estão disponíveis apenas quando o método de segmentação de Computer Vision é selecionado.
  • Tipo de controle de CV - Especifica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Especifica o texto identificado usando o Computer Vision.
  • Precisão do texto CV - Especifica o limite de confiança usado para correspondência de texto OCR. O valor padrão é 0,7.
  • Ocorrência de CV Text - Especifica qual ocorrência usar quando várias correspondências são encontradas.

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.