Partilhar via


Tipos de dados de variáveis

Quando cria variáveis nos seus fluxos, o Power Automate converte-as num tipo específico baseado no seu conteúdo.

Alguns destes tipos de dados são amplamente utilizados ao longo da aplicação, tais como números, enquanto outros, como instâncias de browser, necessitam de ações explícitas ou grupos de ações.

Tipos de dados simples

Os tipos de dados simples representam valores individuais, tais como textos e números. Pode utilizar estes tipos de dados independentemente ou utilizá-los para criar estruturas de dados mais complexas, tais como listas e tabelas de dados.

Valor de texto

Isto é qualquer tipo de texto, desde endereços de e-mail até aos conteúdos de texto de um ficheiro .txt.

Propriedades de tipo de dados de texto

Para criar uma variável Valor de texto, utilize a ação Definir variável e povoe o parâmetro de entrada com o texto desejado sem qualquer notação.

Captura de ecrã de uma ação Definir variável que cria uma variável de valor de texto.

Valor numérico

Numérico é o tipo aplicado a números. Apenas este tipo de dados pode ser utilizado em operações matemáticas.

Para criar uma variável Valor numérico, utilize a ação Definir variável e povoe o parâmetro de entrada com um número sem qualquer notação.

Com a exceção dos valores numéricos codificados, pode usar expressões matemáticas com variáveis entre sinais percentuais. Para mais informações sobre as expressões matemáticas, aceda a Utilizar variáveis e a notação %.

Captura de ecrã de uma ação Definir variável que cria uma variável de valor Numérico.

Valor booleano

O valor pode ser True ou False.

Para criar uma variável Valor booleano, utilize a ação Definir variável e preencha o parâmetro de entrada com as expressões %True% ou %False%.

Além disso, pode criar expressões complexas utilizando operadores lógicos, variáveis e a notação de percentagem. Para mais informações sobre as expressões lógicas, aceda a Utilizar variáveis e a notação %.

Captura de ecrã de uma ação Definir variável que cria uma variável de valor Booleano.

Tipos de dados avançados

Os tipos de dados avançados representam estruturas de dados complexas. Funcionam como coleções de outros tipos de dados aos quais pode aceder como uma entidade.

Lista

As listas são coleções de itens. Consoante os tipos de itens de lista individuais, poderão existir listas de valores de texto, listas de valores numéricos, etc. O tipo de dados de lista é o equivalente a uma matriz de dimensão única em termos de programação.

Pode criar uma lista através da ação Criar nova lista e adicionar um item a essa lista através da açãoAdicionar item à lista.

Captura de ecrã de um fluxo que cria uma lista.

Também pode criar uma lista através de ações que geram listas como saída. Por exemplo, a ação Ler texto a partir de ficheiro pode devolver uma lista de valores de texto e a ação Obter ficheiros na pasta devolve uma lista de ficheiros.

Para obter um item específico numa lista, utilize a seguinte notação: %VariableName[ItemNumber]%

No exemplo abaixo, o fluxo armazena o primeiro número da lista apresentada anteriormente para uma nova variável. Tenha em mente que o índice deve ser 0 para o primeiro item da lista.

Captura de ecrã de uma expressão que acede ao primeiro item de uma lista.

Uma prática comum é usar uma ação For each para iterar através dos itens de uma lista.

Se precisar de aceder apenas a uma parte específica de uma lista, utilize a notação %VariableName[StartIndex:StopIndex]%. Por exemplo, a expressão %List[2:4]% obtém o terceiro e o quarto itens da lista. O item na posição StopIndex é o limite da segmentação e não é obtido.

Para segmentar uma lista desde o início para um item específico, não defina um valor StartIndex, por exemplo, %List[:4]%. Para segmentar uma lista a partir de um índice até ao final, não defina um valor StopIndex, por exemplo, %List[2:]%.

Propriedades de tipo de dados de lista

Tabela de dados

As tabelas de dados contêm dados num formato tabular e são o equivalente 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 forma exclusiva. As fichas de dados podem ser consideradas como listas que contêm datarows como itens.

