Ações de variáveis

Para criar manualmente uma variável num fluxo de ambiente de trabalho, implemente a ação Definir variável. Esta ação exige que forneça um nome e um valor para a nova variável.

Importante

As palavras-chave reservadas não podem ser usadas como nomes de variáveis. Para ver a lista completa de palavras-chave reservadas, aceda a Palavras-chave reservadas em fluxos de ambiente de trabalho.

Para aumentar ou diminuir o valor de uma variável numérica, utilize as ações Aumentar variável e Diminuir variável, respetivamente.

A maioria das ações produz o seu resultado numa variável. Por exemplo, a ação Criar nova lista produz uma lista vazia.

De modo semelhante, a ação Gerar número aleatório produz um valor numérico aleatório. Se ativar Gerar vários números nesta ação, irá criar uma variável de lista contendo vários valores numéricos aleatórios.

Para adicionar itens a uma lista existente, implemente a ação Adicionar item à lista e preencha um valor codificado ou uma variável para definir o item a adicionar. Da mesma forma, pode remover itens de uma lista com a ação Remover item da lista.

Nota

Os índices de lista começam a partir de 0, o que significa que o primeiro item na lista tem sempre um índice de 0. Utilize a notação %ListName[0]% para se referir ao primeiro ponto da lista, %ListName[1]% para o segundo, e assim por diante.

Se pretende criar uma variável de tabela de dados, implemente a ação Criar nova tabela de dados e especifique os respetivos itens iniciais utilizando o construtor visual.

Para manipular uma variável de tabela de dados, utilize as ações do respetivo subgrupo de ação, tais como as ações Localizar ou substituir numa tabela de dados e Atualizar item de tabela de dados.

Criar nova tabela de dados

Cria uma nova variável de tabela de dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Nova tabela	Não	Tabela de dados		A tabela de dados de entrada

Variáveis produzidas

Argumento	Tipo	Descrição
DataTable	Tabela de dados	A nova tabela de dados

Exceções

Esta ação não inclui quaisquer exceções.

Inserir linha numa tabela de dados

Insere uma linha no fim ou antes de um valor de índice específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ter sido especificada previamente por uma ação que produz uma variável de tabela de dados
Na localização	N/A	Fim da tabela de dados, Antes do índice de linha	Fim da tabela de dados	Especifique se pretende inserir a nova linha no fim da tabela de dados ou antes de um índice de linha especificado
Índice de linha	Não	Valor numérico		Inserir o valor do índice de linha a utilizar quando o índice de linha é especificado como parâmetro Na localização
Novos valores	Não	Lista, Linha de dados		Este parâmetro aceita uma variável de lista ou linha de dados onde a contagem de colunas deve corresponder à contagem de colunas na tabela de dados

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O índice de itens está fora do intervalo	Indica que o índice de item fornecido está fora do intervalo
Argumentos de entrada inválidos	Indica que existe um parâmetro de entrada inválido
Erro de tipo incompatível	Indica que um parâmetro de entrada de um tipo incompatível é fornecido

Eliminar linha de tabela de dados

Eliminar uma linha de tabela de dados no índice de linha correspondente.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ser especificada por uma ação que produz uma variável de tabela de dados
Índice de linha	Não	Valor numérico		O índice de linha de uma tabela de dados que deve ser eliminado

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O índice de itens está fora do intervalo	Indica que o item de tabela de dados especificado está fora do intervalo

Atualizar item de tabela de dados

Atualizar um item de linha de tabela de dados numa coluna definida.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ter sido especificada previamente por uma ação que produz uma variável de tabela de dados.
Coluna	Não	Valor de texto		O índice ou nome da coluna do item a atualizar.
Linha	Não	Valor numérico		O índice de linha do item a atualizar.
Novo valor	Não	Valor de texto		O novo valor a atualizar no índice de linha e na coluna especificados.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O índice de itens está fora do intervalo	Indica que o item de tabela de dados especificado está fora do intervalo
O nome da coluna não existe	Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo
Erro de tipo incompatível	Indica que foi fornecido um parâmetro de entrada de um tipo incompatível

Localizar ou substituir numa tabela de dados

