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 olanak tanır. Yapılandırma parametrelerini geçersiz kılınabilir olarak tanımlamak, veri kaynağını daha esnek hale getirir ve kullanıcılara, kullanıcı tarafından yapılandırılabilen rapor şablonları oluşturma olanağı tanır.

Örneğin, hava durumu verileri sağlayan bir bağlayıcı, rapor görüntüleyicilerin varsayılandan farklı bir yerel ayarda hava durumu raporu istemesine olanak tanıyan bir konum parametresi içerebilir.

Bu belgede, geçersiz kılınabilir parametrelerin nasıl tanımlandığı, değiştirilmek üzere 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 Data Studio'da nasıl kullanıldığı hakkında daha fazla bilgi edinmek için Veri kaynağı parametreleri başlıklı makaleyi inceleyin.

Roller

Dokümanda referans verilen kullanıcı rolleri:

Rol	Tanım
Bağlayıcı geliştirici	Topluluk bağlayıcısı oluşturmuş bir kullanıcı
Veri kaynağı sahibi	Veri kaynağı oluşturan ve bu kaynağın sahibi olan kullanıcılar.
Rapor düzenleyici	Bir rapora düzenleme modu erişimi olan kullanıcılar.
Rapor görüntüleyici	Bir rapora görüntüleme modu erişimi olan kullanıcılar.

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

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

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

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

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'dır. Bir parametre için geçersiz kılmayı etkinleştirmek istemiyorsanız setAllowOverride() çağrısını atlayabilirsiniz.

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

[Data Studio'nun verilerinize nasıl bağlandığı] başlıklı makaleyi inceleyerek Bağlayıcılar, Veri Kaynakları ve Raporlar'ın birbirleriyle ilişkili olarak nasıl çalıştığını öğrenmeniz önerilir.

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

1. Bir parametrenin değeri şemayı etkilediğinde.
   • 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ğlı tüm raporlar eksik alanlar nedeniyle bozulabilir.
2. Parametre değeri hassas verileri kontrol ediyorsa. Örn. Hesap seçimi.
   • Hassas verilerin istenmeden görüntülenmesini veya paylaşılmasını önlemek 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üzenleyicilerin hangi geçersiz kılınabilir parametreleri değiştirmesine izin verileceğini kontrol eder. Benzer şekilde, rapor düzenleyiciler, rapor görüntüleyenlerin hangi parametreleri değiştirebileceğini kontrol eder.

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

Raporlarda hangi parametrelerin değiştirilebileceğini veri kaynağı sahibi kontrol eder. Bu ayar, veri kaynağı oluşturulurken veya düzenlenirken 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. Etkinleştirilirse rapor düzenleyiciler raporlardaki parametreleri değiştirebilir.

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

Raporu görüntüleyenlerin parametre değerlerini değiştirmesine izin verin

Rapor düzenleyiciler, rapor görüntüleyenlerin hangi parametreleri değiştirebileceğini kontrol eder. Parametre değerleri daha sonra raporun URL'si aracılığıyla raporu görüntüleyen herkes tarafından değiştirilebilir.

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

Örneğin, geçersiz kılınabilir olarak tanımlanmış 2 parametresi olan bir bağlayıcıyı ele alalım: zipcode ve units (Şekil 1). Veri kaynağı sahibi, raporlarda zipcode değiştirilmesine izin verdiyse (Şekil 2) rapor düzenleyiciler yalnızca zipcode değiştirilmesine rapor görüntüleyiciler tarafından izin verebilir. Rapor düzenleyicisi, units parametresinin rapor görüntüleyicileri tarafından değiştirilmesine izin verecek 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üleyenler, parametrelerle kontrol edilen tüm verilere erişebilir. Hassas verilerin yanlışlıkla paylaşılmasını önlemek için bir parametrenin değiştirilmesine izin vermeden önce veri kaynağının ve veri kaynağı kimlik bilgilerinin doğru şekilde yapılandırıldığını inceleyip onaylayın. Bir parametre hassas verilere erişimi etkinleştiriyorsa rapor görüntüleyenin yalnızca kendi verilerini görebilmesi için görüntüleyenin kimlik bilgilerini kullanmayı düşünebilirsiniz.

URL parametreleri

Raporu görüntüleyenlerin rapor URL'si üzerinden parametre değerlerini düzenlemesine izin vermek için:

1. Raporu düzenleyin.
2. Kaynak -> Rapor parametrelerini yönet'i seçin.
3. Rapor URL'sinde 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ğ üstteki Kapat'ı tıklayın.

Parametre değerlerini değiştirme

Rapor düzenleyicileri, rapor özellikleri panelini kullanarak parametre değerlerini değiştirebilir. Raporu görüntüleyenler ise parametre değerlerini rapor URL'si üzerinden değiştirebilir.

Rapor özellikleri paneli

Rapor düzenleyicinin parametre değerlerini nasıl ayarlayacağını öğrenmek için Raporlardaki parametreleri değiştirme başlıklı makaleyi inceleyin.

Rapor URL parametreleri

Rapor URL'sinde değiştirilmesine izin verilen parametreler için değerler, görüntüleme modunda rapor URL'sine eklenen URL kodlu 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 parametrelerini yönet'i seçin.
   3. Rapor URL'si aracılığıyla ayarlamayı planladığınız parametrelerin adını not edin.

   Örneğin, aşağıdaki şekilde parametre adı ds0.zipcode'dır.

   

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ğeri türleri STRING, NUMBER veya BOOLEAN olmalıdır. Birden fazla değer kabul eden parametreler (ör. çoklu seçim açılır listeleri) için değer dizisi kullanın.

   Örneğin, parametre adı ds0.zipcode ise posta kodunu 94094 olarak ayarlamak için JSON şu şekilde olmalıdır:

   {
     "ds0.zipcode": "94094"
   }
   

3. Parametre nesnesini URL kodlama

   Parametre nesnesini oluşturduktan sonra JSON.stringify() kullanarak dizeye dönüştürün, ardından URL kodlaması için [encodeURIComponent] kullanın.

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

   Bu durumda aşağıdaki kodlanmış dize elde edilir:

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

4. Rapor URL'sini oluşturma

   URL kodlu parametre nesnesini aldıktan sonra, params sorgu parametresini kullanarak 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 kullanma

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

Parametre nesnesi örneği

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

• ds0.includeToday, onay kutusu girişidir
• ds0.units, tek seçimli bir giriştir
• ds1.countries, çoklu seçim girişidir
• ds1.labelName, 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 göre öncelik sırasına tabidir. Daha yüksek öncelikli konumlarda ayarlanan parametreler, daha düşük öncelikli konumlarda ayarlanan parametreleri geçersiz kılar. Öncelik sırası (en düşükten en yükseğe) şöyledir:

1. Veri kaynağı (varsayılan)
2. URL'yi bildir
3. Veri kaynağı parametre devralma kurallarına göre rapor özellikleri paneli.