Compartir por

Tipos de datos de variables

  • Artigo

Cando creas variables nos teus fluxos, Power Automate convérteas nun tipo específico en función do seu contido.

Algúns destes tipos de datos úsanse amplamente en toda a aplicación, como números, mentres que outros, como instancias de navegador, requiren accións explícitas ou grupos de accións.

Tipos de datos sinxelos

Os tipos de datos sinxelos representan valores únicos, como textos e números. Podes usar estes tipos de datos de forma independente ou utilizalos para crear estruturas de datos máis complexas, como listas e táboas de datos.

Valor de texto

Este é calquera tipo de texto, desde enderezos de correo electrónico ata o contido de texto dun ficheiro .txt.

Propiedades do tipo de datos de texto

Para crear unha variable Valor de texto , use a acción Establecer variable e enche o parámetro de entrada co texto desexado sen calquera notación.

Captura de pantalla dunha acción Establecer variable que crea unha variable de valor de texto.

Valor numérico

Numérico é o tipo aplicado aos números. Só este tipo de datos se pode usar en operacións matemáticas.

Para crear unha variable Valor numérico , use a acción Establecer variable e enche o parámetro de entrada cun número sen ningún cualificación.

Agás para os valores numéricos codificados, pode usar expresións matemáticas con variables dentro de signos de porcentaxe. Para obter máis información sobre expresións matemáticas, vai a Usar variables e a notación %.

Captura de pantalla dunha acción Establecer variable que crea unha variable de valor numérico.

Valor booleano

O valor pode ser Verdadero ou Falso.

Para crear unha variable Valor booleano , use a acción Establecer variable e enche o parámetro de entrada coas expresións %True% ou %False%.

Ademais, pode crear expresións complexas utilizando operadores lóxicos, variables e a notación porcentual. Para obter máis información sobre expresións lóxicas, vai a Usar variables e a notación %.

Captura de pantalla dunha acción Establecer variable que crea unha variable de valor booleano.

Tipos de datos avanzados

Os tipos de datos avanzados representan estruturas de datos complexas. Funcionan como coleccións doutros tipos de datos aos que pode acceder como unha única entidade.

Lista

As listas son coleccións de elementos. Dependendo dos tipos de elementos individuais da lista, pode haber listas de valores de texto, listas de valores numéricos, etc. O tipo de datos da lista é o equivalente a unha matriz de dimensión única en termos de programación.

Podes crear unha lista mediante a acción Crear unha nova lista e engadir un elemento a esa lista mediante a Engadir elemento á lista acción.

Captura de pantalla dun fluxo que crea unha lista.

Tamén pode crear unha lista mediante accións que xeran listas como saída. Por exemplo, a acción Ler texto do ficheiro pode devolver unha lista de valores de texto e a Obter ficheiros no cartafol acción devolve unha lista de ficheiros.

Para recuperar un elemento específico dunha lista, use a seguinte notación: %VariableName[ItemNumber]%

No seguinte exemplo, o fluxo almacena o primeiro número da lista mostrada anteriormente nunha nova variable. Teña en conta que o índice debe ser 0 para o primeiro elemento da lista.

Captura de pantalla dunha expresión que accede ao primeiro elemento dunha lista.

Unha práctica habitual é utilizar unha Para cada acción para iterar polos elementos dunha lista.

Se precisa acceder só a unha parte específica dunha lista, use a notación %VariableName[StartIndex:StopIndex]% . Por exemplo, a expresión %List[2:4]% recupera o terceiro e o cuarto elementos da lista. O elemento na posición StopIndex é o límite do corte e non se recupera.

Para dividir unha lista desde o principio ata un elemento específico, non estableza un valor StartIndex , por exemplo, %List[:4] %. Para dividir unha lista desde un índice específico ata o final, non estableza un valor StopIndex , por exemplo, %List[2:] %.

Lista de propiedades do tipo de datos

Táboa de datos

As táboas de datos conteñen datos en forma tabular e son o equivalente a matrices bidimensionais en termos de programación.

Unha táboa de datos contén filas e columnas que describen a posición de cada elemento de forma única. As táboas de datos pódense considerar como listas que conteñen filas de datos como elementos.