Captura de ecrã do conteúdo de uma variável de tabela de dados.

O Power Automate fornece a ação Criar novas tabelas de dados para gerar novas tabelas de dados. Depois de implementar a ação, pode utilizar o construtor visual para preencher os valores e mudar o nome dos cabeçalhos de coluna.

Captura de ecrã do construtor visual da ação Criar nova tabela de dados.

Além da ação Criar nova tabela de dados, mais três ações produzem tabelas de dados para armazenar os dados extraídos: as ações Ler a partir da folha de cálculo do Excel, Executar instrução SQL e Extrair dados a partir de uma página Web.

Além disso, pode criar uma tabela de dados utilizando a ação Definir variável e a notação da matriz de programação. Esta notação é composta por várias matrizes de dimensão única separadas por vírgulas e entre chavetas. A expressão final tem de ter o seguinte formato: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Captura de ecrã de uma ação Definir variável que cria uma tabela de dados.

Se pretender adicionar cabeçalhos de coluna enquanto cria uma nova tabela de dados através da notação da matriz, utilize a expressão ^['ColumnName1', 'ColumnName2'] para a primeira linha.

Captura de ecrã de uma ação Definir variável que cria uma nova tabela de dados com cabeçalhos de coluna.

Para adicionar uma nova linha a uma tabela existente, utilize a ação Inserir linha numa tabela de dados. Em alternativa, crie uma expressão que contenha o nome variável da tabela de dados, um caráter de adição (+) e os valores que pretende adicionar entre parênteses.

Captura de ecrã de uma ação Definir variável que adiciona uma nova linha a uma tabela de dados.

Além de inserir linhas em tabelas de dados, os fluxos de ambiente de trabalho oferecem várias ações que manipulam tabelas de dados. Pode encontrar uma lista completa com estas ações na referência de ações de variáveis.

Para obter um item específico de uma tabela de dados, utilize a seguinte notação: %VariableName[RowNumber][ColumnNumber]%. Tenha em mente que RowNumber e ColumnNumber devem ser 0 para o primeiro item (linha ou coluna).

Por exemplo, suponha que um fluxo obtém o conteúdo de uma folha de cálculo do Excel e a armazena na variável ExcelData. Para aceder à primeira célula na segunda linha da tabela obtida, utilize a expressão apresentada abaixo.

Captura de ecrã de uma expressão que acede à segunda célula da primeira linha de um ficheiro Excel lido.

Nota

A variável ExcelData contém uma tabela de valores extraídos de uma folha de cálculo do Excel utilizando a ação Ler a partir da folha de cálculo do Excel. Contém alguns valores de uma folha de cálculo específica e não de todo o ficheiro Excel.

Se pretende aceder a uma coluna específica numa tabela de dados que contenha cabeçalhos de coluna, utilize a notação %ExcelData[rowNumber]['ColumnName']%.

Se efetuar o ciclo de uma tabela de dados com uma ação For Each, a variável que contém os dados da iteração atual são considerados para serem uma linha de dados.

Do mesmo modo que as listas utilizam a notação %VariableName[StartRow:StopRow]% para aceder a uma parte específica de uma tabela de dados. A expressão só obtém as linhas definidas pelos dois índices, enquanto a posição StopRow é o limite da segmentação e não é obtida.

Para segmentar uma tabela de dados desde a primeira linha para uma linha específica, não utilize um valor StartRow, por exemplo, %Datatable[:4]%. Da forma semelhante, para segmentar uma tabela de dados para uma linha específica até ao final, não utilize um valor StopRow, por exemplo, %Datatable[2:]%.

Propriedades de tipo de dados de tabela de dados

Linha de dados

Um linha de dados contém os valores de uma única linha de uma tabela de dados. Quando se faz um loop através de 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 obter um item específico de uma tabela de dados, utilize a seguinte notação: %VariableName[ItemNumber]%

Em alternativa, pode utilizar a notação %VariableName['ColumnName']%. O nome de cada coluna é definido pela tabela de dados a partir da qual recuperou a linha de dados.

Propriedades de tipo de dados de linha de dados

Captura de ecrã do conteúdo de uma variável de linha de dados.

