Bu fonksiyon, seçilen bir uygulama için kiracı ve alan etki alanı özniteliklerini döndürür. Hem veri kod dosyasında hem de grafik ifadesinde kullanılabilir.
GetSysAttr() fonksiyonu doğrudan yükleme komut dosyasında veya bir grafik ifadesinde kullanılabilir. Her iki durumda da, fonksiyonu, öznitelikleri bir değişkende veya doğrudan bir değişken olmadan saklamak için kullanabilirsiniz.
Bu işlevi 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:
GetSysAttr(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 ortam özniteliklerini yüklemek için kullanabilirsiniz. Fonksiyon aşağıdaki öznitelikleri döndürebilir:
GetSysAttr() tarafından döndürülebilen ortam öznitelikleri
Öznitelik
Açıklama
Yükleme komut dosyası değişkeni örneği
Grafik ifadesi (değişken yoktur) örneği
tenantId
Kiracı kimliği.
Let vTenantID = GetSysAttr('tenantId')
=GetSysAttr('tenantId')
tenantName
Kiracının adı.
Let vTenantName = GetSysAttr('tenantName')
=GetSysAttr('tenantName')
tenantUrl
Kiracının varsayılan URL'si.
Let vTenantUrl = GetSysAttr('tenantUrl')
=GetSysAttr('tenantUrl')
tenantUrlAlias
Kiracı için tanımlanmış takma isim URL'si.
Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')
=GetSysAttr('tenantUrlAlias')
tenantRegion
Kiracının yerleşik olduğu bölge.
Let vTenantRegion = GetSysAttr('tenantRegion')
=GetSysAttr('tenantRegion')
spaceId
Alan kimliği. Bu yalnızca paylaşılan veya yönetilen bir alandaki uygulama için tanımlanır.
Bilgi notu
GetSysAttr() işlevi spaceId öğesinde boş bir Qlik Cloud değeri döndürürse bu, uygulamanın kişisel bir alanda bulunduğunu gösterir.
GetSysAttr() işlevi Qlik Sense Client-Managed içinde kullanıldığında her zaman boş bir spaceId değeri döndürür.
Let vSpaceId = GetSysAttr('spaceId')
=GetSysAttr('spaceId')
spaceName
Alanın adı. Bu yalnızca paylaşılan veya yönetilen bir alandaki uygulama için tanımlanır.
Bilgi notu
GetSysAttr() işlevi Qlik Cloud öğesinde boş bir spaceName değeri döndürürse bu, uygulamanın kişisel bir alanda bulunduğunu gösterir.
GetSysAttr() işlevi Qlik Sense Client-Managed içinde kullanıldığında her zaman boş bir spaceName değeri döndürür.
Let vSpaceName = GetSysAttr('spaceName')
=GetSysAttr('spaceName')
spaceType
Uygulamanın bulunduğu alanın türü. Bu yalnızca paylaşılan veya yönetilen bir alandaki uygulama için tanımlanır.
Bilgi notu
GetSysAttr() işlevi Qlik Cloud öğesinde boş bir spaceType değeri döndürürse bu, uygulamanın kişisel bir alanda bulunduğunu gösterir.
GetSysAttr() işlevi Qlik Sense Client-Managed içinde kullanıldığında her zaman boş bir spaceType değeri döndürür.
Let vSpaceType = GetSysAttr('spaceType')
=GetSysAttr('spaceType')
Ne zaman kullanılır?
Bu fonksiyon, farklı ortamlar arasında taşınabilecek bir Qlik Sense uygulamasının alan ve kiracı tanımlamasını basitleştirir. Bu fonksiyon, çalıştığınız belirli ortamı tanımlamanızı kolaylaştırır. Özellikle bir uygulamanın yaşam döngüsünün geliştirme, test, kabul ve üretim (DTAP) aşamalarında kullanışlıdır.
Bu fonksiyon, 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ılabilir. Uygulamanızın yaşam döngüsü boyunca alanlar veya kiracılar arasında taşınacağını öngörüyorsanız uygulamayı yeniden yüklemeden, alan ve kiracı bilgilerini dinamik olarak elde etmek için fonksiyonu bir grafik ifadesinde kullanın. Bunu yaparken, fonksiyon ifadesini yükleme komut dosyasının dışındaki bir değişkende saklayın veya fonksiyonu doğrudan grafik ifadesinde kullanın.
Örnek 1 - Ortam özniteliklerinin yükleme komut dosyası değişkenleri olarak saklanması
Bu örnekte, oluşturduğunuz uygulama içeriğinde kullanılabilecek bir dizi komut dosyası değişkeni tanımlayacağız. Uygulama her yeniden yüklendiğinde, öznitelikler değerlendirilir ve uygulamaya eklenir.
Aşağıdakileri yapın:
Paylaşılan bir alanda yeni bir Qlik Sense uygulaması oluşturun.
Veri yükleme düzenleyicisi uygulamasını açın.
Aşağıdaki yükleme komut dosyasını yeni bir sekmeye yapıştırın:
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 vTenantId = GetSysAttr('tenantId');
Let vTenantName = GetSysAttr('tenantName');
Let vTenantUrl = GetSysAttr('tenantUrl');
Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias');
Let vTenantRegion = GetSysAttr('tenantRegion');
Let vSpaceId = GetSysAttr('spaceId');
Let vSpaceName = GetSysAttr('spaceName');
Let vSpaceType = GetSysAttr('spaceType');
Bu yükleme komut dosyası aşağıdakileri içerir:
Transactions adı verilen yeni bir tablo örnek işlem verilerini içerir. Bu herhangi bir veri ile değiştirilebilir ve yer tutucu olarak eklenir.
GetSysAttr() tarafından getirilebilen mevcut öznitelikler için bir dizi komut dosyası değişkeni tanımı.
Verileri yükleyin ve gelişmiş düzenleme modunda yeni bir sayfa açın.
Bir Tablo nesnesi oluşturun ve aşağıdaki ifadeleri ilgili etiketleriyle birlikte boyut olarak ekleyin:
=vTenantId, etiketli Tenant ID
=vTenantName, etiketli Tenant Name
=vTenantUrl, etiketli Tenant URL (Default)
=vTenantUrlAlias, etiketli Tenant URL (Alias)
=vTenantRegion, etiketli Tenant Region
=vSpaceId, etiketli Space ID
=vSpaceName, etiketli Space Name
=vSpaceType, etiketli Space Type
Artık uygulamanızda, mevcut ortam özniteliklerinin her birini dinamik olarak görüntüleyen bir tablonuz var. Uygulamayı dışa aktarmak ve farklı bir kiracıya ve alana yüklemek, uygulamanın yeni yüklenen sürümü için size bu öznitelikleri verecektir.
Örnek 2 - Ortam özniteliklerini değişkenler olarak saklama ve bunları grafik ifadelerinde kullanma
Bu örnekte, değişkenleri komut dosyasında tanımlamak yerine, gelişmiş düzenleme modunda iletişim kutusunu kullanarak çeşitli değişkenler tanımlıyoruz. Sonrasında, değişkenler, uygulamadaki grafik ifadelerinde kullanılabilir.
Aşağıdakileri yapın:
Paylaşılan bir alanda yeni bir Qlik Sense uygulaması oluşturun.
Gelişmiş düzenleme modunda yeni bir sayfa açın.
Değişkenler diyalog penceresini açmak için seçeneğine tıklayın.
Yeni oluştur'a tıklayın.
Ad seçeneğinin altına vTenantId girin.
Tanım seçeneğinin altına =GetSysAttr('tenantId') girin.
Oluştur'a tıklayın.
Bu, kiracının kimliğini görüntülemek için bir uygulama değişkeni oluşturur. Kalan özniteliklerin her biri için bir değişken oluşturmak üzere 3 ile 6 arasındaki adımları tekrarlayın. Aşağıdaki parametreleri kullanın:
Kiracı Adı
Ad: vTenantName
Tanım: =GetSysAttr('tenantName')
Kiracı URL'si
Ad: vTenantUrl
Tanım: =GetSysAttr('tenantUrl')
Kiracı URL'si Takma İsmi
Ad: vTenantUrlAlias
Tanım: =GetSysAttr('tenantUrlAlias')
Kiracı Bölgesi
Ad: vTenantRegion
Tanım: =GetSysAttr('tenantRegion')
Alan Kimliği
Ad: vSpaceId
Tanım: =GetSysAttr('spaceId')
Alan Adı
Ad: vSpaceName
Tanım: =GetSysAttr('spaceName')
Alan Türü
Ad: vSpaceType
Tanım: =GetSysAttr('spaceType')
Bir Tablo nesnesi oluşturun ve aşağıdaki ifadelerin her birini ilgili etiketleriyle birlikte boyut olarak ekleyin:
=vTenantId, etiketli Tenant ID
=vTenantName, etiketli Tenant Name
=vTenantUrl, etiketli Tenant URL (Default)
=vTenantUrlAlias, etiketli Tenant URL (Alias)
=vTenantRegion, etiketli Tenant Region
=vSpaceId, etiketli Space ID
=vSpaceName, etiketli Space Name
=vSpaceType, etiketli Space Type
Artık uygulamanızda, mevcut ortam özniteliklerinin her birini dinamik olarak görüntüleyen bir tablonuz var. Uygulamayı dışa aktarmak ve farklı bir kiracıya ve alana yüklemek, uygulamanın yeni yüklenen sürümü için size bu öznitelikleri verecektir.
Fonksiyonu grafik ifadelerinde kullanmanın temel faydası, bu özniteliklerin yenilenmesi için uygulamanın yeniden yüklenmesine gerek olmamasıdır. Bu, uygulamaların, uygulama yaşam döngüsü kapsamında kiracılar ve alanlar arasında daha sorunsuz hareket etmesini sağlar.
Örnek 3 - Fonksiyonu doğrudan yükleme 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:
Paylaşılan bir alanda yeni bir Qlik Sense uygulaması oluşturun.
Veri yükleme düzenleyicisini açın.
Aşağıdaki yükleme komut dosyasını yeni bir sekmeye yapıştırın:
Attributes:
Load RowNo() as Key,
GetSysAttr('tenantId') as TenantID,
GetSysAttr('tenantName') as TenantName,
GetSysAttr('tenantUrl') as TenantUrl,
GetSysAttr('tenantUrlAlias') as TenantUrlAlias,
GetSysAttr('tenantRegion') as TenantRegion,
GetSysAttr('spaceId') as SpaceID,
GetSysAttr('spaceName') as SpaceName,
GetSysAttr('spaceType') as SpaceType 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 4 - Fonksiyonu doğrudan grafik ifadelerinde kullanma
Fonksiyonu bir değişken kullanmadan doğrudan grafik ifadelerine girebilirsiniz.
Grafik ifadelerinde işlev kullanmanın temel faydası, bu öznitelikleri yenilemek için uygulamanın yeniden yüklenmesine gerek olmamasıdır. Bu, uygulamaların, uygulama yaşam döngüsü kapsamında kiracılar ve alanlar arasında daha sorunsuz hareket etmesini sağlar.
Aşağıdakileri yapın:
Paylaşılan bir alanda 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.
Metin eklemek için boş grafiğin içine tıklayın ve yazın:
Kiracı Kimliği:
Özellikler panelinde Hesaplama ekle seçeneğine tıklayın.
Aşağıdaki ifadeyi girin:
=GetSysAttr('tenantId')
Bu yardım konusunun giriş bölümündeki öznitelikler tablosunda sunulan ifadeleri kullanarak yeni satırlardaki diğer öznitelikler için bu adımları tekrarlayın.
Bu sayfa size yardımcı oldu mu?
Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız, bize bildirin, düzeltelim!