Captura de pantalla do contido dunha variable da táboa de datos.

Power Automate ofrece a acción Crear nova táboa de datos para xerar novas táboas de datos. Despois de implementar a acción, pode usar o creador visual para encher valores e renomear as cabeceiras das columnas.

Captura de pantalla do creador visual da acción Crear unha nova táboa de datos.

Ademais da acción Crear nova táboa de datos , tres accións máis producen táboas de datos para almacenar os datos extraídos: a Ler desde a folla de cálculo de Excel, Executar instrución SQL e Extraer datos das accións da páxina web .

Ademais, pode crear unha táboa de datos mediante a acción Establecer variable e a notación de matriz de programación. Esta notación consta de varias matrices dunha soa dimensión separadas por comas e encerradas entre corchetes. A expresión final debe ter a seguinte forma: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Captura de pantalla da acción Establecer variable que crea unha táboa de datos.

Se desexa engadir cabeceiras de columna ao crear unha nova táboa de datos mediante a notación matricial, use a expresión ^['ColumnName1', 'ColumnName2'] para a primeira fila.

Captura de pantalla dunha acción Establecer variable que crea unha nova táboa de datos con cabeceiras de columna.

Para engadir unha nova fila a unha táboa existente, use a acción Inserir fila na táboa de datos . Como alternativa, cree unha expresión que conteña o nome da variable da táboa de datos, un carácter máis (+) e os valores que quere engadir entre corchetes.

Captura de pantalla dunha acción Establecer variable que engade unha nova fila a unha táboa de datos.

Ademais de inserir filas nas táboas de datos, os fluxos de escritorio ofrecen varias accións que manipulan as táboas de datos. Podes atopar unha lista completa con estas accións na referencia de accións variables.

Para recuperar un elemento específico dunha táboa de datos, use a seguinte notación: %VariableName[RowNumber][ColumnNumber]%. Ten en conta que o RowNumber e o ColumnNumber deben ser 0 para o primeiro elemento (fila ou columna).

Por exemplo, supoña que un fluxo recupera o contido dunha folla de cálculo de Excel e o almacena na variable ExcelData . Para acceder á primeira cela da segunda fila da táboa recuperada, use a expresión que aparece a continuación.

Captura de pantalla dunha expresión que accede á segunda cela da primeira fila dun ficheiro Excel lido.

Nota

A variable ExcelData contén unha táboa de valores extraídas dunha folla de cálculo de Excel mediante a acción Ler desde a folla de cálculo de Excel . Contén algúns valores dunha folla de traballo específica e non o ficheiro Excel completo.

Se queres acceder a unha columna específica dunha táboa de datos que contén cabeceiras de columna, utiliza a notación %ExcelData[rowNumber]['ColumnName']% .

Se recorre unha táboa de datos cunha acción For Each acción, a variable que contén os datos da iteración actual considérase unha fila de datos.

Do mesmo xeito que as listas, usa a notación %VariableName[StartRow:StopRow]% para acceder a unha parte específica dunha táboa de datos. A expresión recupera só as filas definidas polos dous índices, mentres que a StopRow posición é o límite do corte e non se recupera.

Para dividir unha táboa de datos desde a primeira fila a unha fila específica, non use un valor StartRow , por exemplo, %Datatable[:4 ]%. Do mesmo xeito, para dividir unha táboa de datos desde unha fila específica ata o final, non use un valor StopRow , por exemplo, %Datatable[2 :]%.

Propiedades do tipo de datos da táboa de datos

Fila de datos

Unha fila de datos contén os valores dunha única fila dunha táboa de datos. Cando recorre unha táboa de datos cunha acción For Each acción, a variable que contén os datos da iteración actual é unha fila de datos.

Para recuperar un elemento específico dunha fila de datos, use a seguinte notación: %VariableName[ItemNumber]%

Como alternativa, pode utilizar a notación %VariableName['ColumnName']% . O nome de cada columna está definido pola táboa de datos da que obtivo a fila de datos.

Propiedades do tipo de datos da fila de datos

Captura de pantalla do contido dunha variable de fila de datos.

Obxecto personalizado

