Listar métodos de conector

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

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

    Adicionar

    Adiciona um único item à lista.

    Para fornecer entradas para os parâmetros, consulte Configurar 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? Anotações
    Item Nome do item da lista. Dados em Object Nenhum Sim

    AdicionarLista

    Adiciona uma lista de itens.

    Para fornecer entradas para os parâmetros, consulte Configurar 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 Object Nenhum Sim Você pode passar os itens da lista de uma variável ou de um componente apropriado.

    Contém

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

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

    Tabela 3. Parâmetros do método "contém"
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Item Nome do item da lista que o método pesquisa. Dados em Object Nenhum Sim
    Retornar Retorna Verdadeiro se o item da lista for encontrado, caso contrário, retorna Falso. Dados esgotados Booleano Não aplicável Não aplicável

    Contagem

    Retorna a contagem total de itens da 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? Anotações
    Retornar Retorna a contagem total de itens da lista adicionados. Dados esgotados Inteiro Não aplicável Não aplicável

    LocalizarPorPropriedade

    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 Configurar 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? Anotações
    Proposta A chave no par de chave-valor. Dados em Cadeia de caracteres Nenhum Sim
    valor O valor no par de chave-valor. Dados em Cadeia de caracteres Nenhum Sim
    Encontrado Retorna Verdadeiro se o item da lista for encontrado, caso contrário, retorna Falso. Dados esgotados Booleano Não aplicável Não aplicável
    Item se o parâmetro encontrado for verdadeiro, o método retornará o item da lista. Dados esgotados Object Não aplicável Não aplicável

    LocalizarTexto

    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 Configurar 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? Anotações
    SearchText Texto que o método pesquisa nos itens da lista. Dados em Cadeia de caracteres Nenhum Sim
    Localizar por Opção para indicar se o método pesquisa um texto ou regex. Dados em Cadeia de caracteres Nenhum Sim
    Tipo de correspondência Opção para indicar se o tipo de correspondência será:
    • Uma correspondência exata
    • Caso de correspondência
    • Contendo os caracteres especificados.
    		 Dados em Cadeia de caracteres Nenhum Sim
    Contagem Retorna o total de ocorrências da correspondência. Dados esgotados Inteiro Não aplicável Não aplicável
    Lista de itens excluídos Retorna a lista de correspondências. Dados esgotados Lista Não aplicável Não aplicável

    Obter item

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

    Para fornecer entradas para os parâmetros, consulte Configurar 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? Anotações
    Índice Valor de índice do item da lista. Dados em Inteiro Nenhum Sim
    Retornar Retorna o item da lista. Dados esgotados Object Não aplicável Não aplicável

    Obter itens

    Retorna os itens da lista com base em seus valores de índice. Você deve configurar os valores de índice primeiro.

    Para configurar, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do 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.

    Obter lista

    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? Anotações
    Retornar Retorna os itens da lista e as listas. Dados esgotados Matriz Nenhum Não aplicável

    Remover

    Remove o item da lista especificado.

    Para fornecer entradas para os parâmetros, consulte Configurar 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? Anotações
    Item Item da lista que o método remove. Dados em Object Nenhum Sim

    Remover tudo

    Remove todos os itens da lista adicionados.

    Reverter

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

    Definir itens

    Atualiza os valores dos itens da lista. Para usar o método, primeiro você deve configurá-lo.

    Para configurar, siga estas etapas.
    1. Clique no ícone de configurações do método (ícone de configurações do 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 Configurar 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? Anotações
    Item Aceita o valor dos itens da lista. Dados em Object Nenhum Sim

    Classificação

    Classifica os itens da lista.

    Para Matriz

    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? Anotações
    Retornar Retorna os itens da lista na forma de uma lista de matriz. Dados esgotados Lista de matrizes Não aplicável Não aplicável