Accions de variables

Per crear manualment una variable en un flux d'escriptori, implementeu l'acció Defineix la variable . Aquesta acció requereix que proporcioneu un nom i un valor per a la variable nova.

Important

Les paraules clau reservades no es poden utilitzar com a noms de variables. Per obtenir la llista completa de paraules clau reservades, aneu a Paraules clau reservades als fluxos d'escriptori.

Per augmentar o disminuir el valor d'una variable numèrica, utilitza les accions Augmenta la variable i Disminueix la variable , respectivament.

La majoria de les accions generen el seu resultat en una variable. Per exemple, l'acció Crea una llista nova produeix una llista buida.

De la mateixa manera, l'acció Genera un nombre aleatori produeix un valor numèric aleatori. Si activeu Genera diversos números en aquesta acció, creeu una variable de llista que conté diversos valors numèrics aleatoris.

Per afegir ítems a una llista existent, implementeu l'acció Afegeix un element a la llista i empleneu un valor codificat o una variable per definir l'element que voleu afegir. De la mateixa manera, pots suprimir ítems d'una llista amb l'acció Eliminar ítem de la llista .

Nota

Els índexs de llista comencen des de 0, el que significa que el primer element de la llista sempre té un índex de 0. Utilitzeu la notació %ListName[0]% per fer referència al primer element de la llista, %ListName[1]% al segon, i així successivament.

Si voleu crear una variable de taula de dades, implementeu l'acció Crea una nova taula de dades i especifiqueu-ne els elements inicials mitjançant el generador visual.

Per manipular una variable de taula de dades, utilitzeu les accions del subgrup d'accions respectiu, com ara les accions Cerca o substitueix a la taula de dades i Actualitza l'element de la taula de dades.

Crea una taula de dades nova

Crea una nova variable de taula de dades.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula nova	No	Taula de dades		La taula de dades d'entrada

Variables generades

Argument	Type	Descripció
Taula de dades	Taula de dades	La taula de dades nova

Excepcions

Aquesta acció no inclou cap excepció.

Insereix una fila a la taula de dades

Insereix una fila al final o abans d'un valor d'índex específic.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable ha d'haver estat especificada prèviament per una acció que produeix una variable de taula de dades
A la ubicació	N/A	Final de la taula de dades, abans de l'índex de fila	Final de la taula de dades	Especifiqueu si cal inserir la fila nova al final de la taula de dades o abans d'un índex de fila especificat
Índex de files	No	Valor numèric		Inseriu el valor d'índex de fila que s'utilitzarà quan l'índex d'abans de la fila s'especifica com a paràmetre d'ubicació
Valors nous	No	Llista,Fila de dades		Aquest paràmetre accepta una variable de llista o datarow on el recompte de columnes ha de coincidir amb el recompte de columnes de la taula de dades

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
L'índex de l'element està fora de l'interval	Indica que l'índex d'elements proporcionat està fora de l'interval
Arguments d'entrada no vàlids	Indica que hi ha un paràmetre d'entrada no vàlid
Error del tipus incompatible	Indica que s'ha proporcionat un paràmetre d'entrada d'un tipus incompatible

Suprimeix la fila de la taula de dades

Suprimiu una fila de la taula de dades a l'índex de fila corresponent.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable s'ha d'especificar mitjançant una acció que produeixi una variable de taula de dades
Índex de files	No	Valor numèric		Índex de fila dins d'una taula de dades que s'ha de suprimir

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
L'índex de l'element està fora de l'interval	Indica que l'element de la taula de dades especificat està fora de l'interval

Actualitza l'element de la taula de dades

Actualitzeu un element de fila de la taula de dades en una columna definida.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable ha d'haver estat especificada prèviament per una acció que produeix una variable de taula de dades.
Column	No	Valor de text		El nom de la columna o l'índex de l'element que s'ha d'actualitzar.
Fila	No	Valor numèric		L'índex de fila de l'element que s'ha d'actualitzar.
Valor nou	No	Valor de text		El valor nou que s'ha d'actualitzar a la fila, l'índex i la columna especificats.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
L'índex de l'element està fora de l'interval	Indica que l'element de la taula de dades especificat està fora de l'interval
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval
Error del tipus incompatible	Indica que s'ha proporcionat un paràmetre d'entrada d'un tipus incompatible

Cerca o substitueix a la taula de dades

