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.

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 berikut ini:

• label untuk kolom, model, Jelajahi, atau tampilan
• label untuk aplikasi di framework ekstensi Looker
• group_label untuk Jelajahi dan group_label untuk kolom
• group_item_label untuk kolom
• description untuk Jelajahi dan description untuk kolom
• Rentang waktu, interval, dan rentang waktu kustom yang dihasilkan oleh parameter dimension_group (untuk mengetahui informasi selengkapnya, lihat bagian Melokalkan grup dimensi di halaman ini)

Anda juga dapat membuat dasbor LookML yang dilokalkan dalam 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, IDE Looker 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.

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 key-value pair 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.

Contoh file en.strings.json ini akan digunakan untuk semua pengguna yang memiliki nilai Locale en. Dalam LookML contoh 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:

Perhatikan hal berikut:

• Dalam LookML contoh tampilan flights yang ditampilkan sebelumnya di halaman ini, tidak ada label yang diberikan untuk dimensi location, sehingga Looker menggunakan huruf kapital pada nama dimensi dan menampilkannya sebagai "Location".
• Pelokalan untuk label "negara" tidak ditentukan dalam file en.strings.json, sehingga Looker menampilkan label sebagaimana 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 apa yang akan dilihat pengguna dengan lokalitas yang ditetapkan ke es_ES di Looker:

Perhatikan hal berikut:

• Seperti pada contoh sebelumnya, di tampilan asli dengan label dan deskripsi yang ditambahkan, tidak ada label yang diberikan untuk dimensi lokasi, sehingga Looker menggunakan huruf kapital dan menampilkan nama dimensi sebagai "Location".
• Pelokalan tidak ditentukan untuk label "country" dalam file en.strings.json, yang merupakan file string lokalitas default. Artinya, meskipun "country" ditentukan dalam file es_ES.strings.json, Looker tidak melokalkan string ini dan menampilkan label sebagaimana yang 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.

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.

Jangan salah mengartikan lokalitas default untuk project Anda dengan lokalitas 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 tempat pengguna 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 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. Looker IDE menampilkan error validasi LookML untuk elemen yang tidak memiliki label serta untuk label dan deskripsi yang tidak ditentukan dalam file string lokal 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 individu, 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 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.

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.

Melokalkan grup dimensi

Anda dapat menggunakan pelokalan model dengan parameter dimension_group. Dengan fitur ini, developer LookML dapat memberikan terjemahan kustom untuk hal berikut:

• Jangka waktu grup dimensi type: time (seperti month, year, atau opsi jangka waktu standar)
• Interval grup dimensi type: duration (seperti months, years, atau opsi interval standar)
• Rentang waktu kustom dari grup dimensi type: custom_calendar (seperti custom_period atau custom_year). Lihat Melokalkan grup dimensi kalender kustom.

Melokalkan grup dimensi sangat berguna untuk memberikan nama kustom yang akurat untuk kolom yang dibuat oleh grup dimensi kalender kustom (misalnya, mengganti nama kolom default menjadi "Periode Penjualan").

Untuk menerjemahkan atau mengganti nama nilai jangka waktu dan interval yang dihasilkan oleh grup dimensi, tambahkan string jangka waktu, interval, atau jangka waktu kustom sebagai kunci dalam file string lokal Anda (seperti en.strings.json dan es_ES.strings.json) dan berikan nilai tampilan yang diterjemahkan.

Berikut adalah LookML untuk contoh grup dimensi:

  dimension_group: created {
    type: time
    timeframes: [time, date, week, month, year]
    sql: ${TABLE}.created_at ;;
  }

Berikut adalah contoh file string lokal en.strings.json yang menyediakan terjemahan pasangan nilai kunci untuk year:

{
  "year": "translated year",
}

Di pemilih kolom Jelajah, grup dimensi ditampilkan seperti ini:

Created Date
  Date
  Month
  Time
  translated year
  Week

Melokalkan grup dimensi kalender kustom

Untuk grup dimensi type: custom_calendar, Anda harus menambahkan jangka waktu kustom (seperti custom_date dan custom_year) sebagai kunci dalam file string lokalitas dan memberikan nilai tampilan yang diterjemahkan.

Berikut adalah LookML untuk contoh grup dimensi kalender kustom:

  dimension_group: cust_created_localized {
    type: custom_calendar
    custom_timeframes: [custom_date, custom_week, custom_period, custom_year]
    sql: ${TABLE