Tipus de dades de variables

  • Article

Quan creeu variables als vostres fluxos, Power Automate les converteix a un tipus específic en funció del seu contingut.

Alguns d'aquests tipus de dades s'utilitzen àmpliament en tota l'aplicació, com els números , mentre que altres, comles instàncies del navegador, requereixen accions explícites o grups d'accions.

Tipus de dades simples

Els tipus de dades simples representen valors únics, com ara textos i números. Podeu utilitzar aquests tipus de dades de manera independent o utilitzar-los per crear estructures de dades més complexes, com ara llistes i taules de dades.

Valor de text

Es tracta de qualsevol tipus de text, des d'adreces de correu electrònic fins al contingut de text d'un fitxer .txt.

Propietats del tipus de dades de text

Per crear una variable de valor de text, utilitzeu l'acció Defineix la variable i empleneu el paràmetre d'entrada amb el text desitjat sense cap notació.

Captura de pantalla d'una acció Defineix una variable que crea una variable de valor de text.

Valor numèric

Numèric és el tipus aplicat als nombres. Només aquest tipus de dades es pot utilitzar en operacions matemàtiques.

Creeu una variable de valor numèric, utilitzeu l'acció Defineix la variable i empleneu el paràmetre d'entrada amb un número sense cap notació.

Excepte els valors numèrics codificats, podeu utilitzar expressions matemàtiques amb variables dins de signes percentuals. Per obtenir més informació sobre les expressions matemàtiques, aneu a Utilitzar variables i notació percent.

Captura de pantalla d'una acció Defineix una variable que crea una variable de valor numèric.

Valor booleà

El valor pot ser True o False.

Τo creeu una variable de valor booleà, utilitzeu l'acció Defineix la variable i empleneu el paràmetre d'entrada amb les expressions %True% o %False%.

A més, podeu crear expressions complexes utilitzant operadors lògics, variables i notació percentual. Per obtenir més informació sobre les expressions lògiques, aneu a Utilitzar variables i notació percent.

Captura de pantalla d'una acció Defineix una variable que crea una variable de valor booleà.

Tipus avançats de dades

Els tipus avançats de dades representen estructures de dades complexes. Funcionen com a col·leccions d'altres tipus de dades a les quals podeu accedir com una entitat.

Llista

Les llistes són col·leccions d'elements. Depenent dels tipus dels elements de llista individuals, hi pot haver llistes de valors de text, llistes de valors numèrics, etc. El tipus de dades de llista és l'equivalent a una matriu d'una sola dimensió en termes de programació.

Podeu crear una llista mitjançant l'acció Crea una llista nova i afegir-hi un element mitjançant l'acció Afegeix un element a la llista .

Captura de pantalla d'un flux que crea una llista.

També podeu crear una llista mitjançant accions que generin llistes com a sortida. Per exemple, l'acció Llegeix el text del fitxer pot retornar una llista de valors de text i l'acció Obtén fitxers a la carpeta retorna una llista de fitxers.

Per recuperar un element específic d'una llista, utilitzeu la notació següent: %VariableName[ItemNumber]%

En l'exemple següent, el flux emmagatzema el primer número de la llista mostrada anteriorment a una nova variable. Tingueu en compte que l'índex ha de ser 0 per al primer element de la llista.

Captura de pantalla d'una expressió que accedeix al primer element d'una llista.

Una pràctica comuna és utilitzar un Per a cada acció per iterar a través dels elements d'una llista.

Si necessiteu accedir només a una part específica d'una llista, utilitzeu la notació %VariableName[StartIndex:StopIndex]% . Per exemple, l'expressió %List[2:4]% recupera el tercer i quart elements de la llista. L'element en posició StopIndex és el límit del tall i no es recupera.

Per tallar una llista des del principi a un element específic, no definiu un valor StartIndex , per exemple, %List[:4]%. Per tallar una llista d'un índex específic fins al final, no definiu un valor StopIndex , per exemple, %List[2:]%.

Llista les propietats del tipus de dades

Taula de dades

Les taules de dades contenen dades en forma tabular i són l'equivalent a les matrius bidimensionals en termes de programació.

