Tipus de dades de variables

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

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

Tipus de dades senzilles

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 nota.

Valor numèric

Numèric és el tipus que s'aplica als números. Només aquest tipus de dades es pot utilitzar en operacions matemàtiques.

Per crear una variable de valor numèric, utilitzar l'acció Estableix la variable i omplir 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 dels signes de percentatge. Per obtenir més informació sobre les expressions matemàtiques, aneu a Utilitza variables i la notació %.

Valor booleà

El valor pot ser True o False.

Per crear una variable de valor booleà, utilitzar l'acció Estableix la variable i emplenar el paràmetre d'entrada amb les expressions %True% o %False%.

A més, podeu crear expressions complexes mitjançant operadors lògics, variables i la notació de percentatge. Per obtenir més informació sobre les expressions lògiques, aneu a Utilitza variables i la notació %.

Tipus de dades avançats

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

Llista

Les llistes són col·leccions d'elements. Depenent dels tipus d'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ó.

Pots crear una llista mitjançant l'acció Crear una llista nova i afegir-hi un ítem mitjançant l'acció Afegir ítem a la llista .

També podeu crear una llista mitjançant accions que generen llistes com a sortida. Per exemple, l'acció Llegir text a partir d'un fitxer pot retornar una llista de valors de text i l'acció Obtenir 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]%

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

Una pràctica habitual és utilitzar una acció For each per iterar a través dels elements d'una llista.

Si només necessiteu accedir 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 el quart element de la llista. L'element de la posició StopIndex és el límit del tall i no es recupera.

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

Llista de les propietats del tipus de dades

Taula de dades

Les taules de dades contenen dades en forma tabular i són l'equivalent a 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 com a llistes que contenen files de dades com a elements.

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

A part de l'acció Crea una taula de dades nova, tres accions més produeixen taules de dades per emmagatzemar dades extretes: el full de càlcul Llegeix des de l'Excel, Executa la sentència SQL i Extreu dades de la pàgina web.

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

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

Per afegir una fila nova a una taula existent, utilitzeu l'acció Insereix fila a la taula de dades. Alternativament, creeu 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 parèntesis.

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'accionsde variables.

Per recuperar un element específic d'una taula de dades, utilitzeu la notació següent: %VariableName[RowNumber][ColumnNumber]%. Tingueu en compte que el RowNumber i el ColumnNumber 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ó.

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

Si recorreu una taula de dades amb una acció For Each , la variable que conté 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ó només recupera les files definides pels dos índexs, mentre que la posició StopRow és el límit del tall i no es recupera.

Per dividir una taula de dades de la primera fila a una fila específica, no utilitzeu un valor StartRow , per exemple, %Datatable[:4]%. De la mateixa manera, per dividir una taula de dades des d'una fila específica fins 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 recorreu una taula de dades amb una acció For Each , 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['ColumnName']% . El nom de cada columna està definit per la taula de dades de la qual heu recuperat la fila de dades.

Propietats del tipus de dades Datarow

Objecte personalitzat

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

Per crear un objecte personalitzat buit , utilitzeu l'acció Defineix lavariable i 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'{ %. }

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

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 objecte personalitzat buit nou.

Objecte del connector

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

Llista d'informació de la taula PDF

Una variable d'aquest tipus de dades només es pot produir mitjançant l'acció Extreu taules del PDF .

Cada element de la llista descriu una taula extreta i proporciona tota la informació essencial sobre ella. Per accedir a un element d'informació específic de la taula de dades, utilitzeu la notació %VariableName[ItemNumber]%.

Cada element de llista proporciona quatre propietats que us permeten obtenir un detall específic de manera independent. Les propietats disponibles són les 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 del tipus de dades de variables.

Per accedir al valor d'una propietat específica, utilitzeu el %VariableName[ItemNumber]. PropertyName% notation. Per exemple, l'expressió següent retorna el valor de la taula de dades del primer element de la variable ExtractedPDFTables .

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

