Ações de variáveis

Para criar manualmente uma variável em um fluxo da área de trabalho, implante a ação Definir variável. Esta ação exige que você forneça um nome e um valor para a nova variável.

Importante

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

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

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

Da mesma forma, a ação Gerar número aleatório produz um valor numérico aleatório. Se você ativar Gerar vários números nesta ação, você criará uma variável de lista contendo vários valores numéricos aleatórios.

Para adicionar itens a uma lista existente, implante a ação Adicionar item à lista e preencha um valor embutido em código ou uma variável para definir o item a ser adicionado. Da mesma forma, você pode remover itens de uma lista com a ação Remover item da lista.

Observação

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

Se você deseja criar uma variável de tabela de dados, implante a ação Criar nova tabela de dados e especifique os itens iniciais dela usando o construtor visual.

Para manipular uma variável da tabela de dados, use as ações do respectivo subgrupo de ação, como as ações Localizar ou substituir na tabela de dados e Atualizar item da 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 padrão	Description
Nova tabela	Não	Datatable		A tabela de dados de entrada

Variáveis produzidas

Argumento	Type	Description
DataTable	Datatable	A nova tabela de dados

Exceções

Essa ação não inclui exceções.

Inserir linha na tabela de dados

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

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Tabela de dados	Não	Tabela de dados		A variável da tabela de dados com a qual trabalhar. Esta variável deve ter sido especificada anteriormente por uma ação que gera uma variável de tabela de dados
No local	N/A	Fim da tabela de dados, antes do índice de linha	Término da tabela de dados	Especifique se a nova linha deve ser inserida no final da tabela de dados ou antes de um índice de linha especificado
Índice de linha	Não	Valor numérico		Insira o valor de índice de linha a ser usado quando antes do índice de linha é especificado como parâmetro de local
Novos valores	Não	Lista, Linha de dados		Este parâmetro aceita uma variável de lista ou linha de dados em que a contagem de colunas deve corresponder à contagem de colunas da tabela de dados

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
O índice do item está fora do intervalo	Indica que o índice do item fornecido está fora do intervalo
Argumentos de entrada inválidos	Indica que há 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

Encontrar ou substituir na tabela de dados

Encontra e/ou substitui valores da tabela de dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Tabela de dados	Não	Tabela de dados		A variável da tabela de dados com a qual trabalhar. Esta variável deve ter sido especificada anteriormente por uma ação que gera 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 booliano	Verdadeiro	Especifique se é para localizar ou substituir o texto em todas as células correspondentes encontradas ou somente na primeira célula correspondente
Texto a ser localizado	Não	Valor do texto		O texto a ser encontrando na tabela de dados
Encontrar usando uma expressão regular	N/A	Valor booliano	Falso	Especifique se é para usar uma expressão regular para corresponder o conteúdo da célula ao texto a ser encontrado
Diferenciar maiúsculas de minúsculas	N/A	Valor booliano	Falso	Especifique se é para pesquisar dados com diferenciação entre maiúsculas e minúsculas
Corresponder ao conteúdo da célula inteira	N/A	Valor booliano	Falso	Especifique se é para pesquisar células que contêm apenas o texto especificado
Texto substituto	Não	Valor do texto		O texto usado para substituir as células correspondentes
Pesquisar por	N/A	Em todos os lugares, na coluna	Todos os lugares	A ordem na qual pesquisar o texto (em todo o arquivo ou em uma coluna)
Índice ou nome da coluna	Não	Valor do texto		O valor do cabeçalho da coluna ou do índice

Variáveis produzidas

Argumento	Type	Description
DataTableMatches	Datatable	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 de coluna fornecido está fora do intervalo
Erro de tipo incompatível	Indica que um parâmetro de entrada de um tipo incompatível é fornecido

Atualizar item da tabela de dados

Atualizar um item de linha da tabela de dados em uma coluna definida.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Tabela de dados	Não	Tabela de dados		A variável da tabela de dados com a qual trabalhar. Esta variável deve ter sido especificada anteriormente por uma ação que gera uma variável de tabela de dados
Coluna	Não	Valor do texto		O nome da coluna ou o índice do item a ser atualizado
Linha	Não	Valor numérico		O índice de linha do item a ser atualizado
Novo valor	Não	Valor do texto		O novo valor a ser atualizado no índice de linha e na coluna especificados

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
O índice do item está fora do intervalo	Indica que o item da 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 de coluna fornecido está fora do intervalo
Erro de tipo incompatível	Indica que um parâmetro de entrada de um tipo incompatível foi fornecido

Excluir linha da tabela de dados

Atualizar um item de linha da tabela de dados em uma coluna definida.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Tabela de dados	Não	Tabela de dados		A variável da tabela de dados com a qual trabalhar. Esta variável deve ter sido especificada anteriormente por uma ação que gera uma variável de tabela de dados
Índice de linha	Não	Valor numérico		O índice de linha que deve ser excluído em uma tabela de dados

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

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