Contén pares de propiedades e valores, que se poden converter facilmente ao formato JSON.

Para crear un novo obxecto personalizado, utiliza a acción Establecer variable e enche a seguinte expresión %{{ }}%. Para crear un novo obxecto personalizado e inicializalo con propiedades e valores, utiliza unha expresión da seguinte estrutura: %{ 'Propiedade1': 'Valor1', 'Propiedade2': 'Valor2', 'Propiedade3': 'Valor2' }.

Captura de pantalla de Set acción variable que crea un novo obxecto personalizado.

Importante

As palabras clave reservadas non se poden usar como propiedades de obxectos personalizados. Para a lista completa de palabras clave reservadas vai a Reserved keywords nos fluxos de escritorio.

Para actualizar o valor dunha propiedade existente ou engadir unha nova, despregar unha acción variable Set, poboar o nome da propiedade no campo Set e introducir o seu valor no campo To .

Captura de pantalla dunha acción variable Set que engade unha nova propiedade a un obxecto personalizado.

Ademais dos valores literais, pode usar variables para configurar dinámicamente as propiedades e valores dos obxectos personalizados. Por exemplo, o seguinte fluxo usa dúas variables para engadir unha nova propiedade a un novo obxecto personalizado baleiro.

Captura de pantalla dun fluxo que usa variables para engadir unha nova propiedade a un obxecto personalizado.

Obxecto de conector

Os obxectos conectores almacenan información de conectores cloud e funcionan de xeito similar a obxectos personalizados. As súas propiedades xeralmente conteñen listas doutros obxectos conectores. Acceder a valores funciona como en obxectos personalizados, aínda que acceder a valores aniñados pode requirir expresións máis complicadas.

Captura de pantalla dunha variable de obxectos personalizados no visor de variables.

Lista de información da táboa PDF

Unha variable deste tipo de datos só se pode producir a través das táboas de extractos da acción PDF .

Cada elemento da lista describe unha táboa extraída e proporciona toda a información esencial sobre ela. Para acceder a un elemento de información de datos específico, use o %VariableName[ItemNumber]% notación.

Captura de pantalla dunha lista de información da táboa PDF.

Cada elemento da lista fornece catro propiedades que lle permiten obter un detalle específico de forma independente. As propiedades dispoñibles son as seguintes:

  • DataTable – Devolve a táboa extraída.
  • TableStartingPage – Devolve o índice da páxina do ficheiro que contén o inicio da táboa.
  • TableEndingPage – Devolve o índice da páxina do ficheiro que contén o final da táboa.
  • TableOrderInPage - Devolve a orde da táboa na páxina.

Podes atopar máis información sobre as propiedades deste tipo de datos nas propiedades do tipo de datos variables.

Captura de pantalla das propiedades dunha lista da información da táboa PDF.

Para acceder ao valor dunha propiedade específica, use o %VariableName[ItemNumber]. PropertyName% notación. Por exemplo, a seguinte expresión devolve o valor datatable do primeiro elemento da variable ExtractedPDFTables .

Captura de pantalla da táboa de datos contida nunha lista de variables de información da táboa PDF.

Limitacións e problemas coñecidos

  • Problema: Cando unha cela datatable ou de datarow contén unha entrada multilina, o visor variable mostra só a primeira liña da mesma.
  • Workarounds: Ningunha.

Instancias

Conexións

Outras

Esta sección presenta todos os tipos de datos dispoñibles que non pertencen a ningunha das categorías anteriores.

Valor xeral

  • Valor xeral – Este tipo de datos úsase durante o tempo de deseño cando Power Automate non se pode definir o tipo de datos dunha variable ou dun parámetro de entrada. Os valores xerais convértense noutros tipos de datos durante o tempo de execución en función dos seus datos.

Active Directory

  • Entrada de Active Directory – Contén unha conexión a un servidor de Active Directory establecida mediante a acción Conectar ao servidor .
  • Información do grupo – Contén o nome, o nome para mostrar, unha descrición e os membros dun grupo de Active Directory especificado.
  • Membro do grupo : representa un membro dun grupo de Active Directory especificado.
  • Información do usuario – Contén información sobre un usuario de Active Directory especificado, como primeiro e apelidos, iniciais e un nome distinguido, detalles do traballo (empresa, departamento e título), información de contacto (número de teléfono, extensión)., e correo electrónico) e localización (país/rexión, cidade, estado, enderezo e código postal).

