ObjectId - Diagrammfunktion
Die Diagrammfunktion ObjectId() gibt die ID des Objekts zurück, in dem die Formel ausgewertet wird. Die Funktion übernimmt ein optionales Argument, das angibt, welcher Typ von Objekt die Funktion betrifft. Das Objekt kann ein Arbeitsblatt oder eine Visualisierung sein. Diese Funktion ist nur in Diagrammformeln verfügbar.
Syntax:
ObjectId([object_type_str])
Rückgabe Datentyp: String
Das einzige Argument der Funktion, object_type_str, ist optional und verweist auf einen Stringwert, der den Objekttyp darstellt.
| Argument | Beschreibung |
|---|---|
| object_type_str | Ein Stringwert, der den Typ des auszuwertenden Objekts darstellt. |
Wenn in der Funktionsformel kein Argument angegeben ist, gibt ObjectId() die ID des Objekts zurück, in dem die Formel verwendet wird. Um die ID des Arbeitsblattobjekts zurückzugeben, in dem die Visualisierung angezeigt wird, verwenden Sie ObjectId('sheet').
Im Fall von Visualisierungsobjekten, die in anderen Visualisierungsobjekten verschachtelt sind, geben Sie den gewünschten Objekttyp im Funktionsargument an, um andere Ergebnisse zu erhalten. Verwenden Sie beispielsweise für ein Text und Bild-Diagramm in einer Sammelbox 'text-image', um das Text und Bild-Objekt zurückzugeben, und 'container', um die ID der Sammelbox zurückzugeben.
Gehen Sie folgendermaßen vor:
-
Fügen Sie im Analysemodus den folgenden Text zu Ihrer URL hinzu:
/options/developer
-
Klicken Sie mit der rechten Maustaste auf eine Visualisierung und klicken Sie auf
Entwickler. -
Rufen Sie unter Eigenschaften die Objekt-ID aus der Dialogkopfzeile und den Objekttyp aus der Eigenschaft "qType" ab.
Beschränkungen:
Diese Funktion kann zu unerwarteten Ergebnissen führen, wenn sie in einem Objekt (z. B. einer Schaltfläche) innerhalb einer Sammelbox aufgerufen wird, die ein Master-Element ist. Diese Einschränkung gilt auch für Filterfenster-Master-Elemente, bei denen es sich um Sammelboxen für eine Reihe von Listboxen handelt. Das liegt daran, wie Master-Elemente die Objekthierarchie verwenden.
Die Diagrammformel ObjectId('sheet') gibt in diesen Fällen einen leeren String zurück, während ObjectId('masterobject') die Identifikatoren des besitzenden Master-Elements anzeigt.
ObjectId() wird oft in Kombination mit den folgenden Funktionen verwendet:
| Funktion | Interaktion |
|---|---|
| if - Skript- und Diagrammfunktion | Die Funktionen if und ObjectId können zusammen verwendet werden, um bedingte Formeln zu erstellen. Beispielsweise können Visualisierungen bedingte Farben über Formeln erhalten, wenn diese Funktionen verwendet werden. |
| InObject - Diagrammfunktion | Ähnlich wie if wird auch InObject zusammen mit ObjectId verwendet, um bedingte Formeln zu erstellen. |
Beispiel 1 – Zurückgeben der Diagrammobjekt-ID
Das folgende grundlegende Beispiel zeigt, wie die ID einer Visualisierung zurückgegeben wird.
Gehen Sie folgendermaßen vor:
-
Öffnen Sie ein neues Arbeitsblatt und ziehen Sie ein Text und Bild-Diagramm auf das Arbeitsblatt.
-
Klicken Sie im Eigenschaftsfenster auf Kennzahl hinzufügen.
-
Klicken Sie zum Öffnen des Formel-Editors auf
. -
Fügen Sie folgende Formel in das Dialogfeld ein:
=ObjectId() -
Klicken Sie auf Übernehmen.
Die ID des Text und Bild-Objekts wird in der Visualisierung angezeigt.
Das gleiche Ergebnis kann mit der folgenden Formel erzielt werden:
Beispiel 2 – Zurückgeben der Arbeitsblatt-ID
Das folgende grundlegende Beispiel zeigt, wie die ID des Arbeitsblatts zurückgegeben wird, auf dem eine Visualisierung angezeigt wird.
Gehen Sie folgendermaßen vor:
-
Öffnen Sie ein neues Arbeitsblatt und ziehen Sie ein Text und Bild-Diagramm auf das Arbeitsblatt.
-
Klicken Sie im Eigenschaftsfenster auf Kennzahl hinzufügen.
-
Klicken Sie zum Öffnen des Formel-Editors auf
. -
Fügen Sie folgende Formel in das Dialogfeld ein:
=ObjectId('sheet') -
Klicken Sie auf Übernehmen.
Die ID des Arbeitsblatts wird in der Visualisierung angezeigt.
Beispiel 3 – Verschachtelte Formel
Das folgende Beispiel zeigt, wie die Funktion ObjectId() innerhalb anderer Formeln verschachtelt werden kann.
Gehen Sie folgendermaßen vor:
-
Öffnen Sie ein neues Arbeitsblatt und ziehen Sie ein Text und Bild-Diagramm auf das Arbeitsblatt.
-
Klicken Sie im Eigenschaftsfenster auf Kennzahl hinzufügen.
-
Klicken Sie zum Öffnen des Formel-Editors auf
. -
Fügen Sie folgende Formel in das Dialogfeld ein:
=if(InObject(ObjectId('text-image')), 'In Text und Bild', 'Nicht in Text und Bild')
-
Klicken Sie auf Übernehmen.
Der Text In Text und Bild wird im Diagramm angezeigt und gibt an, dass das in der Formel referenzierte Objekt ein Text und Bild-Diagramm ist.
Ein detaillierteres Beispiel mit bedingten Farben finden Sie unter InObject - Diagrammfunktion.