Mit überschreibbaren Konfigurationsparametern können Mitbearbeiter die Standardwerte in einer Datenquelle ändern. Wenn Sie Konfigurationsparameter als überschreibbar definieren, wird eine Datenquelle flexibler und Nutzer können Berichtsvorlagen erstellen, die vom Nutzer konfiguriert werden können.
Ein Connector, der Wetterdaten bereitstellt, kann beispielsweise einen Standortparameter enthalten, mit dem Betrachter einen Wetterbericht von einer anderen als der Standardsprache anfordern können.
In diesem Dokument wird beschrieben, wie überschreibbare Parameter definiert und geändert werden können. Außerdem wird beschrieben, wie Parameterwerte von Nutzern eines Berichts geändert werden können. Weitere Informationen zur Verwendung von Parametern in Looker Studio finden Sie unter Datenquellenparameter.
Rollen
Die Nutzerrollen, auf die im Dokument verwiesen wird:
Rolle | Definition |
---|---|
Connector-Entwickler | Nutzer, der einen Community-Connector erstellt hat |
Inhaber der Datenquelle | Ein Nutzer, der eine Datenquelle erstellt und Eigentümer der Datenquelle ist. |
Berichtseditor | Ein Nutzer mit Zugriff im Bearbeitungsmodus auf einen Bericht. |
Berichtseditor | Ein Nutzer mit Zugriff im Anzeigemodus auf einen Bericht. |
Überschreibbare Parameter definieren
Der Connector-Entwickler definiert Konfigurationsparameter in der Funktion getConfig()
eines Community-Connectors. Wenn ein Konfigurationsparameter als überschreibbar definiert werden soll, ruft der Connector setAllowOverride(true)
auf.
Im folgenden Beispiel werden zwei überschreibbare Parameter definiert: zipcode
und units
sowie ein nicht überschreibbarer Parameter: days-to-forcecast
.
function getConfig(request) {
var config = cc.getConfig();
// A
config
.newTextInput()
.setId("zipcode")
.setName("ZIP Code")
.setAllowOverride(true);
// B
config
.newSelectSingle()
.setId("units")
.setName("Units")
.addOption(
config
.newOptionBuilder()
.setLabel("Metric")
.setValue("metric")
)
.addOption(
config
.newOptionBuilder()
.setLabel("Imperial")
.setValue("imperial")
)
.setAllowOverride(true);
// C
config
.newTextInput()
.setId("days-to-forecast")
.setName("Days to forecast")
.setAllowOverride(false);
return config.build();
}
Wann ein Parameter nicht als überschreibbar definiert werden sollte
Es wird empfohlen, den Abschnitt Verbindung zwischen Looker Studio und Ihren Daten herstellen zu lesen und sich darüber zu informieren, wie Connectors, Datenquellen und Berichte miteinander interagieren.
In den folgenden Fällen sollten Parameter nicht als überschreibbar definiert werden:
- Wenn sich der Wert eines Parameters auf das Schema auswirkt.
- Wenn ein Nutzer einen Parameterwert ändert und das Schema der zurückgegebenen Daten von dem in der Datenquelle definierten Schema abweicht, können Berichte, die von der Datenquelle abhängen, aufgrund fehlender Felder fehlerhaft sein.
- Ob sensible Daten durch einen Parameterwert gesteuert werden Beispiel: Kontoauswahl.
- Definieren Sie einen Parameter nicht als überschreibbar, wenn Sie verhindern möchten, dass sensible Daten unbeabsichtigt aufgerufen oder freigegeben werden.
Parameter für Nutzer von Berichten aktivieren
Die Inhaber der Datenquelle legen fest, welche überschreibbaren Parameter von Berichtseditoren geändert werden dürfen. Mit Berichtseditoren wird auf ähnliche Weise gesteuert, welche Parameter von Betrachtern geändert werden können.
Berichtseditoren erlauben, Parameterwerte zu ändern
Mit dem Inhaber der Datenquelle wird festgelegt, welche Parameter in Berichten geändert werden dürfen. Diese wird beim Erstellen oder Bearbeiten einer Datenquelle konfiguriert und gilt nur für Parameter, die vom Connector-Entwickler als überschreibbar definiert wurden. Wenn diese Option aktiviert ist, können Berichtseditoren Parameter in einem Bericht ändern.
Im folgenden Beispiel sind zwei Parameter eines Connectors als überschreibbar definiert: zipcode
und units
. Der Inhaber der Datenquelle hat festgelegt, dass nur zipcode
in Berichten geändert werden darf. Im Berichtseditor kann der Parameterwert zipcode
geändert werden.
Betrachtern von Berichten erlauben, Parameterwerte zu ändern
Mit Berichtseditoren wird festgelegt, welche Parameter von Betrachtern geändert werden können. Die Parameterwerte können dann von jedem Betrachter des Berichts über die Berichts-URL geändert werden.
Angenommen, für einen Connector sind zwei Parameter als überschreibbar definiert: zipcode
und units
(Abbildung 1). Wenn der Inhaber der Datenquelle das Ändern von zipcode
in Berichten zulässt (Abbildung 2), können Berichtseditoren nur zulassen, dass zipcode
von Betrachtern geändert wird. Der Berichtseditor hat keinen Zugriff und keine Sichtbarkeit, sodass der Parameter units
von Betrachtern des Berichts geändert werden kann.
![Postleitzahlparameter aktiviert](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters.png?authuser=6&hl=de)
![Nur der Parameter für die Postleitzahl kann geändert werden](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters-2.png?authuser=6&hl=de)
URL-Parameter
So erlauben Sie Betrachtern von Berichten, Parameterwerte über die Berichts-URL zu bearbeiten:
- Öffnen Sie den Bericht zum Bearbeiten.
- Wählen Sie Ressource -> URL-Parameter des Berichts verwalten aus.
- Klicken Sie auf das Kästchen Änderung in der Berichts-URL zulassen, um die Änderung von Parameterwerten in der Berichts-URL zuzulassen oder zu verbieten. Änderungen werden automatisch gespeichert.
- Klicken Sie rechts oben auf Schließen.
Parameterwerte ändern
Berichtseditoren haben die Möglichkeit, Parameterwerte über den Eigenschaftenbereich des Berichts zu ändern. Betrachter können Parameterwerte über die Berichts-URL ändern.
Eigenschaftenbereich von Berichten
Informationen dazu, wie Parameterwerte in einem Berichtseditor festgelegt werden können, finden Sie unter Parameter in einem Bericht ändern.
URL-Parameter für Berichte
Für Parameter, die in der Berichts-URL geändert werden dürfen, können Werte über ein URL-codiertes JSON-Objekt festgelegt werden, das im Anzeigemodus an die Berichts-URL angehängt wird.
So erstellen Sie eine URL-Konfiguration:
Parameternamen erfassen
- Öffnen Sie den Bericht zum Bearbeiten.
- Wählen Sie Ressource -> URL-Parameter des Berichts verwalten aus.
- Notieren Sie sich den Namen der Parameter, die Sie über die Berichts-URL festlegen möchten.
In der Abbildung unten lautet der Parametername beispielsweise
ds0.zipcode
.Parameterobjekt erstellen
Parameter werden über ein JSON-Objekt definiert. Die Schlüssel für die Parameterwerte sind die Parameternamen.
{ "parameterName": parameterValue }
Parameterwerttypen sind
STRING
,NUMBER
oderBOOLEAN
. Verwenden Sie für Parameter, die mehrere Werte akzeptieren (z.B. Drop-down-Menüs mit Mehrfachauswahl), ein Array von Werten.Wenn der Parametername beispielsweise
ds0.zipcode
lautet und die Postleitzahl auf94094
gesetzt werden soll, sieht der JSON-Code so aus:{ "ds0.zipcode": "94094" }
Das Parameterobjekt URL-codieren
Nachdem Sie das Parameterobjekt erstellt haben, wandeln Sie es mit JSON.stringify() in einen String um und codieren Sie es dann mit [encodeURIComponent].
var params = { "ds0.zipcode": "94094" }; var paramsAsString = JSON.stringify(params); var encodedParams = encodeURIComponent(paramsAsString)
Dies führt zum folgenden codierten String:
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
Berichts-URL erstellen
Wenn Sie das URL-codierte Parameterobjekt haben, hängen Sie es mithilfe des Abfrageparameters
params
an die URL der Berichtsansicht an.https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D
Ersetzen Sie REPORT_ID und PAGE_ID durch die Werte für Ihren Bericht und die Seite.
URL verwenden
Die Berichts-URL überschreibt die im JSON-Parameterobjekt definierten Parameter basierend auf der Parameterübernahme.
Beispiel für Parameterobjekt
Das folgende Parameterobjekt zeigt, wie mehrere Parameter festgelegt werden. Außerdem wird das Festlegen von Parameterwerten für die verschiedenen Eingabetypen veranschaulicht.
ds0.includeToday
ist eine Kästcheneingabeds0.units
ist eine Eingabe mit Einzelauswahl- „
ds1.countries
“ ist eine Eingabe mit Mehrfachauswahl ds1.labelName
ist eine Texteingabe.
{
"ds0.includeToday": true,
"ds0.units": "Metric",
"ds1.countries": ["Canada", "Mexico"],
"ds1.labelName": "Population"
}
Parameter übernehmen
Der für einen Parameter verwendete Wert folgt einer Rangfolge, je nachdem, wo der Parameter festgelegt ist. Parameter, die an einer höheren Prioritätsposition festgelegt werden, haben Vorrang vor solchen, die für Standorte mit niedrigerer Priorität festgelegt wurden. Die Rangfolge (von der niedrigsten zur höchsten) ist:
- Datenquelle (Standard)
- Berichts-URL
- im Eigenschaftenbereich von Berichten. Dabei werden die Regeln für die Parameterübernahme für Datenquellen berücksichtigt.