Überschreibbare Konfigurationsparameter

Mit überschreibbaren Konfigurationsparametern können Mitbearbeiter Änderungen vornehmen in einer Datenquelle verwenden. Konfigurationsparameter als überschreibbar definieren eine flexiblere Datenquelle und bietet Nutzern die Möglichkeit, Berichtsvorlagen erstellen.

Ein Connector, der Wetterdaten bereitstellt, kann beispielsweise einen Standort enthalten, Parameter, mit dem Betrachter von Berichten einen Wetterbericht für eine bestimmte Sprache anfordern können vom Standard abweichen.

In diesem Dokument wird beschrieben, wie überschreibbare Parameter definiert werden, und wie Parameterwerte von Nutzern des Berichts geändert werden können. Weitere Informationen Weitere Informationen zur Verwendung von Parametern in Looker Studio finden Sie unter Datenquellenparameter:

Rollen

Die im Dokument referenzierten Nutzerrollen:

Rolle	Definition
Connector-Entwickler	Nutzer, die einen Community-Connector erstellt haben
Inhaber der Datenquelle	Ein Nutzer, der eine Datenquelle erstellt und deren Inhaber ist.
Berichtseditor	Ein Nutzer mit Bearbeitungszugriff auf einen Bericht
Betrachter	Ein Nutzer mit Zugriff auf einen Bericht im Ansichtsmodus

Überschreibbare Parameter definieren

Der Connector-Entwickler definiert die Konfigurationsparameter in der getConfig()-Funktion eines Community-Connector. So definieren Sie einen Konfigurationsparameter, dass er den Connector überschreiben kann: ruft 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. und 1 Parameter, 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 keine das Überschreiben für einen Parameter aktivieren, können Sie den Aufruf der setAllowOverride()

Wann sollte ein Parameter nicht als überschreibbar definiert werden?

Es empfiehlt sich, sich mit der Funktionsweise von Connectors, Datenquellen und Berichten in Weitere Informationen

In den folgenden Fällen sollten Sie einen Parameter nicht als überschreibbar definieren:

1. Wenn sich der Wert eines Parameters auf das Schema auswirkt.
   • Wenn ein Nutzer einen Parameterwert und das Schema der neuen Daten ändert die zurückgegebenen Daten von der Definition in der Datenquelle abweichen, Datenquelle aufgrund fehlender Felder nicht richtig funktionieren.
2. Ob sensible Daten durch einen Parameterwert gesteuert werden Beispiel: Kontoauswahl.
   • Definieren Sie einen Parameter nicht als überschreibbar, wenn Sie verhindern möchten, unbeabsichtigte Ansicht oder Freigabe sensibler Daten

Parameter für Berichtsnutzer aktivieren

Inhaber der Datenquelle legen fest, welche überschreibbaren Parameter zulässig sind. von Mitbearbeitern geändert wurden. Mit Berichtseditoren wird gesteuert, Parameter können von Betrachtern von Berichten geändert werden.

Bearbeitern von Berichten erlauben, Parameterwerte zu ändern

Der Inhaber der Datenquelle legt fest, in welchen Parametern Änderungen zulässig sind. Berichte. Diese wird beim Erstellen oder Bearbeiten einer Datenquelle konfiguriert und wird gilt nur für Parameter, die definiert als überschreibbar durch den Connector . Wenn diese Option aktiviert ist, können Berichtseditoren Folgendes tun: Parameter in einem Bericht ändern

Im folgenden Beispiel sind zwei Parameter für einen Connector als überschreibbar definiert: zipcode und units. Der Inhaber der Datenquelle hat nur zipcode erlaubt, die in Berichten geändert wurden. Im Berichtseditor können Änderungen Wert des Parameters zipcode

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 über die Berichts-URL geändert werden. des Berichts.

Hinweis :Ein Berichtseditor kann das Ändern von Parametern über auf die vom Inhaber der Datenquelle zugelassenen Parameter beschränkt.