Objeto personalizado

Contém pares de propriedades e valores, que podem ser convertidos facilmente para o formato JSON.

Para criar um novo Objeto personalizado vazio, utilize 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, utilize uma expressão da seguinte estrutura: %{ 'Propriedade1': 'Valor1', 'Propriedade2': 'Valor2', 'Propriedade3': 'Valor2' }%.

Captura de ecrã de uma ação Definir variável que cria um novo objeto personalizado.

Importante

As palavras-chave reservadas não podem ser usadas como propriedades de objeto personalizado. Para ver a lista completa de palavras-chave reservadas, aceda a Palavras-chave reservadas em fluxos de ambiente de trabalho.

Para atualizar o valor de uma propriedade existente ou adicionar um novo, implemente uma ação Definir variável, povoe o nome da propriedade no campo Definir e introduza o respetivo valor no campo Para.

Captura de ecrã de uma ação Definir variável que adiciona uma nova propriedade a um objeto personalizado.

Além dos valores literais, pode utilizar variáveis para definir dinamicamente as propriedades e valores de objetos personalizados. Por exemplo, o fluxo a seguir utiliza duas variáveis para adicionar uma nova propriedade a um novo objeto personalizado vazio.

Captura de ecrã de um fluxo que utiliza variáveis para adicionar uma nova propriedade a um objeto personalizado.

Objeto de conector

Os objetos do conector armazenam informações a partir de conectores de cloud e funcionam de modo semelhante aos objetos personalizados. Normalmente, as propriedades deles contêm listas de outros objetos conectores. O acesso a valores funciona como em objetos personalizados, embora o acesso a valores aninhados possa exigir expressões mais complicadas.

Captura de ecrã de uma variável de objeto personalizado no visualizador de variáveis.

Lista de informações de tabela PDF

Uma variável deste tipo de dados só pode ser produzida através da ação Extrair tabelas do PDF.

Cada item na lista descreve uma tabela extraída e fornece todas as informações essenciais sobre o mesmo. Para aceder a um item de informação específica da tabela de dados, utilize a notação %VariableName[ItemNumber]%.

Captura de ecrã de uma Lista de informações de tabela PDF.

Cada item da lista fornece quatro propriedades que lhe permitem obter um detalhe específico de forma independente. Seguem-se as propriedades disponíveis:

  • DataTable – Obtém a tabela extraída.
  • TableStartingPage – Obtém o índice da página de ficheiro que contém o início da tabela.
  • TableEndingPage – Obtém o índice da página de ficheiro que contém o final da tabela.
  • TableOrderInPage – Obtém a ordem da tabela na página.

Pode encontrar mais informações sobre as propriedades deste tipo de dados em Propriedades do tipo de dados das variáveis.

Captura de ecrã das propriedades de uma Lista de informações de tabela PDF.

Para aceder ao valor de uma propriedade específica, utilize a notificação %VariableName[ItemNumber].PropertyName%. Por exemplo, a expressão a seguir devolve o valor de tabela de dados do primeiro item da variável ExtractedPDFTables.

Captura de ecrã da tabela de dados contida numa lista de variáveis de informações de tabela PDF.

Problemas e limitações conhecidos

  • Problema: quando uma célula datável ou datarow contém uma entrada multilinha, o visualizador da variável apresenta apenas a primeira linha do mesmo.
  • Soluções: nenhuma.

Instâncias

Ligações

Outras

Esta secçã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 é utilizado durante o tempo de conceção quando o Power Automate não consegue definir o tipo de dados de uma variável ou parâmetro de entrada. Os valores gerais são convertidos noutros tipos de dados durante o runtime com base nos respetivos dados.

Active Directory

  • Entrada do Active Directory – Contém uma ligação a um servidor do Active Directory estabelecida através da ação Ligar ao servidor.
  • Informações do grupo – Contém o nome, o nome a apresentar, uma descrição e os membros de um grupo do Active Directory especificado.
  • Membro do grupo – Representa um membro de um grupo especificado do Active Directory.
  • Informações de utilizador – Contém informações sobre um utilizador especificado do Active Directory, tais como o nome próprio e o apelido, iniciais e um nome único, detalhes de trabalho (empresa, departamento e título), informações de contacto (número de telefone, extensão e e-mail) e localização (país/região, localidade, estado, rua e código postal).