Una taula de dades conté files i columnes que descriuen la posició de cada element de manera única. Les taules de dades es poden considerar llistes que contenen files de dades com a elements.

Captura de pantalla del contingut d'una variable datatable.

Power Automate proporciona l'acció Crea una taula de dades nova per generar taules de dades noves. Després de desplegar l'acció, podeu utilitzar el constructor visual per emplenar valors i canviar el nom de les capçaleres de columna.

Captura de pantalla del constructor visual de l'acció Crea una taula de dades nova.

A part de l'acció Crea una nova taula de dades, tres accions més produeixen taules de dades per emmagatzemar les dades extretes: el full de càlcul Read from Excel, Execute SQL i Extreu dades de les accions de la pàgina web.

A més, podeu crear una taula de dades mitjançant l'acció Defineix la variable i la notació matricial de programació. Aquesta notació consisteix en múltiples matrius unidimensionals separades per comes i tancades entre claudàtors. L'expressió final ha de tenir la forma següent: %['Product1', '10 USD'], ['Product2', '20 USD']{%}.

Captura de pantalla de l'acció Defineix una variable que crea una taula de dades.

Si voleu afegir capçaleres de columna mentre creeu una taula de dades nova mitjançant la notació matricial, utilitzeu l'expressió ^['NomColumna1', 'NomColumna2'] per a la primera fila.

Captura de pantalla d'una acció Defineix una variable que crea una taula de dades nova amb capçaleres de columna.

Per afegir una fila nova a una taula existent, utilitzeu l'acció Insereix fila a la taula de dades. També podeu crear una expressió que contingui el nom de la variable de la taula de dades, un caràcter més (+) i els valors que voleu afegir entre claudàtors.

Captura de pantalla d'una acció Defineix una variable que afegeix una fila nova a una taula de dades.

A més d'inserir files a les taules de dades, els fluxos d'escriptori ofereixen diverses accions que manipulen les taules de dades. Podeu trobar una llista completa amb aquestes accions a la referència d'accionsvariables.

Per recuperar un element específic d'una taula de dades, utilitzeu la notació següent: %NomVariable[RowNumber][ColumnNumber]%. Tingueu en compte que el Número de fila i el Número de columna han de ser 0 per al primer element (fila o columna).

Per exemple, suposem que un flux recupera el contingut d'un full de càlcul de l'Excel i l'emmagatzema a la variable ExcelData . Per accedir a la primera cel·la de la segona fila de la taula recuperada, utilitzeu l'expressió que es mostra a continuació.

Captura de pantalla d'una expressió que accedeix a la segona cel·la de la primera fila d'un fitxer Excel llegit.

Nota

La variable ExcelData conté una taula de valors extreta d'un full de càlcul de l'Excel mitjançant l'acció Llegeix des del full de càlcul de l'Excel . Conté alguns valors d'un full de càlcul específic i no tot el fitxer Excel.

Si voleu accedir a una columna específica d'una datable que contingui capçaleres de columna, utilitzeu la notació %ExcelData[rowNumber]['NomColumna']% .

Si feu un bucle a través d'una taula de dades amb una opció Per a cada acció, la variable que contindrà les dades de la iteració actual es considera una fila de dades.

De manera similar a les llistes, utilitzeu la notació %VariableName[StartRow:StopRow]%per accedir a una part específica d'una taula de dades. L'expressió recupera només les files definides pels dos índexs, mentre que la posició StopRow és el límit del tall i no es recupera.

Per tallar una taula de dades de la primera fila a una fila específica, no utilitzeu cap valor StartRow , per exemple, %Datatable[:4]%. De la mateixa manera, per tallar una taula de dades d'una fila específica al final, no utilitzeu un valor StopRow , per exemple, %Datatable[2:]%.

Propietats del tipus de dades de la taula de dades

Fila de dades

Una fila de dades conté els valors d'una sola fila d'una taula de dades. Quan feu un bucle a través d'una taula de dades amb una opció Per a cada acció, la variable que conté les dades de la iteració actual és una fila de dades.

Per recuperar un element específic d'una fila de dades, utilitzeu la notació següent: %VariableName[ItemNumber]%