Angenommen, bei einem Connector sind zwei Parameter als überschreibbar definiert: zipcode und units (Abbildung 1). Wenn der Inhaber der Datenquelle zipcode in Berichten geändert werden (Abbildung 2), dann werden Bearbeiter nur können zulassen, dass zipcode von Betrachtern von Berichten geändert werden kann. Der Bericht hat Editor keinen Zugriff und keine Sichtbarkeit, sodass der units-Parameter die von den Betrachtern des Berichts geändert wurden.

<ph type="x-smartling-placeholder">

</ph>

Abbildung 1: Connector-Konfiguration

<ph type="x-smartling-placeholder">

</ph>

Abbildung 2: Parameter verwalten

Warnung: Betrachter von Berichten können auf alle Daten zugreifen, Parameter. Damit sensible Daten nicht versehentlich weitergegeben werden, solltest du sie prüfen und bestätigen. ob die Anmeldedaten für die Datenquelle und die Datenquellen konfiguriert sind bevor ein Parameter geändert werden darf. Wenn ein Parameter Zugriff auf sensible Daten haben, sollten Sie die Anmeldedaten des Betrachters verwenden, Sorgen Sie dafür, dass Betrachter des Berichts nur ihre 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
3. Verwenden Sie die Kästchen Änderungen an der Berichts-URL zulassen, um Die Änderung von Parameterwerten in der Berichts-URL ist nicht zulässig. Änderungen sind automatisch gespeichert.
4. Klicken Sie rechts oben auf Schließen.

Parameterwerte ändern

Mitbearbeiter können Parameterwerte über den Eigenschaftenbereich des Berichts ändern. Betrachter können Parameterwerte über die Berichts-URL ändern.

Eigenschaftenbereich für Berichte

Weitere Informationen dazu, wie ein Berichtseditor Parameterwerte festlegen kann, 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 werden über ein URL-codiertes JSON-Objekt festgelegt, 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
   3. Notieren Sie sich den Namen der Parameter, die Sie über den Bericht festlegen möchten. URL

   In der Abbildung darunter 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. Für Parameter, die mehrere Werte akzeptieren (z.B. Drop-down-Menüs mit Mehrfachauswahl), verwenden ein Array von Werten.

   Wenn der Parametername beispielsweise ds0.zipcode lautet, wird die Postleitzahl auf 94094 enthält, sieht die JSON so aus:

   {
     "ds0.zipcode": "94094"
   }
   

3. URL-Codierung des Parameterobjekts

   Nachdem Sie das Parameterobjekt erstellt haben, verwenden Sie JSON.stringify(), um es zu aktivieren. in einen String umwandeln und mit [encodeURIComponent] eine URL-Codierung durchführen.

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

   Daraus ergibt sich die folgende codierte Zeichenfolge:

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

4. Berichts-URL erstellen

   Nachdem Sie das URL-codierte Parameterobjekt erhalten haben, hängen Sie es der Berichtsdatenansicht an. URL mit dem Abfrageparameter params.

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

5. URL verwenden

   Die Berichts-URL überschreibt die in den JSON-Parametern definierten Parameter. basierend auf der Parameterübernahme.

Beispiel für ein Parameterobjekt

Das folgende Parameterobjekt zeigt, wie mehrere Parameter festgelegt werden. Außerdem zeigt das Festlegen von Parameterwerten für die verschiedenen Eingabetypen.

• 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 hat eine Rangfolge, die davon abhängt, an welcher Stelle der Parameter festgelegt ist. Parameter, die für höherrangige Standorte festgelegt sind, überschreiben Parameter, die für weniger wichtige Standorte festgelegt sind. Die Rangfolge (von aufsteigend) ist:

1. Datenquelle (Standard)
2. URL melden
3. Eigenschaftenbereich für den Bericht unter der Datenquelle Parameterübernahme festlegen.