Listar métodos do conector

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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. Você deve primeiro expor os métodos antes de usar.

    Adicionar

    Adiciona um único item de 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?
    Item Nome do item de lista. Dados em Objeto Nenhum(a) 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 Objeto Nenhum(a) Sim Você pode passar os itens de lista de uma variável ou de 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 Configurar 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 de lista for encontrado, caso contrário, retorna 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

    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?
    Prop A chave no par de valores de chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Valor O valor no par de valores de chave. Dados em Cadeia de caracteres Nenhum(a) Sim
    Encontrado Retorna verdadeiro se o item de lista for encontrado, caso contrário, retorna 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

    LocalizarTexto

    Localiza texto ou regex nos itens de 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?
    SearchText Texto que o método pesquisa nos itens da lista. Dados em Cadeia de caracteres Nenhum(a) Sim
    LocalizarPor Opção para indicar se o método pesquisa um texto ou regex. Dados em Cadeia de caracteres Nenhum(a) Sim
    Tipo de correspondência Opção para indicar se o tipo de correspondência será:
    • Uma correspondência exata
    • Caso de correspondência
    • Contém os caracteres especificados.
    		 Entrada de dados 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

    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?
    Í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

    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 de método (ícone de configurações de método).
    2. Clique no ícone de adição de índice ( íconede adição de í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 de lista correspondente ao valor do índice.

    ObterLista

    Retorna todos os itens de lista e 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 de lista e as listas. 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 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?
    Item Item de lista que o método remove. Dados em Objeto Nenhum(a) Sim

    Remover tudo

    Remove todos os itens de 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, você deve primeiro configurar o método.

    Para configurar, siga estas etapas.
    1. Clique no ícone de configurações de método (ícone de configurações de método).
    2. Clique no ícone de adição de índice ( íconede adição de í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 entrada de dados é criada 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?
    Item Aceita o valor dos itens de lista. Dados em Objeto Nenhum(a) 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?
    Retornar Retorna os itens da lista na forma de uma lista de matrizes. Saída de dados Lista de matrizes Não aplicável Não aplicável