Propriedades de tipo de dados do Active Directory

Amazon Web Services (AWS)

  • Cliente EC2 – Contém uma sessão do EC2 criada através da ação Criar sessão EC2.
  • Instância EC2 – Representa uma instância do EC2 obtida.
  • Informações das instâncias do EC2 – Contém informações sobre uma instância do EC2.
  • Alteração do estado da instância – Contém informações sobre uma instância do EC2 que foi iniciada ou parada.
  • Instantâneo do EBS – Representa um Instantâneo do EBS.
  • Volume do EBS – Representa um Volume do EBS.

Propriedades do tipo de dados AWS

Azure

  • Cliente Azure – Contém uma sessão do Azure criada através da ação Criar sessão.
  • Grupo de recursos do Azure – Representa um grupo de recursos do Azure obtido.
  • Disco gerido do Azure – Representa um disco do Azure obtido.
  • Instantâneo do Azure – Representa um instantâneo do Azure.
  • Máquina virtual do Azure – Representa uma máquina virtual do Azure obtida.
  • Informações da máquina virtual do Azure – Contém informações sobre uma máquina virtual do Azure.
  • Subscrição do Azure – Representa uma subscrição do Azure obtida.

Propriedades de tipo de dados do Azure

CMD

  • Sessão CMD – Contém uma sessão do CMD criada através da ação Abrir sessão CMD.

Propriedades do tipo de dados CMD

Credentials

  • Credencial – Contém uma credencial obtida por meio da ação Obter credencial (pré-visualização).

Propriedades de tipo de dados da credencial

Datas e hora

  • Datetime – Contém informações de data e hora. Para criar uma variável datetime através da ação Definir Variável, povoe o parâmetro de entrada com as expressões %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, em que:

    Anotações Descrição
    yyyy Ano
    MM Mês
    dd Dia
    HH Hora
    mm Minutos
    ss Segundos
    ff Milissegundos
    zzz Desvio UTC

    Por exemplo, %d"2022-03-25"% atribui a data de 25 de março de 2022 à variável de destino.

Propriedades do tipo de dados datas e hora

Email

  • Mensagem de correio – Representa uma mensagem de e-mail. A ação Obter e-mails povoa estas variáveis.

Propriedades de tipo de dados de e-mail

Exchange

  • Mensagem de correio do Exchange – Representa uma mensagem de e-mail obtida a partir de um servidor Exchange. A ação Obter mensagens de e-mail do Exchange povoa estas variáveis.

Propriedades de tipo de dados do Exchange

Ficheiros e pastas

  • Ficheiro – Representa um ficheiro.
  • Pasta – Representa uma pasta.
  • FileSystemObject – Representa uma pasta ou um ficheiro. Este tipo de dados é utilizado em parâmetros de entrada que aceitem pastas e ficheiros.

Propriedades do tipo de dados de ficheiros e pastas

FTP

  • Ficheiro FTP – Representa um ficheiro FTP.
  • Diretório FTP – Representa um diretório FTP

Propriedades do tipo de dados FTP

OCR

  • Motor de OCR – Contém um motor de OCR criado através da ação Criar motor de OCR.

Outlook

  • Mensagem de correio do Outlook – Representa uma mensagem de e-mail do Outlook. A ação Obter mensagens de e-mail do Outlook povoa estas variáveis.

Propriedades de tipo de dados do Outlook

Terminal

  • Sessão de terminal – Contém uma sessão de terminal criada através da ação Abrir sessão de terminal.

Propriedades de tipo de dados de Terminal

XML

  • Nó XML – Contém o conteúdo de um documento XML. A ação Ler XML a partir de ficheiro povoa estas variáveis.

Propriedades do tipo de dados XML

Erro

  • Erro – Contém informações sobre o último erro ocorrido no fluxo de ambiente de trabalho. A ação Obter o último erro cria este tipo de variável.

Propriedades do erro