Überschreibbare Konfigurationsparameter

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.

Hinweis :Parameter können auch als Teil einer benutzerdefinierten BigQuery-Abfrage definiert werden.

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();
}

Hinweis: Der Standardwert für allowOverride ist false. Wenn Sie das Überschreiben für einen Parameter nicht aktivieren möchten, können Sie den Aufruf von setAllowOverride() weglassen.

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:

1. 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.
2. 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.

Hinweis :Die Steuerelemente eines Berichtseditors, die das Ändern von Parametern zulassen, ist auf die Parameter beschränkt, die vom Inhaber der Datenquelle zugelassen 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.

Abbildung 1: Connector-Konfiguration.

Abbildung 2: Parameter verwalten.

Warnung :Betrachter können auf alle Daten zugreifen, die durch Parameter gesteuert werden. Damit sensible Daten nicht versehentlich freigegeben werden, sollten Sie prüfen und bestätigen, dass die Datenquelle und die Anmeldedaten für die Datenquelle richtig konfiguriert sind, bevor Sie das Ändern eines Parameters zulassen. Wenn ein Parameter den Zugriff auf sensible Daten ermöglicht, sollten Sie die Anmeldedaten des Betrachters verwenden, damit die Betrachter des Berichts nur seine Daten sehen können.

URL-Parameter

So erlauben Sie Betrachtern von Berichten, Parameterwerte über die Berichts-URL zu bearbeiten:

1. Öffnen Sie den Bericht zum Bearbeiten.
2. Wählen Sie Ressource -> URL-Parameter des Berichts verwalten aus.
3. 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.
4. 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:

1. Parameternamen erfassen

   1. Öffnen Sie den Bericht zum Bearbeiten.
   2. Wählen Sie Ressource -> URL-Parameter des Berichts verwalten aus.
   3. 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.

   

2. 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 oder BOOLEAN. 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 auf 94094 gesetzt werden soll, sieht der JSON-Code so aus:

   {
     "ds0.zipcode": "94094"
   }
   

3. 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"
   

4. 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.

5. 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ästcheneingabe
• ds0.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:

1. Datenquelle (Standard)
2. Berichts-URL
3. im Eigenschaftenbereich von Berichten. Dabei werden die Regeln für die Parameterübernahme für Datenquellen berücksichtigt.