List package

O package Lista contém actions que permitem executar várias operações em uma variável do tipo de dados de lista.

Trabalhar com variáveis do tipo de dados de lista

Uma lista é um conjunto de valores pedidos. Os valores podem ser do subtipo de dados booliano, número ou string. Ao inicializar uma variável do dicionário, você pode selecionar o subtipo de dados Qualquer para manter qualquer um dos três subtipos de dados. Você pode inserir valores manualmente criando uma nova variável ou selecionando uma variável existente no menu Variáveis e clicando em Adicionar.

Os usos comuns das variáveis de lista incluem:
  • Enviar um e-mail para vários destinatários.
  • Pesquisar vários endereços da web.
Nota:
  • No momento, não é possível classificar os valores da lista.
  • Não é possível atribuir diretamente valores do registro a uma lista. No entanto, é possível usar a action Loop para executar o loop em todos os itens de registro e adicioná-los à variável da lista.

Actions no package Lista

Se você estiver usando uma action Lista em uma action Loop, você deve usar o iterador Para cada item na lista.

As seguintes actions estão disponíveis no package Lista:

Action Descrição
Adicionar item Consulte Add item action in List.
Acrescentar Consulte action Anexar na List.
Assign (Atribuir) Consulte Atribuir action em List.
Limpar Consulte Limpar action no List.
Obter item Consulte action Obter item no List.
Unir itens Consulte action Juntar itens na List.
Remover item Consulte action Remover item na List.
Definir item Consulte action Definir item na List.
Tamanho Consulte Tamanho action no List.

Exemplo

Crie um bot para adicionar itens a uma lista e recuperar dados de uma lista. Para utilizar esta utilidade, execute as seguintes etapas:
  1. Crie um bot.
    1. No painel do lado esquerdo, clique em Automação.

      Uma lista de formulários e bots disponíveis é exibida.

    2. Clique em Criar um bot.
    3. Digite o nome do bot: ListBot
    4. Clique em Criar e editar.
  2. Crie as seguintes variáveis.
    • Variável: StringList
      • Tipo: Lista
      • Subtipo: String
      • Nome: StringList
      • O valor padrão é 0: Automation
      • O valor padrão é 1: Anywhere
    • Variável: SampleString
      • Nome: SampleString
      • Valor padrão: PvtLtd
    • Variável: ListOutput
      • Tipo: Qualquer um
      • Nome: ListOutput
  3. Para inserir um item em uma variável de lista, no painel Ações, clique duas vezes ou arraste a action Lista > Adicionar item.
    1. No campo Variável de lista, selecione StringList.
    2. No campo Item a ser adicionado, selecione SampleString.
    3. Para inserir o item no fim da lista, selecione a opção Para o fim da lista .
  4. Para recuperar um valor em uma posição especificada de uma lista, no painel Ações, clique duas vezes ou arraste a action Lista > Obter item.
    1. No campo Variável de lista, selecione StringList.
    2. No campo Número de índice, digite 0. Isso serve para especificar a posição na lista a partir da qual se pretende recuperar um valor.
    3. Para armazenar a saída de Atribuir a saída à lista de variáveis, selecione ListOutput.
  5. Para imprimir o valor do Índice 0, clique duas vezes ou arraste a action Caixa de mensagens. Clique em Salvar e Executar.

    O bot mostra os dados do índice zero da variável da lista, que é Automação.