Localiza e/ou substitui valores de tabela de dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ter sido especificada previamente por uma ação que produz uma variável de tabela de dados
Modo de pesquisa	N/A	Localizar, Localizar e substituir	Localizar	O modo de pesquisa (localizar ou localizar e substituir)
Todas as correspondências	N/A	Valor booleano	Verdadeiro	Especifique se o texto deve ser localizado ou substituído em todas as células correspondentes encontradas ou apenas na primeira célula correspondente
Texto a analisar	Não	Valor de texto		O texto a encontrar na tabela de dados
Localizar utilizando uma expressão regular	N/A	Valor booleano	Falso	Especificar se deve ser utilizada uma expressão regular para corresponder o conteúdo das células com o texto a localizar
Maiúsculas/Minúsculas	N/A	Valor booleano	Falso	Especifique se pretende procurar dados sensíveis às maiúsculas e minúsculas
Corresponder a totalidade do conteúdo da célula	N/A	Valor booleano	Falso	Especifique se pretende procurar células que contenham apenas o texto especificado
Texto para substituir	Não	Valor de texto		O texto utilizado para substituir as células correspondentes
Procurar por	N/A	Em todo o lado, Na coluna	Em todo o lado	A ordem pela qual o texto deve ser procurado (em todo o lado ou numa coluna)
Índice ou nome da coluna	Não	Valor de texto		O cabeçalho da coluna ou o valor do índice

Variáveis produzidas

Argumento	Tipo	Descrição
DataTableMatches	Tabela de dados	A tabela de dados que contém os índices de linha e coluna para correspondência

Exceções

Exceção	Descrição
A expressão regular fornecida é inválida	Indica que a expressão regular fornecida é inválida
O nome da coluna não existe	Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo
Erro de tipo incompatível	Indica que um parâmetro de entrada de um tipo incompatível é fornecido

Inserir coluna numa tabela de dados

Insere uma coluna no fim ou antes de um valor de índice específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ser especificada por uma ação que produz uma variável de tabela de dados.
Na localização	N/A	Fim da tabela de dados, Antes do índice da coluna	Fim da tabela de dados	Especifique se pretende inserir a nova coluna no fim da tabela de dados ou antes de um índice de coluna especificado.
Nome da coluna	Não	Valor de texto		Especificar o cabeçalho da nova coluna.
Índice de coluna	Não	Valor numérico		Especifique o valor do índice de coluna que é utilizado quando é selecionada a opção Antes do índice da coluna para o parâmetro Para a Localização.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo.
Duplicar nome de coluna	Indica que o nome de coluna fornecido já existe.

Eliminar coluna de tabela de dados

Eliminar uma coluna da tabela de dados no índice de coluna ou nome de coluna especificado.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ser especificada por uma ação que produz uma variável de tabela de dados.
Especificar coluna com	N/A	Nome, Índice	Nome	Especifique se a coluna deve ser localizada por nome ou índice.
Nome da coluna	Não	Valor de texto		O nome da coluna que deve ser eliminada.
Índice de coluna	Não	Valor numérico		O índice da coluna que deve ser eliminada. Os índices de coluna começam a partir de 0.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O nome da coluna não existe	Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo

Eliminar linhas vazias da tabela de dados

Elimina as linhas da tabela de dados que têm todas as células vazias.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. Esta variável tem de ter sido especificada previamente por uma ação que produz uma variável de tabela de dados

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Eliminar linhas duplicadas da tabela de dados

Elimina todas as linhas que são duplicadas da tabela de dados, se os valores tiverem o mesmo tipo de dados em cada coluna.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Erro de correspondência de tipos nas células de uma coluna	Indica que dois ou mais valores numa única coluna têm tipos de dados diferentes

Limpar tabela de dados

Elimina todas as linhas da tabela de dados, mantendo os cabeçalhos da tabela não afetados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Ordenar tabela de dados

Ordena as linhas da tabela de dados por ordem ascendente ou descendente pela coluna especificada, se todos os seus valores tiverem o mesmo tipo de dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.
Especificar coluna com	N/A	Nome, Índice	Nome	Especifique se a coluna deve ser localizada por nome ou índice.
Nome da coluna	Não	Valor de texto		O nome da coluna que deve ser ordenada.
Índice de coluna	Não	Valor numérico		O índice da coluna que deve ser ordenada. Os índices de coluna começam a partir de 0.
Ordenar	N/A	Ascendente, Descendente	Ascendente	A ordem para ordenar a tabela de dados.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O nome da coluna não existe	​Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo
Erro de correspondência de tipos nas células de uma coluna	Indica que dois ou mais valores numa única coluna têm tipos de dados diferentes

