link

Penggunaan

view: view_name {
  dimension: field_name {
    link: {
      label: "desired label name"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more links
  }
}
Hierarki
view
Jenis Kolom
link
Jenis Kolom yang Mungkin
Dimensi, Ukuran

Menerima
Berbagai parameter

Definisi

Dengan parameter link, Anda dapat menambahkan link web ke dimensi dan ukuran agar pengguna bisa dengan mudah membuka konten terkait langsung dari Looker. Bentuk parameter link adalah:

dimension: field_name {
  link: {
    label: "desired label name"
    url: "desired_url"
    icon_url: "url_of_an_image_file"
  }
  # Possibly more links
}

Parameter link memiliki beberapa parameter turunan:

  • label adalah nama link yang ingin Anda tampilkan kepada pengguna.
  • url adalah URL yang ingin Anda tuju saat link diklik. Anda dapat menggunakan variabel Liquid untuk membuat link dinamis, seperti yang dijelaskan di bagian Menggunakan variabel Liquid dengan link di halaman ini.
  • icon_url adalah URL, yang dapat diakses oleh browser pengguna, yang berisi file gambar. Hal ini memudahkan pengguna untuk memahami sekilas ke mana link akan mengarahkan mereka. Parameter icon_url tidak wajib diisi jika Anda tidak menginginkan ikon. Jika Anda memerlukan logo perusahaan, coba jalankan penelusuran Google dengan pola http://www.google.com/s2/favicons?domain=[company website of interest] untuk menemukan gambar dalam format .ico.

Contoh

Perusahaan e-commerce ingin karyawannya dapat menghubungi dukungan gudang langsung dari konten Looker, seperti Look yang menampilkan pesanan tertunda dari bulan lalu. Look berisi ID pesanan dan ID pengguna pelanggan yang terkait dengan setiap pesanan.

Anda dapat menambahkan link ke dimensi ID Pesanan untuk membuat tindakan ini tersedia bagi pengguna yang melihat Look:


dimension: id {
  primary_key: yes
  type: number
  sql: ${TABLE}.id ;;
  link: {
    label: "Contact Warehouse Support"
    url: "mailto:warehouse@altostrat.com"
  }
}

Di Look, pengguna akan melihat link Hubungi Dukungan Warehouse di antara opsi dalam menu link, yang dapat diakses dengan mengklik menu tiga titik untuk salah satu nilai kolom ID Pesanan.

Dengan mengklik nama link, pengguna akan diarahkan ke konten yang ditautkan — dalam hal ini, tab baru dengan draf email kosong yang ditujukan ke alamat email yang ditentukan.

Saat pengguna mengklik link, Looker akan membuka link di tab browser baru atau di tab yang sama (atau iframe, untuk kueri sematan):

  • Link absolut, seperti https://example.looker.com, akan terbuka di tab browser baru.
  • Link relatif, seperti /dashboards/456, akan terbuka di tab browser atau iframe yang sama. Setelah link dibuka, pengguna dapat mengklik Kembali di browser untuk kembali ke kueri asli.

Pengguna harus memiliki izin explore atau see_drill_overlay untuk mengakses link.

Parameter link mendukung variabel Liquid untuk membuat konten menjadi lebih interaktif hingga tingkat baris dan nilai. LookML mendukung dua jenis tag penggunaan Liquid: tag input nilai {{ }} dan tag logika bersyarat {% %}.

Dari keduanya, {{ }}, bersama dengan variabel Liquid value dan _filters['view_name.field_name'], paling umum digunakan dengan link. Hal ini karena tag {{ }} memasukkan nilai input secara langsung di tempat tag tersebut ditempatkan, seperti dalam URL.

Lihat contoh di halaman ini untuk contoh penggunaan tag Liquid {{ }} dengan variabel value dan _filters['view_name.field_name'] untuk membuat konten interaktif dengan link.

Menautkan ke konten eksternal

Misalnya, Anda memiliki dimensi artist_name dan ingin pengguna memiliki opsi untuk menjalankan penelusuran Google untuk artis tersebut, langsung dari Looker. Anda dapat menggunakan value variabel Liquid untuk menambahkan opsi tersebut ke dimensi seperti berikut:

dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{ value }}"
    icon_url: "http://google.com/favicon.ico"
  }
}