Número truncado

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

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Number to truncate	Não	Valor numérico		O número ou a variável que contém o valor numérico a ser truncado/arredondado para mais
Operation	N/D	Obter parte inteira, Obter parte decimal, Número redondo	Obter parte inteira	Especifica a operação a ser realizada em relação ao número fornecido
Decimal places	Sim	Valor numérico	3	O número de casas decimais para arredondar o número fornecido. Insira 0 para retornar um inteiro como resultado

Variáveis produzidas

Argumento	Type	Description
TruncatedValue	Valor numérico	O número truncado ou arredondado

Exceções

Essa ação não inclui 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 padrão	Description
Valor mínimo	Sim	Valor numérico	0	O limite inferior dos números aleatórios a serem gerados
Valor máximo	Sim	Valor numérico	100	O limite superior dos números aleatórios a serem gerados
Generate multiple numbers	N/D	Valor booliano	Falso	Especifica se deseja gerar um único número aleatório ou uma lista de números aleatórios
Quantos números	Sim	Valor numérico	10	Especifica quantos números aleatórios devem ser gerados
Permitir duplicatas	N/D	Valor booliano	Falso	Especifica se deseja permitir ou impedir que o mesmo número apareça mais de uma vez na lista de números aleatórios

Variáveis produzidas

Argumento	Type	Description
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 há um erro ao gerar um número aleatório

Limpar lista

Remover todos os itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Listar para limpar	Não	Lista de Valores gerais		Uma variável de lista para remover seus elementos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Remover item da lista

Remover um ou mais itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Remover item por	N/D	Índice, Valor	Índice	Especifica se deseja remover o item em um índice especificado ou os itens com um valor específico
Em índice	Não	Valor numérico		O número do índice do item a ser removido
Com valor	Não	Valor geral		O item a ser removido
Remover todas as ocorrências de item	N/D	Valor booliano	Falso	Remove todas as ocorrências que correspondem ao item especificado
Da lista	Não	Lista de Valores gerais		A lista com itens a serem removidos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

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

Classificar lista

Classificar os itens de uma lista. Usar itens do mesmo tipo.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Lista a ser classificada	Não	Lista de Valores gerais		A variável que contém a lista a ser classificada
Classificar por propriedades do item da lista	N/D	Valor booliano	False	Se os itens da lista forem objetos (como arquivos, pastas, etc.), ative esta opção para classificar o item por uma propriedade específica. Deixe esta opção desabilitada para classificar os elementos por sua propriedade padrão (por exemplo, os objetos de arquivo são classificados por seu caminho completo)
Primeira propriedade para classificar	Sim	Valor do texto		O nome de uma propriedade do item para usada para classificar a lista. Consulte o arquivo de ajuda para obter os nomes das propriedades de cada objeto
Classificar	N/D	Ascendente, Descendente	Ascendente	Especifica se deseja classificar pela primeira propriedade em ordem crescente ou decrescente
Segunda propriedade para classificar	Sim	Valor do texto		O nome de uma segunda propriedade usada para classificar a lista
Classificar	N/D	Ascendente, Descendente	Ascendente	Especifica se deseja classificar pela segunda propriedade em ordem crescente ou decrescente
Terceira propriedade para classificar	Sim	Valor do texto		O nome de uma terceira propriedade usada para classificar a lista
Classificar	N/D	Ascendente, Descendente	Ascendente	Especifica se deseja classificar pela terceira propriedade em ordem crescente ou decrescente

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Lista aleatória

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

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Lista a ser embaralhada	Não	Lista de Valores gerais		A variável que contém a lista a ser embaralhada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Mesclar listas

Mesclar duas listas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Primeira lista	Não	Lista de Valores gerais		A primeira lista de itens a ser mesclada
Segunda lista	Não	Lista de Valores gerais		A segunda lista de itens a ser mesclada

Variáveis produzidas

Argumento	Type	Description
OutputList	Lista de Valores gerais	A lista mesclada. 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

Lista reversa

Reverta a ordem dos itens de uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Lista a ser T3 revertida	Não	Lista de Valores gerais		A lista cujos itens devem ser revertidos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Remover itens duplicados da lista

Remova as várias ocorrências de itens em uma lista, para que na lista resultante cada item seja único.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Lista da qual deseja remover itens duplicados	Não	Lista de Valores gerais		A variável de lista da qual deseja remover itens duplicados
Ignorar maiúsculas e minúsculas do texto ao pesquisar itens duplicados	N/D	Valor booliano	Falso	Especifica se deseja executar uma comparação com diferenciação de maiúsculas e minúsculas ao pesquisar itens duplicados (aplicável apenas a listas compostas por itens de texto)

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Localizar itens comuns da lista

