Dashboard-Makros

Dashboard-Makros sind nützlich, um die wechselnden Workspace-Elemente in Dashboard-Text einzufügen oder um Webinhalte in Dashboards einzubetten, die ein dynamisches Verhalten aufweisen. Die Makros fungieren als Platzhalter, die automatisch durch dynamische Workspace-Werte ersetzt werden.

Sie können Makros in den URLs von eingebetteten Webinhalt-Widgets und in einigen Fällen in Dashboard-Textfeldern verwenden.

Sie können Dashboard-Makros verwenden, um Ihrem Workspace dynamische Bilder hinzuzufügen (siehe Hinzufügen von dynamischen Bildern zu Ihren Workspaces).

Unterstützte Makros

SieheDashboard-Makro-Referenz.

Wo Sie Makros verwenden können

Eingebettete Webinhalt-Widgets

Bei Verwendung in iframe-URLs können Dashboard-Makros Workspace-Parameter wie den aktuellen Wert eines Dashboard-Filters an eine andere Webseite übergeben, auf der ein GoodData-Dashboard eingebettet ist. Makros können auch zum Synchronisieren von Aspekten von zwei Dashboards verwendet werden, in denen ein Dashboard in ein anderes eingebettet ist.

Die URL in einem eingebetteten Webinhalt-Widget, in dem ein Makro verwendet wird, ist Ihre Workspace-URL mit Ausnahme des Makros VARIABLE_VALUE, das sich auf die URL des Amazon-S3-Buckets von GoodData beziehen muss (siehe VARIABLE_VALUE).

Für weitere Informationen, wie Sie ein Webinhalt-Widget zu einem Dashboard hinzufügen, siehe So erstellen Sie ein Dashboard.

Dashboard-Textfelder

In einigen Fällen können Sie die Makros auch verwenden, um dynamische Workspace-Werte in Dashboard-Textfelder (Überschrift, Untertitel, Beschreibung) einzufügen.

Für weitere Informationen zum Hinzufügen eines Textfelds zu einem Dashboard, siehe So erstellen Sie ein Dashboard.

Syntax von Makros

Ein Dashboard-Makro ist von Prozent-Symbolen umgeben (%).

Zum Beispiel sieht das Makro, das die URL der aktuell verwendeten Domain darstellt, wie folgt aus:

%HOST_NAME%

Für weitere Informationen über unterstützte Makros, deren Syntax und Parameter siehe Dashboard-Makro-Referenz.

Beispiel: Aktuelle Domain einbetten

Bei Verwendung in einem Webinhalt-Widget, bettet die folgende URL die aktuell ausgewählte Domain ein (siehe HOST_NAME):

https://%HOST_NAME%

Beispiel: Aktuell ausgewählte Werte eines Variablenfilters anzeigen

Bei Verwendung in einem Webinhalt-Widget zeigt die folgende URL die Werte an, die derzeit im zugehörigen Variablenfilter ausgewählt sind (siehe VARIABLE_VALUE):

https://s3.amazonaws.com/gd-images.gooddata.com/customtext/magic.html?text=%VARIABLE_VALUE(assNNkQ0ZefWf)%

Beispiel: Aktuell ausgewählten Wert eines Datumsfilters anzeigen

Bei Verwendung in einem Textfeld auf einem Dashboard zeigt die folgende URL das Startdatum des im zugehörigen Datumsfilter ausgewählten Zeitbereichs an (siehe DATE_FILTER_VALUE):

%DATE_FILTER_VALUE(closed.date,FROM)%