Geçersiz kılınabilir yapılandırma parametreleri

Geçersiz kılınabilir yapılandırma parametreleri, rapor düzenleyicilerin bir veri kaynağındaki varsayılan değerleri değiştirmesine izin verme seçeneği sunar. Yapılandırma parametrelerinin geçersiz kılınabilir olarak tanımlanması, veri kaynağını daha esnek hale getirir ve kullanıcılara, kullanıcı tarafından yapılandırılabilir rapor şablonları oluşturma olanağı sunar.

Örneğin, hava durumu verileri sağlayan bir bağlayıcı, görüntüleyenlerin varsayılandan farklı bir yerel ayardan hava durumu raporu istemesini raporlayan bir konum parametresi içerebilir.

Bu dokümanda, geçersiz kılınabilir parametrelerin nasıl tanımlandığı, değiştirme için nasıl etkinleştirildiği ve parametre değerlerinin rapor kullanıcıları tarafından nasıl değiştirilebileceği açıklanmaktadır. Parametrelerin Looker Studio'da nasıl kullanıldığı hakkında daha fazla bilgi için Veri kaynağı parametreleri bölümüne bakın.

Roller

Dokümanda başvurulan kullanıcı rolleri:

Rol	Tanım
Bağlayıcı geliştiricisi	Topluluk bağlayıcısı oluşturmuş bir kullanıcı.
Veri kaynağı sahibi	Veri kaynağı oluşturan ve veri kaynağına sahip olan bir kullanıcı.
Rapor düzenleyici	Bir rapora düzenleme modu erişimi olan bir kullanıcı.
Görüntüleyeni bildir	Bir rapora görüntüleme modu erişimi olan bir kullanıcı.

Geçersiz kılınabilir parametreleri tanımlama

Bağlayıcı geliştiricisi, yapılandırma parametrelerini topluluk bağlayıcısının getConfig() işlevinde tanımlar. Bir config parametresini geçersiz kılınabilir olarak tanımlamak için bağlayıcı setAllowOverride(true) yöntemini çağırır.

Not: Parametreler, BigQuery özel sorgusunun parçası olarak da tanımlanabilir.

Aşağıdaki örnekte geçersiz kılınabilir 2 parametre tanımlanmaktadır: zipcode ve units ile geçersiz kılınamayan 1 parametre: days-to-forcecast.

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

Not: allowOverride için varsayılan değer false'tır. Bir parametre için geçersiz kılmayı etkinleştirmek istemiyorsanız setAllowOverride() çağrısını atlayabilirsiniz.

Bir parametreyi ne zaman geçersiz kılınabilir olarak tanımlamaktan kaçınmalısınız?

Looker Studio'nun verilerinize bağlanma şekli başlıklı makaleyi inceleyerek Bağlayıcıların, Veri Kaynaklarının ve Raporların birbirleriyle nasıl ilişkili olduğunu öğrenmeniz önerilir.

Aşağıdaki durumlarda, bir parametreyi geçersiz kılınabilir olarak tanımlamaktan kaçının:

1. Bir parametrenin değerinin şemayı etkilemesidir.
   • Bir kullanıcı bir parametre değerini değiştirirse ve döndürülen yeni verilerin şeması, veri kaynağında tanımlanandan farklıysa veri kaynağına bağımlı olan tüm raporlar eksik alanlar nedeniyle bozulabilir.
2. Bir parametre değerinin hassas verileri kontrol edip etmediği. Ör. Hesap seçimi.
   • Hassas verilerin yanlışlıkla görüntülenmesini veya paylaşılmasını engellemek istiyorsanız bir parametreyi geçersiz kılınabilir olarak tanımlamayın.

Rapor kullanıcıları için parametreleri etkinleştirme

Veri kaynağı sahipleri, rapor düzenleyiciler tarafından hangi geçersiz kılınabilir parametrelerin değiştirilmesine izin verileceğini kontrol eder. Benzer şekilde, rapor düzenleyiciler hangi parametrelerin rapor görüntüleyenler tarafından değiştirilebileceğini kontrol eder.

Rapor düzenleyicilerin parametre değerlerini değiştirmesine izin verin

Veri kaynağı sahibi, raporlarda hangi parametrelerin değiştirilmesine izin verileceğini kontrol eder. Bu ayar, veri kaynağının oluşturulması veya düzenlenmesi sırasında yapılandırılır ve yalnızca Bağlayıcı geliştiricisi tarafından geçersiz kılınabilir olarak tanımlanan parametreler için geçerlidir. Politika etkinleştirilirse rapor düzenleyiciler bir rapordaki parametreleri değiştirebilir.

Aşağıdaki örnekte, bir bağlayıcının geçersiz kılınabilir olarak tanımlanmış 2 parametresi vardır: zipcode ve units. Veri kaynağı sahibi, raporlarda yalnızca zipcode öğesinin değiştirilmesine izin verdi. Raporda, rapor düzenleyici zipcode parametre değerini değiştirme seçeneğine sahiptir.

Rapor görüntüleyicilerin parametre değerlerini değiştirmesine izin ver

Rapor düzenleyiciler, hangi parametrelerin rapor görüntüleyenler tarafından değiştirilebileceğini kontrol eder. Daha sonra parametre değerleri, raporu herhangi bir görüntüleyen tarafından rapor URL'si aracılığıyla değiştirilebilir.

Not: Rapor düzenleyicinin, parametrelerin değiştirilmesine izin verme üzerindeki denetimi, veri kaynağı sahibi tarafından izin verilen parametrelerle sınırlıdır.