Alternativament, podeu utilitzar la notació %VariableName['NomColumna']% . El nom de cada columna el defineix la taula de dades de la qual heu recuperat la fila de dades.

Propietats del tipus de dades de la fila de dades

Captura de pantalla del contingut d'una variable de fila de dades.

Objecte personalitzat

Conté parells de propietats i valors, que es poden convertir fàcilment al format JSON.

Per crear un nou objecte Personalitzat buit , utilitzeu l'acció Defineix la variablei empleneu l'expressió següent%% {{ }}. Per crear un objecte personalitzat nou i inicialitzar-lo amb propietats i valors, utilitzeu una expressió de l'estructura següent:% 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2'{ %. }

Captura de pantalla de l'acció Defineix una variable que crea un objecte personalitzat nou.

Per actualitzar el valor d'una propietat existent o afegir-ne una de nova, implementeu una acció Defineix una variable, empleneu el nom de la propietat al camp Defineix i introduïu el seu valor al camp Per a .

Captura de pantalla d'una acció Defineix una variable que afegeix una propietat nova a un objecte personalitzat.

A part dels valors literals, podeu utilitzar variables per definir dinàmicament les propietats i els valors dels objectes personalitzats. Per exemple, el flux següent utilitza dues variables per afegir una propietat nova a un nou objecte personalitzat buit.

Captura de pantalla d'un flux que utilitza variables per afegir una propietat nova a un objecte personalitzat.

Objecte del connector

Els objectes del connector emmagatzemen informació dels connectors del núvol i funcionen de manera similar als objectes personalitzats. Les seves propietats solen contenir llistes d'altres objectes connectors. L'accés als valors funciona com en els objectes personalitzats, tot i que l'accés a valors imbricats pot requerir expressions més complicades.

Captura de pantalla d'una variable d'objecte personalitzada al visualitzador de variables.

Llista d'informació de la taula PDF

Una variable d'aquest tipus de dades només es pot produir a través de les taules Extreu de l'acció PDF .

Cada element de la llista descriu una taula extreta i proporciona tota la informació essencial al respecte. Per accedir a una informació específica de la taula de dades, utilitzeu la notació %NomVariable[ItemNumber]% .

Captura de pantalla d'una llista d'informació de la taula PDF.

Cada element de la llista proporciona quatre propietats que us permeten obtenir un detall específic de manera independent. Els immobles disponibles són els següents:

  • DataTable - Retorna la taula extreta.
  • TableStartingPage - Retorna l'índex de la pàgina del fitxer que conté l'inici de la taula.
  • TableEndingPage - Retorna l'índex de la pàgina del fitxer que conté el final de la taula.
  • TableOrderInPage - Retorna l'ordre de la taula a la pàgina.

Podeu trobar més informació sobre les propietats d'aquest tipus de dades a Propietats de tipus de dades de variables.

Captura de pantalla de les propietats d'una llista d'informació de la taula PDF.

Per accedir al valor d'una propietat concreta, utilitzeu el %NomVariable[ItemNumber]. PropertyName% notation. Per exemple, l'expressió següent retorna el valor de la taula de dades del primer element de la variable PDFTables extret.

Captura de pantalla de la taula de dades continguda en una llista de variables d'informació de la taula PDF.

Problemes i limitacions coneguts

  • Problema: Quan una taula de dades o una cel·la de fila de dades conté una entrada de diverses línies, el visualitzador de variables només mostra la primera línia.
  • Solucions: Cap.

Instàncies

Connexions

Altres

Aquesta secció presenta tots els tipus de dades disponibles que no pertanyen a cap de les categories anteriors.

Valor general

  • Valor general: aquest tipus de dades s'utilitza durant el temps de disseny quan Power Automate no es pot definir el tipus de dades d'una variable o d'un paràmetre d'entrada. Els valors generals es converteixen a altres tipus de dades en temps d'execució en funció de les seves dades.

