Lista pacote

O pacote Lista contém ações 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.

Ações no pacote Lista

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

As seguintes ações estão disponíveis no pacote Lista:


Ação	Descrição
Adicionar item	Insere um item em uma variável lista. Você pode optar por adicionar o item no final da lista ou especificar uma posição na lista. Selecione na lista Variável lista a variável lista na qual adicionar um item. Selecione na lista Item a ser adicionado a variável que contém o valor a ser adicionado. Nota: A variável deve ser do mesmo tipo de subdados que os outros itens da lista. Selecione a opção Para o fim da lista para inserir o item no final da lista ou selecione No índice da lista para especificar o índice na lista onde inserir o item. O índice da lista começa em 0. O primeiro item da lista está na posição 0, o segundo item em 1 e assim por diante. Por exemplo, para adicionar um item na quarta posição em uma lista, insira `3` no campo No índice da lista.
Acrescentar	Adiciona uma variável da lista ao índice da coluna de uma tabela de dados. Você pode optar por adicionar a variável de lista no início ou no final ou especificar uma posição na tabela de dados. Selecione a variável de lista que contém o valor a ser adicionado. No campo Atribuir o resultado à Tabela de Dados, selecione uma variável de tabela que você deseja usar para armazenar a saída. Escolha entre as seguintes opções para inserir uma coluna no índice: Primeiro índice: Define o valor para a primeira posição (0 índice) em uma tabela de dados. Último índice: Define o valor no final da tabela de dados. Índice específico: Especifique o índice onde você deseja entrar o índice da coluna. Por exemplo, para definir um valor para a primeira coluna, digite `0`. O número de índice começa em 0. O primeiro item da tabela de dados está na posição 0, o segundo item em 1 e assim por diante. Por exemplo, para adicionar um item na terceira posição em uma tabela de dados, insira `2` no campo Índice específico.
Assign (Atribuir)	Atribui o valor da lista de origem à variável lista de destino. Selecione a variável da lista de origem na lista suspensa ou crie uma nova variável da lista. Selecione ou crie uma variável de lista para manter a saída.
Limpar	Limpa todos os itens da variável lista selecionada.
Obter item	Recupera o valor na posição especificada em uma lista e armazena a saída em uma variável. Selecione na lista Variável lista a variável lista a partir da qual deseja recuperar um valor. Especifique a posição na lista de onde deseja recuperar o valor no campo Número do índice. O índice da lista começa em 0. O primeiro item da lista está na posição 0, o segundo item em 1 e assim por diante. Na lista Atribuir a saída à variável, selecione a variável que deseja usar para armazenar a saída.
Unir itens	Combina todos os valores disponíveis em uma variável lista e armazena a saída em uma variável string. Você pode especificar o delimitador que deseja usar como separador na saída. Na lista Variável de lista, selecione a variável de lista que deseja usar. Especifique o delimitador que deseja usar para separar valores na saída no campo Delimitador. Na lista Atribuir a saída à variável, selecione a variável que deseja usar para armazenar a saída.
Remover item	Remove um item da lista e atribui a saída a uma variável. Selecione na lista Variável lista a variável lista a partir da qual deseja remover um item. Especifique a posição na lista de onde deseja remover o valor no campo Número do índice. O índice da lista começa em 0. O primeiro item da lista está na posição 0, o segundo item em 1 e assim por diante. Na lista Atribuir a saída à variável, selecione a variável que deseja usar para armazenar a saída.
Definir item	Define um item na posição específica em uma lista e armazena a saída em uma variável. Selecione a lista Variável lista na variável lista a partir da qual deseja configurar um valor. Especifique a posição na lista onde deseja configurar o item no campo Número do índice. O índice da lista começa em 0. O primeiro item da lista está na posição 0, o segundo item em 1 e assim por diante. Na lista Atribuir a saída à variável, selecione a variável que deseja usar para armazenar a saída.
Size (Tamanho)	Recupera o número de itens em uma lista e atribui a saída a uma variável numérica. Selecione na lista Variável lista a variável lista para a qual deseja recuperar o tamanho. Na lista Atribui o número de itens à variável, selecione a variável numérica que deseja usar para armazenar a saída.

Exemplo:

Crie um bot para adicionar itens a uma lista e recuperar dados de uma lista. Para utilizar esta utilidade, execute as seguintes etapas:

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.
Crie as seguintes variáveis.
- Variável: StringList
  - Tipo: Lista
  - Subtipo: String
  - Nome: StringList
  - O valor padrão é 0: Automação
  - O valor padrão é 1: Anywhere
- Variável: SampleString
  - Nome: SampleString
  - Valor padrão: PvtLtd
- Variável: ListOutput
  - Tipo: Qualquer um
  - Nome: ListOutput
Para inserir um item em uma variável de lista, no painel Ações, clique duas vezes ou arraste a ação 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 .
Para recuperar um valor em uma posição especificada de uma lista, no painel Ações, clique duas vezes ou arraste a ação 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.
Para imprimir o valor do Índice 0, clique duas vezes ou arraste a ação Caixa de mensagens. Clique em Salvar e Executar.
O bot mostra os dados do índice zero da variável da lista, que é Automação.

Automation 360