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 | Descrição |
---|---|---|---|---|
Nova tabela | Não | Datatable | A tabela de dados de entrada |
Variáveis produzidas
Argumento | Type | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | 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 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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | 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 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 | Descrição |
---|---|---|---|---|
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 | 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 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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
JoinedDataTable | Tabela de dados | A tabela de dados gerada após a operação de junçã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 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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
CSVTable | Tabela de dados | O conteúdo do texto do CSV como uma tabela de dados |
Exceções
Exceção | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
CSVText | Valor do texto | A variável na qual o resultado do CSV é armazenado |
Exceções
Exceção | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | 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 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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | 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 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 | Descrição |
---|---|---|---|---|
Objeto personalizado | Não | Objeto personalizado | O objeto personalizado a ser convertido em JSON |
Variáveis produzidas
Argumento | Type | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
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 | Descrição |
---|---|---|---|---|
To | Não | * | O valor a ser atribuído à variável |
Variáveis produzidas
Argumento | Type | Descrição |
---|---|---|
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.