Tabela de dados com filtro

Filtra as linhas da tabela de dados com base nas regras aplicadas.

No assistente incorporado da ação que o ajuda a criar os filtros necessários, pode aplicar vários filtros a diferentes colunas que são definidas por nome ou índice. Cada filtro é composto por uma coluna específica a que se destina, um operador que está selecionado e o valor que lhe é atribuído.

Além disso, vários filtros são aplicados em conjunto através das regras AND e/ou OR. As regras AND são resolvidas primeiro na expressão de filtro resultante, seguidas pelas regras OR.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.
Filtros a aplicar	Não	Regras de filtragem conforme definido pelo utilizador	N/A	Regras de filtragem aplicadas às colunas definidas

Variáveis produzidas

Argumento	Tipo	Descrição
FilteredDataTable	Tabela de dados	A tabela de dados gerada após a aplicação dos filtros

Exceções

Exceção	Descrição
O nome da coluna não existe	​Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo
Erro de correspondência de tipos nas células de uma coluna	Indica que dois ou mais valores numa única coluna têm tipos de dados diferentes

Intercalar tabelas de dados

Une duas tabelas de dados, especificando o comportamento de união no caso do número de colunas ser diferente.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Primeira tabela de dados	Não	Tabela de dados		A primeira variável de tabela de dados com a qual trabalhar. Esta é também a variável produzida pela ação que contém a tabela de dados unida
Segunda tabela de dados	Não	Tabela de dados		A segunda tabela de dados que é unida na primeira tabela de dados
Modo de intercalação	N/A	Adicionar colunas extras, Ignorar colunas extras, Erro em colunas extras	Adicionar colunas	O comportamento de união que é aplicado quando as tabelas não têm o mesmo número de colunas

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Esquema em Falta	Indica que as tabelas de dados não têm o mesmo número de colunas

Associar tabelas de dados

Associa duas tabelas de dados com base na regra de associação especificada.

No assistente incorporado da ação que o ajuda a criar as regras de associação necessárias, pode definir várias regras especificando a coluna da primeira e da segunda tabela de dados em conformidade, bem como o operador de comparação que se aplica entre elas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Primeira tabela de dados	Não	Tabela de dados		A primeira variável de tabela de dados com a qual trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.
Segunda tabela de dados	Não	Tabela de dados		A segunda variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.
Operação de associação	N/A	Interno, Esquerdo, Completo	Interno	A operação de associação que é utilizada para associar as duas tabelas
Regras de associação	Não	Regras de união conforme definidas pelo utilizador	N/A	Defina as colunas e a operação a utilizar para unir as duas tabelas de dados

Variáveis produzidas

Argumento	Tipo	Descrição
JoinedDataTable	Tabela de dados	A tabela de dados gerada após a operação de associação

Exceções

Exceção	Descrição
O nome da coluna não existe	​Indica que o nome de coluna fornecido não existe
O índice da coluna está fora do intervalo	Indica que o índice da coluna fornecido está fora do intervalo

Ler a partir de variável de texto CSV

Gera uma tabela de dados a partir de um texto CSV.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Texto CSV	Não	Valor de texto		A variável de texto CSV a ler.
Trim fields	N/A	Valor booleano	True	Especifica se os espaços em branco à direita e à esquerda das células extraídas devem ser automaticamente cortados.
A primeira linha contém nomes de colunas	N/A	Valor booleano	False	Especifica se deve utilizar a primeira linha do texto CSV para definir os nomes das colunas da tabela de dados resultante. Ative esta opção para evitar a leitura dos nomes como dados na tabela. As ações subsequentes poderão aceder aos dados detidos pela tabela de dados utilizando nomes de colunas (em vez de números de coluna).
Obter campos CSV como texto	N/A	Valor booleano	False	Especifique se pretende obter o conteúdo dos campos de texto CSV como texto simples ou como o tipo correspondente mais próximo. Por exemplo, Data/Hora para datas e Numérico para números.
Columns separator	N/A	Larguras de Coluna Predefinidas, Personalizadas e Fixas	Predefinido	Especifica se pretende utilizar o separador de colunas predefinido, um separador personalizado ou colunas de largura fixa.
Separador	N/A	Sistema predefinido, Vírgula, Ponto e vírgula, Tabulação	Predefinição do sistema	O separador de colunas para analisar o texto CSV.
Separador personalizado	Não	Valor de texto		O separador de colunas personalizado a utilizar para analisar o texto CSV.
Larguras de coluna fixas	Não	Valor de texto		As larguras fixas das colunas a utilizar para analisar o texto CSV. Separar as larguras usando vírgulas, espaços, separadores ou linhas novas.

