Interessante Möglichkeiten, Liquid in Labels zu verwenden

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

Für die Beispiele auf dieser Seite sind Kenntnisse von Liquid erforderlich. Weitere Informationen zur Verwendung von Liquid in Looker finden Sie auf der Dokumentationsseite Referenz für Liquid-Variablen.

view_label für dynamische Ansichtsnamen verwenden

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

Wenn Sie Dimensionen dasselbe view_label zuweisen, werden Explores für Nutzer vereinfacht. Durch übersichtliche, beschreibende Gruppen von Feldern können Nutzer die benötigten Daten leichter finden.

Beispiel: DRY-Code (Don't Repeat Yourself) mit einem Liquid-view_label schreiben

Angenommen, Sie haben Felder, die in einem Explore namens Inventory Items unter dem view_label Finance & Accounting 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 wäre, wenn Sie das view_label Finance & Accounting für Nutzer in The Money Zone ändern möchten? Mit Liquid können Sie das wiederholte Umschreiben von Code vermeiden.

Sie können mit dem Looker-Feld parameter eine Art Pseudovariable des gewünschten Ansichtsnamens erstellen. Wenn Sie den Ansichtsnamen im 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 ;; }

Die Felderauswahl in Explore für Inventarartikel mit „Cost“, „Cost Eur“ und „Cost Ex Vat“ unter dem Ansichtslabels „The Money Zone“.

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

Dynamische Feldlabels

Es gibt möglicherweise mehrere Nutzergruppen, die den Namen eines Felds unterschiedlich interpretieren. Einige Nutzer könnten beispielsweise eine Handelsspanne als Betriebsmarge bezeichnen, während andere Nutzer je nach Anwendungsfall eine Handelsspanne als Standardmarge bezeichnen.

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 verschiedene Nutzerattribute

Wenn wir das vorherige Beispiel weiter ausführen, können Sie Unterschiede in der Geschäftslogik berücksichtigen, indem Sie das Feld Gross Margin für einige Nutzer als Standard Margin und für andere Nutzer als Operating Margin anzeigen. In der folgenden LookML 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 Gross Margin in einer Feldauswahl für das Explore für User A als Operating Margin angezeigt.

Basierend auf der LookML wird das Feld Gross Margin in einer Feldauswahl für das Explore für User B als Standard Margin angezeigt.

Dieses Muster kann auch verwendet werden, um eine einfache Lokalisierung auf Nutzerbasis zu erstellen, wie im nächsten Beispiel gezeigt.

Beispiel: Angepasste Feldnamen für mehrere Explores

In diesem Beispiel werden die Techniken aus den vorherigen Beispielen kombiniert, um ein Explore 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 die Messwerte Total Profit und Total Revenue in ihren Abfragen 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 DRY LookML mit den folgenden Liquid-Parametern verwenden:

  • Der from Parameter gibt die zugrunde liegende Ansicht für die Explores an.
  • Mitexplore_label wird für die beiden Explores mit Alias („Company Sales“) derselbe Name 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 {{ _explore._name}} Liquid-Variable 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 der explorativen Datenanalyse wird das Feld Total profit für das Team von Finance East als Finance_East: Profit und das Feld Total Revenue als Finance_East: Revenue angezeigt.

    Bei der explorativen Datenanalyse wird das Feld Total profit für das Team von Finance West als Finance_West: Profit und das Feld Total Revenue als Finance_West: Revenue angezeigt.

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