Saat pengguna mengklik menu tiga titik untuk nilai kolom Nama Artis, Looker akan menampilkan menu Link, yang menyertakan link yang dibuat dalam LookML contoh. Link akan membuka tab browser baru ke penelusuran Google untuk artis yang mereka pilih. Nama artis yang dipilih dimasukkan ke dalam URL tempat {{ value }} ditempatkan.

Pola ini dapat direplikasi untuk situs eksternal lain yang dapat diakses oleh browser pengguna, seperti sistem pengelolaan tiket, sistem pengelolaan klien, dan alat terkait bisnis lainnya, untuk memudahkan navigasi antar-aplikasi web.

Menautkan ke konten di Looker

Selain situs eksternal, Anda dapat menggunakan parameter link untuk mengarahkan pengguna ke Eksplorasi, Look, atau dasbor Looker relevan lainnya untuk pengalaman penelusuran kustom. Anda juga dapat menerapkan contoh yang sama ke link dalam parameter LookML html untuk kolom.

Untuk memulai, Anda harus mendapatkan URL Explore, Look, atau dasbor yang ada yang ingin Anda tautkan. Kemudian, Anda dapat mengganti elemen tertentu dari URL, seperti nilai dan nama filter, dengan tag {{ }} yang berisi variabel value dan _filters['view_name.field_name']. Variabel akan memasukkan nilai yang dipilih pengguna ke dalam elemen URL yang digantikannya. Struktur dasar URL konten adalah sebagai berikut:

  • Jelajahi: /explore/YOUR_MODEL_NAME/YOUR_EXPLORE_NAME?fields=view_name.field_name1,view_name.field_name2...
    • Anda dapat memperoleh URL Eksplorasi untuk Eksplorasi yang ada dengan memilih opsi ikon roda gigi URL Panjang.
    • Filter Explore akan muncul di URL sebagai f[view_name.field_name]. Lihat bagian Menautkan ke Explore terkait untuk melihat contohnya.
  • Tampilan: /looks/YOUR_LOOK_NUMBER

  • Dasbor yang Ditentukan Pengguna: /dashboards/YOUR_DASHBOARD_NUMBER?FILTER_NAME_1=VALUE&FILTER_NAME_2=VALUE

    • Anda dapat memperoleh URL untuk dasbor yang ada dengan menyalin URL browser dari halaman dasbor.

  • Dasbor LookML: /dashboards/YOUR_MODEL::YOUR_DASHBOARD

    • Anda dapat memperoleh URL untuk dasbor LookML yang ada dengan menyalin URL browser dari halaman dasbor.

Filter dasbor untuk dasbor yang ditentukan pengguna dan LookML akan muncul di URL sebagai filter_name, dengan filter_name adalah nama yang diberikan ke filter yang ditempatkan di dasbor. Lihat bagian Meneruskan nilai filter yang ada ke konten tertaut untuk melihat contohnya.

Elemen URL, seperti nilai dan nama filter, dienkode URL dengan karakter khusus, seperti ? untuk menunjukkan awal string kueri, & untuk memisahkan elemen, dan %20 untuk spasi. Lihat bagian Encoding URL untuk operator perbandingan lainnya untuk mengetahui contohnya.

Setelah memiliki URL konten yang ingin ditautkan, Anda dapat menggunakan Liquid untuk menyisipkan nilai kolom ke dalam elemen URL, menggunakan variabel value atau _filters['view_name.field_name'] dan tag {{ }}. Lihat postingan Komunitas Looker Menggunakan URL dan parameter kueri untuk mengetahui informasi selengkapnya tentang bagian-bagian URL kueri.

Kita memiliki dimensi bernama Kota. Kami ingin pengguna dapat mengakses Eksplorasi lain yang sudah ada, dengan metrik kota dan filter Kota. Kita ingin Eksplorasi tertaut difilter menurut kota yang dipilih pengguna.

Untuk mencapai hal ini:

  1. Dapatkan URL Eksplorasi yang ada untuk melihat perincian.
  2. Tambahkan parameter link ke dimensi Kota:
  dimension: city {
  type: string
  sql: ${TABLE}.city ;;
  link: {
    label: "City Metrics Explore"
    url: "/explore/ecommerce_model/order_items_explore?fields=users.city,orders.count,users.count&f[users.city]=&sorts=orders.count+desc&limit=500"
  }
  }