Variáveis produzidas

Argumento	Tipo	Descrição
CSVTable	Tabela de dados	O conteúdo do texto CSV como uma tabela de dados

Exceções

Exceção	Descrição
Falha ao analisar CSV	Indica um problema ao analisar o texto CSV

Converter a tabela de dados em texto

Converte uma tabela de dados num texto CSV.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A variável de tabela de dados para trabalhar. A variável especificada tem de ser definida através de uma ação que gera uma variável de tabela de dados.
Include column names	N/A	Valor booleano	False	Especifica se os nomes das colunas da variante especificada devem tornar-se a primeira linha do texto CSV.
Use custom columns separator	N/A	Valor booleano	False	Especifica se pretende utilizar um separador de colunas personalizado ou um separador de colunas predefinido.
Separador	N/A	Sistema predefinido, Vírgula, Ponto e vírgula, Tabulação	Predefinição do sistema	O separador de colunas a utilizar no texto CSV especificado.
Custom columns separator	Não	Valor de texto		O separador de colunas personalizado a utilizar no texto CSV especificado.

Variáveis produzidas

Argumento	Tipo	Descrição
CSVText	Valor de texto	A variável na qual o resultado CSV é armazenado

Exceções

Exceção	Descrição
Falha ao converter	Indica um problema ao converter a tabela de dados em texto CSV

Truncar número

Obter os dígitos integrais ou fracionais de um valor numérico ou arredondar o valor para um número especificado de casas decimais.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Number to truncate	Não	Valor numérico		O número ou variável que contém o valor numérico para truncar/arredondar
Operation	N/D	Obter parte inteira, Obter parte decimal, Arredondar número	Obter parte inteira	Especifica a operação a efetuar no número indicado
Decimal places	Sim	Valor numérico	3	O número de casas decimais para o qual pretende arredondar o número dado. Introduza 0 para devolver um número inteiro como resultado

Variáveis produzidas

Argumento	Tipo	Descrição
TruncatedValue	Valor numérico	O número truncado ou arredondado

Exceções

Esta ação não inclui quaisquer exceções.

Gerar número aleatório

Gerar um número aleatório ou uma lista de números aleatórios entre um valor mínimo e um valor máximo.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Minimum value	Sim	Valor numérico	0	O limite inferior para os números aleatórios a gerar
Maximum value	Sim	Valor numérico	100	O limite superior para os números aleatórios a gerar
Generate multiple numbers	N/D	Valor booleano	Falso	Especifica se deve ser gerado um único número aleatório ou uma lista de números aleatórios
How many numbers	Sim	Valor numérico	10	Especifica quantos números aleatórios devem ser gerados
Allow duplicates	N/D	Valor booleano	Falso	Especifica se pretende permitir ou impedir que o mesmo número apareça mais do que uma vez na lista de números aleatórios

Variáveis produzidas

Argumento	Tipo	Descrição
RandomNumber	Valor numérico	O número aleatório recém-gerado
RandomNumbers	Lista de valores Numéricos	A lista de números aleatórios recém-gerada

Exceções

Exceção	Descrição
Falha ao gerar número aleatório	Indica que ocorreu um erro ao gerar um número aleatório

Limpar a lista

Remover todos os itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
List to clear	Não	Lista de Valores gerais		Uma variável de lista cujos elementos devem ser removidos

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Remover item da lista

Remover um ou vários itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Remove item by	N/D	Índice, Valor	Índice	Especifica se pretende remover o item num índice especificado ou os itens com um valor específico
At index	Não	Valor numérico		O número de índice do item a remover
With value	Não	Valor geral		O item a remover
Remove all item occurrences	N/D	Valor booleano	Falso	Remove todas as ocorrências correspondentes ao item especificado
From list	Não	Lista de Valores gerais		A lista com itens a remover

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
O índice de itens está fora do intervalo	Indica que o índice de itens está fora do intervalo
Item não encontrado	Indica que o item não existe na lista

