Überschreibbare Konfigurationsparameter

Mit überschreibbaren Konfigurationsparametern können Mitbearbeiter 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.

Beispielsweise kann ein Connector, der Wetterdaten zurückgibt, einen Standortparameter enthalten, über den Betrachter Wetterberichte für einen anderen als den standardmäßigen Ort anfordern können.

In diesem Dokument wird beschrieben, wie überschreibbare Parameter definiert und für Änderungen aktiviert werden und wie Parameterwerte von Nutzern von Berichten geändert werden können. Weitere Informationen zur Verwendung von Parametern in Looker Studio finden Sie unter Datenquellenparameter.

Rollen

Die in diesem Dokument erwähnten Nutzerrollen:

Rolle	Definition
Connector-Entwickler	Ein Nutzer, der einen Community-Connector erstellt hat.
Inhaber der Datenquelle	Ein Nutzer, der eine Datenquelle erstellt hat und Inhaber dieser Datenquelle ist.
Berichtseditor	Ein Nutzer mit Zugriff auf den Bearbeitungsmodus eines Berichts.
Berichtsansicht	Ein Nutzer mit Lesezugriff auf einen Bericht.

Überschreibbare Parameter definieren

Der Connector-Entwickler definiert Konfigurationsparameter in der Funktion getConfig() eines Community-Connectors. Um einen Konfigurationsparameter als überschreibbar zu definieren, 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. Außerdem wird ein Parameter definiert, der nicht überschreibbar ist: 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 sollte ein Parameter nicht als überschreibbar definiert werden?

Es wird empfohlen, sich diesen Artikel durchzulesen, um zu erfahren, wie Connectors, Datenquellen und Berichte zusammenhängen.

Vermeiden Sie es, einen Parameter in den folgenden Fällen als überschreibbar zu definieren:

1. Wenn der Wert eines Parameters das Schema beeinflusst.
   • Wenn ein Nutzer einen Parameterwert ändert und das Schema der zurückgegebenen neuen Daten sich von dem in der Datenquelle definierten Schema unterscheidet, kann es bei allen Berichten, die von der Datenquelle abhängen, zu Problemen kommen, da Felder fehlen.
2. Wenn ein Parameterwert vertrauliche Daten steuert. z.B. Kontoauswahl.
   • Definieren Sie keinen Parameter als überschreibbar, wenn Sie verhindern möchten, dass sensible Daten unbeabsichtigt angezeigt oder weitergegeben werden.

Parameter für Berichtsnutzer aktivieren

Inhaber von Datenquellen legen fest, welche überschreibbaren Parameter von Mitbearbeitern von Berichten geändert werden dürfen. Berichtseditorinnen und ‑editoren legen fest, welche Parameter von Berichtsbetrachtern geändert werden können.

Mitbearbeitern erlauben, Parameterwerte zu ändern

Der Inhaber der Datenquelle legt fest, welche Parameter in Berichten geändert werden dürfen. Dies 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 Mitbearbeiter Parameter in einem Bericht ändern.

Im folgenden Beispiel hat ein Connector zwei Parameter, die als überschreibbar definiert sind: zipcode und units. Der Inhaber der Datenquelle hat nur zugelassen, dass zipcode in Berichten geändert wird. Im Bericht hat der Mitbearbeiter die Möglichkeit, den Parameterwert zipcode zu ändern.

Betrachtern des Berichts erlauben, Parameterwerte zu ändern

Mitbearbeiter von Berichten legen fest, welche Parameter von Betrachtern von Berichten geändert werden können. Die Parameterwerte können dann von jedem Betrachter des Berichts über die Berichts-URL geändert werden.

Hinweis :Die Möglichkeiten eines Bearbeiters des Berichts, Änderungen an Parametern zuzulassen, sind auf die Parameter beschränkt, die vom Inhaber der Datenquelle zugelassen werden.

Angenommen, ein Connector hat zwei Parameter, die als überschreibbar definiert sind: zipcode und units (Abbildung 1). Wenn der Inhaber der Datenquelle zugelassen hat, dass zipcode in Berichten geändert werden kann (Abbildung 2), können Mitbearbeiter nur zulassen, dass zipcode von Betrachtern geändert wird. Der Berichtseditor hat keinen Zugriff und kann den Parameter units nicht so ändern, dass er von Betrachtern des Berichts bearbeitet werden kann.

Abbildung 1: Connector-Konfiguration.

Abbildung 2: Parameter verwalten.

Warnung :Betrachter von Berichten können auf alle Daten zugreifen, die über Parameter gesteuert werden. Um zu verhindern, dass vertrauliche Daten unbeabsichtigt freigegeben werden, sollten Sie die Datenquelle und die Anmeldedaten für die Datenquelle prüfen und bestätigen, bevor Sie die Änderung eines Parameters zulassen. Wenn ein Parameter den Zugriff auf vertrauliche Daten ermöglicht, sollten Sie Anmeldedaten des Betrachters verwenden, damit Berichtsbetrachter nur ihre eigenen Daten sehen können.

URL-Parameter

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

1. Öffnen Sie den Bericht zum Bearbeiten.
2. Wählen Sie Ressource > Berichtsparameter verwalten aus.
3. Über die Kästchen Änderungen in der Berichts-URL zulassen können Sie festlegen, ob Parameterwerte in der Berichts-URL geändert werden dürfen. Änderungen werden automatisch gespeichert.
4. Klicken Sie rechts oben auf Schließen.

Parameterwerte ändern

Mitbearbeiter können Parameterwerte über den Bereich „Berichtseigenschaften“ ändern, Betrachter über die Berichts-URL.

Bereich „Berichtseigenschaften“

Weitere Informationen dazu, wie Mitbearbeiter Parameterwerte festlegen können

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 Ansichtsmodus 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 > Berichtsparameter verwalten aus.
   3. Notieren Sie sich die 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 ist und Sie die Postleitzahl auf 94094 festlegen möchten, sieht der JSON-Code so aus:

   {
     "ds0.zipcode": "94094"
   }
   

3. Parameterobjekt URL-codieren

   Nachdem Sie das Parameterobjekt erstellt haben, wandeln Sie es mit JSON.stringify() in einen String um und URL-codieren Sie es dann mit [encodeURIComponent].

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Das führt zu folgendem codierten String:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Bericht-URL erstellen

   Hängen Sie das URL-codierte Parameterobjekt mit dem Suchparameter 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 Ihre Seite.

5. URL verwenden

   Die Berichts-URL überschreibt Parameter, die im JSON-Parameterobjekt definiert sind, basierend auf der Parametervererbung.

Beispiel für ein Parameterobjekt

Im folgenden Parameterobjekt sehen Sie, wie mehrere Parameter festgelegt werden. Außerdem wird gezeigt, wie Parameterwerte für die verschiedenen Eingabetypen festgelegt werden.

• ds0.includeToday ist eine Checkbox-Eingabe
• ds0.units ist eine Eingabe mit Einfachauswahl
• 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 Prioritätsreihenfolge, die davon abhängt, wo der Parameter festgelegt ist. Parameter, die an Orten mit höherer Priorität festgelegt sind, überschreiben Parameter, die an Orten mit niedrigerer Priorität festgelegt sind. Dabei wird die folgende Reihenfolge (von der niedrigsten zur höchsten Ebene) eingehalten:

1. Datenquelle (Standard)
2. Berichts-URL
3. Eigenschaftenbereich des Berichts gemäß den Regeln für die Parameterübernahme der Datenquelle.