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 merepresentasikan faktor pembeda lainnya, seperti pengguna internal versus eksternal, atau manajer versus kontributor perorangan, dan menyesuaikan label serta 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 lokal.
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 terjadi bersamaan 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:

• label untuk kolom, model, Jelajahi, atau lihat
• label untuk aplikasi di framework ekstensi Looker
• group_label untuk Jelajahi dan group_label untuk bidang
• group_item_label untuk kolom
• description untuk Jelajahi dan description untuk bidang

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 di project yang dapat dilokalkan, Anda dapat menyetel tingkat pelokalan project ke strict. Dengan setelan ini, Looker IDE akan menampilkan error validasi LookML untuk elemen LookML apa pun yang dapat dilokalkan tetapi tidak memiliki label, dan untuk string apa pun dalam model LookML yang dapat dilokalkan tetapi tidak ditentukan dalam file string lokal Anda.

Dalam LookML contoh 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 yang ada di halaman ini, kita akan melokalkan nilai ini dalam file string menggunakan tingkat pelokalan permissive. Perhatikan bahwa dimensi location tidak memiliki label, jadi kita dapat mendemonstrasikan cara menampilkan dimensi tanpa pelokalan.

Membuat file string lokalitas

File string lokal 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 string label atau deskripsi dari model Anda. Sisi kanan pasangan nilai kunci adalah tempat Anda menentukan cara string tersebut ditampilkan di UI Looker.

Untuk setiap lokalitas yang ingin Anda gunakan 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 Anda 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 ingin menggunakan antarmuka pengguna dasbor dan visualisasi yang dilokalkan secara native di Looker, Anda harus mencocokkan judul file string dengan kode lokal yang didukung Looker.

Contoh file en.strings.json ini akan digunakan untuk semua pengguna yang memiliki nilai Locale 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 apa yang akan dilihat pengguna dengan setelan lokalnya 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 flights contoh LookML yang ditampilkan sebelumnya, kami tidak memberikan label sama sekali untuk dimensi location, sehingga Looker menampilkan nama dimensi, yang ditulis dengan huruf kapital: "Location".
• Kita tidak menentukan pelokalan untuk label "country" dalam file en.strings.json, sehingga Looker menampilkan label sebagaimana yang ditentukan dalam file tampilan, tanpa 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 apa 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, di tampilan asli dengan label dan deskripsi yang ditambahkan, kita tidak memberikan label sama sekali untuk dimensi location, sehingga Looker menampilkan nama dimensi, yang ditulis dengan huruf kapital: "Location".
• Kita tidak menentukan pelokalan untuk label "country" dalam file en.strings.json, yang merupakan file string lokalitas default kita. Jadi, meskipun kita telah menentukan "negara" dalam file es_ES.strings.json, Looker tidak melokalkan string ini, dan menampilkan label sebagaimana ditentukan dalam file tampilan: "country".

Menambahkan setelan pelokalan ke file manifes project Anda

Untuk mengaktifkan pelokalan project, 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 Looker IDE.

Di 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 lokal 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.

Bahasa lokal default untuk project Anda tidak boleh disamakan dengan bahasa lokal default untuk pengguna Looker. Admin Looker Anda dapat menetapkan lokalitas default untuk instance Anda. Jika tidak ada default yang ditetapkan, Looker akan menggunakan en sebagai default. Jika admin Anda tidak secara khusus memasukkan nilai Locale untuk pengguna atau grup pengguna yang menjadi anggotanya, Looker akan menetapkan pengguna ke lokalitas instance default. Selain itu, jika admin belum menyetel lokalitas instance default, Looker akan menetapkan pengguna ke lokalitas en.

Oleh karena itu, kecuali jika Anda yakin bahwa admin Looker akan menyetel nilai Locale untuk semua pengguna Looker, Anda harus menyetel parameter default_locale project ke lokalitas default untuk instance Anda (atau ke en jika tidak ada default yang telah 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, Eksplorasi, tampilan, dan kolom dalam project Anda. IDE Looker akan menampilkan error validasi LookML untuk elemen yang tidak memiliki label, dan untuk label serta deskripsi 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 Anda ke permissive saat Anda mengembangkan project untuk mencegah error validasi. Setelah selesai melokalkan semua label dan deskripsi, Anda dapat menyetel tingkat pelokalan ke strict untuk melihat error.

Menetapkan pengguna ke lokalitas

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

Misalnya, jika Anda ingin pengguna melihat label dan deskripsi yang ditentukan dalam file es_ES.strings.json, admin Looker Anda harus menyetel setelan Lokalitas 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 mengetahui 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 Membuat file string lokalitas.

Menetapkan lokalitas untuk pengguna sematan yang login

Anda dapat menyertakan nilai lokal pengguna dalam URL sematan bertanda tangan seperti atribut pengguna lainnya. Format persis yang diperlukan untuk sematan bertanda tangan bergantung pada bahasa pemrograman yang digunakan untuk membuat skrip URL sematan bertanda tangan, tetapi nama atribut pengguna adalah locale. Lihat halaman dokumentasi Penyematan bertanda tangan untuk mengetahui informasi selengkapnya tentang URL penyematan bertanda tangan dan alat untuk membuat URL penyematan bertanda tangan.

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 memungkinkan Anda melokalkan nilai data juga.

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, di file es_ES.strings.json, kita dapat menyediakan versi 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 melihat data "Domestik" dan "Internasional" yang dilokalkan menjadi "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 penerapan aturan pelokalan ke objek yang diperluas dan disempurnakan

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

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

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 perlu menentukan kedua string label tampilan ("flight_info" dan "enhanced_flight_info"). Jika tingkat pelokalan project ditetapkan ke strict, kita tidak dapat melakukan commit pada pembaruan apa pun hingga kita menentukan label atau deskripsi baru.