Cerca i/o substitueix els valors de la taula de dades.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable ha d'haver estat especificada prèviament per una acció que produeix una variable de taula de dades
Mode de cerca	N/A	Cercar, cercar i substituir	Cerca	El mode de cerca (cerca o cerca i substitueix)
Totes les coincidències	N/A	Valor booleà	Cert	Especifiqueu si voleu cercar o substituir text a totes les cel·les coincidents trobades o només a la primera cel·la coincident
Text que s'ha de cercar	No	Valor de text		Text que se cerca a la taula de dades
Cerca amb una expressió regular	N/A	Valor booleà	Fals	Especifiqueu si s'utilitzarà una expressió regular per fer coincidir el contingut de la cel·la amb el text que cal cercar
Distingeix entre majúscules i minúscules	N/A	Valor booleà	Fals	Especifiqueu si s'han de cercar dades distingint entre majúscules i minúscules
Cerca tot el contingut de la cel·la	N/A	Valor booleà	Fals	Especifiqueu si s'han de cercar cel·les que només contenen el text especificat
Text amb el qual cal substituir	No	Valor de text		Text utilitzat per substituir les cel·les coincidents
Cerca per	N/A	A tot arreu, a la columna	Arreu	Ordre de cerca del text (arreu o a la columna)
Nom o índex de la columna	No	Valor de text		La capçalera de columna o el valor de l'índex

Variables generades

Argument	Type	Descripció
DataTableMatches	Taula de dades	La taula de dades que conté els índexs de fila i columna per a les coincidències

Excepcions

Excepció	Descripció
L'expressió regular proporcionada no és vàlida	Indica que l'expressió regular proporcionada no és vàlida
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval
Error del tipus incompatible	Indica que s'ha proporcionat un paràmetre d'entrada d'un tipus incompatible

Insereix una columna a la taula de dades

Insereix una columna al final o abans d'un valor d'índex específic.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable s'ha d'especificar mitjançant una acció que produeixi una variable de taula de dades.
A la ubicació	N/A	Final de la taula de dades, abans de l'índex de columna	Final de la taula de dades	Especifiqueu si voleu inserir la columna nova al final de la taula de dades o abans d'un índex de columna especificat.
Nom de la columna	No	Valor de text		Especifiqueu la capçalera de la columna nova.
Índex de la columna	No	Valor numèric		Especifiqueu el valor de l'índex de columna que s'utilitza quan se selecciona l'opció Abans de l'índex de columna per al paràmetre d'ubicació En.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval.
Nom de columna duplicat	Indica que el nom de columna proporcionat ja existeix.

Suprimeix la columna de la taula de dades

Suprimiu una columna de taula de dades a l'índex de columna o al nom de columna especificats.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable s'ha d'especificar mitjançant una acció que produeixi una variable de taula de dades.
Especifiqueu la columna amb	N/A	Nom, índex	Nom	Especifiqueu si voleu cercar la columna per nom o índex.
Nom de la columna	No	Valor de text		El nom de la columna que s'ha de suprimir.
Índex de la columna	No	Valor numèric		L'índex de la columna que s'ha de suprimir. Els índexs de columna comencen des de 0.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval

Suprimeix les files buides de la taula de dades

Suprimeix les files de la taula de dades que tenen totes les cel·les buides.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. Aquesta variable ha d'haver estat especificada prèviament per una acció que produeix una variable de taula de dades

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Suprimeix les files duplicades de la taula de dades

Suprimeix totes les files duplicades de la taula de dades, si els valors tenen el mateix tipus de dades a cada columna.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
El tipus de les cel·les d'una columna no coincideix	Indica que dos o més valors d'una sola columna són d'un tipus de dades diferent

Esborra la taula de dades

Suprimeix totes les files de la taula de dades, sense que les capçaleres de la taula es vegin afectades.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Ordena la taula de dades

Ordena les files de la taula de dades en ordre ascendent o descendent per la columna especificada, si tots els seus valors tenen el mateix tipus de dades.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.
Especifiqueu la columna amb	N/A	Nom, índex	Nom	Especifiqueu si voleu cercar la columna per nom o índex.
Nom de la columna	No	Valor de text		El nom de la columna que s'ha d'ordenar.
Índex de la columna	No	Valor numèric		L'índex de la columna que s'ha d'ordenar. Els índexs de columna comencen des de 0.
Ordena	N/A	Ascendent, descendent	Ascendent	L'ordre d'ordenació de la taula de dades.

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval
El tipus de les cel·les d'una columna no coincideix	Indica que dos o més valors d'una sola columna són d'un tipus de dades diferent

