Ir al contenido

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.

  • 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_LIST y DIM_LIST tambié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.

=PLAIDXL.LIST_PROJECTS([horizontal])

Enumera los nombres de los proyectos que puede abrir, ordenados por nombre.

  • horizontal: TRUE para enumerar en una fila. El valor predeterminado es FALSE, una columna.

=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: TRUE para enumerar en una fila. El valor predeterminado es FALSE, una columna.

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

=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: TRUE para enumerar en una fila. El valor predeterminado es FALSE, una columna.

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

=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, contando start_node como la primera: 2 devuelve 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 de DRILL_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 pide drill_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.

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 | units
D2 =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.

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 filtro DIMENSION_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.

=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 filtro DIMENSION_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.

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.

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.

=PLAIDXL.REPR.TABLE_REPR(table_name)

La tabla de la que leen CELL y CELLS, por su nombre en el proyecto seleccionado.

=PLAIDXL.REPR.MEASURE(column_name)

La columna numérica que agrega CELL.

=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#.

=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

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

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

Haga clic en Metric… en el grupo Insertar de la cinta de opciones, o elija A business metric en la pestaña Formulas.

  1. 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.
  2. Use las teclas de flecha o haga clic para elegir una métrica.
  3. Opcionalmente, agregue filtros: elija una Dimensión, escriba un Nodo y haga clic en Agregar filtro.
  4. Opcionalmente, elija una columna en Breakdown by (optional) para escribir METRIC_BREAKDOWN en lugar de un solo número.
  5. Haga clic en Insert in active cell, o en Copiar.