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. Informationen zur Verwendung von Liquid in Looker finden Sie auf der Dokumentationsseite Liquid-Variablen-Referenz.

view_label wird für dynamische Ansichtsnamen verwendet.

Der view_label-Parameter von Looker wird verwendet, um Dimensionen im Field Picker von Explore unter einem kontextbezogenen, nutzerfreundlicheren Namen zu gruppieren. Weitere Informationen zu Ansichtslabels finden Sie auf der Dokumentationsseite view_label (für Felder).

Wenn Sie Dimensionen dieselben view_label zuweisen, werden Explores für Nutzer vereinfacht. Klare, beschreibende Gruppen von Feldern stellen sicher, dass Benutzer die benötigten Daten finden können.

Beispiel: DRY-Code (nicht wiederholen) mit Liquid-view_label schreiben

Angenommen, Sie haben Felder, die in der Spalte view_label Finanz- und Buchhaltung in einem Explore namens Inventory Items (Inventarelemente):

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 können Sie tun, wenn Sie die Einstellungen für view_label Finanzen und Sind die Abrechnung von The Money Zone für Nutzer aktiviert? 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 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 ;; }

Feldauswahl für das Explore der Inventarelemente, die unter der Ansichtsbezeichnung „Die Geldzone“ die Kosten, Kosten Euro und Kosten ex MwSt. zeigt.

Hinweis: Wenn Sie nicht möchten, dass die Anführungszeichen im Menü angezeigt werden, muss parameter als type:unquoted festgelegt werden 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

Mehrere Nutzergruppen können den Namen eines Felds unterschiedlich interpretieren. Je nach Anwendungsfall bezeichnen einige Nutzer die Bruttomarge beispielsweise als Betriebsmarge, andere als Standardmarge.

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

Beispiel: Unterschiedliche Labels für unterschiedliche Nutzerattribute

Extrapolation aus dem vorherigen Beispiel können Sie Unterschiede in der Geschäftslogik berücksichtigen, indem Sie das Feld Bruttomarge für einige Nutzer als Standardspanne und für andere Nutzer als Betriebsspanne anzeigen lassen. Der folgende LookML-Code nutzt Benutzerattribute und Liquid-Variablen.

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 Auswahl der Explore-Felder 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 seines 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 entsprechend der Region eines Teams geändert werden. Dazu verwenden Sie die Variable {{ _explore._name}} Liquid, die den Explore-Namen 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.