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 |
Eliminar fila de la tabla de datos
Elimine una fila de tabla de datos en el índice de fila correspondiente.
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. La acción que produce una variable de tabla de datos debe haber especificado esta variable previamente | |
| Í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 |
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. La acción que produce una variable de tabla de datos debe haber especificado esta variable previamente. | |
| Column | No | Valor de texto | El índice o nombre de columna del elemento que se actualizará. | |
| Row | 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 |
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 |
Insertar columna en tabla de datos
Inserta una columna 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. La acción que produce una variable de tabla de datos debe haber especificado esta variable previamente. | |
| En la ubicación | N/A | Fin de la tabla de datos, Antes del índice de columna | Fin de la tabla de datos | Especifique si desea insertar la nueva columna al final de la tabla de datos o antes de un índice de columna especificado. |
| Nombre de la columna | No | Valor de texto | Especifique el encabezado de la nueva columna. | |
| Índice de columna | No | Valor numérico | Especifique el valor del índice de columna que se utiliza cuando se selecciona la opción Antes del índice de columna para el parámetro En la ubicación. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Índice de columna fuera de rango | Indica que el índice de columna especificado está fuera de rango. |
| Duplicar nombre de columna | Indica que existe una columna con ese nombre. |
Eliminar columna de la tabla de datos
Eliminar una columna de tabla de datos en el nombre de columna o índice de columna especificado.
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. La acción que produce una variable de tabla de datos debe haber especificado esta variable previamente. | |
| Especificar columna con | N/A | Nombre, Índice | Name | Especifique si se buscará la columna por nombre o índice. |
| Nombre de la columna | No | Valor de texto | El nombre de la columna que se debe eliminar. | |
| Índice de columna | No | Valor numérico | El índice de la columna que se debe eliminar. Los índices de las columnas comienzan desde 0. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| 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 |
Eliminar filas vacías de la tabla de datos
Elimina las filas de la tabla de datos que tienen todas sus celdas vacías.
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 |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Eliminar filas duplicadas de la tabla de datos
Elimina todas las filas que están duplicadas de la tabla de datos, si los valores tienen el mismo tipo de datos en cada columna.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Error de coincidencia de tipos en las celdas de una columna | Indica que dos o más valores de una sola columna son de tipo de datos diferente |
Borrar tabla de datos
Elimina todas las filas de la tabla de datos y mantiene los encabezados de tabla no afectados.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
Esta acción no incluye ninguna excepción.
Ordenar tabla de datos
Ordena las filas de la tabla de datos en orden ascendente o descendente según la columna especificada, si todos sus valores tienen el mismo tipo de datos.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. | |
| Especificar columna con | N/A | Nombre, Índice | Name | Especifique si se buscará la columna por nombre o índice. |
| Nombre de la columna | No | Valor de texto | El nombre de la columna que se debe ordenar. | |
| Índice de columna | No | Valor numérico | El índice de la columna que se debe ordenar. Los índices de las columnas comienzan desde 0. | |
| Ordenar | N/A | Ascendente, Descendente | Ascendente | El orden en que se debe ordenar la tabla de datos. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| 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 especificado está fuera de rango |
| Error de coincidencia de tipos en las celdas de una columna | Indica que dos o más valores de una sola columna son de tipo de datos diferente |
Filtrar tabla de datos
Filtra las filas de la tabla de datos según las reglas aplicadas.
En el asistente integrado de la acción que le ayuda a crear los filtros necesarios, puede aplicar varios filtros a diferentes columnas definidas por nombre o índice. Cada filtro se compone de una columna específica a la que apunta, un operador seleccionado y el valor que se le asigna.
Además, se aplican varios filtros juntos mediante reglas AND y/u OR. Las reglas AND se resuelven primero en la expresión de filtro resultante, seguidas de las reglas OR.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. | |
| Filtros para aplicar | No | Reglas de filtrado definidas por el usuario | N/A | Reglas de filtrado aplicadas a la columna definida |
Variables producidas
| Argumento | Type | Description |
|---|---|---|
| FilteredDataTable | DataTable | La tabla de datos generada después de aplicar los filtros |
Excepciones
| Excepción | Description |
|---|---|
| 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 especificado está fuera de rango |
| Error de coincidencia de tipos en las celdas de una columna | Indica que dos o más valores de una sola columna son de tipo de datos diferente |
Combinar tablas de datos
Combina dos tablas de datos, especificando el comportamiento de combinación en caso de que su número de columnas sea diferente.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Description |
|---|---|---|---|---|
| Primera tabla de datos | No | DataTable | La primera variable de la tabla de datos con la que se va a trabajar. Esta es también la variable producida por la acción que contiene la tabla de datos fusionados. | |
| Segunda tabla de datos | No | DataTable | La segunda tabla de datos que se fusiona con la primera tabla de datos. | |
| Modo de combinación | N/A | Agregar columnas adicionales, Ignorar columnas adicionales, Error en columnas adicionales | Agregar columnas adicionales | El comportamiento de fusión que se aplica cuando las tablas no tienen el mismo número de columnas. |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Description |
|---|---|
| Falta el esquema | Indica que las tablas de datos no tienen el mismo número de columnas |
Combinar tablas de datos
Combina dos tablas de datos basadas en la regla de combinación especificada.
En el asistente integrado de la acción que le ayuda a crear las reglas de unión necesarias, puede establecer varias reglas especificando la columna de la primera y segunda tabla de datos en consecuencia, y el operador de comparación que se aplica entre ellas.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Description |
|---|---|---|---|---|
| Primera tabla de datos | No | DataTable | La primera variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. | |
| Segunda tabla de datos | No | DataTable | La segunda variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. | |
| Operación de combinación | N/A | Interna, Izquierda, Completa | Interno | La operación de unión que se utiliza para unir las dos tablas. |
| Unirse a reglas | No | Reglas de combinación definidas por el usuario | N/A | Definir las columnas y la operación que se utilizará para unir las dos tablas de datos. |
Variables producidas
| Argumento | Type | Description |
|---|---|---|
| JoinedDataTable | DataTable | La tabla de datos generada después de la operación de combinación |
Excepciones
| Excepción | Description |
|---|---|
| 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 especificado está fuera de rango |
Leer desde la variable de texto CSV
Genera una tabla de datos a partir de un archivo CSV.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Description |
|---|---|---|---|---|
| Texto CSV | No | Valor de texto | Variable de archivo CSV que se leerá. | |
| Trim fields | N/A | Valor booleano | VERDADERO | Especifica si se recortan automáticamente los espacios en blanco iniciales y finales de las celdas extraídas. |
| La primera línea contiene nombres de columnas | N/A | Valor booleano | False | Especifica si se debe utilizar la primera fila del archivo CSV para establecer los nombres de columna de la tabla de datos resultante. Habilite esta opción para evitar leer los nombres como datos en la tabla. Las acciones posteriores podrían tener acceso a los datos que contiene la tabla de datos utilizando nombres de columna (en lugar de números de columna). |
| Obtener campos CSV como texto | N/A | Valor booleano | False | Especifique si desea recuperar el contenido de los campos de texto CSV únicamente como texto o como el tipo de coincidencia más cercano. Por ejemplo, Fecha y hora para fechas y Numérico para números. |
| Columns separator | N/A | Anchos de columna predefinidos, personalizados y fijos | Predefinido | Especifica si se va a usar un separador de columnas predefinido o un separador personalizado, o anchos de columna fijos. |
| Separator | N/A | Predeterminado del sistema, coma, punto y coma, tabulación | Valores predeterminados del sistema | Separador de columnas para analizar el archivo CSV. |
| Custom separator | No | Valor de texto | Separador de columnas personalizado que se usará para analizar el archivo CSV. | |
| Fixed column widths | No | Valor de texto | Anchos de columna fijos que se usarán para analizar el archivo CSV. Separe los anchos con comas, espacios, tabulaciones o líneas nuevas. |
Variables producidas
| Argumento | Type | Description |
|---|---|---|
| CSVTable | DataTable | Contenido del texto CSV como tabla de datos |
Excepciones
| Excepción | Description |
|---|---|
| Error en el análisis CSV | Indica un problema al analizar el texto CSV |
Convertir la tabla de datos en texto
Convierte una tabla de datos en archivo CSV.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Data table | No | DataTable | La variable de la tabla de datos con la que se va a trabajar. La variable especificada debe definirse mediante una acción que genere una variable de tabla de datos. | |
| Include column names | N/A | Valor booleano | False | Especifica si los nombres de columna de la variante especificada se deben convertir en la primera fila del archivo CSV. |
| Use custom columns separator | N/A | Valor booleano | False | Especifica si se utiliza un separador de columnas personalizado o un separador de columnas predefinido. |
| Separator | N/A | Predeterminado del sistema, coma, punto y coma, tabulación | Valores predeterminados del sistema | Separador de columnas que se usará en el archivo CSV especificado. |
| Custom columns separator | No | Valor de texto | Separador de columnas personalizado que se usará en el archivo CSV especificado. |
Variables producidas
| Argumento | Type | Description |
|---|---|---|
| CSVText | Valor de texto | La variable en la que se almacena el resultado CSV |
Excepciones
| Excepción | Description |
|---|---|
| Error en la conversión | Indica un problema al convertir la tabla de datos al texto CSV |
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.