Melokalkan model LookML

Dengan pelokalan model, Anda dapat menyesuaikan cara label dan deskripsi model ditampilkan sesuai dengan lokalitas pengguna.

Pelokalan tidak harus didasarkan pada lokasi geografis atau bahasa. Anda dapat menggunakan lokalitas untuk mewakili faktor pembeda lainnya, seperti pengguna internal versus eksternal, atau pengelola versus kontributor individual, dan menyesuaikan label dan deskripsi Anda.

Catatan: Pelokalan model saat ini tidak kompatibel dengan impor project.

Halaman ini menjelaskan langkah-langkah untuk melokalkan project Anda:

1. Tentukan elemen mana yang akan dilokalkan dengan menambahkan label, label grup, dan deskripsi ke model Anda.
2. Berikan definisi pelokalan untuk project Anda dengan membuat file string lokalitas.
3. Aktifkan pelokalan untuk project Anda dengan menambahkan setelan pelokalan ke file manifes project.
4. Tentukan tampilan untuk pengguna yang berbeda dengan menetapkan pengguna ke lokalitas.

Pelokalan model sering kali dilakukan bersama dengan admin yang menentukan setelan pelokalan format angka dan bahasa antarmuka pengguna.

Melokalkan label dan deskripsi dalam model Anda

Anda dapat melokalkan label, label grup, dan deskripsi dalam model, termasuk hal berikut:

• label untuk kolom, model, Jelajahi, atau tampilan
• label untuk aplikasi dalam framework ekstensi Looker
• group_label untuk Jelajahi dan group_label untuk kolom
• group_item_label untuk kolom
• description untuk Jelajahi dan description untuk kolom

Tips: Pelokalan tidak didukung untuk dimension_group. Sebagai gantinya, gunakan group_label dan group_item_label di tingkat kolom untuk membuat kumpulan dimensi Anda sendiri yang dapat dilokalkan.

Anda juga dapat membuat dasbor LookML yang dilokalkan di project Anda. Parameter dasbor LookML berikut dapat dilokalkan:

• title
• description
• text (yang merupakan subparameter dari parameter note dan dapat diterapkan ke semua jenis elemen dasbor, selain elemen type: text)
• comparison_label
• single_value_title

Untuk melihat semua kolom dalam project yang dapat dilokalkan, Anda dapat menetapkan tingkat pelokalan project ke strict. Dengan setelan ini, Looker IDE akan menampilkan error validasi LookML untuk elemen LookML yang dapat dilokalkan tetapi tidak memiliki label, dan untuk string apa pun dalam model LookML yang dapat dilokalkan tetapi tidak ditentukan dalam file string lokalitas Anda.

Dalam contoh LookML berikut, label disediakan untuk tampilan flights dan kolom id, country, dan number_of_engines. Deskripsi juga diberikan untuk kolom country.

