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.

Captura de ecrã da ação Definir 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.

Captura de ecrã da ação Aumentar variável.

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.

Captura de ecrã da ação Gerar número aleatório.

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.

Captura de ecrã da ação Criar nova 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 Name 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 Name 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.