Ordenar a lista

Ordenar os itens de uma lista. Utilizar itens do mesmo tipo.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
List to sort	Não	Lista de Valores gerais		A variável que contém a lista a ordenar
Sort by list item's properties	N/D	Valor booleano	Falso	Se os itens da lista forem objetos (como ficheiros, pastas, etc.), ative esta opção para ordenar os itens por uma propriedade específica. Deixe esta opção desativada para ordenar os elementos pela respetiva propriedade predefinida (por exemplo, os objetos de ficheiro são ordenados pelo caminho completo)
Primeira propriedade pela qual ordenar	Sim	Valor de texto		O nome da propriedade de um item para ordenar a lista. Consulte o ficheiro de ajuda para obter os nomes de propriedade de cada objeto
Sort	N/D	Ascendente, Descendente	Ascendente	Especifica se a lista deve ser ordenada por ordem ascendente ou descendente pela primeira propriedade
Second property to sort by	Sim	Valor de texto		O nome de uma segunda propriedade para ordenar a lista
Sort	N/D	Ascendente, Descendente	Ascendente	Especifica se a lista deve ser ordenada por ordem ascendente ou descendente pela segunda propriedade
Third property to sort by	Sim	Valor de texto		O nome de uma terceira propriedade para ordenar a lista
Sort	N/D	Ascendente, Descendente	Ascendente	Especifica se a lista deve ser ordenada por ordem ascendente ou descendente pela terceira propriedade

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Aleatorizar a lista

Criar uma permutação aleatória de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
List to shuffle	Não	Lista de Valores gerais		A variável que contém a lista a aleatorizar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Intercalar listas

Unir duas listas numa só.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
First list	Não	Lista de Valores gerais		A primeira lista de itens a intercalar
Second list	Não	Lista de Valores gerais		A segunda lista de itens a intercalar

Variáveis produzidas

Argumento	Tipo	Descrição
OutputList	Lista de Valores gerais	A lista intercalada. As listas iniciais não são afetadas

Exceções

Exceção	Descrição
As listas fornecidas são de tipos incompatíveis	Indica que as listas fornecidas são de tipos incompatíveis

Inverter lista

Inverter a ordem dos itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
List to reverse	Não	Lista de Valores gerais		A lista cuja ordem dos itens pretende inverter

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Remover itens duplicados da lista

Remover as várias ocorrências de itens numa lista, de modo a que cada item seja exclusivo na lista resultante.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
List to remove duplicate items from	Não	Lista de Valores gerais		A variável de lista a partir da qual os itens duplicados devem ser removidos
Ignore text case while searching for duplicate items	N/D	Valor booleano	Falso	Especifica se a comparação do texto não deve ser sensível às maiúsculas e minúsculas ao procurar itens duplicados (apenas aplicável a listas compostas por itens de texto)

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Encontrar itens de lista comuns

Comparar duas listas e criar uma nova lista com os itens que são comuns a ambas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
First list	Não	Lista de Valores gerais		A variável que contém a primeira lista a comparar
Second list	Não	Lista de Valores gerais		A variável que contém a segunda lista a comparar

Variáveis produzidas

Argumento	Tipo	Descrição
IntersectionList	Lista de Valores gerais	A nova lista de itens comuns

Exceções

Esta ação não inclui quaisquer exceções.

Subtrair listas

Comparar duas listas e criar uma nova lista com os itens que existem na primeira lista mas não na segunda.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
First list	Não	Lista de Valores gerais		A variável que contém a primeira lista a comparar
Second list	Não	Lista de Valores gerais		A variável que contém a segunda lista a comparar

Variáveis produzidas

Argumento	Tipo	Descrição
ListDifference	Lista de Valores gerais	A nova lista resultante

Exceções

Esta ação não inclui quaisquer exceções.

Obter coluna de tabela de dados numa lista

Converter o conteúdo de uma coluna de uma tabela de dados numa lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Tabela de dados	Não	Tabela de dados		A tabela de dados com a coluna a converter numa lista
Column name or index	Não	Valor de texto		O nome da coluna (se os nomes das colunas estiverem definidos) ou o número de índice da coluna a obter