Compare duas listas e crie uma lista com os itens em comum.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Primeira lista	Não	Lista de Valores gerais		A variável que contém a primeira lista a ser comparada
Segunda lista	Não	Lista de Valores gerais		A variável que contém a segunda lista a ser comparada

Variáveis produzidas

Argumento	Type	Description
IntersectionList	Lista de Valores gerais	A nova lista de itens comuns

Exceções

Essa ação não inclui exceções.

Subtrair listas

Comparar duas listas e criar uma lista com os itens da primeira lista, mas não na segunda.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Primeira lista	Não	Lista de Valores gerais		A variável que contém a primeira lista a ser comparada
Segunda lista	Não	Lista de Valores gerais		A variável que contém a segunda lista a ser comparada

Variáveis produzidas

Argumento	Type	Description
ListDifference	Lista de Valores gerais	A nova lista resultante

Exceções

Essa ação não inclui exceções.

Recuperar a coluna da tabela de dados em uma lista

Converta o conteúdo de uma tabela de dados em uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Tabela de dados	Não	Datatable		A tabela de dados com a coluna a ser convertida em uma lista
Nome ou índice da coluna	Não	Valor do texto		O nome da coluna, se os nomes das colunas estiverem definidos, ou o número do índice da coluna a ser recuperada

Variáveis produzidas

Argumento	Type	Description
ColumnAsList	Lista de Valores gerais	A nova lista que mantém 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 de caracteres JSON em um objeto personalizado.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
JSON	Não	Valor do texto		Um texto JSON ou uma variável criada anteriormente contendo um texto JSON, para convertê-lo em um objeto personalizado

Variáveis produzidas

Argumento	Type	Description
JsonAsCustomObject	Valor geral	O objeto personalizado convertido do JSON fornecido

Exceções

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

Converter objeto personalizado em JSON

Converter um objeto personalizado em uma cadeia de caracteres JSON.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Objeto personalizado	Não	Objeto personalizado		O objeto personalizado a ser convertido em JSON

Variáveis produzidas

Argumento	Type	Description
CustomObjectAsJson	Valor do texto	O JSON convertido do objeto personalizado fornecido

Exceções

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

Adicionar item à lista

Anexar um novo item a uma lista.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Adicionar item	Não	Valor geral		Um valor ou variável para adicionar à lista. Fornece uma lista de valores para anexar vários elementos. Se a lista tiver um tipo específico de elementos, o novo elemento é convertido para esse tipo
Para a lista	Não	Lista de Valores gerais		Uma variável de lista à qual os novos elementos serão anexados

Variáveis produzidas

Argumento	Type	Description
NewList	Lista de Valores gerais	A nova lista

Exceções

Essa ação não inclui exceções.

Criar nova lista

Criar uma lista vazia.

Parâmetros de entrada

Essa ação não requer entradas.

Variáveis produzidas

Argumento	Type	Description
Lista	Lista de Valores gerais	A nova lista

Exceções

Essa ação não inclui exceções.

Aumentar variável

Aumente o valor de uma variável por um valor específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Nome da variável	Não	Valor numérico		O valor numérico a ser aumentado
Aumentar em	Não	Valor numérico		Um valor numérico, ou variável criada anteriormente contendo um valor numérico, usado para aumentar a variável

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Diminuir variável

Diminuir o valor de uma variável por um valor específico.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Nome da variável	Não	Valor numérico		Um valor numérico, ou variável criada anteriormente contendo um valor numérico, usado para reduzir a variável
Diminuir em	Não	Valor numérico		Um valor numérico, ou variável criada anteriormente contendo um valor numérico, usado para reduzir a variável

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Executar expressão do Power Fx

Executa a expressão do Power Fx fornecida.

Observação

Esta ação está disponível somente para os fluxos da área de trabalho do Power Fx habilitadas (versão preliminar).

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Expressão	No	*		A expressão do Power Fx a ser executada

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui 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 criada anteriormente.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
To	Não	*		O valor a ser atribuído à variável

Variáveis produzidas

Argumento	Type	Description
NewVar	*	O nome da variável a ser definida

Observação

Os nomes das variáveis devem começar com uma letra ou um sublinhado (_). Após o primeiro caractere, os nomes das variáveis podem conter letras, sublinhados e dígitos (0-9). Os nomes não diferenciam maiúsculas de minúsculas, o que significa que myVar, myvar e MYVAR são consideradas a mesma variável. As seguintes palavras-chave reservadas não podem ser usadas como nomes de variáveis: if, then, else, chave, caso, padrão, loop, de, até, etapa, foreach, em, enquanto, próximo, sair, label, acessar, chamar, saída, função, bloco, fim, erro, esperar, para, definir, principal e, ou, xor, não, verdadeiro, falso, sim, não, desabilitar, ativado, repetir, vezes, lançar, ação, mod, global, entrada, importar

Exceções

Essa ação não inclui exceções.