Métodos de conector de lista

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • Os métodos do Conector de lista executam várias ações em itens de lista como parte de um fluxo de trabalho de automação. Primeiro, você deve expor os métodos antes de usar .

    Adicionar

    Adiciona um único item de lista.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 1. Adicionar parâmetros de método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Item Nome do item da lista. Dados em Objeto Nenhum(a) Sim

    AddList

    Adiciona uma lista de itens.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 2. Parâmetros do método AddList
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    Lista Lista de itens. Dados em Objeto Nenhum(a) Sim Você pode passar os itens da lista de uma variável ou um componente apropriado.

    Contém

    Retorna o valor booliano com base na existência de um item de lista.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 3. Contém parâmetros de método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Item Nome do item de lista que o método pesquisa. Dados em Objeto Nenhum(a) Sim
    Retornar Retorna Verdadeiro se o item da lista for encontrado, caso contrário, retornará Falso. Saída de dados Booliano Não aplicável Não aplicável

    Contagem

    Retorna a contagem total de itens de lista adicionados.

    Tabela 4. Parâmetros do método de contagem
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a contagem total de itens de lista adicionados. Saída de dados Inteiro Não aplicável Não aplicável

    FindPorPropriedade

    Encontra um item de lista com base na chave e no valor especificados. Você deve criar pelo menos um item de lista de par de chave-valor antes de executar este método.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 5. Parâmetros do método FindByProperty
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Prop A chave no par de valor de chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Valor O valor no par de valor de chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Encontrado Retorna Verdadeiro se o item da lista for encontrado, caso contrário, retornará Falso. Saída de dados Booliano Não aplicável Não aplicável
    Item Se o parâmetro encontrado for verdadeiro, o método retornará o item da lista. Saída de dados Objeto Não aplicável Não aplicável

    Texto de destino

    Encontra texto ou regex nos itens da lista com base no filtro especificado e retorna o total de ocorrências do texto e o próprio texto.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 6. Parâmetros do método FindByProperty
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    SearchText Texto que o método pesquisa nos itens da lista. Dados em Cadeia de caracteres Nenhum(a) Sim
    FindBy Opção para indicar se o método pesquisa um texto ou regex. Dados em Cadeia de caracteres Nenhum(a) Sim
    MatchType Opção para indicar se o tipo de correspondência será:
    • Uma correspondência exata
    • Corresponder caso
    • Que contém os caracteres especificados.
    		 Dados em Cadeia de caracteres Nenhum(a) Sim
    Contagem Retorna o total de ocorrências da correspondência. Saída de dados Inteiro Não aplicável Não aplicável
    Lista de saída Retorna a lista de correspondências. Saída de dados Lista Não aplicável Não aplicável

    GetItem

    Retorna um item de lista com base em seu valor de índice.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 7. Parâmetros do método GetItem
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Índice Valor de índice do item de lista. Dados em Inteiro Nenhum(a) Sim
    Retornar Retorna o item da lista. Saída de dados Objeto Não aplicável Não aplicável

    GetItems

    Retorna os itens da lista com base em seus valores de índice. Primeiro, você deve configurar os valores de índice.

    Para configurar, execute as etapas a seguir.
    1. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    2. Clique no ícone adicionar índice ( Ícone Adicionar índice.).
    3. Insira o valor do índice.
    4. Atualize o tipo de dados do valor do índice.
    5. Repita as etapas para adicionar mais valores de índice.
    6. Clique em OK.

      Uma porta de saída de dados é criada com cada valor de índice. A porta de saída de dados retorna o item da lista correspondente ao valor do índice.

    GetList

    Retorna todos os itens da lista e as listas criadas.

    Tabela 8. Parâmetros do método GetList
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna os itens e as listas da lista. Saída de dados Matriz Nenhum(a) Não aplicável

    Remover

    Remove o item de lista especificado.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 9. Parâmetros do método GetList
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Item Item de lista que o método remove. Dados em Objeto Nenhum(a) Sim

    RemoveAll

    Remove todos os itens de lista adicionados.

    Reverter

    Reverte a ordem dos valores de índice dos itens da lista.

    SetItems

    Atualiza os valores dos itens da lista. Para usar o método, você deve primeiro configurar o método.

    Para configurar, execute as etapas a seguir.
    1. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    2. Clique no ícone adicionar índice ( Ícone Adicionar índice.).
    3. Insira o valor do índice.
    4. Atualize o tipo de dados do valor do índice.
    5. Repita as etapas para adicionar mais valores de índice.
    6. Clique em OK.

      Um dado na porta é criado com cada valor de índice.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 10. Parâmetros do método SetItems
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Item Aceita o valor dos itens da lista. Dados em Objeto Nenhum(a) Sim

    Classificação

    Classifica os itens da lista.

    Para Array

    Retorna os itens da lista na forma de uma matriz. Você deve adicionar mais de um item de lista antes de executar este método.

    Tabela 11. Parâmetros do método ToArray
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna os itens da lista na forma de uma lista de matriz. Saída de dados Lista de matrizes Não aplicável Não aplicável