Acciones de variables
Para crear manualmente una variable en un flujo de escritorio, implemente la acción Definir variables. Esta acción requiere que proporcione un nombre y un valor para la nueva variable.
Importante
Las palabras clave reservadas no se pueden utilizar como nombres de variables. Para obtener la lista completa de palabras clave reservadas, vaya a Palabras clave reservadas en flujos de escritorio.
Para aumentar o disminuir el valor numérico de una variable, use las acciones Aumentar variable y Reducir variable respectivamente.
La mayoría de las acciones generan su resultado en una variable. Por ejemplo, la acción Crear nueva lista produce una lista vacía.
Del mismo modo, la acción Generar número aleatorio produce un valor numérico aleatorio. Si habilita Generar varios números en esta acción, se crea una variable de lista que contiene varios valores numéricos aleatorios.
Para agregar elementos a una lista existente, implemente la acción Agregar elemento a la lista y complete un valor codificado o una variable para definir el elemento que se agregará. Del mismo modo, puede eliminar los elementos de la lista con la acción Quitar elemento de la lista.
Nota
Los índices de la lista comienzan en 0, lo que significa que el primer elemento de la lista siempre tendrá un índice de 0. Utilice la notación %ListName[0]% para hacer referencia al primer elemento de la lista, %ListName[1]% al segundo, y así sucesivamente.
Si desea crear una variable de tabla de datos, implemente la acción Crear nueva tabla de datos y defina los elementos iniciales de la misma utilizando el generador de objeto visual.
Para manipular una variable de tabla de datos, use las acciones del subgrupo de acciones correspondiente, como las acciones Buscar o reemplazar en la tabla de datos y Actualizar elemento de la tabla de datos.
Crear nueva tabla de datos
Crea una nueva variable de tabla de datos.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Nueva tabla | No | DataTable | La tabla de datos de entrada |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| DataTable | DataTable | La nueva tabla de datos |
Excepciones
Esta acción no incluye ninguna excepción.
Insertar fila en tabla de datos
Inserta una fila al final o antes de un valor de índice específico.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Tabla de datos | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. Esta variable se debe haber especificado anterior a través de una acción que produce una variable de tabla de datos debe haber especificado esta variable anteriormente | |
| En la ubicación | N/A | Fin de la tabla de datos, antes del índice de fila | Fin de la tabla de datos | Especifique si desea insertar la nueva fila al final de la tabla de datos o antes de un índice de fila especificado |
| Índice de fila | No | Valor numérico | Inserte el valor de índice de fila que se usará antes de especificar el índice de fila como parámetro de ubicación de entrada | |
| Nuevos valores | No | Lista, Fila de datos | Este parámetro acepta una variable de lista o fila de datos donde el recuento de columnas debe coincidir con el recuento de columnas de la tabla de datos |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Índice de elemento fuera de rango | Indica que el índice de elemento proporcionado está fuera del intervalo |
| Argumentos de entrada no válidos | Indica que hay un parámetro de entrada no válido |
| Error de tipo incompatible | Indica que se proporciona un parámetro de entrada de un tipo incompatible |
Buscar o reemplazar en la tabla de datos
Busca o reemplaza valores de la tabla de datos.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Tabla de datos | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. Esta variable se debe haber especificado anterior a través de una acción que produce una variable de tabla de datos debe haber especificado esta variable anteriormente | |
| Modo de búsqueda | N/A | Buscar, Buscar y reemplazar | Buscar | El modo con el que se buscará (buscar o buscar y reemplazar) |
| Todas las coincidencias | N/A | Valor booleano | Verdadero | Especifique si se encontrará o reemplazará texto en todas las celdas coincidentes encontradas o solo en la primera celda coincidente. |
| Texto a buscar | No | Valor de texto | El texto que se buscará en la tabla de datos | |
| Buscar con una expresión regular | N/A | Valor booleano | Falso | Especifique si se usará una expresión regular para que coincida con el contenido de la celda con el texto que se buscará |
| Coincidir mayúsculas y minúsculas | N/A | Valor booleano | Falso | Especifique si se buscarán datos con distinción de mayúsculas y minúsculas |
| Coincide con todo el contenido de la celda | N/A | Valor booleano | Falso | Especifique si se buscarán celdas que contengan solo el texto especificado |
| Texto con que le reemplazar | No | Valor de texto | Texto usado para reemplazar las celdas coincidentes | |
| Buscar por | N/A | En todas partes, en la columna | En todas partes | El orden en que se buscará el texto (en todas partes o en columna) |
| Nombre o índice de columna | No | Valor de texto | Encabezado de columna o valor de índice |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| DataTableMatches | DataTable | La tabla de datos que contiene los índices de fila y columna para las coincidencias |
Excepciones
| Excepción | Descripción |
|---|---|
| La expresión regular proporcionada no es válida | Indica que la expresión regular proporcionada no es válida |
| El nombre de la columna no existe | Indica que el nombre de columna especificado no existe |
| Índice de columna fuera de rango | Indica que el índice de columna proporcionado está fuera del intervalo |
| Error de tipo incompatible | Indica que se proporciona un parámetro de entrada de un tipo incompatible |
Actualizar elemento de la tabla de datos
Actualiza un elemento de fila de tabla de datos en una columna definida.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Tabla de datos | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. Esta variable se debe haber especificado anterior a través de una acción que produce una variable de tabla de datos debe haber especificado esta variable anteriormente | |
| Columna | No | Valor de texto | El índice o nombre de columna del elemento que se actualizará | |
| Fila | No | Valor numérico | El índice de fila del elemento que se actualizará | |
| Nuevo valor | No | Valor de texto | El nuevo valor que se actualizará en el índice de fila y la columna especificados |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Índice de elemento fuera de rango | Indica que el elemento de tabla especificado está fuera del intervalo |
| El nombre de la columna no existe | Indica que el nombre de columna especificado no existe |
| Índice de columna fuera de rango | Indica que el índice de columna proporcionado está fuera del intervalo |
| Error de tipo incompatible | Indica que se ha proporcionado un parámetro de entrada de un tipo incompatible |
Eliminar fila de la tabla de datos
Actualiza un elemento de fila de tabla de datos en una columna definida.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Tabla de datos | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. Esta variable se debe haber especificado anterior a través de una acción que produce una variable de tabla de datos debe haber especificado esta variable anteriormente | |
| Índice de fila | No | Valor numérico | El índice de fila dentro de una tabla de datos que debe eliminarse |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Índice de elemento fuera de rango | Indica que el elemento de tabla especificado está fuera del intervalo |
Truncar número
Sirve para obtener los dígitos enteros o fraccionarios de un valor numérico o para redondear el valor al alza, según el número especificado de posiciones decimales.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Number to truncate | No | Valor numérico | Número o variable que contiene el valor numérico para truncar/redondear al alza | |
| Operation | N/D | Obtener parte entera, Obtener parte decimal, Número redondeado | Obtener parte entera | Especifica la operación que se realizará en el número especificado |
| Decimal places | Sí | Valor numérico | 3 | El número de posiciones decimales para redondear el número dado. Ingrese 0 para devolver un número entero como resultado |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| TruncatedValue | Valor numérico | Número truncado o redondeado |
Excepciones
Esta acción no incluye ninguna excepción.
Generar número aleatorio
Sirve para generar un número aleatorio o una lista de números aleatorios comprendidos entre un valor mínimo y máximo.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Minimum value | Sí | Valor numérico | 0 | Límite inferior de los números aleatorios que se generarán |
| Maximum value | Sí | Valor numérico | 100 | Límite superior de los números aleatorios que se generarán |
| Generate multiple numbers | N/D | Valor booleano | False | Especifica si se va a generar un único número aleatorio o una lista de números aleatorios |
| How many numbers | Sí | Valor numérico | 10 | Especifica cuántos números aleatorios se van a generar |
| Allow duplicates | N/D | Valor booleano | False | Especifica si se va a permitir o impedir que el mismo número aparezca más de una vez en la lista de números aleatorios |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| RandomNumber | Valor numérico | Número aleatorio recién generado |
| RandomNumbers | Lista de valores numéricos | Lista recién generada de números aleatorios |
Excepciones
| Excepción | Descripción |
|---|---|
| No se pudo generar el número aleatorio | Indica que se ha producido un error al generar un número aleatorio |
Borrar lista
Quita todos los elementos de una lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| List to clear | No | Lista de valores generales | Variable de lista para quitar sus elementos |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Quitar elemento de la lista
Quita uno o varios elementos de una lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Remove item by | N/D | Índice, Valor | Índice | Especifica si se va a quitar el elemento en un índice especificado o los elementos con un valor específico |
| At index | No | Valor numérico | Número de índice del elemento que se va a quitar | |
| With value | No | Valor general | Elemento que se va a quitar | |
| Remove all item occurrences | N/D | Valor booleano | False | Quita todas las repeticiones que coincidan con el elemento especificado |
| From list | No | Lista de valores generales | Lista con los elementos que se van a quitar |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Índice de elemento fuera de rango | Indica que el índice de elemento está fuera del intervalo |
| Elemento no encontrado | Indica que el elemento no existe en la lista |
Ordenar lista
Ordenar los elementos de una lista. Usar elementos del mismo tipo.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| List to sort | No | Lista de valores generales | Variable que contiene la lista que se va a ordenar | |
| Sort by list item's properties | N/D | Valor booleano | False | Si los elementos de la lista son objetos (como archivos, carpetas, etc.), habilite esta opción para ordenar el elemento por una propiedad específica. Deje esta opción desactivada para ordenar los elementos por su propiedad predeterminada (por ejemplo, los objetos de archivo se ordenan por su ruta completa) |
| First property to sort by | Sí | Valor de texto | Nombre de la propiedad de un elemento según la cual se va a ordenar la lista. Consulte el archivo de ayuda para conocer los nombres de propiedad de cada objeto. | |
| Sort | N/D | Ascendente, Descendente | Ascendente | Especifica si se va a ordenar según la primera propiedad de forma ascendente o descendente |
| Second property to sort by | Sí | Valor de texto | Nombre de una segunda propiedad según la cual se va a ordenar la lista | |
| Sort | N/D | Ascendente, Descendente | Ascendente | Especifica si se va a ordenar según la segunda propiedad de forma ascendente o descendente |
| Third property to sort by | Sí | Valor de texto | Nombre de una tercera propiedad según la cual se va a ordenar la lista | |
| Sort | N/D | Ascendente, Descendente | Ascendente | Especifica si se va a ordenar según la tercera propiedad de forma ascendente o descendente |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Lista aleatoria
Sirve para crear una permutación aleatoria de una lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| List to shuffle | No | Lista de valores generales | Variable que contiene la lista que se va a mezclar |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Combinar listas
Sirve para combinar dos listas en una.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| First list | No | Lista de valores generales | La primera lista de elementos que se va a combinar | |
| Second list | No | Lista de valores generales | La segunda lista de elementos que se va a combinar |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| OutputList | Lista de valores generales | Lista combinada. Las listas iniciales no se ven afectadas. |
Excepciones
| Excepción | Descripción |
|---|---|
| Las listas suministradas son de tipos incompatibles | Indica que las listas suministradas son de tipos incompatibles |
Invertir lista
Sirve para invertir el orden de los elementos de una lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| List to reverse | No | Lista de valores generales | Lista cuyos elementos se van a invertir |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Quitar los elementos duplicados de una lista
Quita las diversas repeticiones de los elementos de una lista, por lo que en la lista resultante cada elemento es único.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| List to remove duplicate items from | No | Lista de valores generales | Variable de lista de la que quitar los elementos duplicados | |
| Ignore text case while searching for duplicate items | N/D | Valor booleano | False | Especifica si se va a realizar la comparación de texto sin distinción de mayúsculas y minúsculas mientras se buscan elementos duplicados (solo se aplica a las listas de elementos de texto) |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Buscar elementos de lista comunes
Compara dos listas y crea una lista nueva con los elementos comunes a ambas.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| First list | No | Lista de valores generales | Variable que contiene la primera lista que se va a comparar | |
| Second list | No | Lista de valores generales | Variable que contiene la segunda lista que se va a comparar |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| IntersectionList | Lista de valores generales | Nueva lista de elementos comunes |
Excepciones
Esta acción no incluye ninguna excepción.
Restar listas
Compara dos listas y crea una lista nueva con los elementos que están en la primera lista, pero no en la segunda.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| First list | No | Lista de valores generales | Variable que contiene la primera lista que se va a comparar | |
| Second list | No | Lista de valores generales | Variable que contiene la segunda lista que se va a comparar |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| ListDifference | Lista de valores generales | La nueva lista resultante |
Excepciones
Esta acción no incluye ninguna excepción.
Recuperar columna de tabla de datos en lista
Sirve para convertir el contenido de una tabla de datos en lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | Tabla de datos con la columna que se va a convertir en lista | |
| Column name or index | No | Valor de texto | Nombre de columna, si se definen nombres de columna, o número de índice de la columna que se va a recuperar |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| ColumnAsList | Lista de valores generales | La nueva lista con el contenido de la tabla de datos especificada |
Excepciones
| Excepción | Descripción |
|---|---|
| El nombre de la columna no existe | Indica que el nombre de columna no se encuentra en la tabla de datos |
| Índice de columna fuera de rango | Indica que el índice de columna está fuera del intervalo |
Convertir JSON a objeto personalizado
Convierte una cadena JSON a un objeto personalizado.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| JSON | No | Valor de texto | Texto JSON, o variable creada anteriormente que lo contenga, que se va a convertir a objeto personalizado |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| JsonAsCustomObject | Valor general | El objeto personalizado convertido a partir del JSON proporcionado |
Excepciones
| Excepción | Descripción |
|---|---|
| Error al analizar JSON | Indica que se ha producido un error al analizar el JSON especificado |
Convertir objeto personalizado a JSON
Sirve para convertir un objeto personalizado en cadena JSON.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Custom object | No | Objeto personalizado | Objeto personalizado que se convertirá a JSON |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| CustomObjectAsJson | Valor de texto | JSON convertido del objeto personalizado proporcionado |
Excepciones
| Excepción | Descripción |
|---|---|
| Error al analizar el objeto personalizado | Indica que se ha producido un error al analizar el objeto personalizado |
Agregar un elemento a una lista
Sirve para anexar un elemento nuevo a una lista.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Add item | No | Valor general | Un valor o una variable para agregar a la lista. Proporcione una lista de valores para agregar varios elementos. Si la lista tiene un tipo específico de elementos, el nuevo elemento se convierte a ese tipo | |
| Into list | No | Lista de valores generales | Variable de lista a la que se anexarán los nuevos elementos |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| NewList | Lista de valores generales | La nueva lista |
Excepciones
Esta acción no incluye ninguna excepción.
Crear nueva lista
Sirve para crear una nueva lista vacía.
Parámetros de entrada
Esta acción no requiere ninguna entrada.
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| List | Lista de valores generales | La nueva lista |
Excepciones
Esta acción no incluye ninguna excepción.
Aumentar variable
Sirve para aumentar el valor de una variable en una cantidad específica.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Variable name | No | Valor numérico | Valor numérico que se aumentará | |
| Increase by | No | Valor numérico | Valor numérico, o variable creada anteriormente que lo contenga, según el cual se va a aumentar la variable |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Reducir variable
Reduce el valor de una variable en una cantidad específica.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Variable name | No | Valor numérico | Valor numérico, o variable creada anteriormente que lo contenga, según el cual se va a reducir la variable | |
| Decrease by | No | Valor numérico | Valor numérico, o variable creada anteriormente que lo contenga, según el cual se va a reducir la variable |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Ejecutar expresión de Power Fx
Ejecuta la expresión de Power Fx proporcionada.
Nota
Esta acción solo está disponible para flujos de escritorio de Power Fx habilitados (versión preliminar).
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Description |
|---|---|---|---|---|
| Expression | No | * | La expresión de Power Fx que se va a ejecutar |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Establecer variable
Establece el valor de una variable nueva o existente, crea una nueva variable o sobrescribe una variable creada anteriormente.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| To | No | * | Valor que se asignará a la variable |
Variables producidas
| Argumento | Type | Description |
|---|---|---|
| NewVar | * | Nombre de la variable que se establecerá |
Nota
Los nombres de las variables deben comenzar con una letra o un guión bajo (_). Después del primer carácter, los nombres de las variables pueden contener letras, guiones bajos y dígitos (0-9). Los nombres no distinguen entre mayúsculas y minúsculas, lo que significa que myVar, myvar y MYVAR se consideran la misma variable. Las siguientes palabras clave reservadas no se pueden usar como nombres de variables: if, then, else, switch, case, default, loop, from, to, step, 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
Excepciones
Esta acción no incluye ninguna excepción.