Funciones personalizadas de PlaidXL
PlaidXL agrega a Excel funciones que leen datos de PlaidCloud directamente en las celdas. Escriba =PLAIDXL. en una celda y el autocompletado de Excel las enumera, con una breve descripción de cada argumento. La pestaña Formulas del panel de tareas también puede escribir una por usted; consulte Insertar una fórmula desde el panel de tareas.
| Grupo | Funciones | Úselas para |
|---|---|---|
| Listas | LIST_PROJECTS, TABLE.TBL_LIST, TABLE.GET_COLUMNS, DIMENSION.DIM_LIST |
Ver qué hay disponible para construir |
| Tablas | TABLE.GET_TABLE |
Leer una tabla completa en un rango |
| Jerarquías | DIMENSION.GET_DIMENSION, DRILL |
Organizar los nodos de una dimensión como filas de un informe |
| Valores | CELL, CELLS |
Calcular un valor acumulado para cualquier combinación de nodos |
| Métricas | METRIC, METRIC_BREAKDOWN |
Leer una métrica de negocio gobernada, tal como la muestran los paneles de control |
| Bloques de construcción | REPR.TABLE_REPR, REPR.MEASURE, REPR.MEASURES, REPR.MEASURE_TYPE, REPR.DIMENSION_REPR, REPR.DRILL_KEY |
Describir la tabla, la medida, la agregación, los nodos y la profundidad de exploración que usan CELL, CELLS y DRILL |
Crear un informe muestra cómo funcionan en conjunto.
Cómo funcionan las funciones
Sección titulada «Cómo funcionan las funciones»- Inicie sesión primero. Las funciones leen con su inicio de sesión de PlaidCloud y sus permisos, así que inicie sesión desde el panel de tareas antes de usarlas.
- Leen del proyecto del libro. Cada función lee del proyecto vinculado al libro en el panel de tareas.
GET_TABLE,TBL_LISTyDIM_LISTtambién aceptan un ID de proyecto opcional, para leer otro proyecto sin cambiar el vínculo. Cada libro tiene su propio proyecto, así que dos libros abiertos pueden leer de proyectos distintos. - Los resultados se desbordan. Una función que devuelve una lista o una tabla rellena las celdas de abajo (o las de la derecha). Deje espacio para los resultados; si algo lo impide, Excel muestra un error
#SPILL!. - Recalcule para recoger los cambios. Una fórmula de PlaidXL vuelve a consultar los datos cuando cambia uno de sus argumentos. Para recoger datos nuevos de PlaidCloud, o un proyecto distinto vinculado en el panel de tareas, use el menú Actualizar de la cinta de opciones: Recalculate PlaidXL formulas recalcula todas las fórmulas de PlaidXL del libro, y Refresh this sheet y Refresh selection recalculan las fórmulas que abarcan. Refresh all tables actualiza las tablas recuperadas, no las fórmulas. Consulte Actualizar.
- Use nombres exactos. Escriba los nombres de tablas, columnas, dimensiones y nodos exactamente como aparecen en PlaidCloud.
Los argumentos entre corchetes son opcionales.
LIST_PROJECTS
Sección titulada «LIST_PROJECTS»=PLAIDXL.LIST_PROJECTS([horizontal])
Enumera los nombres de los proyectos que puede abrir, ordenados por nombre.
horizontal:TRUEpara enumerar en una fila. El valor predeterminado esFALSE, una columna.
TBL_LIST
Sección titulada «TBL_LIST»=PLAIDXL.TABLE.TBL_LIST([project_id], [horizontal])
Enumera los nombres de las tablas de un proyecto, ordenados por nombre.
project_id: el proyecto que se va a leer. El valor predeterminado es el proyecto del libro.horizontal:TRUEpara enumerar en una fila. El valor predeterminado esFALSE, una columna.
GET_COLUMNS
Sección titulada «GET_COLUMNS»=PLAIDXL.TABLE.GET_COLUMNS(table_name, [column_filter], [orientation])
Enumera los nombres de las columnas de una tabla del proyecto seleccionado.
table_name: el nombre de la tabla en PlaidCloud.column_filter: un tipo de datos, como"text", para enumerar solo las columnas de ese tipo. Omítalo para enumerar todas las columnas.orientation:"vertical"(el valor predeterminado) para una columna, o"horizontal"para una fila.
DIM_LIST
Sección titulada «DIM_LIST»=PLAIDXL.DIMENSION.DIM_LIST([project_id], [horizontal])
Enumera los nombres de las dimensiones de un proyecto.
project_id: el proyecto que se va a leer. El valor predeterminado es el proyecto del libro.horizontal:TRUEpara enumerar en una fila. El valor predeterminado esFALSE, una columna.
GET_TABLE
Sección titulada «GET_TABLE»=PLAIDXL.TABLE.GET_TABLE(table_name, [project_id], [limit])
Devuelve las filas de una tabla con una fila de encabezado, desbordadas desde la celda de la fórmula. Los valores vacíos se devuelven como celdas en blanco.
table_name: el nombre de la tabla en PlaidCloud.project_id: el proyecto que se va a leer. El valor predeterminado es el proyecto del libro.limit: el máximo de filas que se devuelven. El valor predeterminado es 1 048 575, el máximo que cabe en una hoja de cálculo debajo de una fila de encabezado.
GET_TABLE devuelve todas las columnas. Para elegir columnas o filtrar filas, recupere la tabla desde el panel de tareas.
Jerarquías
Sección titulada «Jerarquías»GET_DIMENSION
Sección titulada «GET_DIMENSION»=PLAIDXL.DIMENSION.GET_DIMENSION(dimension_name, start_node, [hierarchy], [orientation], [generation_limit])
Organiza los nodos de una dimensión, empezando por start_node y descendiendo por sus descendientes. Cada generación tiene una sangría de cuatro espacios más que su elemento principal, y los grupos de esquema de Excel le permiten contraer y expandir cada nivel.
dimension_name: el nombre de la dimensión, o su ruta en el proyecto.start_node: el nodo desde el que empezar, como la raíz de la dimensión.hierarchy: la jerarquía alternativa que se sigue. El valor predeterminado es"main".orientation:"vertical"(el valor predeterminado) para enumerar los nodos en una columna, o"horizontal"para enumerarlos en una fila.generation_limit: cuántas generaciones se devuelven, contandostart_nodecomo la primera:2devuelve el nodo inicial y sus hijos. Omítalo para devolver todas las generaciones.
=PLAIDXL.DRILL(dimension_name, start_node, drill_key, [hierarchy], [exclude], [expand], [orientation])
Devuelve start_node y los nodos situados debajo que pide drill_key, con sangría por generación y agrupados en un esquema de Excel.
dimension_name: el nombre de la dimensión, o su ruta en el proyecto.start_node: el nodo desde el que explorar. Déjelo vacío ("") para empezar por los nodos superiores de la dimensión. La propia dimensión cuenta como la generación 0 de la clave de exploración y no se muestra, así que los nodos superiores son la generación 1:>[1]muestra solo los nodos superiores, y>[0]no muestra nada.drill_key: hasta dónde explorar, a partir deDRILL_KEY: todos los descendientes, solo las hojas, un número de niveles o un rango de generaciones.hierarchy: la jerarquía alternativa que se sigue. El valor predeterminado es"main".exclude: nodos que se omiten, con todo lo que hay debajo: un nodo, una lista o un rango de celdas. El nodo inicial nunca se omite.expand: nodos cuyos hijos también se muestran, incluso por debajo de la profundidad que pidedrill_key: un nodo, una lista o un rango de celdas. Solo se abren los nodos que muestra la exploración, así que para abrir un nieto, incluya también a su elemento principal.orientation:"vertical"(el valor predeterminado) para enumerar los nodos en una columna, o"horizontal"para enumerarlos en una fila, sin sangría y agrupados por columna. Cualquier otro valor es un error.
exclude y expand aceptan ID de nodo como texto o números; las celdas vacías y los errores de un rango se ignoran. Deje un argumento vacío ("") para omitirlo, como en =PLAIDXL.DRILL("Period", "FY2026", PLAIDXL.REPR.DRILL_KEY("1 level"), "main", "", "", "horizontal").
Por ejemplo, =PLAIDXL.DRILL("Region", "Total", PLAIDXL.REPR.DRILL_KEY("leaves")) enumera Total seguido de todas las regiones hoja que hay debajo.
Los comandos de exploración escriben y editan fórmulas DRILL por usted: seleccione un nodo y explore hacia abajo, explore hacia arriba, conserve o quite nodos.
Valores
Sección titulada «Valores»CELL y CELLS calculan una medida (una columna numérica de una tabla) acumulada hasta los nodos que elija en una o más dimensiones. Piense en cada llamada como una intersección de un informe: Ingresos de EMEA en FY2026.
Usted describe la intersección con las funciones de bloque de construcción que se indican a continuación, normalmente en sus propias celdas, y después pasa esas celdas a CELL o CELLS en cualquier orden:
| Argumento | Se construye con | Obligatorio |
|---|---|---|
| La tabla que se lee | TABLE_REPR |
Exactamente una |
| La columna que se agrega | MEASURE para CELL, MEASURES o varias celdas MEASURE para CELLS |
Sí |
| Cómo se agrega | MEASURE_TYPE |
No: el valor predeterminado es sum |
| Un filtro sobre una columna | DIMENSION_REPR |
Al menos uno, uno por columna |
Cada filtro nombra una columna de la tabla y un valor. Cuando esa columna está vinculada a una dimensión en PlaidCloud, el valor es un nodo, y el filtro incluye todo lo que se acumula hasta ese nodo en la jerarquía principal de la dimensión, o en la jerarquía que usted nombre: en una columna Región vinculada a una dimensión de geografía, el nodo EMEA abarca todos los países que hay debajo. En una columna que no está vinculada a una dimensión, el filtro coincide exactamente con el valor.
Los ejemplos de esta página usan una tabla cuyas columnas Región y Período están vinculadas a dimensiones. Use los nombres de columna de su propia tabla.
=PLAIDXL.CELL(table, measure, [measure_type], node, [node], ...)
Devuelve un número: la medida, agregada sobre las filas que quedan bajo todos los nodos que pase.
A1 =PLAIDXL.REPR.TABLE_REPR("Sales")A2 =PLAIDXL.REPR.MEASURE("revenue")A3 =PLAIDXL.REPR.MEASURE_TYPE("sum")A4 =PLAIDXL.REPR.DIMENSION_REPR("Region", "EMEA")A5 =PLAIDXL.REPR.DIMENSION_REPR("Period", "FY2026")B1 =PLAIDXL.CELL(A1, A2, A3, A4, A5)B1 muestra los ingresos totales de EMEA en FY2026.
Escriba un número sobre una CELL para escribirlo en PlaidCloud. Consulte Escribir valores en PlaidCloud.
Una hoja llena de fórmulas CELL se calcula con rapidez: las fórmulas CELL que se calculan juntas se envían a PlaidCloud en una sola solicitud, hasta 10 000 a la vez, y PlaidXL reutiliza durante 30 segundos los detalles de las columnas de una tabla en lugar de consultarlos para cada celda. Si no se puede calcular un valor, la celda muestra #VALUE! y al pasar el cursor sobre ella se muestra el motivo tal como lo informó PlaidCloud, por ejemplo una columna de filtro que no está en la tabla o un nodo sin miembros. CELLS muestra el primer motivo para todo el resultado.
Cuando ninguna fila coincide, una sum es 0. Cualquier otra forma de combinar (mean, median, min, max, std o var) no tiene ningún valor que dar: una CELL muestra #VALUE! con No value for la agregación, los miembros y la medida al pasar el cursor, y un elemento de CELLS se deja en blanco. Las funciones de Excel como AVERAGE omiten un elemento en blanco de CELLS, y Explicar da el mismo motivo.
=PLAIDXL.CELLS(table, measures, [measure_type], node, [node], ...)
Como CELL, pero para varias medidas a la vez. Devuelve un número por medida, en una columna, en el orden en que las enumeró.
D1:F1 revenue | cost | unitsD2 =PLAIDXL.REPR.MEASURES(D1:F1)B2 =PLAIDXL.CELLS(A1, D2#, A3, A4, A5)D2# pasa todo el resultado desbordado de MEASURES. B2:B4 muestran los ingresos, el costo y las unidades de EMEA en FY2026.
Métricas
Sección titulada «Métricas»METRIC y METRIC_BREAKDOWN leen una definición de métrica del proyecto del libro: un número de negocio como Net Revenue cuyo cálculo está acordado y documentado en PlaidCloud. El valor es el que muestran los paneles de control, calculado con su propio acceso a filas. Metric… en la cinta de opciones enumera las métricas del proyecto con sus valores actuales y escribe la fórmula por usted; consulte Insertar una métrica.
Los filtros son valores de DIMENSION_REPR, como en CELL, salvo que el primer argumento nombra una columna por la que se puede desglosar la métrica. Un nodo incluye todo lo que hay debajo. Pase un solo filtro, o un rango o una lista de ellos; los filtros vacíos se ignoran. Una fórmula puede usar filtros de más de una jerarquía alternativa, y puede combinar un miembro de una jerarquía alternativa con miembros de otras dimensiones.
=PLAIDXL.METRIC(name, [filter], ...)
Devuelve un número: la métrica, para las filas que quedan bajo todos los filtros que pase.
name: el nombre de la métrica, uno de sus sinónimos o su ID. No distingue mayúsculas de minúsculas.filter: un filtroDIMENSION_REPR. Pase tantos como necesite.
=PLAIDXL.METRIC("Net Revenue", PLAIDXL.REPR.DIMENSION_REPR("Region", "EMEA"))Cuando ninguna fila coincide, METRIC devuelve 0; cuando la métrica no tiene valor, la celda queda en blanco.
METRIC_BREAKDOWN
Sección titulada «METRIC_BREAKDOWN»=PLAIDXL.METRIC_BREAKDOWN(name, breakdown, [filter], ...)
Devuelve la métrica dividida por una columna: dos columnas, con cada miembro de breakdown junto a su valor, el valor más grande primero, sin fila de encabezado.
name: el nombre de la métrica, uno de sus sinónimos o su ID.breakdown: la columna por la que se desglosa la métrica, una por la que la métrica se pueda desglosar.filter: un filtroDIMENSION_REPR. Pase tantos como necesite.
=PLAIDXL.METRIC_BREAKDOWN("Net Revenue", "Region")Los miembros sin valor van al final, con un valor en blanco. Cuando ninguna fila coincide, devuelve una fila: un miembro vacío y 0.
Errores de métricas
Sección titulada «Errores de métricas»Una métrica que no se puede calcular muestra #VALUE!; pase el cursor sobre la celda para ver el motivo:
| Mensaje | Qué hacer |
|---|---|
| Métrica desconocida, o columna desconocida | Compruebe el nombre. Cuando hay coincidencias cercanas, el mensaje las enumera después de Did you mean. |
| El nombre coincide con más de una métrica | Use el nombre completo de la métrica o su ID. |
| Your PlaidCloud role doesn’t allow reading metrics in this project. | Solicite acceso a un propietario del proyecto. |
| This PlaidCloud workspace doesn’t serve metrics to Excel yet. | Pida a su administrador que actualice el espacio de trabajo. |
| PlaidCloud is busy; try again in un número de segundos | PlaidXL ya lo ha reintentado. Recalcule después del tiempo que indica. |
| Choose a project in the PlaidXL pane first. | Vincule el libro a un proyecto. |
| This PlaidCloud workspace can’t combine an alternate hierarchy with other members yet. Ask your administrator to update the workspace. | Pida a su administrador que actualice el espacio de trabajo. Las demás celdas del mismo recálculo siguen respondiendo. |
Bloques de construcción
Sección titulada «Bloques de construcción»Estas funciones no leen datos por sí mismas. Cada una devuelve un fragmento de texto breve que describe una parte de un cálculo, listo para pasarlo a CELL, CELLS o DRILL. Colóquelas en celdas a las que haga referencia, de modo que un solo cambio (un período distinto, por ejemplo) actualice todas las fórmulas que las usan.
TABLE_REPR
Sección titulada «TABLE_REPR»=PLAIDXL.REPR.TABLE_REPR(table_name)
La tabla de la que leen CELL y CELLS, por su nombre en el proyecto seleccionado.
MEASURE
Sección titulada «MEASURE»=PLAIDXL.REPR.MEASURE(column_name)
La columna numérica que agrega CELL.
MEASURES
Sección titulada «MEASURES»=PLAIDXL.REPR.MEASURES(column_names)
Varias columnas de medida para CELLS, a partir de un rango de celdas que contienen nombres de columna. El resultado se desborda en una celda por columna; páselo a CELLS con el operador de desbordamiento, como D2#.
MEASURE_TYPE
Sección titulada «MEASURE_TYPE»=PLAIDXL.REPR.MEASURE_TYPE(agg_function)
Cómo se agrega la medida. agg_function es uno de estos valores, en minúsculas:
| Valor | Devuelve |
|---|---|
sum |
El total (el valor predeterminado cuando no se pasa un tipo de medida) |
mean |
El promedio |
median |
El valor central |
min |
El valor más pequeño |
max |
El valor más grande |
std |
La desviación estándar |
var |
La varianza |
DIMENSION_REPR
Sección titulada «DIMENSION_REPR»=PLAIDXL.REPR.DIMENSION_REPR(dimension_name, start_node, [hierarchy])
Un filtro para CELL, CELLS, METRIC y METRIC_BREAKDOWN. Pase uno por cada columna por la que quiera filtrar.
dimension_name: el nombre de una columna de la tabla, la columna que contiene los valores de la dimensión, como"Region". Debe coincidir exactamente con el nombre de la columna; una columna que no está en la tabla devuelve un error.start_node: el nodo hasta el que se acumula, como"EMEA". En una columna que no está vinculada a una dimensión, el valor con el que se hace coincidir.hierarchy: la jerarquía alternativa por la que se acumula el nodo. El valor predeterminado es"main".
Haga referencia a una celda para el nodo a fin de crear una cuadrícula: =PLAIDXL.REPR.DIMENSION_REPR("Region", $A7). Los espacios iniciales y finales se ignoran, así que puede apuntar a los nombres de nodo con sangría que organiza DRILL.
DRILL_KEY
Sección titulada «DRILL_KEY»=PLAIDXL.REPR.DRILL_KEY(d_key)
Hasta dónde llega DRILL por debajo de su nodo inicial. d_key es texto sin formato, ya sea una forma con palabras o una clave de exploración escrita completa:
d_key |
Explora hasta |
|---|---|
"all" |
Todos los descendientes |
"leaves" |
Solo las hojas, que son los nodos sin nada debajo |
"1 level", "2 levels", … |
Esa cantidad de generaciones hacia abajo |
">[...]" |
La clave de exploración escrita completa, como en la tabla siguiente |
Escriba el número con dígitos: "2 levels", no "two levels". Un drill inicial se ignora, así que "drill 2 levels" también funciona.
Una clave escrita completa cuenta las generaciones hacia abajo desde el nodo inicial, que es la generación 0 y siempre se incluye. Los números negativos cuentan hacia arriba desde las hojas de cada rama, de modo que una jerarquía irregular funciona como cabría esperar.
| Clave | Incluye |
|---|---|
>[*] o >[:] |
Todos los nodos |
>[] o >[-1] |
Solo las hojas |
>[n] |
El nodo inicial y n generaciones por debajo. >[0] es solo el nodo inicial. |
>[a:] |
El nodo inicial, y después la generación a y todo lo que hay debajo |
>[a:b] |
El nodo inicial, y después las generaciones desde a hasta b - 1 |
>[0:-k] |
El nodo inicial y todos los nodos que tienen al menos k generaciones debajo, de modo que las últimas k generaciones de cada rama quedan fuera. >[0:-1] es todos los nodos excepto las hojas. |
>[a:-k] |
Lo mismo, empezando en la generación a |
Para la jerarquía A, con los hijos B, C y D, donde B tiene B1 y B2 y C tiene C1:
| Clave | Resultado |
|---|---|
>[1] |
A, B, C, D |
>[2] |
A, B, B1, B2, C, C1, D |
>[] |
A, B1, B2, C1, D |
>[0:-1] |
A, B, C |
>[2:] |
A, B1, B2, C1 |
Los nodos se enumeran en el orden de la jerarquía, cada uno bajo su propio elemento principal, y los grupos de esquema de Excel siguen el mismo orden. Los espacios dentro de una clave se ignoran. Una clave que no coincide con ninguna de estas formas devuelve un error que enumera las formas válidas.
Insertar una fórmula desde el panel de tareas
Sección titulada «Insertar una fórmula desde el panel de tareas»La pestaña Formulas del panel de tareas escribe una fórmula por usted. Ábrala desde el panel de tareas, con Formula… en la cinta de opciones, o con Insert formula here… en el menú contextual PlaidXL. En What do you want in the cell?, elija una opción:
- A whole table (
GET_TABLE): elija o escriba la tabla y, opcionalmente, un número máximo de filas. - One number (
CELL): elija o escriba la tabla, y elija la Column to total y How to combine the values. - A list of dimension nodes (
DRILL): elija o escriba la dimensión y el nodo inicial, elija hasta dónde explorar y, opcionalmente, una Alternate hierarchy, nodos que excluir y nodos que abrir. Filas muestra una vista previa de los nodos que enumera la exploración. Consulte Exploración personalizada. - A business metric (
METRIC): consulte Insertar una métrica.
La vista previa de Formula muestra el resultado a medida que completa los campos. Haga clic en Insert in active cell (o pulse Ctrl+Enter) para colocarla en la celda seleccionada, o en Copiar para pegarla usted mismo. Elegir una tabla en la pestaña Tablas o una dimensión en la pestaña Dimensiones rellena el campo correspondiente.
Insertar una métrica
Sección titulada «Insertar una métrica»Haga clic en Metric… en el grupo Insertar de la cinta de opciones, o elija A business metric en la pestaña Formulas.
- En Metric, escriba parte del nombre o de un sinónimo de una métrica, como
revenue. Cada coincidencia muestra su valor actual y su descripción. - Use las teclas de flecha o haga clic para elegir una métrica.
- Opcionalmente, agregue filtros: elija una Dimensión, escriba un Nodo y haga clic en Agregar filtro.
- Opcionalmente, elija una columna en Breakdown by (optional) para escribir
METRIC_BREAKDOWNen lugar de un solo número. - Haga clic en Insert in active cell, o en Copiar.
Temas relacionados
Sección titulada «Temas relacionados»- Crear un informe: una jerarquía a lo largo del lateral, valores en la parte superior
- Trabajar con tablas y dimensiones: elija el proyecto del que leen las funciones
- Usar dimensiones: jerarquías principales y alternativas, y cómo se acumulan los nodos
- Diseñar una jerarquía de dimensión: cree la jerarquía hasta la que se acumula su informe