ObjectId - función de gráfico
La función de gráfico ObjectId() devuelve el ID del objeto en el que se evalúa la expresión. La función toma un argumento opcional que especifica a qué tipo de objeto se refiere la función. El objeto puede ser una hoja o una visualización. Esta función solo está disponible en expresiones de gráfico.
Sintaxis:
ObjectId([object_type_str])
Tipo de datos que devuelve: cadena de texto
El único argumento de la función, object_type_str, es opcional y hace referencia a un valor de cadena de caracteres que representa el tipo del objeto.
| Argumento | Descripción |
|---|---|
| object_type_str | Un valor de cadena que representa el tipo de objeto que se está evaluando. |
Si no se especifica ningún argumento en la expresión de la función, ObjectId() devuelve el ID del objeto en el que se utiliza la expresión. Para devolver el ID del objeto de hoja en el que aparece la visualización, utilice ObjectId('sheet').
En el caso de objetos de visualización anidados dentro de otros objetos de visualización, especifique el tipo de objeto deseado en el argumento de la función para obtener diferentes resultados. Por ejemplo, para un gráfico de Texto e imagen dentro de un contenedor, use "text-image" para devolver el objeto de Texto e imagen y "contenedor" para devolver el ID del contenedor.
Haga lo siguiente:
-
En el modo de análisis, agregue el siguiente texto a su URL:
/options/developer
-
Haga clic con el botón derecho en una visualización y después haga clic en
Developer. -
En Propiedades, obtenga el ID de objeto del encabezado del cuadro de diálogo y el tipo de objeto de la propiedad "qType".
Limitaciones:
Esta función puede dar resultados inesperados cuando se invoca en un objeto (por ejemplo, un botón) dentro de un contenedor que es un elemento maestro. Esta limitación también se aplica a los elementos maestros del panel de filtrado, que son contenedores para varios cuadros de lista. Esto se debe a cómo los elementos maestros utilizan la jerarquía de objetos.
La expresión del gráfico ObjectId('sheet') devolverá una cadena vacía en esos casos, mientras que ObjectId('masterobject') mostrará el identificador del elemento maestro propietario.
ObjectId() se utiliza a menudo en combinación con las siguientes funciones:
| Función | Interacción |
|---|---|
| if - función de script y de gráfico | Las funciones if y ObjectId se pueden utilizar juntas para crear expresiones condicionales. Por ejemplo, las visualizaciones pueden lograr colores condicionales a través de expresiones que usan estas funciones. |
| InObject - función de gráfico | Similar a if, InObject también se usa con ObjectId para crear expresiones condicionales. |
Ejemplo 1: Devolver el ID de un objeto gráfico
El siguiente ejemplo básico demuestra cómo devolver el ID de una visualización.
Haga lo siguiente:
-
Abra una hoja nueva y arrastre un gráfico de Texto e imagen a la hoja.
-
En el panel de propiedades, haga clic en Añadir medida.
-
Haga clic en
para abrir el editor de expresiones. -
Pegue la siguiente expresión en el cuadro de diálogo:
=ObjectId() -
Haga clic en Aplicar.
El ID del objeto Texto e imagen se muestra en la visualización.
El mismo resultado se puede lograr con la siguiente expresión:
Ejemplo 2: ID de la hoja de devolución
El siguiente ejemplo básico demuestra cómo devolver el ID de la hoja en la que aparece una visualización.
Haga lo siguiente:
-
Abra una hoja nueva y arrastre un gráfico de Texto e imagen a la hoja.
-
En el panel de propiedades, haga clic en Añadir medida.
-
Haga clic en
para abrir el editor de expresiones. -
Pegue la siguiente expresión en el cuadro de diálogo:
=ObjectId('sheet') -
Haga clic en Aplicar.
El ID de la hoja se muestra en la visualización.
Ejemplo 3: expresión anidada
El siguiente ejemplo muestra cómo la función ObjectId() se puede anidar dentro de otras expresiones.
Haga lo siguiente:
-
Abra una hoja nueva y arrastre un gráfico de Texto e imagen a la hoja.
-
En el panel de propiedades, haga clic en Añadir medida.
-
Haga clic en
para abrir el editor de expresiones. -
Pegue la siguiente expresión en el cuadro de diálogo:
=if(InObject(ObjectId('text-image')), 'In Text & image', 'Not in Text & image')
-
Haga clic en Aplicar.
El texto en Texto e imagen aparece en el gráfico, lo que indica que el objeto al que se hace referencia en la expresión es un gráfico de Texto e imagen.
Para ver un ejemplo más detallado del uso de la coloración condicional, vea el ejemplo en InObject - función de gráfico.