Variáveis produzidas

Argumento	Tipo	Descrição
ColumnAsList	Lista de Valores gerais	A nova lista que armazena o conteúdo da tabela de dados especificada

Exceções

Exceção	Descrição
O nome da coluna não existe	Indica que o nome da coluna não está na tabela de dados
O índice da coluna está fora do intervalo	Indica que o índice da coluna está fora do intervalo

Converter JSON em objeto personalizado

Converter uma cadeia JSON num objeto personalizado.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
JSON	Não	Valor de texto		Um texto JSON (ou uma variável previamente criada que contenha um) para converter num objeto personalizado

Variáveis produzidas

Argumento	Tipo	Descrição
JsonAsCustomObject	Valor geral	O objeto personalizado convertido do JSON fornecido

Exceções

Exceção	Descrição
Erro ao analisar o JSON	Indica que ocorreu um erro ao analisar o JSON especificado

Converter objeto personalizado em JSON

Converter um objeto personalizado numa cadeia JSON.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Custom object	Não	Objeto personalizado		O objeto personalizado a converter em JSON

Variáveis produzidas

Argumento	Tipo	Descrição
CustomObjectAsJson	Valor de texto	O JSON convertido do objeto personalizado fornecido

Exceções

Exceção	Descrição
Erro ao analisar o objeto personalizado	Indica que ocorreu um erro ao analisar o objeto personalizado

Adicionar o item à lista

Acrescentar um novo item a uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Add item	Não	Valor geral		Um valor ou uma variável a adicionar à lista. Forneça uma lista de valores para acrescentar vários elementos. Se a lista tiver um tipo de elementos específico, o novo elemento é convertido nesse tipo
Into list	Não	Lista de Valores gerais		Uma variável de lista à qual os novos elementos serão acrescentados

Variáveis produzidas

Argumento	Tipo	Descrição
NewList	Lista de Valores gerais	A nova lista

Exceções

Esta ação não inclui quaisquer exceções.

Criar nova lista

Criar uma nova lista vazia.

Parâmetros de entrada

Esta ação não exige qualquer entrada.

Variáveis produzidas

Argumento	Tipo	Descrição
List	Lista de Valores gerais	A nova lista

Exceções

Esta ação não inclui quaisquer exceções.

Aumentar variável

Aumentar o valor de uma variável por uma quantidade específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Variable name	Não	Valor numérico		O valor numérico a aumentar
Increase by	Não	Valor numérico		Um valor numérico (ou uma variável previamente criada que contenha um) pelo qual a variável deve ser aumentada

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Diminuir variável

Diminuir o valor de uma variável por uma quantidade específica.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Variable name	Não	Valor numérico		Um valor numérico (ou uma variável previamente criada que contenha um) pelo qual a variável deve ser diminuída
Decrease by	Não	Valor numérico		Um valor numérico (ou uma variável previamente criada que contenha um) pelo qual a variável deve ser diminuída

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Executar expressão do Power Fx

Executa a expressão do Power Fx fornecida.

Nota

Esta ação só está disponível para fluxos de ambiente de trabalho ativados do Power Fx (pré-visualização).

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Expression	Não	*		A expressão do Power Fx a executar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Definir variável

Definir o valor de uma variável nova ou existente, criar uma nova variável ou substituir uma variável previamente criada.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
To	Não	*		O valor a atribuir à variável

Variáveis produzidas

Argumento	Tipo	Descrição
NewVar	*	O nome da variável a definir

Nota

Os nomes das variáveis têm de começar por uma letra ou um de sublinhado (_). Após o primeiro caráter, os nomes das variáveis podem conter letras, sublinhados e dígitos (0-9). Os nomes não são sensível às maiúsculas e minúsculas, ou seja, minhaVar, minhavar e MINHAVAR são considerados a mesma variável. As seguintes palavras-chave reservadas não podem ser utilizadas como nomes de variáveis: if, then, else, switch, case, default, loop, from, to, step, foreach, in, while, next, exit, label, goto, call, output, function, block, end, error, wait, for, set, main, and, or, xor, not, true, false, yes, no, disable, on, repeat, times, throw, action, mod, global, input, import

Exceções

Esta ação não inclui quaisquer exceções.