Filtra la taula de dades

Filtra les files de la taula de dades en funció de les regles aplicades.

A l'auxiliar integrat de l'acció que us ajuda a crear els filtres necessaris, podeu aplicar diversos filtres a diferents columnes definides pel nom o l'índex. Cada filtre es compon d'una columna específica a la qual s'orienta, un operador seleccionat i el valor que se li assigna.

A més, s'apliquen diversos filtres junts mitjançant les regles AND i/o OR. Les regles AND es resolen primer a l'expressió de filtre resultant, seguides de les regles OR.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.
Filtres que s'han d'aplicar	No	Regles de filtratge definides per l'usuari	N/A	Regles de filtratge aplicades a les columnes definides

Variables generades

Argument	Type	Descripció
Taula de dades filtrada	Taula de dades	Taula de dades generada després d'aplicar els filtres

Excepcions

Excepció	Descripció
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval
El tipus de les cel·les d'una columna no coincideix	Indica que dos o més valors d'una sola columna són d'un tipus de dades diferent

Combina les taules de dades

Combina dues taules de dades, especificant el comportament de fusió en cas que el nombre de columnes sigui diferent.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Primera taula de dades	No	Taula de dades		La primera variable de taula de dades amb la qual treballar. Aquesta també és la variable produïda de l'acció que conté la taula de dades combinades
Segona taula de dades	No	Taula de dades		La segona taula de dades que es fusiona amb la primera taula de dades
Mode de combinació	N/A	Afegeix columnes addicionals, Ignora columnes addicionals, Error en columnes addicionals	Afegeix columnes addicionals	El comportament de fusió que s'aplica quan les taules no tenen el mateix nombre de columnes

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
Falta l'esquema	Indica que les taules de dades no tenen el mateix nombre de columnes

Unió de taules de dades

Uneix dues taules de dades en funció de la regla d'unió especificada.

A l'auxiliar integrat de l'acció que us ajuda a crear les regles d'unió necessàries, podeu definir diverses regles especificant la columna de la primera i la segona taula de dades en conseqüència, i l'operador de comparació que s'aplica entre elles.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Primera taula de dades	No	Taula de dades		La primera variable de taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.
Segona taula de dades	No	Taula de dades		La segona variable de taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.
Operació d'unió	N/A	Interior, Esquerra, Ple	Interior	L'operació d'unió que s'utilitza per unir les dues taules
Regles d'unió	No	Regles d'unió definides per l'usuari	N/A	Definiu les columnes i l'operació que s'utilitzarà per unir les dues taules de dades

Variables generades

Argument	Type	Descripció
JoinedDataTable	Taula de dades	La taula de dades generada després de l'operació d'unió

Excepcions

Excepció	Descripció
El nom de la columna no existeix	Indica que el nom de columna proporcionat no existeix
L'índex de la columna està fora de l'interval	Indica que l'índex de columna proporcionat està fora de l'interval

Llegeix des de la variable de text CSV

Genera una taula de dades a partir d'un text CSV.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Text d'CSV	No	Valor de text		La variable de text CSV que s'ha de llegir.
Retalla els camps	N/A	Valor booleà	Cert	Especifica si s'han de retallar automàticament els espais en blanc inicials i finals de les cel·les extretes.
La primera línia conté noms de columna	N/A	Valor booleà	Fals	Especifica si s'ha d'utilitzar la primera fila del text CSV per definir els noms de columna de la taula de dades resultant. Activeu aquesta opció per evitar llegir els noms com a dades a la taula. Les accions posteriors poden accedir a les dades de la taula de dades mitjançant noms de columna (en lloc de números de columna).
Obtenir camps CSV com a text	N/A	Valor booleà	Fals	Especifiqueu si voleu recuperar el contingut dels camps de text CSV només com a text o com el tipus de coincidència més proper. Per exemple, Data i hora per a les dates i Numèrica per als números.
Separador de columnes	N/A	Amplades de columna predefinides, personalitzades i fixes	Predefinit	Especifica si s'ha d'utilitzar un separador de columnes predefinit, un separador personalitzat o amplades de columna fixes.
Separador	N/A	Per defecte del sistema, coma, punt i coma, tabulador	Valor per defecte del sistema	El separador de columnes per analitzar el text CSV.
Separador personalitzat	No	Valor de text		El separador de columnes personalitzat que s'utilitzarà per analitzar el text CSV.
Amplades de columna fixes	No	Valor de text		Les amplades de columna fixes que s'utilitzaran per analitzar el text CSV. Separeu les amplades mitjançant comes, espais, tabulacions o noves línies.