view: flights {
  label: "flight_info"
  sql_table_name: flightstats.accidents ;;

  dimension: id {
    label: "id"
    primary_key: yes
    type: number
    sql: ${TABLE}.id ;;
  }

  dimension: country {
    label: "country"
    description: "country_of_departure"
    type: string
    map_layer_name: countries
    sql: ${TABLE}.country ;;
  }

  dimension: number_of_engines {
    label: "number_of_engines"
    type: string
    sql: ${TABLE}.number_of_engines ;;
  }

  dimension: location {
    type: string
    sql: ${TABLE}.location ;;
  }

Dalam contoh berikut di halaman ini, kita akan melokalkan nilai ini dalam file string menggunakan tingkat pelokalan permissive. Perhatikan bahwa dimensi location tidak memiliki label, sehingga kita dapat menunjukkan cara dimensi tanpa pelokalan ditampilkan.

Membuat file string lokalitas

File string lokalitas menggunakan pasangan nilai kunci untuk menentukan cara label dan deskripsi dalam model Anda ditampilkan untuk setiap lokalitas. Di sisi kiri setiap pasangan nilai kunci adalah kunci pelokalan, yang merupakan label atau string deskripsi dari model Anda. Di sisi kanan pasangan nilai kunci, Anda dapat menentukan cara string tersebut ditampilkan di UI Looker.

Untuk setiap lokalitas yang ingin digunakan untuk project, Anda perlu membuat file string khusus. Buat hanya satu file string untuk setiap lokalitas. Anda harus memiliki file string yang diberi nama agar cocok dengan lokalitas default. Misalnya, jika telah menentukan default_locale: en dalam file manifes project, Anda harus memiliki file dalam model yang disebut en.strings.json. Setiap string harus ditentukan dalam file string lokalitas default atau tidak akan dilokalkan.

Tips: Pelokalan model tidak harus didasarkan pada lokasi geografis atau bahasa. Namun, jika Anda menggunakan pelokalan model dan juga ingin menggunakan dasbor dan antarmuka pengguna visualisasi Looker yang dilokalkan secara native, Anda harus mencocokkan judul file string dengan kode lokalitas yang didukung Looker.

Contoh file en.strings.json ini akan digunakan untuk semua pengguna yang memiliki nilai Lokalitas en. Dalam contoh LookML berikut, en juga ditentukan sebagai lokalitas default, sehingga semua string harus ditentukan dalam file ini agar dapat dilokalkan.

{
  "flight_info": "Flights",
  "id": "Identifier",
  "country_of_departure": "Country of Departure",
  "number_engines": "Number of Engines"
}

Tabel berikut menunjukkan tampilan yang akan dilihat pengguna dengan lokalitas yang ditetapkan ke en di tabel data Eksplorasi Looker:

Flights Identifier	Flights country	Flights Location	Flights Number of Engines
493	Congo	Kisangani, Congo	3
2167	Saudi Arabia	Riyadh, Saudi Arabia	3
2657	Austria	Vienna, Austria	2
17992	United States	Kansas City, MO	2
18893	United States	Anchorage, AK	4

Perhatikan hal berikut:

• Dalam LookML contoh tampilan flights yang ditampilkan sebelumnya, kita tidak memberikan label sama sekali untuk dimensi location, sehingga Looker menampilkan nama dimensi, dengan huruf kapital: "Location".
• Kita tidak menentukan pelokalan untuk label "country" dalam file en.strings.json, sehingga Looker menampilkan label seperti yang ditentukan dalam file tampilan, tanpa menggunakan huruf kapital: "country".

Sebagai contoh lain, kita dapat membuat file es_ES.strings.json yang digunakan untuk semua pengguna dengan nilai Locale es_ES:

{
  "flight_info": "Vuelos",
  "id": "Identificador",
  "country": "País",
  "country_of_departure": "País de Partida",
  "number_engines": "Número de Motores"
}

Tabel berikut menunjukkan tampilan yang akan dilihat pengguna dengan lokalitas yang ditetapkan ke es_ES di Looker:

Vuelos Identificador	Vuelos country	Vuelos Location	Vuelos Número de Motores
493	Congo	Kisangani, Congo	3
2167	Saudi Arabia	Riyadh, Saudi Arabia	3
2657	Austria	Vienna, Austria	2
17992	United States	Kansas City, MO	2
18893	United States	Anchorage, AK	4

Perhatikan hal berikut:

• Seperti pada contoh sebelumnya, dalam tampilan asli dengan label dan deskripsi yang ditambahkan, kita tidak memberikan label sama sekali untuk dimensi location, sehingga Looker menampilkan nama dimensi, dengan huruf kapital: "Location".
• Kita tidak menentukan pelokalan untuk label "country" dalam file en.strings.json, yang merupakan file string lokalitas default. Jadi, meskipun kita telah menentukan "country" dalam file es_ES.strings.json, Looker tidak melokalkan string ini, dan menampilkan label seperti yang ditentukan dalam file tampilan: "country".

Menambahkan setelan pelokalan ke file manifes project

Untuk mengaktifkan pelokalan untuk project Anda, tambahkan parameter localization_settings ke file manifes project Anda.

Tips: Jika project Anda belum memilikinya, Anda dapat membuat file manifes dari ikon + di bagian atas browser file di IDE Looker.

Dalam file manifes, tambahkan setelan pelokalan Anda. Berikut contohnya:

localization_settings: {
  default_locale: en
  localization_level: permissive
}

default_locale

Parameter default_locale menentukan nama file string lokalitas default dalam project Anda.

File string lokalitas default menentukan string mana dari model Anda yang dilokalkan. Meskipun string label atau deskripsi ditentukan dalam file string lokalitas lain, jika tidak ditentukan dalam file string lokalitas default, UI Looker akan menampilkan string yang tidak dilokalkan.

Lokalitas default untuk project Anda tidak boleh disamakan dengan lokalitas default untuk pengguna Looker. Admin Looker dapat menetapkan lokalitas default untuk instance Anda. Jika tidak ada setelan default yang ditetapkan, Looker akan menetapkan setelan default ke en. Jika admin Anda tidak memasukkan nilai Locale secara khusus untuk pengguna atau grup pengguna tempat pengguna tersebut berada, Looker akan menetapkan pengguna ke lokalitas instance default. Selain itu, jika admin belum menetapkan lokalitas instance default, Looker akan menetapkan pengguna ke lokalitas en.

Oleh karena itu, kecuali jika Anda yakin admin Looker akan menetapkan nilai Lokasi untuk semua pengguna Looker, Anda harus menetapkan parameter default_locale project ke lokalitas default untuk instance (atau ke en jika tidak ada default yang ditetapkan), dan menentukan pelokalan untuk semua label dan deskripsi dalam file .strings.json untuk lokalitas tersebut.

localization_level

Tingkat pelokalan project Anda menentukan apakah elemen yang tidak dilokalkan diizinkan dalam model Anda:

• Tetapkan tingkat pelokalan ke strict untuk mewajibkan label yang dilokalkan untuk semua model, Jelajah, tampilan, dan kolom di project Anda. Looker IDE akan menampilkan error validasi LookML untuk elemen mana pun yang tidak memiliki label, dan untuk label dan deskripsi apa pun yang tidak ditentukan dalam file string lokalitas default.
• Tetapkan tingkat pelokalan ke permissive untuk mengizinkan elemen tanpa label, dan untuk mengizinkan label dan deskripsi yang tidak ditentukan dalam file string pelokalan default.

Meskipun Anda menginginkan tingkat pelokalan strict, sebaiknya tetapkan tingkat pelokalan project ke permissive saat mengembangkan project untuk mencegah error validasi. Setelah selesai menerjemahkan semua label dan deskripsi, Anda dapat menetapkan tingkat pelokalan ke strict untuk melihat error.

Menetapkan pengguna ke lokalitas

Setelah menyiapkan file string lokalitas, Anda dapat menetapkan pengguna ke lokalitas yang sesuai dengan salah satu file string lokalitas. Hal ini dapat dilakukan di tingkat instance, grup pengguna, atau pengguna individual, menggunakan kolom Locale atau atribut pengguna locale.

Misalnya, jika Anda ingin pengguna melihat label dan deskripsi yang ditentukan dalam file es_ES.strings.json, admin Looker harus menetapkan setelan Lokasi pengguna ke es_ES.

Lokalitas kustom yang Anda buat dengan file string dapat dimasukkan di kolom Locale dengan mengklik kolom dan mengetik nama file string, bukan memilih lokalitas bawaan dari menu drop-down. Untuk informasi selengkapnya, lihat halaman dokumentasi Pengguna.

Catatan: Jika lokalitas tidak ditetapkan untuk pengguna di tingkat individu atau grup pengguna, Looker akan menetapkan pengguna ke lokalitas instance. Namun, jika tidak ada file .strings yang disiapkan untuk lokalitas instance, pelokalan model tidak akan berfungsi untuk pengguna tersebut. Oleh karena itu, file .strings harus disiapkan untuk lokalitas default setiap instance. Anda dapat mempelajari lebih lanjut di bagian default_locale atau bagian Membuat file string lokalitas.

Menetapkan lokalitas untuk pengguna penyematan yang login

Anda dapat menyertakan nilai lokalitas pengguna dalam URL sematan yang ditandatangani seperti atribut pengguna lainnya. Format yang tepat yang diperlukan untuk penyematan yang ditandatangani bergantung pada bahasa pemrograman yang digunakan untuk mem-build skrip URL penyematan yang ditandatangani, tetapi nama atribut pengguna adalah locale. Lihat halaman dokumentasi Penyematan yang ditandatangani untuk mengetahui informasi selengkapnya tentang URL penyematan yang ditandatangani dan alat untuk membuat URL penyematan yang ditandatangani.

Menggunakan lokalitas dalam variabel Liquid

Seperti yang dijelaskan sebelumnya, pelokalan model memungkinkan Anda menyesuaikan tampilan label dan deskripsi model untuk berbagai lokalitas. Namun, Anda juga dapat menyertakan kunci pelokalan dalam Variabel Liquid, yang juga memungkinkan Anda melokalkan nilai data.

Misalnya, dalam file string lokalitas default bernama en.strings.json, kita dapat membuat kunci pelokalan domestic dan international dengan entri berikut:

{
  "domestic": "Domestic",
  "international": "International"
}

Kemudian, dalam file es_ES.strings.json, kita dapat memberikan versi bahasa Spanyol dari kunci pelokalan ini:

{
  "domestic": "Nacional",
  "international": "Internacional"
}

Dari sana, kita dapat menggunakan kunci pelokalan domestic dan international dalam variabel Liquid untuk melokalkan output dimensi:

dimension: from_US {
    label: "from_us"
    type: string
    sql: CASE
         WHEN ${TABLE}.country = 'United States' THEN '{{ _localization['domestic'] }}'
         ELSE '{{ _localization['international'] }}'
         END;;
  }

Pengguna dengan lokalitas en akan melihat hasil berikut:

Flights Identifier	Flights country	Flights From the US?
289	United States	Domestic
400	Canada	International
493	Congo	International
936	United States	Domestic

Pengguna dengan lokalitas es_ES akan melihat hasil berikut:

Vuelos Identificador	Vuelos País	Vuelos ¿De Los Estados Unidos?
289	United States	Nacional
400	Canada	Internacional
493	Congo	Internacional
936	United States	Nacional

Pengguna dengan lokalitas es_ES akan melihat data "Domestic" dan "International" yang dilokalkan ke "Nacional" dan "Internacional".

Anda juga dapat menggunakan Liquid di filter dasbor LookML dan filter elemen dasbor LookML untuk melokalkan nilai default dalam filter. Misalnya, jika dasbor LookML memiliki kartu yang menggunakan data dari model yang dilokalkan ini, dan ada filter pada kartu tersebut yang ditentukan di LookML sebagai berikut:

filters:
  flights.from_US: "{{ _localization['domestic'] }}"

Saat pengguna dengan lokalitas en menjelajahi dari kartu tersebut di dasbor, Eksplorasi akan difilter berdasarkan nilai Domestic untuk kolom Flights From the US?, dan tabel data di Eksplorasi akan menyertakan hasil berikut:

Flights Identifier	Flights country	Flights From the US?
289	United States	Domestic
936	United States	Domestic

Saat pengguna dengan lokalitas es_ES menjelajahi dari kartu tersebut di dasbor, Eksplorasi akan difilter berdasarkan nilai Nacional untuk kolom Vuelos ¿De Los Estados Unidos?, dan tabel data di Eksplorasi akan menyertakan hasil berikut:

Vuelos Identificador	Vuelos País	Vuelos ¿De Los Estados Unidos?
289	United States	Nacional
936	United States	Nacional

Memahami cara aturan pelokalan diterapkan ke objek yang diperluas dan dioptimalkan

Perhatikan bahwa aturan pelokalan berlaku saat Anda memperluas dasbor tampilan, Jelajah, atau LookML, dan saat Anda meningkatkan kualitas tampilan atau Jelajah.

Jika Anda telah memperluas atau menyaring objek, lalu menambahkan label atau deskripsi baru, Anda harus memberikan definisi pelokalan dalam file string lokalitas.

Misalnya, jika kita memiliki tampilan flights:

view: flights {
  label: "flight_info"
  sql_table_name: flightstats.accidents ;;
  ...
}

Kemudian, kita membuat tampilan baru yang memperluas tampilan flights:

include: "/views/flights.view"

view: flights_enhanced {
  extends: [flights]
  label: "enhanced_flight_info"
}

Dalam file string lokalitas, kita harus menentukan kedua string label tampilan ("flight_info" dan "enhanced_flight_info"). Jika tingkat pelokalan project ditetapkan ke strict, kita tidak akan dapat melakukan update apa pun hingga kita menentukan label atau deskripsi baru.