• Instància del navegador web: conté una instància del navegador creada mitjançant l'inici de les accions de llançament del navegador nou Internet Explorer o d'un altre navegador.

  Propietats del tipus de dades d'instància del navegador web

• Instància de finestra: conté una instància de finestra creada mitjançant l'acció Obtén la finestra .

  Propietats del tipus de dades d'instància de finestra

• Instància de l'Excel: conté una instància de l'Excel creada mitjançant l'acció Inicia l'Excel .

  Propietats del tipus de dades d'instància de l'Excel

• Instància de l'Outlook : conté una instància de l'Outlook creada mitjançant l'acció Inicia l'Outlook .

Connexions

• Connexió SQL: conté una connexió a una base de dades SQL establerta mitjançant l'acció Obre connexió SQL.

  Propietats del tipus de dades de connexió SQL

• Connexió de l'Exchange: conté una connexió a un servidor de l'Exchange establerta mitjançant l'acció Connecta't al servidor de l'Exchange .

  Propietats del tipus de dades de connexió de l'Exchange

• Connexió FTP: conté una connexió FTP creada mitjançant les accions Connexió FTP oberta i Connexió FTP segura oberta.

  Propietats del tipus de dades de connexió FTP

Altres

En aquesta secció es presenten 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 en 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 en altres tipus de dades durant el 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 mitjançant l'acció Connecta't al servidor .
• Informació del grup: conté el nom, el nom de visualització, una descripció i els membres d'un grup d'Active Directory especificat.
• Membre del grup: representa un membre d'un grup d'Active Directory especificat.
• Informació de l'usuari: conté informació sobre un usuari especificat de l'Active Directory, com ara nom i cognom, inicials i nom distintiu, detalls de la feina (empresa, departament i títol), informació de contacte (número de telèfon, extensió i correu electrònic) i ubicació (país/regió, ciutat, estat, adreça postal i codi postal).

Propietats del tipus de dades de l'Active Directory

Amazon Web Services (AWS)

• Client EC2: conté una sessió EC2 creada mitjançant l'acció Crea una sessió EC2.
• Instància EC2: representa una instància EC2 recuperada.
• Informació d'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 d'AWS

Azure

• Client de l'Azure : conté una sessió de l'Azure creada mitjançant l'acció Crea una sessió .
• Grup de recursos de l'Azure: representa un grup de recursos de l'Azure recuperat.
• Disc gestionat de l'Azure: representa un disc de l'Azure recuperat.
• Azure instantània : representa una instantània de l'Azure.
• Màquina virtual Azure: representa una màquina virtual Azure recuperada.
• Informació de la màquina virtual Azure: conté informació sobre una màquina virtual Azure.
• Subscripció de l'Azure: representa una subscripció de l'Azure recuperada.

Propietats del tipus de dades de l'Azure

CMD

• Sessió CMD: conté una sessió CMD creada mitjançant l'acció Obrir sessió CMD.

Propietats del tipus de dades CMD

Credencials

• Credencial : conté una credencial recuperada mitjançant l'acció Obtén la credencial (versió preliminar).

Propietats del tipus de dades de credencials

Dates i hores

• 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 %d"aaaa-MM-dd HH:mm:ss.ff+zzz"%, on:

  Notació	Descripció
  aaaa	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 de destinació.

Propietats del tipus de dades de dates i hora

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

Fitxers 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.

Propietats del tipus de dades de fitxers i carpetes

FTP

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

Propietats del tipus de dades FTP

OCR

• Motor d'OCR: conté un motor d'OCR creat mitjançant l'acció Crea un motor d'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 mitjançant 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ó Llegir XML des d'un fitxer emplena aquestes variables.

Propietats del tipus de dades XML

Error

• Error : conté informació sobre l'últim error que s'ha produït al flux d'escriptori. L'acció Obtén l'últim error crea aquest tipus de variable.

Propietats d'error