Di sini, URL telah disingkat menjadi limit=500, yang membatasi hasil Jelajah hingga 500 baris, agar lebih jelas — Anda dapat menyertakan bagian URL lainnya, yang biasanya mencakup encoding URL setelan visualisasi, sesuai kebutuhan.

  1. Sisipkan tag dan variabel Liquid {{ value }} di tempat Anda ingin menyisipkan nilai ke dalam URL. Dalam hal ini, kita ingin menempatkan nilai di tempat elemen filter, f[users.city]=, berada dalam string URL agar Explore difilter menurut kota yang dipilih pengguna:
dimension: city {
  type: string
  sql: ${TABLE}.city ;;
  link: {
    label: "City Metrics Explore"
    url: "/explore/ecommerce_model/order_items_explore?fields=users.city,orders.count,users.count&f[users.city]={{ value }}&sorts=orders.count+desc&limit=500"
  }
}

Dimensi Kota kemudian akan menampilkan menu link tiga titik yang menampilkan opsi Jelajahi Metrik Kota.

Saat pengguna mengklik link, mereka akan dialihkan ke City Metrics Explore, yang difilter menurut kota yang dipilih.

Anda juga dapat mempertahankan nilai filter yang ada saat menautkan ke konten Looker, seperti yang dibahas dalam contoh berikut.

Contoh: Meneruskan nilai filter yang ada ke konten tertaut

Variabel Liquid lain yang didukung oleh parameter link adalah _filters['view_name.field_name']. Variabel ini mengambil nilai yang ada yang dimasukkan untuk filter dan meneruskannya ke Explore, dasbor, atau Look yang ditautkan.

Di URL konten, Anda dapat melihat tempat nilai filter ditentukan dan menggantinya dengan variabel _filters['view_name.field_name']. Lihat postingan Komunitas Looker Menggunakan URL dan parameter kueri untuk mengetahui informasi tentang bagian-bagian URL kueri.

Berikut adalah contoh dimensi yang menggunakan variabel _filters['view_name.field_name'] dalam parameter link-nya untuk meneruskan nilai filter yang ada untuk kolom bernama users.state:

dimension: name {
  link: {
    label: "Business Pulse By State Dashboard"
    url: "/dashboards/694?State={{ _filters['users.state'] | url_encode }}"
  }
}

Dalam contoh ini, jika pengguna memfilter kueri menurut dimensi users.state, dasbor tertaut akan otomatis difilter menurut negara bagian yang sama yang dipilih dalam kueri asli. Menyertakan filter Liquid url_encode dalam contoh ini akan mengonversi string yang tidak aman untuk URL menjadi string yang dienkode dalam persen. Hal ini memastikan bahwa nilai filter yang berisi karakter khusus, seperti spasi atau koma, dapat diteruskan ke dasbor tertaut.

Misalnya, anggaplah pengguna telah memfilter kueri menurut negara bagian "California". Saat pengguna mengklik menu tiga titik di samping nilai untuk kolom Nama, menu Link akan menampilkan link ke dasbor Tren Bisnis menurut Negara Bagian. Saat pengguna mengklik link ini, dasbor Business Pulse by State akan difilter berdasarkan negara bagian "California".

Cara ini juga berfungsi untuk meneruskan nilai filter ke Eksplorasi dan Look tertaut:

dimension: name {
    link: {
      label: "Average Order Profit Look"
      url: "/looks/249?&f[users.state]={{ _filters['users.state'] | url_encode }}"
    }
    link: {
      label: "User Facts Explore Explore"
      url: "/explore/ecommerce/users?fields=users.id,users.name&f[users.state]={{ _filters['users.state'] | url_encode }}"
    }
  }

Anda dapat meneruskan beberapa filter dengan menempatkan & di antaranya, seperti dalam URL berikut:

dimension: name {
  link: {
    label: "Business Pulse By State Dashboard"
    url: "/dashboards/694?State={{ _filters['users.state'] | url_encode }}&Date={{ _filters['orders.date'] | url_encode }}"
  }
  link: {
    label: "Average Order Profit Look"
    url: "/looks/249?&f[users.state]={{ _filters['users.state'] | url_encode }}&f[orders.date]={{ _filters['orders.date'] | url_encode }}"
  }
}

Untuk mengetahui informasi tentang cara membuat filter dasbor, lihat halaman dokumentasi Membangun dasbor LookML dan Menambahkan dan mengedit filter dasbor yang ditentukan pengguna.