Variables generades

Argument	Type	Descripció
CSVTable	Taula de dades	El contingut del text CSV com a taula de dades

Excepcions

Excepció	Descripció
Error en l'anàlisi de CSV	Indica un problema en analitzar el text CSV

Converteix la taula de dades en text

Converteix una taula de dades en un text CSV.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		La variable de la taula de dades amb la qual treballar. La variable especificada s'ha de definir mitjançant una acció que generi una variable de taula de dades.
Inclou els noms de columnes	N/A	Valor booleà	Fals	Especifica si els noms de columna de la variant especificada s'han de convertir en la primera fila del text CSV.
Utilitza un separador de columnes personalitzat	N/A	Valor booleà	Fals	Especifica si s'ha d'utilitzar un separador de columna personalitzat o un separador de columna predefinit.
Separador	N/A	Per defecte del sistema, coma, punt i coma, tabulador	Valor per defecte del sistema	El separador de columna que s'utilitzarà al text CSV especificat.
Separador de columnes personalitzat	No	Valor de text		El separador de columna personalitzat que s'utilitzarà en el text CSV especificat.

Variables generades

Argument	Type	Descripció
CSVText	Valor de text	La variable en què s'emmagatzema el resultat CSV

Excepcions

Excepció	Descripció
No s'ha pogut convertir	Indica un problema en convertir la taula de dades a text CSV

Trunca el número

Obteniu els dígits integrals o fracionaris d'un valor numèric o arrodoniu el valor a un nombre especificat de decimals.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Número que s'ha de truncar	No	Valor numèric		Número o variable que conté el valor numèric que s'ha de truncar o arrodonir
Operació	N/A	Obtén part entera, Obté part decimal, Nombre rodó	Obtén la part entera	Especifica l'operació que s'ha de realitzar en el número proporcionat
Xifres decimals	Sí	Valor numèric	3	El nombre de decimals per arrodonir el nombre donat. Introduïu 0 per retornar un enter com a resultat

Variables generades

Argument	Type	Descripció
Valor truncat	Valor numèric	Número truncat o arrodonit

Excepcions

Aquesta acció no inclou cap excepció.

Genera un número aleatori

Genera un nombre aleatori o una llista de números aleatoris que es troben entre un valor mínim i màxim.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Valor mínim	Sí	Valor numèric	0	Límit inferior dels números aleatoris que s'han de generar
Valor màxim	Sí	Valor numèric	100	Límit superior dels números aleatoris que s'han de generar
Genera diversos números	N/A	Valor booleà	Fals	Especifica si s'ha de generar un únic número aleatori o una llista de números aleatoris
Nombre de números	Sí	Valor numèric	10	Especifica quants números aleatoris s'han de generar
Permet els duplicats	N/A	Valor booleà	Fals	Especifica si s'ha de permetre o impedir que el mateix número aparegui més d'una vegada a la llista de números aleatoris

Variables generades

Argument	Type	Descripció
Nombre aleatori	Valor numèric	Número aleatori generat
Nombres aleatoris	Llista de valors numèrics	Llista generada de números aleatoris

Excepcions

Excepció	Descripció
No s'ha pogut generar un número aleatori	Indica que s'ha produït un error en generar un nombre aleatori

Esborra la llista

Suprimir tots els elements d'una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llista que s'ha d'esborrar	No	Llista de valors generals		Variable de llista de la qual s'han de suprimir els elements

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Suprimeix l'element de la llista

Suprimir un o diversos elements d'una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Suprimeix l'element per	N/A	Índex, Valor	Índex	Especifica si s'ha de suprimir l'element en un índex especificat o l'element amb un valor específic
A l'índex	No	Valor numèric		Número d'índex de l'element que s'ha d'eliminar
Amb el valor	No	Valor general		Element que s'ha de suprimir
Suprimeix totes les repeticions de l'element	N/A	Valor booleà	Fals	Suprimeix totes les repeticions que coincideixen amb l'element especificat
De la llista	No	Llista de valors generals		Llista amb els elements que s'han de suprimir

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Excepció	Descripció
L'índex de l'element està fora de l'interval	Indica que l'índex de l'element està fora de l'interval
No s'ha trobat l'element	Indica que l'element no existeix a la llista

