Interessante Möglichkeiten, Liquid in Labels zu verwenden

Auf dieser Seite werden nützliche Möglichkeiten zur Verwendung des parameter-Felds von Looker mit einigen der label-Unterparameter beschrieben, die Liquid-Variablen akzeptieren.

Für die Beispiele auf dieser Seite ist ein Verständnis von Liquid erforderlich. Weitere Informationen zur Verwendung von Liquid in Looker finden Sie in der Referenz für Liquid-Variablen.

view_label für Namen dynamischer Ansichten verwenden

Der Parameter view_label von Looker wird verwendet, um Dimensionen in der Feldauswahl für das Explore unter einem kontextbezogenen, nutzerfreundlichen Namen zu gruppieren. Weitere Informationen zu Ansichtslabels finden Sie auf der Dokumentationsseite view_label (für Felder).

Wenn Sie Dimensionen dieselbe view_label zuweisen, werden Explores für Nutzer einfacher. Durch klare, beschreibende Feldgruppen können Nutzer die benötigten Daten leichter finden.

Beispiel: DRY-Code (Don't Repeat Yourself, d. h. „Nicht wiederholen“) mit einem Liquid-view_label schreiben

Angenommen, Sie haben Felder, die in einem Explore namens Inventarelemente unter view_label Finanzen und Buchhaltung organisiert sind:

dimension: cost {
  view_label: "Finance & Accounting"
  type: number
  sql: ${TABLE}.COST ;;
}

dimension: cost_ex_vat { view_label: "Finance & Accounting" type: number sql: ${TABLE}.COST_EX_VAT ;; }

dimension: cost_eur { view_label: "Finance & Accounting" type: number sql: ${TABLE}.COST_EUR ;; }

Was passiert, wenn Sie view_label Finanzen und Buchhaltung in The Money Zone ändern möchten? Mit Liquid lässt sich das wiederholte Neuschreiben von Code vermeiden.

Mit dem Feld parameter in Looker können Sie eine Art Pseudovariable mit dem gewünschten Namen der Datenansicht erstellen. Wenn Sie den Namen der Ansicht in der parameter ändern, werden alle Felder aktualisiert.

parameter: view_label {
  type: string
  default_value: "The Money Zone"
}

dimension: cost { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST ;; }

dimension: cost_ex_vat { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST_EX_VAT ;; }

dimension: cost_eur { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST_EUR ;; }

In der Auswahl der Felder für die explorative Datenanalyse für Inventarelemente werden „Kosten“, „Kosten in Euro“ und „Kosten ohne MwSt.“ unter dem Ansichtslabel „Die Geldzone“ angezeigt.

Hinweis:Wenn die Anführungszeichen nicht im Menü angezeigt werden sollen, muss parameter auf type:unquoted festgelegt sein und default_value muss ein String ohne Leerzeichen sein, z. B. The_Money_Zone. Wenn der Parameter type:string ist, werden die Anführungszeichen angezeigt.

Labels für dynamische Felder

Möglicherweise haben Sie mehrere Nutzergruppen, die den Namen eines Felds unterschiedlich interpretieren. Je nach Anwendungsfall bezeichnen einige Nutzer die Bruttomarge beispielsweise als Betriebsmarge und andere als Standardmarge.

Der Name eines Felds kann für verschiedene Nutzer unterschiedlich aussehen, je nachdem, wie Sie Nutzerattribute und Liquid-Variablen kombinieren.

Beispiel: Unterschiedliche Labels für unterschiedliche Nutzerattribute

Um auf das vorherige Beispiel zurückzukommen: Sie können Unterschiede in der Geschäftslogik berücksichtigen, indem Sie das Feld Bruttomarge für einige Nutzer als Standardmarge und für andere Nutzer als Betriebsmarge anzeigen lassen. In der folgenden LookML-Anfrage werden Nutzerattribute und Liquid-Variablen verwendet.

dimension: gross_margin {
  label: "{% if _user_attributes['customer'] == 'A' %} Standard Margin
    {% elsif _user_attributes['customer'] == 'B' %} Operating Margin
    {% else %} Gross Margin
    {% endif %}"
  type: number
  value_format_name: usd
  sql: ${sale_price} - ${inventory_items.cost} ;;
}

Basierend auf der LookML wird das Feld Bruttomarge in der Feldauswahl eines Explores für Nutzer A als Betriebsmarge angezeigt.

Basierend auf der LookML wird das Feld Bruttomarge in der Feldauswahl für Explores für Nutzer B als Standardmarge angezeigt.

Dieses Muster kann auch verwendet werden, um Low-Level-Lokalisierungen auf Nutzerebene zu erstellen, wie im nächsten Beispiel gezeigt.

Beispiel: Benutzerdefinierte Feldnamen für mehrere Explores

In diesem Beispiel werden die Techniken aus den vorherigen Beispielen kombiniert, um ein exploratives Datenanalysetool mit Feldlabels zu erstellen, die je nach Region des Nutzers variieren.

In diesem Beispiel gibt es zwei regionale Teams – Finance East und Finance West –, die ein Explore namens Company Sales verwenden. Beide Teams müssen in ihren Abfragen die Messwerte Gesamtgewinn und Gesamtumsatz verwenden:

measure: total_profit {
  label: "{{ _explore._name}}: Profit"
  type: sum
  sql: ${profit} ;;
}

measure: total_revenue { label: "{{ _explore._name}}: Revenue" type: sum sql: ${sale_price} ;; value_format_name: usd }

Jedes Team möchte jedoch, dass der Feldname die Region des Teams widerspiegelt.

Entwickler können die Feldnamen für Nutzer von Finance East und Finance West unterschiedlich gestalten. Dazu können sie die folgenden Liquid-Parameter in DRY LookML verwenden:

  • Der Parameter from gibt die zugrunde liegende Ansicht für die Explores an.
  • Mit der explore_label wird derselbe Name für die beiden Explores mit Alias („Unternehmensumsätze“) angezeigt, um für beide Teams eine ansonsten identische explorative Datenanalyse zu ermöglichen.
  • Die Labels der Messwerte können je nach Region eines Teams geändert werden. Dazu wird die Liquid-Variable {{ _explore._name}} verwendet, die den Namen des Explores erfasst und anzeigt.
  • Die Explores

    explore: Finance_East{
      from: order_items
      label: "Company Sales"
      view_label: "The Money Zone"
    }
    

    explore: Finance_West{ from: order_items label: "Company Sales" view_label: "The Money Zone" }

    Bei explorativen Datenanalysen sieht das Team „Finance East“ das Feld Gesamtgewinn als Finance_East: Profit und das Feld Gesamtumsatz als Finance_East: Umsatz.

    In der explorativen Datenanalyse sieht das Team „Finance West“ das Feld Gesamtgewinn als Finance_West: Gewinn und das Feld Gesamtumsatz als Finance_West: Umsatz.

    Weitere Möglichkeiten zum Anpassen der Darstellung von Feldern für Nutzer finden Sie auf der Dokumentationsseite Das Menü „Explore“ und den Field Picker ändern.