Jika admin Looker Anda telah mengaktifkan fitur Penelusuran Visual, Anda dapat menyesuaikan visualisasi yang ditampilkan di overlay penelusuran Eksplorasi dan Look menggunakan parameter link dan variabel Liquid. Dasbor mendukung penelusuran visual menggunakan parameter link tanpa perlu mengaktifkan fitur Penelusuran Visual.

Berikut adalah contoh cara menyetel visualisasi penelusuran ke diagram sebar:


  measure: count {
    type: count_distinct
    sql: ${id} ;;
    drill_fields: [created_date, total_sale_price]
    link: {
      label: "Drill as scatter plot"
      url: "
      {% assign vis_config = '{\\"type\\": \\"looker_scatter\\"}' %}
        \{\{ link \}\}&vis_config=\{\{ vis_config | encode_uri \}\}&toggle=dat,pik,vis&limit=5000"
    }
  }

Lihat halaman Praktik Terbaik Penelusuran data yang lebih andal untuk contoh lainnya tentang cara menyesuaikan visualisasi penelusuran.

Hal-hal yang perlu dipertimbangkan saat menautkan ke konten Looker

Mungkin ada kasus saat Anda perlu menyertakan operator perbandingan filter selain sama dengan, menyertakan beberapa filter, atau menghindari koma dalam link ke konten Looker. Bagian berikut memberikan informasi selengkapnya tentang kasus penggunaan ini.

Mengenkode URL operator perbandingan lainnya

Jika ingin menyertakan operator perbandingan dalam filter tertaut selain sama dengan (=), Anda dapat melakukannya dengan mengenkode URL operator.

Misalnya, jika Anda menginginkan filter order_id pada Tampilan tertaut untuk menyertakan nilai yang kurang dari (<) kolom order_id yang terkait dengan nilai yang Anda klik, Anda akan mengenkode sebagian karakter operator (%3C dalam hal ini) dan menambahkannya ke URL:

f[orders.order_id]=%3C{{ other_orders.order_id._value }}
Menyertakan beberapa filter

Lebih dari satu filter dapat diterapkan ke Look, dasbor, dan Jelajah yang ditautkan dengan menggunakan ampersand (&) untuk memisahkan setiap filter:

dimension: name {
  link: {
    label: "Drill Look"
    url:"/looks/looknumber?&f[users.state]={{ value }}[users.region]={{ users.region._value }}&f[users.age]={{ _filters['users.age'] | url_encode }}"
  }
}
Menggunakan escape untuk koma

Anda dapat menghindari koma dalam nilai yang ditautkan dengan variabel filterable_value jika biasanya Anda menggunakan variabel value.

Link berikut akan melihat perincian Explore yang akan memfilter hasil menurut nilai users.city yang dipilih:

dimension: city {
    type: string
    sql: ${TABLE}.city ;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]={{ value }}"
    }
}

Jika pengguna mengklik Santa Cruz, CA untuk melihat hasil yang difilter menurut kota ini, hasil penelusuran akan menampilkan semua hasil yang berisi Santa Cruz atau CA.

Jika filterable_value digunakan, bukan value, koma akan di-escape:

dimension: city {
    type: string
    sql: ${TABLE}.city ;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]={{ filterable_value }}"
    }
}

Penelusuran yang dihasilkan akan menampilkan semua hasil yang berisi seluruh nilai string Santa Cruz, CA.

Jika Anda ingin meng-hardcode nilai filter yang berisi koma dalam URL penelusuran, Anda dapat meng-escape koma dengan membungkus nilai dalam tanda kutip ganda, lalu meng-escape-nya dengan garis miring terbalik (\):

dimension: city {
    type: string
    sql: ${TABLE}.city;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]=\"Santa Cruz, CA\"&sorts=users.email"
    }
}

Referensi lainnya

Yang perlu diketahui

Jika dimensi berisi parameter link yang mereferensikan kolom lain, kolom tambahan tersebut dapat ditambahkan ke SQL pokok kueri yang menggunakan dimensi tersebut. Jika kolom yang dirujuk tidak ada dalam visualisasi kueri, dan visualisasi adalah diagram tabel dengan kolom yang disusun ulang secara manual, urutan kolom dalam beberapa format yang didownload dapat terpengaruh.