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.

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.

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

Excluir linha da tabela de dados

Exclui uma linha da tabela de dados no índice de linha correspondente.

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. Essa variável deve ser especificada 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

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.
Column	No	Valor do texto		O nome da coluna ou o índice do item a ser atualizado.
Linha	No	Valor numérico		O índice de linha do item a ser atualizado.
Novo valor	No	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

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

Inserir coluna na tabela de dados

Insere uma coluna 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. Essa variável deve ser especificada 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 da coluna	Término da tabela de dados	Especifique se a nova coluna deve ser inserida no final da tabela de dados ou antes de um índice de coluna especificado.
Nome da coluna	No	Valor do texto		Especificar o cabeçalho da nova coluna.
Índice de coluna	No	Valor numérico		Especifique o valor do índice da coluna que será utilizado quando a opção Antes do índice da coluna for selecionada para o parâmetro No local.

Variáveis produzidas

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

Exceções

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

Excluir coluna da tabela de dados

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

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. Essa variável deve ser especificada por uma ação que gera uma variável de tabela de dados.
Especificar coluna com	N/A	Nome, Índice	Name	Especificar se é para localizar a coluna por nome ou por índice.
Nome da coluna	No	Valor do texto		O nome da coluna que deve ser excluída.
Índice de coluna	No	Valor numérico		O índice da coluna que deve ser excluída. Índices de coluna começam em 0.

Variáveis produzidas

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

Exceções

Exceção	Description
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

Excluir linhas vazias da tabela de dados

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

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

Variáveis produzidas

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

Exceções

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

Excluir linhas duplicadas da tabela de dados

Exclui todas as linhas 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 padrão	Description
Data table	No	Tabela de dados		A variável da tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.

Variáveis produzidas

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

Exceções

Exceção	Description
Incompatibilidade de tipo nas células de uma coluna	Indica que dois ou mais valores em uma única coluna são de um tipo de dados diferente

Limpar tabela de dados

Exclui todas as linhas da tabela de dados, não afeta os cabeçalhos de tabela.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Data table	No	Tabela de dados		A variável da tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.

Variáveis produzidas

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

Exceções

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

Classificar tabela de dados

Classifica as linhas da tabela de dados em ordem crescente ou decrescente pela coluna especificada, se todos os seus valores tiverem o mesmo tipo de dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Data table	No	Tabela de dados		A variável da tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.
Especificar coluna com	N/A	Nome, Índice	Name	Especificar se é para localizar a coluna por nome ou por índice.
Nome da coluna	No	Valor do texto		O nome da coluna que deve ser classificada.
Índice de coluna	No	Valor numérico		O índice da coluna que deve ser classificada. Índices de coluna começam em 0.
Ordenar	N/A	Ascendente, Descendente	Ascendente	A ordem para classificar a tabela de dados.

Variáveis produzidas

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

Exceções

Exceção	Description
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
Incompatibilidade de tipo nas células de uma coluna	Indica que dois ou mais valores em uma única coluna são de um tipo de dados diferente

Filtrar tabela de dados

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

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

Além disso, vários filtros são aplicados juntos por meio de 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 padrão	Description
Data table	No	Tabela de dados		A variável da tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.
Filtros a aplicar	No	Regras de filtragem, conforme definido pelo usuário	N/A	Regras de filtragem aplicadas às colunas definidas

Variáveis produzidas

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

Exceções

Exceção	Description
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
Incompatibilidade de tipo nas células de uma coluna	Indica que dois ou mais valores em uma única coluna são de um tipo de dados diferente

Mesclar tabelas de dados

Mescla duas tabelas de dados, especificando o comportamento de mesclagem caso o número de colunas seja diferente.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Primeira tabela de dados	No	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 mesclada
Segunda tabela de dados	No	Tabela de dados		A segunda tabela de dados que é mesclada na primeira tabela de dados
Modo de mesclagem	N/A	Adicionar colunas extras, Ignorar colunas extras, Erro em colunas extras	Adicionar colunas extras	O comportamento de mesclagem que é aplicado quando as tabelas não têm o mesmo número de colunas

Variáveis produzidas

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

Exceções

