Tipos de dados de variável
Quando você cria variáveis em seus fluxos, o Power Automate converte-os em um tipo específico com base em seu conteúdo.
Alguns desses tipos de dados são amplamente usados em todo o aplicativo, como números, enquanto outros, como instâncias do navegador, exigem ações explícitas ou grupos de ações.
Tipos de dados simples
Tipos de dados simples representam valores únicos, como textos e números. Você pode usar esses tipos de dados de forma independente ou usá-los para criar estruturas de dados mais complexas, como listas e tabelas de dados.
Valor do texto
Qualquer tipo de texto, desde endereços de email até o conteúdo de texto de um arquivo .txt.
Propriedades do tipo de dados de texto
Para criar uma variável de Valor do texto, use a ação Definir variável e preencha o parâmetro de entrada com o texto desejado sem qualquer notação.
Valor numérico
Numérico é o tipo aplicado a números. Apenas este tipo de dados pode ser usado em operações matemáticas.
Para criar uma variável de Valor numérico, use a ação Definir variável e preencha o parâmetro de entrada com um número sem qualquer notação.
Exceto para valores numéricos codificados, você pode usar expressões matemáticas com variáveis dentro de sinais de porcentagem. Para obter mais informações sobre as expressões matemáticas, acesse Usar variáveis e a notação %.
Valor booliano
O valor pode ser tanto True ou False.
Para criar uma variável de Valor booliano, use a ação Definir variável e preencha o parâmetro de entrada com as expressões %True% ou %False%.
Além disso, você pode criar expressões complexas usando operadores lógicos, variáveis e a notação de porcentagem. Para obter mais informações sobre as expressões lógicas, acesse Usar variáveis e a notação %.
Tipos de dados avançados
Tipos de dados avançados representam estruturas de dados complexas. Eles funcionam como coleções de outros tipos de dados que você pode acessar como uma entidade.
Lista
Listas são coleções de itens. Dependendo dos tipos de itens de lista individuais, pode haver listas de valores de texto, listas de valores numéricos e assim por diante. O tipo de dados de lista é o equivalente a uma matriz de dimensão única em termos de programação.
Você pode criar uma lista por meio da ação Criar nova lista e adicionar um item a essa lista por meio da ação Adicionar item à lista.
Você também pode criar uma lista por meio de ações que geram listas como saída. Por exemplo, a ação Ler texto do arquivo pode retornar uma lista de valores de texto e a ação Obter arquivos na pasta retorna uma lista de arquivos.
Para recuperar um item específico em uma lista, use a seguinte notação: %VariableName[ItemNumber]%
No exemplo abaixo, o fluxo armazena o primeiro número da lista exibida anteriormente em uma nova variável. Lembre-se de que o índice deve ser 0 para o primeiro item da lista.
Uma prática comum é usar uma ação Para cada para iterar por meio dos itens de uma lista.
Se você precisar acessar apenas uma parte específica de uma lista, use a notação %VariableName[StartIndex:StopIndex]%. Por exemplo, a expressão %List[2:4]% recupera o terceiro e o quarto item da lista. O item na posição StopIndex é o limite da divisão e não é recuperado.
Para segmentar uma lista desde o início até um item específico, não defina um valor StartIndex, por exemplo, %List[:4]%. Para segmentar uma lista de um índice específico até o fim, não defina um valor StopIndex, por exemplo, %List[2:]%.
Listar propriedades do tipo de dados
Datatable
As tabelas de dados contêm dados em um formato tabular e são equivalentes a matrizes bidimensionais em termos de programação.
Uma tabela de dados contém linhas e colunas que descrevem a posição de cada item de maneira única. As tabelas de dados podem ser consideradas listas que contêm linhas de dados como itens.
O Power Automate fornece a ação Criar nova tabela de dados para gerar novas tabelas de dados. Após implantar a ação, você pode usar o construtor visual para preencher valores e renomear os cabeçalhos de coluna.
Além da ação Criar nova tabela de dados, três outras ações produzem tabelas de dados para armazenar dados extraídos: as ações Ler da planilha do Excel, Executar a instrução SQL e Extrair dados da página da Web.
Além disso, você pode criar uma tabela de dados usando a ação Definir variável e a notação de matriz de programação. Essa notação consiste em várias matrizes unidimensionais separadas por vírgulas e entre colchetes. A expressão final deve ter o seguinte formato: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.
Se deseja adicionar cabeçalhos de coluna ao criar uma nova tabela de dados por meio da notação de matriz, use a expressão ^['ColumnName1', 'ColumnName2'] para a primeira linha.
Para adicionar uma nova linha a uma tabela existente, use a ação Inserir linha na tabela de dados. Outra opção é criar uma expressão que contém o nome da variável da tabela de dados, um caractere de adição (+) e os valores que você deseja adicionar entre colchetes.
Além de inserir linhas em tabelas de dados, os fluxos da área de trabalho oferecem várias ações que manipulam tabelas de dados. Você pode encontrar uma lista completa com todas essas ações na referência de ações de variáveis.
Para recuperar um item específico de uma tabela de dados, use a seguinte notação: %VariableName[RowNumber][ColumnNumber]%. Tenha em mente que o RowNumber e a ColumnNumber deve ser 0 para o primeiro item (linha ou coluna).
Por exemplo, suponha que um fluxo recupere o conteúdo de uma planilha do Excel e o armazene na variável ExcelData. Para acessar a primeira célula na segunda linha da tabela recuperada, use a expressão exibida abaixo.
Observação
A variável ExcelData contém uma tabela de valores extraída de uma planilha do Excel usando a ação Ler da planilha do Excel. Ele contém alguns valores de uma planilha específica e não o arquivo inteiro do Excel.
Se você deseja acessar uma coluna específica em uma tabela de dados que contém cabeçalhos de coluna, use a notação %ExcelData [rowNumber]['ColumnName']%.
Se você percorrer uma tabela de dados com uma ação Para Cada, a variável que contém os dados da iteração atual é considerada uma linha de dados.
Da mesma forma que as listas, você usa a notação %VariableName[StartRow:StopRow]% para acessar uma parte específica de uma tabela de dados. A expressão recupera apenas as linhas definidas pelos dois índices, enquanto a posição StopRow é o limite da divisão e não é recuperada.
Para segmentar uma tabela de dados da primeira linha até uma linha específica, não use um valor StartRow, por exemplo, %Datatable[:4]%. Da mesma forma, para segmentar uma tabela de dados de uma linha específica até o final, não use um valor StopRow, por exemplo, %Datatable[2:]%.
Propriedades do tipo de dados da tabela de dados
Linha de dados
Uma linha de dados contém os valores de uma única linha de uma tabela de dados. Quando você percorre uma tabela de dados com uma ação For Each, a variável que contém os dados da iteração atual é uma linha de dados.
Para recuperar um item específico de uma linha de dados, use a seguinte notação: %VariableName[ItemNumber]%
Ou você pode usar a notação %VariableName['ColumnName']%. O nome de cada coluna é definido pela tabela de dados da qual você recuperou a linha de dados.
Propriedades do tipo de dados da linha de dados
Objeto personalizado
Contém pares de propriedades e valores, que podem ser facilmente convertidos para o formato JSON.
Para criar um Objeto personalizado vazio, use a ação Definir variável e preencha a seguinte expressão %{{ }}%. Para criar um novo Objeto personalizado e inicializá-lo com propriedades e valores, use uma expressão da seguinte estrutura: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.
Importante
Palavras-chave reservadas não podem ser usadas como propriedades de objetos personalizados. Para ver a lista completa de palavras-chave reservadas, acesse Palavras-chave reservadas em fluxos da área de trabalho.
Para atualizar o valor de uma propriedade existente ou adicionar uma nova, implemente uma ação Definir variável, preencha o nome da propriedade no campo Definir e insira seu valor no campo Para.
Além de valores literais, você pode usar variáveis para definir dinamicamente as propriedades e os valores de objetos personalizados. Por exemplo, o fluxo a seguir usa duas variáveis para adicionar uma nova propriedade a um novo objeto personalizado vazio.
Objeto do conector
Os objetos do conector armazenam informações dos conectores de nuvem e funcionam de maneira semelhante aos objetos personalizados. Suas propriedades geralmente contêm listas de outros objetos de conector. O acesso a valores funciona como em objetos personalizados, embora o acesso a valores aninhados possa exigir expressões mais complicadas.
Lista de informações da tabela PDF
Uma variável deste tipo de dados pode ser produzida somente por meio da ação Extrair tabelas do PDF.
Cada item da lista descreve uma tabela extraída e fornece todas as informações essenciais sobre ela. Para acessar um item de informação específico da tabela de dados, use a notação %VariableName[ItemNumber]%.
Cada item da lista fornece quatro propriedades que permitem obter um detalhe específico de forma independente. As propriedades disponíveis são as seguintes:
- DataTable – retorna a tabela extraída.
- TableStartingPage – retorna o índice da página do arquivo que contém o início da tabela.
- TableEndingPage – retorna o índice da página do arquivo que contém o final da tabela.
- TableOrderInPage – retorna a ordem da tabela na página.
Você pode encontrar mais informações sobre as propriedades desse tipo de dados em Propriedades do tipo de dados de variáveis.
Para acessar o valor de uma propriedade específica, use a notação %VariableName[ItemNumber].PropertyName%. Por exemplo, a seguinte expressão retorna o valor da tabela de dados do primeiro item da variável ExtractedPDFTables.
Limitações e problemas conhecidos
- Problema: quando uma célula de tabela de dados ou linha de dados contém uma entrada de várias linhas, o visualizador de variáveis exibe somente a primeira linha dela.
- Soluções alternativas:: nenhuma.
Instâncias
Instância do navegador da Web: contém uma instância do navegador criada por meio de Lançar novo Internet Explorer ou outras ações de inicialização do navegador.
Propriedades do tipo de dados da instância do navegador da Web
Instância da janela - Contém uma instância de janela criada por meio da ação Obter janela.
Instância do Excel - Contém uma instância do Excel criada por meio da ação Iniciar o Excel.
Instância do Outlook – Contém uma instância do Outlook criada por meio da ação Iniciar o Outlook.
Conexões
Conexão SQL - Contém uma conexão com um banco de dados SQL estabelecido por meio da ação Abrir conexão SQL.
Conexão do Exchange – Contém uma conexão com um servidor Exchange estabelecida por meio da ação Conectar-se ao servidor Exchange.
Conexão FTP – Contém uma conexão FTP criada por meio das ações Abrir conexão FTP e Abrir conexão FTP segura.
Outros
Esta seção apresenta todos os tipos de dados disponíveis que não pertencem a nenhuma das categorias anteriores.
Valor geral
- Valor geral – Este tipo de dados é usado durante o tempo de design quando o Power Automate não pode definir o tipo de dados de um parâmetro de entrada ou variável. Os valores gerais são convertidos em outros tipos de dados durante o tempo de execução com base em seus dados.
Active Directory
- Entrada do Active Directory – Contém uma conexão com um servidor Active Directory estabelecida por meio da ação Conectar-se ao servidor.
- Informações do grupo – Contém o nome, o nome de exibição, uma descrição e os membros de um grupo especificado do Active Directory.
- Membro do grupo – Representa um membro de um grupo especificado do Active Directory.
- Informação de usuário - Contém informações sobre um usuário especificado do Active Directory, como nome e sobrenome, iniciais e um nome diferenciado, detalhes de trabalho (empresa, departamento e cargo), informações de contato (número de telefone, ramal e email) e local (país/região, cidade, estado, endereço e código postal).
Propriedades de tipo de dados do Active Directory
Amazon Web Services (AWS)
- Cliente do EC2 – Contém uma sessão do EC2 criada por meio da ação Criar sessão do EC2.
- Instância do EC2 – Representa uma instância do EC2 recuperada.
- Informações de instâncias do EC2 – Contém informações sobre uma instância do EC2.
- Alteração de estado da instância – Contém informações sobre uma instância do EC2 que foi iniciada ou interrompida.
- Instantâneo do EBS – Representa um instantâneo do EBS.
- Volume do EBS – Representa um volume do EBS.
Propriedades de tipos de dados da AWS
Azure
- Cliente do Azure – Contém uma sessão do Azure criada por meio da ação Criar sessão.
- Grupo de recursos do Azure – Representa um grupo de recursos do Azure recuperado.
- Disco gerenciado do Azure – Representa um disco do Azure recuperado.
- Instantâneo do Azure – Representa um instantâneo do Azure.
- Máquina virtual do Azure – Representa uma máquina virtual do Azure recuperada.
- Informações da máquina virtual do Azure – Contém informações sobre uma máquina virtual do Azure.
- Assinatura do Azure – Representa uma assinatura recuperada do Azure.
Propriedades do tipo de dados do Azure
CMD
- Sessão de CMD – Contém uma sessão de CMD criada por meio da ação Abrir sessão de CMD.
Propriedades de tipos de dados da CMD
Data e hora
Data hora – Contém informações de data e hora. Para criar uma variável datetime por meio da ação Definir Variável, preencha o parâmetro de entrada com as expressões %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, em que:
Notação Descrição yyyy Ano MM Mês dd Dia HH Hora mm Minutos ss Segundos ff Milissegundos zzz Diferença UTC Por exemplo, %d"2022-03-25"% atribui a data de 25 de março de 2022 à variável de destino.
Propriedades de tipo de dados de datas e hora
- Mensagem de email – Representa uma mensagem de email. A ação Recuperar e-mails preenche essas variáveis.
Propriedades do tipo de dados do e-mail
Exchange
- Mensagem de email do Exchange – Representa uma mensagem de email recuperada de um servidor Exchange. A ação Recuperar mensagens de email do Exchange preenche essas variáveis.
Propriedades do tipo de dados do Exchange
Arquivos e pastas
- Arquivo – Representa um arquivo.
- Pasta – Representa uma pasta.
- FileSystemObject – Representa uma pasta ou um arquivo. Esse tipo de dados é usado em parâmetros de entrada que aceitam pastas e arquivos.
Propriedades de tipo de dados de arquivos e pastas
FTP
- Arquivo FTP – Representa um arquivo FTP.
- Diretório FTP – Representa um diretório FTP
Propriedades de tipos de dados da FTP
OCR
- Mecanismo OCR - Contém um mecanismo OCR criado por meio da ação Criar mecanismo do OCR.
Outlook
- Mensagem de email do Outlook – Representa uma mensagem de email do Outlook. A ação Recuperar mensagens de email do Outlook preenche essas variáveis.
Propriedades do tipo de dados do Outlook
Terminal
- Sessão do terminal – Contém uma sessão do terminal criada por meio da ação Abrir sessão do terminal.
Propriedades do tipo de dados do terminal
XML
- Nó XML – Contém o conteúdo de um documento XML. A ação Ler XML do arquivo preenche essas variáveis.
Propriedades de tipos de dados da XML
Error
- Erro – Contém informações sobre o último erro ocorrido no fluxo da área de trabalho. A ação Obter o último erro cria este tipo de variável.