GetUserAttr() fonksiyonu, bir uygulamaya erişen kullanıcı için aşağıdaki bilgileri döndürür:
Kullanıcının e-posta adresi.
Kullanıcının konusu.
Kullanıcının ait olduğu kimlik sağlayıcı (IdP) grupları.
GetUserAttr() fonksiyonunu doğrudan yükleme komut dosyasında veya bir grafik ifadesinde kullanın. Her iki durumda da, fonksiyonu, öznitelikleri bir değişkende veya doğrudan bir değişken olmadan saklamak için kullanabilirsiniz. Bu fonksiyonu Qlik Sense Client-Managed içinde kullanırsanız yalnızca boş veri değerleri döndürür. Bu nedenle, daha sonra uygulamaları Qlik Cloud içine yüklemek amacıyla, Qlik Sense Client-Managed içinde hatalarla karşılaşmadan komut dosyaları geliştirmek için bu fonksiyonu kullanabilirsiniz.
Söz Dizimi:
GetUserAttr(name)
Dönüş verileri türü: dual
Bağımsız Değişkenler
Bağımsız Değişken
Açıklama
name
Döndürülecek özniteliğin adı. İfadeye bir dize değeri olarak girin. Girilen dize değeri büyük/küçük harfe duyarlıdır.
Fonksiyonu, uygulamanıza kullanıcı özniteliklerini yüklemek için fonksiyonu kullanın. Fonksiyon aşağıdaki öznitelikleri döndürebilir:
GetSysAttr() fonksiyonu tarafından döndürülebilen kullanıcı öznitelikleri
Öznitelik
Açıklama
Yükleme komut dosyası değişkeni örneği
Grafik ifadesi (değişken yoktur) örneği
Örnek grafik ifadesi sonuçları
userEmail
Geçerli kullanıcının e-postası.
Let vUserEmail = GetUserAttr('userEmail')
=GetUserAttr('userEmail')
john.doe@company.com
userSubject
Geçerli kullanıcının konusu.
Let vUserSubject = GetUserAttr('userSubject')
=GetUserAttr('userSubject')
00uss7ra3dk9doJln0x7
userGroups
Uygulamaya erişen geçerli kullanıcının IdP grupları. Virgülle ayrılmış bir listeyi dize olarak döndürür.
Let vUserGroups = GetUserAttr('userGroups')
=GetUserAttr('userGroups')
Sales,Product-Lead,OKTA-Github-RnD
Ne zaman kullanılır?
Bu fonksiyon, uygulamanın geçerli kullanıcısı için kullanıcı özelliklerini ve gruplarını döndürür. Bu, kullanıcılarınız için görünen içeriği özelleştiren çözümler oluşturmanıza olanak tanır. Örneğin, global bir satış uygulamasında, ürüne özel sayfaları yalnızca belirli bir ürün grubundan sorumlu olan satış temsilcilerine gösterebilirsiniz. Fonksiyonu, uygulamanın yükleme komut dosyasındaki yükleme deyimlerinde veya grafik ifadelerinde, doğrudan bir ifade olarak ya da değişken olarak saklanan bir ifadede kullanın.
Örnek - Kullanıcı özniteliklerini komut dosyası içinde değişken olarak saklama
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:
Yeni bir Qlik Sense uygulaması oluşturun.
Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin. Yükleme kodu ş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.
GetSysAttr() fonksiyonunun döndürebildiği mevcut öznitelikler için bir dizi komut dosyası değişkeni tanımı.
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');
Verileri yükleyin ve gelişmiş düzenleme modunda yeni bir sayfa açın.
Bir Tablo nesnesi 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
İpucu notuBoyutu oluştururken daha iyi okunabilirlik için Kullanıcı E-postası gibi bir boyut etiketi ekleyebilirsiniz.
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.
Sonuçlar tablosu
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Örnek – Kullanıcı özniteliklerini değişkenler olarak saklama ve bunları grafik ifadelerinde kullanma
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:
Yeni bir Qlik Sense uygulaması oluşturun.
Gelişmiş düzenleme modunda yeni bir sayfa açın.
Değişkenler iletişim kutusunu açın.
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')
Bir Tablo nesnesi 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)
İpucu notuBoyutu oluştururken daha iyi okunabilirlik için Kullanıcı E-postası gibi bir boyut etiketi ekleyebilirsiniz.
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.
Sonuçlar tablosu
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Örnek – GetUserAttr fonksiyonunu komut dosyasında kullanma
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:
Yeni bir Qlik Sense uygulaması oluşturun.
Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin. Yükleme kodu şunları içerir:
Her özniteliği bir alan olarak içeren Attributes adlı yeni bir tablo.
Attributes:
Load RowNo() as Key,
GetUserAttr('userEmail') as UserEmail,
GetUserAttr('userSubject') as UserSubject,
GetUserAttr('userGroups') as UserGroups autogenerate 1;
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.
Örnek – GetUserAttr fonksiyonunu grafik ifadesinde kullanma
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:
Yeni bir Qlik Sense uygulaması oluşturun.
Gelişmiş düzenleme modunda yeni bir sayfa açın.
Sayfaya bir Metin ve resim nesnesi sürükleyin.
Boş grafiğin içine tıklayın ve aşağıdaki etiketi girin:
Kullanıcı E-postası:
Özellikler panelinde Hesaplama ekle'yi seçin.
Aşağıdaki ifadeyi girin:
=GetUserAttr('userEmail')
Diğer nitelikler olan User Subject ve User Groups 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