Include/Must_Include değişkeni, koda eklenmesi ve kod olarak değerlendirilmesi gereken metni içeren bir dosyayı belirtir. Veri eklemek için kullanılmaz. Kodunuzun bölümlerinizi ayrı bir metin dosyasında depolayabilir ve birkaç uygulamada yeniden kullanabilirsiniz. Bu, kullanıcı tanımlı bir değişkendir.
Söz Dizimi:
$(Include=filename)
$(Must_Include=filename)
Değişkenin iki sürümü vardır:
- Include, dosya bulunamadığı takdirde bir hata üretmez ve sessizce başarısız olur.
- Must_Include ise dosya bulunamadığı takdirde hata üretir.
Bir yol belirtmezseniz, dosya adı Qlik Sense uygulaması çalışma dizinine göreceli olur. Ayrıca mutlak bir dosya yolu veya lib:// klasör bağlantısına giden bir yol da belirtebilirsiniz. Eşittir işaretinden önce veya sonra boşluk karakteri koymayın.
Örnekler:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Sınırlamalar
Windows ve Linux altında UTF-8 kodlu dosyalar arasında sınırlı çapraz uyumluluk.
UTF-8'i BOM (Bayt Sırası İşareti) ile kullanmak isteğe bağlıdır. BOM, bir dosyanın başlangıcında ASCII olmayan baytlar beklemeyen, ancak metin akışını işleyebilecek yazılımlarda UTF-8 kullanımına müdahale edebilir.
Windows sistemleri, bayt depolamasında belirsizlik olmamasına rağmen, bir dosyanın UTF-8 kodlu olduğunu belirlemek için UTF-8'de BOM kullanır.
Unix / Linux, Unicode için UTF-8 kullanır, ancak BOM'u kullanmaz çünkü bu, komut dosyalarının sözdizimini bozar.
Bunu Qlik Sense için bazı etkileri vardır.
Windows'ta UTF-8 BOM ile başlayan herhangi bir dosya UTF-8 komut dosyası olarak kabul edilir. Aksi takdirde ANSI kodlaması varsayılır.
Linux'ta, sistem varsayılan 8 bit kod sayfası UTF-8'dir. Bu nedenle UTF-8 bir BOM içermemesine rağmen çalışır.
Sonuç olarak taşınabilirlik garanti edilemez. Windows'ta Linux tarafından yorumlanabilen (veya tersi olan) bir dosya oluşturmak her zaman mümkün değildir. BOM'un farklı işlenmesi nedeniyle, UTF-8 kodlu dosyalara ilişkin iki sistem arasında çapraz uyumluluk yoktur.
Daha fazla bilgi için bk. Bayt sırası işareti
QVS kodunu Qlik Cloud Analizleri içindeki alanlardan ekleme
Qlik Cloud Analizleri içinde, bir komut dosyasındaki bir veri dosyasından veri yüklerken bir LOAD deyimi kullanabilir veya QVS kodunu ekleyebilirsiniz. Her iki durumda da, komut dosyası deyiminizde hiyerarşik alan klasör yapılarına referans verilebilir. Geçerli alan klasör yolları için kuralları izleyin. Ayrıca, dosyanın ve referans verilen tüm klasörlerin belirtilen konumda zaten mevcut olması gerekir. Aksi takdirde, yeniden yükleme başarısız olur.
Örnek: Bir alanın üst düzey yolunda QVS dosyasına referans verme
Bu örnekte, test.qvs dosyasına komut dosyasında referans verilmektedir. Dosya, TeamSharedSpace alanında yer almaktadır. Dosya belirli bir klasör içinde değil, bunun yerine alandaki en üst düzey yolda bulunuyor.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Örnek: Bir alanda belirli bir klasör yolundaki QVS dosyasına referans verme
Bu örnekte, test.qvs dosyasına komut dosyasında referans verilmektedir. Dosya TeamSharedSpace alanındaki SalesData klasöründe yer almaktadır.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Komut dosyalarında alan klasörü yapısına referans verilmesi hakkında daha fazla bilgi için bk. Uygulama ve komut dosyası geliştirmede alan klasör yapısına başvurma.