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
Beispiel 2 – Zurückgeben der Arbeitsblatt-ID
Beispiel 3 – Verschachtelte Formel
Ein detaillierteres Beispiel mit bedingten Farben finden Sie unter InObject - Diagrammfunktion.