Ordena la llista

Ordenar els elements d'una llista. Utilitzeu elements del mateix tipus.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llista que s'ha d'ordenar	No	Llista de valors generals		Variable que conté la llista que s'ha d'ordenar
Ordenar per les propietats de l'element de la llista	N/A	Valor booleà	Fals	Si els elements de la llista són objectes (com ara fitxers, carpetes, etc.), activeu aquesta opció per ordenar l'element per una propietat específica. Deixeu aquesta opció desactivada per ordenar els elements per la seva propietat predeterminada (per exemple, els objectes de fitxer s'ordenen pel seu camí complet)
Primera propietat per la qual s'ha d'ordenar	Sí	Valor de text		El nom de la propietat d'un element per ordenar la llista. Consulteu el fitxer d'ajuda per veure els noms de propietat de cada objecte
Ordena	N/A	Ascendent, descendent	Ascendent	Especifica si s'ha d'ordenar per la primera propietat en ordre ascendent o descendent
Segona propietat per la qual s'ha d'ordenar	Sí	Valor de text		Nom d'una segona propietat per la qual s'ha d'ordenar la llista
Ordena	N/A	Ascendent, descendent	Ascendent	Especifica si s'ha d'ordenar per la segona propietat en ordre ascendent o descendent
Tercera propietat per la qual s'ha d'ordenar	Sí	Valor de text		Nom d'una tercera propietat per la qual s'ha d'ordenar la llista
Ordena	N/A	Ascendent, descendent	Ascendent	Especifica si s'ha d'ordenar per la tercera propietat en ordre ascendent o descendent

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Desordena la llista

Creeu una permutació aleatòria d'una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llista que s'ha de desordenar	No	Llista de valors generals		Variable que conté la llista que s'ha de desordenar

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Combina les llistes

Combina dues llistes en una.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Primera llista	No	Llista de valors generals		Primera llista d'elements que s'han de combinar
Segona llista	No	Llista de valors generals		Segona llista d'elements que s'han de combinar

Variables generades

Argument	Type	Descripció
Llista de sortida	Llista de valors generals	La llista fusionada. Les llistes inicials no es veuen afectades

Excepcions

Excepció	Descripció
Les llistes proporcionades són de tipus incompatibles	Indica que les llistes proporcionades són de tipus incompatibles

Inverteix la llista

Inverteix l'ordre dels elements d'una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llista que s'ha d'invertir	No	Llista de valors generals		Llista els elements de la qual s'han d'invertir

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Suprimeix els elements duplicats de la llista

Suprimiu les múltiples aparicions d'elements d'una llista, de manera que a la llista resultant cada element sigui únic.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llista de la qual s'han de suprimir els elements duplicats	No	Llista de valors generals		Variable de llista de la qual s'han de suprimir elements duplicats
No diferencia entre les majúscules i les minúscules del text en cercar elements duplicats	N/A	Valor booleà	Fals	Especifica si s'ha de realitzar una comparació de text sense distinció entre majúscules i minúscules en cercar els elements duplicats (només s'aplica a les llistes formades per elements de text)

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Cerca els elements comuns de les llistes

Compareu dues llistes i creeu una llista nova amb els elements que són comuns a ambdues.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Primera llista	No	Llista de valors generals		Variable que conté la primera llista que s'ha de comparar
Segona llista	No	Llista de valors generals		Variable que conté la segona llista que s'ha de comparar

Variables generades

Argument	Type	Descripció
Llista d'interseccions	Llista de valors generals	Llista nova d'elements comuns

Excepcions

Aquesta acció no inclou cap excepció.

Resta les llistes

Compareu dues llistes i creeu una llista nova amb els elements que es troben a la primera llista però no a la segona.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Primera llista	No	Llista de valors generals		Variable que conté la primera llista que s'ha de comparar
Segona llista	No	Llista de valors generals		Variable que conté la segona llista que s'ha de comparar

Variables generades

Argument	Type	Descripció
Diferència de llista	Llista de valors generals	Llista resultant nova

Excepcions

Aquesta acció no inclou cap excepció.

Recupera la columna de la taula de dades a la llista

Converteix el contingut d'una columna de taula de dades en una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Taula de dades	No	Taula de dades		Taula de dades amb la columna que s'ha de convertir en una llista
Nom o índex de la columna	No	Valor de text		Nom de la columna, si es defineixen els noms de les columnes, o número d'índex de la columna que s'ha de recuperar

