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
Il seguente esempio di base dimostra come restituire l'ID di una visualizzazione.
Procedere come indicato di seguito:
-
Aprire un nuovo foglio e trascinare un grafico Testo e immagine sul foglio.
-
Nel pannello proprietà, fare clic su Aggiungi misura.
-
Fare clic su
per visualizzare l'editor delle espressioni. -
Incollare la seguente espressione nella finestra di dialogo:
=ObjectId() -
Fare clic su Applica.
L'ID dell'oggetto Testo e immagine viene mostrato nella visualizzazione.
Lo stesso risultato può essere ottenuto con la seguente espressione:
Esempio 2 - ID del foglio di ritorno
Il seguente esempio di base dimostra come restituire l'ID del foglio in cui appare una visualizzazione.
Procedere come indicato di seguito:
-
Aprire un nuovo foglio e trascinare un grafico Testo e immagine sul foglio.
-
Nel pannello proprietà, fare clic su Aggiungi misura.
-
Fare clic su
per visualizzare l'editor delle espressioni. -
Incollare la seguente espressione nella finestra di dialogo:
=ObjectId('sheet') -
Fare clic su Applica.
L'ID del foglio viene visualizzato nella visualizzazione.
Esempio 3 - Espressione nidificata
L'esempio seguente mostra come la funzione ObjectId() possa essere nidificata all'interno di altre espressioni.
Procedere come indicato di seguito:
-
Aprire un nuovo foglio e trascinare un grafico Testo e immagine sul foglio.
-
Nel pannello proprietà, fare clic su Aggiungi misura.
-
Fare clic su
per visualizzare l'editor delle espressioni. -
Incollare la seguente espressione nella finestra di dialogo:
=if(InObject(ObjectId('text-image')), 'In Text & image', 'Not in Text & image')
-
Fare clic su Applica.
Il testo In Testo e immagine appare nel grafico, indicando che l'oggetto a cui si fa riferimento nell'espressione è un grafico Testo e immagine.
Per un esempio più dettagliato di utilizzo della colorazione condizionale, vedere l'esempio su InObject - funzione per grafici.