GetUserAttr - Komut dosyası ve grafik fonksiyonu

Bu örnek, oluşturduğunuz uygulama içeriğinde kullanılabilecek bir dizi komut dosyası değişkenini tanımlar. Uygulama her yeniden yüklendiğinde, öznitelikler değerlendirilir ve uygulamaya eklenir.

Aşağıdakileri yapın:

1. Yeni bir Qlik Sense uygulaması oluşturun.

2. Veri yükleme düzenleyicisini açın ve aşağıdaki komut dosyasını yeni bir bölüme ekleyin. Komut dosyası şunları içerir:

   • Örnek işlem verilerini içeren, Transactions adı verilen yeni bir tablo. Bu herhangi bir veri ile değiştirilebilir ve yer tutucu olarak eklenir.

   • QlikCloudGroupMode sistem değişkenini 2 olarak ayarlayan bir komut dosyası deyimi. userGroups özniteliği hem IdP hem de kullanıcının ait olduğu özel grupları döndürecektir.

   • GetSysAttr() fonksiyonunun döndürebildiği mevcut öznitelikler için bir dizi komut dosyası değişkeni tanımı.

   Set QlikCloudGroupMode = 2;
   Transactions:
   Load * inline [
   id,date,amount
   1,1/1/2023,500.67
   2,1/2/2023,458.91
   3,1/3/2023,12.34
   4,1/4/2023,90.90
   5,1/5/2023,256.30
   6,1/6/2023,789.16
   7,1/7/2023,501.25
   8,1/8/2023,87.01
   9,1/9/2023,161.16
   10,1/10/2023,300.06
   ];
   Let vUserEmail = GetUserAttr('userEmail');
   Let vUserSubject = GetUserAttr('userSubject');
   Let vUserGroups = GetUserAttr('userGroups');
   Let vUserLocale = GetUserAttr('userLocale');
   Let vUserZoneinfo = GetUserAttr('userZoneinfo');

3. Verileri yükleyin ve gelişmiş düzenleme modunda yeni bir sayfa açın.

4. Bir tablo oluşturun ve aşağıdaki ifadeleri boyut olarak ekleyin:

• =vUserEmail

• =vUserSubject

• =vUserGroups, bir dize içinde virgülle ayrılmış bir liste döndürür

• =vUserLocale

• =vUserZoneinfo

Tablodaki çıktı, mevcut kullanıcı özniteliklerini dinamik olarak görüntüler. Aşağıdaki tabloda, GetUserAttr fonksiyonu kullanılarak döndürülen sonuçların bir örneği gösterilmektedir.

Bu örnekte, komut dosyasında değişkenleri tanımlamak yerine, değişkenler uygulamada tanımlanır. Değişkenler tanımlandıktan sonra uygulamadaki grafik ifadelerinde kullanılabilir. Grafik ifadelerinde fonksiyon kullanmanın ana faydası, uygulamanın yeniden yüklenmesine gerek kalmadan özniteliklerin otomatik olarak yenilenmesidir. Bu, uygulama yaşam döngüsünün bir parçası olarak uygulamaların kullanıcılar arasında daha sorunsuz hareket etmesini sağlar.

Aşağıdakileri yapın:

1. Yeni bir Qlik Sense uygulaması oluşturun.

2. Gelişmiş düzenleme modunda yeni bir sayfa açın.

3. Değişkenler iletişim kutusunu açın.

4. Yeni oluştur öğesini seçin ve ardından aşağıdakileri yapın:

   • Ad altında vUserEmail girin.

   • Tanım altında =GetUserAttr('userEmail') girin.

   • Oluştur öğesini seçin.

Kullanıcının e-posta adresini görüntülemek için bir uygulama değişkeni oluşturulur. Aşağıdaki parametreleri kullanarak kalan nitelikler için bir değişken oluşturmak üzere bu adımı tekrarlayın:

• Kullanıcı Konusu

  • Ad: vUserSubject

  • Tanım: =GetUserAttr('userSubject')

• Kullanıcı Grupları

  • Ad: vUserGroups

  • Tanım: =GetUserAttr('userGroups')

• Kullanıcı Yerel Ayarı

  • Ad: vUserLocale

  • Tanım: =GetUserAttr('userLocale')

• Kullanıcı Bölge Bilgisi

  • Ad: vUserZoneinfo

  • Tanım: =GetUserAttr('userZoneinfo')

5. Bir tablo oluşturun ve aşağıdaki ifadeleri boyut olarak ekleyin:

• =vUserEmail

• =vUserSubject

• =vUserGroups (bir dize içinde virgülle ayrılmış bir liste döndürür)

• =vUserLocale

• =vUserZoneinfo

Yeni tablodaki çıktı, mevcut kullanıcı özniteliklerini dinamik olarak görüntüler. Aşağıdaki tabloda, GetUserAttr fonksiyonundan döndürülen sonuçların bir örneği gösterilmektedir.

