ObjectId - funzione per grafici
La funzione del grafico ObjectId() restituisce l'ID dell'oggetto nel quale è valutata l'espressione. La funzione accetta un argomento opzionale che specifica il tipo di oggetto a cui si riferisce la funzione. L'oggetto può essere un foglio o una visualizzazione. La funzione è disponibile solo nelle espressioni del grafico.
Sintassi:
ObjectId([object_type_str])
Tipo di dati restituiti: stringa
L'unico argomento della funzione, object_type_str, è opzionale e si riferisce a un valore stringa che rappresenta il tipo dell'oggetto.
Argomento | Descrizione |
---|---|
object_type_str | Un valore stringa che rappresenta il tipo dell'oggetto da valutare. |
Se nell'espressione della funzione non è specificato alcun argomento, ObjectId() restituisce l'ID dell'oggetto in cui viene utilizzata l'espressione. Per restituire l'ID dell'oggetto foglio all'interno del quale appare la visualizzazione, usare ObjectId('sheet').
Nel caso di oggetti di visualizzazione nidificati all'interno di altri oggetti di visualizzazione, specificare il tipo di oggetto desiderato nell'argomento della funzione per ottenere risultati diversi. Ad esempio, per un grafico Testo e immagine con un contenitore, utilizzare 'text-image' per restituire l'oggetto Testo e immagine e 'contenitore' per restituire l'ID del contenitore.
Procedere come indicato di seguito:
-
In modalità analisi, aggiungere il seguente testo all'URL:
/options/developer
-
Fare clic con il pulsante destro del mouse su una visualizzazione e fare clic su Sviluppatore.
-
Sotto Proprietà, ottenere l'ID oggetto dall'intestazione finestra di dialogo, oltre al tipo di oggetto dalla proprietà "qType".
Limiti:
Questa funzione può dare risultati imprevisti se richiamata in un oggetto (ad esempio, un pulsante) all'interno di un contenitore che rappresenta una voce principale. Questa limitazione si applica anche alle voci principali della casella di filtro, che rappresentano contenitori di diverse caselle di elenco. Ciò si verifica a causa del modo in cui le voci principali utilizzano la gerarchia oggetti.
L'espressione grafico ObjectId('sheet') restituirà una stringa vuota in tali casi, mentre ObjectId('masterobject') mostrerà l'identificatore della voce principale posseduta.
ObjectId() viene spesso utilizzato in combinazione con le seguenti funzioni:
Funzione | Interazione |
---|---|
if - funzione dello script e del grafico | Le funzioni if e ObjectId possono essere utilizzate insieme per creare espressioni condizionali. Ad esempio, le visualizzazioni possono ottenere una colorazione condizionale attraverso espressioni che utilizzano queste funzioni. |
InObject - funzione per grafici | In modo simile a if, InObject viene utilizzato anche con ObjectId per creare espressioni condizionali. |
Esempio 1 – Restituzione ID oggetto grafico
Esempio 2 - ID del foglio di ritorno
Esempio 3 - Espressione nidificata
Per un esempio più dettagliato di utilizzo della colorazione condizionale, vedere l'esempio su InObject - funzione per grafici.