Propiedades do tipo de datos de Active Directory

Servizos web de Amazon (AWS)

  • Cliente EC2 – Contén unha sesión EC2 creada mediante a acción Crear sesión EC2 .
  • Instancia EC2 – Representa unha instancia EC2 recuperada.
  • Información de instancias EC2 – Contén información sobre unha instancia EC2.
  • Cambio de estado da instancia – Contén información sobre unha instancia EC2 que se iniciou ou detivo.
  • Instantánea de EBS – Representa unha instantánea de EBS.
  • Volume EBS – Representa un volume EBS.

Propiedades do tipo de datos de AWS

Azure

  • Cliente de Azure – Contén unha sesión de Azure creada mediante a acción Crear sesión .
  • Grupo de recursos de Azure : representa un grupo de recursos de Azure recuperado.
  • Disco xestionado de Azure : representa un disco de Azure recuperado.
  • Instantánea de Azure : representa unha instantánea de Azure.
  • Máquina virtual de Azure : representa unha máquina virtual de Azure recuperada.
  • Información da máquina virtual de Azure : contén información sobre unha máquina virtual de Azure.
  • Subscrición de Azure : representa unha subscrición de Azure recuperada.

Propiedades do tipo de datos de Azure

CMD

  • Sesión CMD – Contén unha sesión CMD creada mediante a acción Abrir sesión CMD .

Propiedades do tipo de datos CMD

Datas e hora

  • Datetime – Contén información de data e hora. Para crear unha variable de data e hora mediante a acción Establecer variable , enche o parámetro de entrada coas expresións %d"aaaa-MM-dd HH:mm:ss .ff+zzz"%, onde:

    Cualificación Descripción
    yyyy Ano
    MM Mes
    dd Día
    HH Hora
    mm minutos
    ss Segundos
    ff Milisegundos
    zz Desprazamento de UTC

    Por exemplo, %d"2022-03-25"% asigna a data do 25 de marzo de 2022 á variable de destino.

Propiedades do tipo de datos de datas e hora

Enviar correo electrónico

  • Mensaxe de correo : representa unha mensaxe de correo electrónico. A acción Recuperar correos electrónicos enche estas variables.

Propiedades do tipo de datos de correo electrónico

Exchange

  • Mensaxe de correo de Exchange : representa unha mensaxe de correo electrónico recuperada dun servidor de Exchange. A acción Recuperar mensaxes de correo electrónico de Exchange enche estas variables.

Propiedades do tipo de datos de intercambio

Ficheiros e cartafoles

  • Ficheiro – Representa un ficheiro.
  • Cartafol : representa un cartafol.
  • FileSystemObject – Representa un cartafol ou un ficheiro. Este tipo de datos utilízase nos parámetros de entrada que aceptan cartafoles e ficheiros.

Propiedades do tipo de datos de ficheiros e cartafoles

FTP

  • Ficheiro FTP – Representa un ficheiro FTP.
  • Directorio FTP – Representa un directorio FTP

Propiedades do tipo de datos FTP

OCR

  • Motor OCR – Contén un motor OCR creado mediante a acción Crear motor OCR .

Outlook

  • Mensaxe de correo electrónico de Outlook : representa unha mensaxe de correo electrónico de Outlook. A acción Recuperar mensaxes de correo electrónico de Outlook enche estas variables.

Propiedades do tipo de datos de Outlook

Terminal

  • Sesión de terminal – Contén unha sesión de terminal creada mediante a acción Abrir sesión de terminal .

Propiedades do tipo de datos do terminal

XML

  • Nodo XML – Contén o contido dun documento XML. A acción Ler XML do ficheiro enche estas variables.

Propiedades do tipo de datos XML

Erro

  • Erro – Contén información sobre o último erro que se produciu no fluxo do escritorio. A acción Obter último erro crea este tipo de variable.

Propiedades de erro