Fonksiyonu uygulamalarınızda değişken olmadan da kullanabilirsiniz. Bu örnek, her bir özniteliği ayrı bir alan olarak içeren bir tablonun nasıl yükleneceğini göstermektedir. Buradan, bu ayrıntıları görüntülemek için uygulamada görselleştirmeler oluşturabilirsiniz.

Aşağıdakileri yapın:

1. Yeni bir Qlik Sense uygulaması oluşturun.

2. Veri yükleme düzenleyicisini açın ve aşağıdaki komut dosyasını yeni bir bölüme ekleyin. Komut dosyası şunları içerir:

   • Her özniteliği bir alan olarak içeren Attributes adlı yeni bir tablo.

   • Özel gruplar için QlikCloudGroupMode sistem değişkenini 1 olarak ayarlayan bir komut dosyası deyimi. userGroups özniteliği yalnızca kullanıcının ait olduğu özel grupları döndürecektir.

   Set QlikCloudGroupMode = 1;
   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userLocale') as UserLocale,
   GetUserAttr('userZoneinfo') as UserZoneinfo,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;
   

3. Verileri yükleyin. Veri modelinde, özniteliklerin her birini ayrı alanlarda görüntüleyen bir tablo oluşturulur.

Artık öznitelik alanlarını tablolar veya metin ve görüntü nesneleri gibi görselleştirmelerde kullanabilirsiniz.

Fonksiyonu bir değişken kullanmadan doğrudan grafik ifadelerine girebilirsiniz. Kullanıcı öznitelikleri, uygulamayı yeniden yüklemek zorunda kalmadan yenilenecektir. Bu, uygulama yaşam döngüsünün bir parçası olarak uygulamaların kullanıcılar arasında daha sorunsuz hareket etmesini sağlar.

Aşağıdakileri yapın:

1. Yeni bir Qlik Sense uygulaması oluşturun.

2. Gelişmiş düzenleme modunda yeni bir sayfa açın.

3. Sayfaya bir Metin ve resim nesnesi sürükleyin.

4. Boş grafiğin içine tıklayın ve aşağıdaki etiketi girin:

   Kullanıcı E-postası:

5. Özellikler panelinde Hesaplama ekle'yi seçin.

6. Aşağıdaki ifadeyi girin:

   • =GetUserAttr('userEmail')

7. Diğer öznitelikler olan için etiketleri ve hesaplamaları yeni satırlara ekleyin. Her bir öznitelik için aşağıdaki ifadeleri kullanın:

   • =GetUserAttr('userSubject'), Kullanıcı Konusu için

   • =GetUserAttr('userGroups'), Kullanıcı Grupları için

   • =GetUserAttr('userLocale'), Kullanıcı Yerel Ayarı için

   • =GetUserAttr('userZoneinfo'), Kullanıcı Bölge bilgisi için​

Genel bakış

Bu örnek, kullanıcının e-posta adresinin etki alanına göre tablodaki bir sütunu gösterir veya gizler.

Aşağıdakileri yapın:

1. Yeni bir Qlik Sense uygulaması oluşturun.

2. Veri yükleme düzenleyicisini açın ve aşağıdaki komut dosyasını yeni bir bölüme ekleyin. Komut dosyası şunları içerir:

   • Transactions adlı tabloya yüklenen bir veri kümesi.

   • Veri tablosundaki şu alanlar:

     • ID

     • Date

     • Amount

     Komut dosyası

     Transactions:
     Load * inline [
     ID, Date, Amount
     1, 1/1/2023, 500.67
     2, 1/2/2023, 458.91
     3, 1/3/2023, 12.34
     ];

3. Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:

   • ID

   • Date

   • Amount

   Şu ifadeyi hesaplanan boyut olarak ekleyin:

   • =WildMatch(GetUserAttr('userEmail'),'*@qlik.com')>0, kullanıcının e-posta alan adının @qlik.com ile eşleşip eşleşmediğini kontrol etmek için.

4. Amount boyutunun özellikler panelinde, Şu durumda sütunu göster: öğesinin altına aşağıdaki ifadeyi ekleyin:

   • =WildMatch(GetUserAttr('userEmail'),'*@qlik.com')>0, kullanıcının e-postası qlik.com etki alanıyla eşleşiyorsa Tutar sütununu görüntülemek için.

   İfade, yalnızca e-posta adresi etki alanı @qlik.com içeren kullanıcılar için Amount sütununu görüntüleyecektir. Sütun, diğer alan adlarına sahip kullanıcılar için gizlenecektir.

Bu örnekte, belirli bir sütunu koşullu olarak gizlemek veya göstermek için GetUserAttr işlevinin nasıl kullanıldığını görebilirsiniz. Uygulamayı görüntüleyen kullanıcının e-posta adresi @qlik.com etki alanını içerdiğinden ve 4. sütundaki boyut ifadesi -1 döndürdüğünden Amount sütunu ilk tabloda gösterilir. Kullanıcının qlik.com etki alanına sahip bir e-posta adresi olmadığı için Amount sütunu ikinci tablodaki sonuçlardan gizlenir.