Variables generades

Argument	Type	Descripció
ColumnAsList	Llista de valors generals	Llista nova que conté el contingut de la taula de dades especificada

Excepcions

Excepció	Descripció
El nom de la columna no existeix	Indica que el nom de la columna no és a la taula de dades
L'índex de la columna està fora de l'interval	Indica que l'índex de la columna està fora de l'interval

Converteix un JSON a un objecte personalitzat

Converteix una cadena JSON en un objecte personalitzat.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
JSON	No	Valor de text		Text JSON o variable creada prèviament que en contingui un, que s'ha de convertir en un objecte personalitzat

Variables generades

Argument	Type	Descripció
JsonAsCustomObject	Valor general	L'objecte personalitzat convertit des del JSON proporcionat

Excepcions

Excepció	Descripció
S'ha produït un error en analitzar el JSON	Indica que hi ha un error en analitzar el JSON especificat

Converteix un objecte personalitzat a JSON

Converteix un objecte personalitzat en una cadena JSON.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Objecte personalitzat	No	Objecte personalitzat		Objecte personalitzat que s'ha de convertir a JSON

Variables generades

Argument	Type	Descripció
CustomObjectAsJson	Valor de text	JSON convertit de l'objecte personalitzat proporcionat

Excepcions

Excepció	Descripció
S'ha produït un error en analitzar l'objecte personalitzat	Indica que s'ha produït un error en analitzar l'objecte personalitzat

Afegeix un element a la llista

Afegeix un element nou a una llista.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Afegeix un element	No	Valor general		Un valor o una variable per afegir a la llista. Proporcioneu una llista de valors per afegir diversos elements. Si la llista té un tipus específic d'elements, l'element nou es converteix en aquest tipus
A la llista	No	Llista de valors generals		Variable de llista a la qual s'han d'annexar els elements nous

Variables generades

Argument	Type	Descripció
Llista nova	Llista de valors generals	Llista nova

Excepcions

Aquesta acció no inclou cap excepció.

Crea una llista nova

Creeu una llista buida.

Paràmetres d’entrada

Aquesta acció no requereix cap entrada.

Variables generades

Argument	Type	Descripció
Llista	Llista de valors generals	Llista nova

Excepcions

Aquesta acció no inclou cap excepció.

Incrementa la variable

Augmenta el valor d'una variable en una quantitat específica.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Nom de la variable	No	Valor numèric		Valor numèric que s'ha d'incrementar
Incrementa en	No	Valor numèric		Valor numèric, o variable creada prèviament que en conté un, segons el qual s'ha d'incrementar la variable

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Redueix la variable

Disminueix el valor d'una variable en una quantitat específica.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Nom de la variable	No	Valor numèric		Valor numèric, o variable creada prèviament que en conté un, segons el qual s'ha de reduir la variable
Redueix en	No	Valor numèric		Valor numèric, o variable creada prèviament que en conté un, segons el qual s'ha de reduir la variable

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Executa l'expressió del Power Fx

Executa l'expressió proporcionada Power Fx .

Nota

Aquesta acció només està disponible per als Power Fx fluxos d'escriptori habilitats (versió preliminar).

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Expression	No	*		Expressió del Power Fx que s'executarà

Variables generades

Aquesta acció no produeix cap variable.

Excepcions

Aquesta acció no inclou cap excepció.

Defineix la variable

Definiu el valor d'una variable nova o existent, creeu una variable nova o sobreescriviu una variable creada anteriorment.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Per a	No	*		El valor que s'assignarà a la variable

Variables generades

Argument	Type	Descripció
NewVar	*	El nom de l'atribut que es definirà

Nota

Els noms de les variables han de començar amb una lletra o un guió baix (_). Després del primer caràcter, els noms de les variables poden contenir lletres, guions baixos i dígits (0-9). Els noms no distingeixen entre majúscules i minúscules, és a dir, myVar, myvar i MYVAR es consideren la mateixa variable. Les paraules clau reservades següents no es poden utilitzar com a noms de variables: if, then, else, switch, case, default, loop, from, to, pas, foreach, in, while, next, exit, label, goto, call, output, function, block, end, error, wait, for, set, main, and, or, xor, not, true, false, yes, no, disable, on, repeat, times, throw, action, mod, global, input, import

Excepcions

Aquesta acció no inclou cap excepció.