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
Ejemplo 2: ID de la hoja de devolución
Ejemplo 3: expresión anidada
Para ver un ejemplo más detallado del uso de la coloración condicional, vea el ejemplo en InObject - función de gráfico.