Match function

UiPath.Excel.Activities.Business.MatchFunctionX

Pesquisa um item especificado em um intervalo de células e retorna a posição relativa dele nesse intervalo. Essa atividade pode ser usada com um arquivo Excel selecionado para uma atividade Use Excel File pai, um arquivo do Excel conectado à automaçãoou com o Notebook do projeto.

Configurando a atividade

No corpo da atividade

• Valor a ser correspondido — clique Mais no lado direito do campo e, no menu, selecione um valor usando uma das opções disponíveis:

  • Dados do Project Notebook, um arquivo do Excel pai ou conta do Outlook. Por exemplo, selecione uma célula em um arquivo do Excel ou um campo em um e-mail do Outlook que contenha o valor.
  • Usar valor salvo — selecione uma variável que você salvou anteriormente para uso posterior no projeto.
  • Texto — insira um valor no Construtor de Texto.
  • Perguntar quando executar — solicite um valor quando o projeto é executado.
  • Número — insira um valor numérico.
  • Colar da área de transferência — cole um valor que você copiou anteriormente na área de transferência no projeto.
  • Aberto no editor avançado - Insira uma expressão VB.
• No intervalo - O intervalo a ser pesquisado para o valor correspondente. Clique Mais no lado direito do campo e, no menu, selecione um intervalo nomeado ou selecione Indicar no Excel para abrir o arquivo e selecione um intervalo diretamente do arquivo. Como alternativa, você pode selecionar Entrada personalizada para inserir o intervalo manualmente ou Abrir no Editor avançado para inserir uma expressão VB.

• Tipo de correspondência - Especifique como o valor deve ser correspondido. Selecione entre as opções disponíveis:

  • 0 (primeiro valor exatamente igual ao valor a ser correspondido)
  • 1 (maior valor menor ou igual ao valor a ser correspondido)
  • -1 (menor valor maior ou igual ao valor a ser correspondido)
• Salvar em — salve o valor retornado pela atividade (a posição do valor correspondido dentro do intervalo). Se o valor para correspondência não for encontrado, -1 será retornado. Clique em Mais no lado direito do campo e, no menu, selecione uma das opções disponíveis para salvar o valor resultante:
  • Dados do Project Notebook, um arquivo do Excel pai ou conta do Outlook. Por exemplo, selecione uma célula em um arquivo do Excel ou um campo em um e-mail do Outlook onde salvar.
  • Copiar para área de transferência — salvar o valor resultante para a área de transferência.
  • Salvar para uso posterior — salve o valor resultante para uso posterior em seu projeto como entrada para outra atividade.

  • Aberto no editor avançado - Insira uma expressão VB.

    Observação: o valor retornado pela atividade é a posição do valor correspondente dentro do intervalo, não o valor em si.

Painel de Propriedades

Comum

• NomeDeExibição — o nome exibido para a atividade no Designer.

Entrada

• Consulte as opções no corpo da atividade.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

• Consulte as opções no corpo da atividade.