Exceção	Description
Esquema Ausente	​​Indica que as tabelas de dados não têm o mesmo número de colunas

Ingressar em tabelas de dados

Une duas tabelas de dados com base na regra de junção especificada.

No assistente interno da ação que ajuda a criar as regras de junção necessárias, você pode definir várias regras especificando a coluna da primeira e da segunda tabela de dados adequadamente e o operador de comparação que se aplica entre elas.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Primeira tabela de dados	No	Tabela de dados		A primeira variável de tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.
Segunda tabela de dados	No	Tabela de dados		A segunda variável de tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.
Ingressar na operação	N/A	Interno, Esquerdo, Completo	Interno	A operação de junção usada para unir as duas tabelas
Regras de ingresso	No	Regras de junção, conforme definidas pelo usuário	N/A	Define as colunas e a operação a ser usada para unir as duas tabelas de dados

Variáveis produzidas

Argumento	Type	Description
JoinedDataTable	Tabela de dados	A tabela de dados gerada após a operação de junção

Exceções

Exceção	Description
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

Ler variável de texto do CSV

Gera uma tabela de dados de um texto do CSV.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Texto do CSV	No	Valor do texto		A variável de texto do CSV a ser lida.
Cortar campos	N/A	Valor booliano	Verdadeiro	Especifica se devem ser cortados automaticamente os espaços em branco à esquerda e à direita das células extraídas.
A primeira linha contém os nomes das colunas	N/A	Valor booliano	False	Especifica se deve ser usada a primeira linha do texto do CSV para definir os nomes das colunas da variante da tabela de dados resultante. Habilite essa opção para evitar a leitura dos nomes como dados na tabela. As ações subsequentes podem acessar os dados mantidos pela tabela de dados usando nomes de coluna (em vez de números de coluna).
Obter campos de CSV como texto	N/A	Valor booliano	False	Especifica se o conteúdo dos campos de texto do CSV deve ser recuperado puramente como texto ou como o tipo de correspondência mais próximo. Por exemplo, Data e Hora para datas e Numérico para números.
Separador de colunas	N/A	Predefinida, Personalizada, Larguras de Coluna Fixa	Predefinida	Especifica se deve usar um separador de colunas predefinido, um separador personalizado ou larguras de coluna fixas.
Separador	N/A	Padrão do sistema, Vírgula, Ponto e vírgula, Tabulação	Padrão do sistema	O separador de colunas para analisar o texto do CSV.
Separador personalizado	No	Valor do texto		O separador de colunas personalizado a ser usado para analisar o texto do CSV.
Larguras de coluna fixas	No	Valor do texto		As larguras de coluna fixas a serem usadas para analisar o texto do CSV. Separe as larguras usando vírgulas, espaços, tabulações ou novas linhas.

Variáveis produzidas

Argumento	Type	Description
CSVTable	Tabela de dados	O conteúdo do texto do CSV como uma tabela de dados

Exceções

Exceção	Description
Falha na análise do CSV	​Indica um problema ao analisar o texto do CSV

Converter tabela de dados em texto

Converter uma tabela de dados em um texto do CSV.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Data table	No	Tabela de dados		A variável da tabela de dados com a qual trabalhar. A variável especificada deve ser definida por uma ação que gera uma variável de tabela de dados.
Incluir nomes das colunas	N/A	Valor booliano	False	Especifica se os nomes de coluna da variante especificada devem se tornar a primeira linha do texto do CSV.
Usar separador de colunas personalizado	N/A	Valor booliano	False	Especifica se deve usar um separador de coluna personalizado ou um predefinido.
Separador	N/A	Padrão do sistema, Vírgula, Ponto e vírgula, Tabulação	Padrão do sistema	O separador de colunas a ser usado no texto do CSV especificado.
Separador de colunas personalizado	No	Valor do texto		O separador de colunas personalizado a ser usado no texto do CSV especificado.

Variáveis produzidas

Argumento	Type	Description
CSVText	Valor do texto	A variável na qual o resultado do CSV é armazenado

Exceções

Exceção	Description
Falha na conversão	Indica um problema na conversão da tabela de dados em texto do CSV

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.

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

Exceções

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