Örneğin, geçersiz kılınabilir olarak tanımlanmış 2 parametreye sahip bir bağlayıcıyı düşünün: zipcode ve units (Şekil 1). Veri kaynağı sahibi raporlarda zipcode üzerinde değişiklik yapılmasına izin verdiyse (Şekil 2) rapor düzenleyicileri yalnızca rapor görüntüleyenler tarafından zipcode üzerinde değişiklik yapılmasına izin verebilir. Rapor düzenleyici, units parametresinin rapor görüntüleyiciler tarafından değiştirilmesine izin vermek için erişime veya görünürlüğe sahip olmaz.

Şekil 1: Bağlayıcı yapılandırması.

Şekil 2: Parametreleri yönetme.

Uyarı: Rapor görüntüleyiciler, parametrelerle kontrol edilen tüm verilere erişebilir. Hassas verileri yanlışlıkla paylaşmaktan kaçınmak için bir parametrenin değiştirilmesine izin vermeden önce veri kaynağı ve veri kaynağı kimlik bilgilerinin doğru şekilde yapılandırıldığını inceleyip onaylayın. Bir parametre hassas verilere erişimi sağlıyorsa rapor görüntüleyicinin yalnızca izleyicinin verilerini görebildiğinden emin olmak için izleyicinin kimlik bilgilerini kullanabilirsiniz.

URL parametreleri

Rapor görüntüleyicilerin parametre değerlerini rapor URL'si aracılığıyla düzenlemesine izin vermek için:

1. Raporu düzenleyin.
2. Kaynak -> Rapor URL parametrelerini yönet'i seçin.
3. Rapor URL'sindeki parametre değerlerinin değiştirilmesine izin vermek veya vermemek için Rapor URL'sinde değiştirilmesine izin ver onay kutularını kullanın. Değişiklikler otomatik olarak kaydedilir.
4. Sağ üstten Kapat'ı tıklayın.

Parametre değerlerini değiştirme

Rapor düzenleyiciler, rapor özellikleri panelini kullanarak parametre değerlerini değiştirebilir. Raporu görüntüleyenler ise parametre değerlerini rapor URL'si aracılığıyla değiştirebilir.

Rapor özellikleri paneli

Bir rapor düzenleyicinin parametre değerlerini nasıl ayarlayabileceğini öğrenmek için Rapordaki parametreleri değiştirme bölümüne bakın.

Rapor URL'si parametreleri

Rapor URL'sinde değiştirilmesine izin verilen parametreler için değerler, görüntüleme modunda rapor URL'sine eklenen URL kodlamalı bir JSON nesnesi aracılığıyla ayarlanabilir.

URL yapılandırması oluşturmak için:

1. Parametre adlarını toplama

   1. Raporu düzenleyin.
   2. Kaynak -> Rapor URL parametrelerini yönet'i seçin.
   3. Rapor URL'si aracılığıyla ayarlamak istediğiniz parametrelerin adını not edin.

   Örneğin, aşağıdaki şekilde parametre adı ds0.zipcode şeklindedir.

   

2. Parametre nesnesini oluşturma

   Parametreler bir JSON nesnesi aracılığıyla tanımlanır. Parametre değerlerinin anahtarları, parametre adlarıdır.

   {
     "parameterName": parameterValue
   }
   

   Parametre değer türleri şunlardır: STRING, NUMBER veya BOOLEAN. Birden çok değeri kabul eden parametreler (ör. Çok seçimli açılır listeler) için bir değer dizisi kullanın.

   Örneğin, parametrenin adı ds0.zipcode ise Posta Kodu'nu 94094 olarak ayarlamak için JSON aşağıdaki gibi olur:

   {
     "ds0.zipcode": "94094"
   }
   

3. URL Parametre nesnesini kodlama

   Parametre nesnesini oluşturduktan sonra, JSON.stringify() işlevini kullanarak dizeye dönüştürün. Ardından, nesneyi URL olarak kodlamak için [encodeURIcomponent] öğesini kullanın.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Bu, aşağıdaki kodlanmış dizeyle sonuçlanır:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Rapor URL'sini oluşturma

   URL kodlamalı parametre nesnesini oluşturduktan sonra, params sorgu parametresini kullanarak bunu rapor görünümü URL'sine ekleyin.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   REPORT_ID ve PAGE_ID değerlerini raporunuz ve sayfanızın değerleriyle değiştirdiğinizden emin olun.

5. URL'yi kullan

   Rapor URL'si, Parametre devralma değerine göre JSON parametre nesnesinde tanımlanan parametreleri geçersiz kılar.

Parametre nesnesi örneği

Aşağıdaki parametre nesnesinde birden çok parametrenin nasıl ayarlanacağı gösterilmektedir. Ayrıca, farklı giriş türleri için parametre değerlerinin ayarlanmasını da gösterir.

• ds0.includeToday bir onay kutusu girişidir
• ds0.units, tekli seçim girişidir
• ds1.countries, çoklu seçimli bir giriştir
• ds1.labelName bir metin girişidir.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Parametre devralma

Bir parametre için kullanılan değer, parametrenin ayarlandığı yere bağlı olarak bir öncelik sırası izler. Daha yüksek öncelikli konumlarda ayarlanan parametreler, düşük öncelikli konumlarda ayarlanan parametreleri geçersiz kılar. Öncelik sırası (en düşükten en yükseğe) şu şekildedir:

1. Veri kaynağı (varsayılan)
2. Rapor URL'si
3. Veri kaynağı parametre devralma kurallarını izleyerek rapor özellikleri panelini açın.