Tipos de dados avançados

Concluído

Embora você possa tratar a maioria dos tipos de dados do Power Automate para desktop de maneira semelhante, alguns tipos de dados precisam de tratamento distintivo. Nesta unidade, examinaremos esses tipos de dados avançados que precisam de tratamento especial.

Listas

Se você deseja armazenar um alto volume de informações do mesmo tipo de dados, a melhor maneira de conseguir isso é por meio de listas.

Listas são coleções de itens que você pode fazer referência como um grupo. Dependendo dos itens individuais, você pode criar listas de valores de texto, números, arquivos etc.

O tipo de dados lista é o equivalente a uma matriz de dimensão única em termos de programação e funciona praticamente da mesma forma.

Captura de tela de uma variável de lista que contém pastas.

Você pode criar listas por meio da ação Criar nova lista e adicionar itens a essa lista por meio da ação Adicionar item à lista.

Captura de tela da ação Criar nova lista.

Você também pode criar listas por meio de ações que geram listas como saída, como a ação Obter arquivos na pasta que retorna uma lista de arquivos.

Se desejar recuperar um item específico de uma lista, você poderá usar a seguinte notação: %VariableName[ItemNumber]%.

Por exemplo, você pode renomear a primeira pasta da lista de pastas exibida anteriormente usando a ação a seguir. Lembre-se de que o valor de ItemNumber deve ser 0 para o primeiro item da lista.

Captura de tela da notação para acessar o primeiro item de uma lista.

Observação

Se você deseja iterar por meio dos itens de uma lista, uma prática comum é implantar uma ação For each.

Tabelas de dados

Se você deseja armazenar dados estruturados em um formato tabular, o Power Automate para área de trabalho fornece as tabelas de dados.

Uma tabela de dados contém linhas e colunas, e cada item armazenado nela pode ser recuperado por meio do número exclusivo de linha e coluna. Considere as tabelas de dados como listas que têm outras listas como itens.

As tabelas de dados são o equivalente a uma matriz bidimensional em termos de programação e funciona praticamente da mesma forma.

Captura de tela de uma tabela do Excel que contém produtos e preços.

Não há uma forma direta de criar uma tabela de dados, mas você pode gerar tabelas de dados por meio das ações Ler do Excel e Executar instrução SQL.

Se quiser recuperar um item específico da tabela de dados, você poderá usar a seguinte notação: %VariableName[RowNumber][ColumnNumber]%.

Por exemplo, você pode salvar o preço do primeiro produto dentro de uma nova variável usando a ação a seguir. Lembre-se de que o valor de RowNumber e ColumnNumber deve ser 0 para o primeiro item da lista.

Captura de tela da notação para acessar um elemento da tabela.

Observação

Se você executar um loop em uma tabela de dados com uma ação For each, a variável que contém os dados da iteração atual será uma linha de dados.

Formato JSON — objetos personalizados

Se você deseja usar dados no formato JSON em seus fluxos, o Power Automate para área de trabalho fornece os objetos personalizados.

Os objetos personalizados têm uma estrutura semelhante para JSON e são compostos de objetos e matrizes.

Os objetos são pares de nome/valor não ordenados entre chaves e separados por vírgulas. Por exemplo, o seguinte objeto contém dois pares de nomes e valores { "firstName": "John", "lastName": "Michael" }.

As matrizes são coleções ordenadas de valores entre colchetes e separados por vírgulas. Por exemplo, a matriz a seguir contém quatro números [1,2,3,4].

A combinação dessas duas estruturas permite que você crie listas ordenadas de pares de nome/valor.

Captura de tela de um bloco JSON como parâmetro na ação Converter JSON em objeto personalizado.

Você pode acessar valores de objetos individuais usando a notação de ponto (.) (Object.PropertyName) ou a notação de colchete ([]) (Object["PropertyName"]).

Captura de tela da notação para acessar um elemento JSON.

Se desejar converter variáveis entre os tipos de dados JSON e objetos personalizados, você poderá usar as ações Converter objeto personalizado em JSON e Converter JSON em objeto personalizado.