Active Directory

  • Entrada de l'Active Directory: conté una connexió a un servidor de l'Active Directory establerta a través de l'acció Connecta't al servidor .
  • Informació del grup: conté el nom, el nom de visualització, una descripció i els membres d'un grup especificat de l'Active Directory.
  • Membre del grup: representa un membre d'un grup especificat de l'Active Directory.
  • Informació de l'usuari: conté informació sobre un usuari especificat de l'Active Directory, com ara el primer i el cognom, les inicials i un nom distingit, els detalls de la feina (empresa, departament i títol), la informació de contacte (número de telèfon, extensió i correu electrònic) i la ubicació (país/regió, ciutat, estat, adreça postal i codi postal).

Propietats del tipus de dades de l'Active Directory

Serveis web d'Amazon (AWS)

  • EC2 client – Conté una sessió EC2 creada a través de l'acció Create EC2 session .
  • Instància EC2: representa una instància EC2 recuperada.
  • Informació sobre instàncies EC2: conté informació sobre una instància EC2.
  • Canvi d'estat de la instància: conté informació sobre una instància EC2 que s'ha iniciat o aturat.
  • Instantània EBS: representa una instantània EBS.
  • Volum EBS: representa un volum EBS.

Propietats del tipus de dades AWS

Azure

  • Client de l'Azure: conté una sessió de l'Azure creada a través de l'acció Crea una sessió .
  • Azure resource group – Representa un grup de recursos de l'Azure recuperat.
  • Azure managed disk – Representa un disc recuperat de l'Azure.
  • Instantània de l'Azure: representa una instantània de l'Azure.
  • Azure virtual machine - Representa una màquina virtual recuperada de l'Azure.
  • Informació de la màquina virtual de l'Azure: conté informació sobre una màquina virtual de l'Azure.
  • Subscripció de l'Azure: representa una subscripció recuperada de l'Azure.

Propietats del tipus de dades de l'Azure

CMD

  • Sessió CMD - Conté una sessió CMD creada a través de l'acció de sessió Open CMD.

Propietats del tipus de dades CMD

Dates i horari

  • Datetime - Conté informació de data i hora. Per crear una variable datetime mitjançant l'acció Defineix la variable , empleneu el paràmetre d'entrada amb les expressions "aaaaa-MM-dd HH:mm:ss.ff %d+zzz"%, on:

    Notació Descripció
    yyyy Any
    MM Mes
    dd Dia
    HH Hora
    mm Minuts
    ss Segons
    Ff Mil·lisegons
    zzz Desplaçament d'UTC

    Per exemple, %d"2022-03-25"% assigna la data del 25 de març de 2022 a la variable objectiu.

Propietats de tipus de dades de dates i hores

Correu

  • Missatge de correu: representa un missatge de correu electrònic. L'acció Recupera correus electrònics emplena aquestes variables.

Propietats del tipus de dades de correu electrònic

Exchange

  • Missatge de correu de l'Exchange: representa un missatge de correu electrònic recuperat d'un servidor de l'Exchange. L'acció Recupera els missatges de correu electrònic de l'Exchange emplena aquestes variables.

Propietats del tipus de dades de l'Exchange

Arxius i carpetes

  • Fitxer : representa un fitxer.
  • Carpeta : representa una carpeta.
  • FileSystemObject - Representa una carpeta o un fitxer. Aquest tipus de dades s'utilitza en paràmetres d'entrada que accepten carpetes i fitxers.

Fitxers i carpetes propietats del tipus de dades

FTP

  • Fitxer FTP: representa un fitxer FTP.
  • Directori FTP– Representa un directori FTP

Propietats del tipus de dades FTP

OCR

  • Motor OCR- Conté un motor OCR creat a través de l'acció Crea un motor OCR.

Outlook

  • Missatge de correu d'Outlook: representa un missatge de correu electrònic d'Outlook. L'acció Recupera missatges de correu electrònic de l'Outlook emplena aquestes variables.

Propietats del tipus de dades de l'Outlook

Terminal

  • Sessió de terminal: conté una sessió de terminal creada a través de l'acció Obre sessió de terminal .

Propietats del tipus de dades del terminal

XML

  • Node XML– Conté el contingut d'un document XML. L'acció Read XML from file emplena aquestes variables.

Propietats del tipus de dades XML

Error

  • Error - Conté informació sobre l'últim error produït al flux de l'escriptori. L'última acció d'error crea aquest tipus de variable.

Propietats de l'error