Uzantıları yönetme
Uzantılar, Qlik Cloud analiz platformunun işlevselliğini genişleterek Qlik Sense uygulamaları için özel görselleştirmeleri etkinleştirir. Uzantıları Yönetim etkinlik merkezinden yükleyebilir ve düzenleyebilirsiniz.
Uzantı oluşturma ve yükleme ile ilgili yönergeler
Qlik Cloud için görselleştirme uzantıları oluşturup yüklerken bu yönergeleri izleyin.
Uzantı eklemek ve kullanımıyla ilgili bir görsel demo için bk. Qlik Cloud içinde üçüncü parti görselleştirme uzantılarının kullanımı ve Uzantılar ve API anahtarları.
Uzantılar için ZIP dosyası sınırları
-
Maksimum ZIP dosya boyutu: 30 MB
-
ZIP biçiminde maksimum dosya boyutu: 30 MB
-
ZIP biçiminde maksimum dosya sayısı: 500
-
ZIP biçiminde maksimum sıkıştırılmış toplam dosya boyutu: 100 MB
En iyi uygulamalar
-
Kod dosyalarınızı küçültün.
-
Yalnızca gerekli dosyaları ekleyin. ZIP dosyasının yalnızca uzantınızın düzgün çalışması için gerekli dosyaları içerdiğinden emin olun.
-
Yüklemeden önce uzantıları ve kodlarını gözden geçirin. Daha fazla bilgi için bkz. Görselleştirme uzantıları (yalnızca İngilizce).
Bir uzantı için gerekli temel dosyalar
Uzantı ZIP dosyanızın aşağıdaki temel dosyaları içerdiğinden emin olun:
-
.qext: Uzantı meta veri dosyası
-
.js: Uzantı için JavaScript kodu
-
.html: Uzantıyı oluşturmak için HTML kodu
-
.css: Uzantıyı şekillendirmek için özel CSS
Görüntü dosyalarının harici barındırılması
Görüntü dosyalarını (örneğin, GIF, PNG, JPG) ZIP dosyası uzantısı içinde yüklemeyin. Bunun yerine dosyaları, kişisel bir uygulama sunucusunda, bir S3 demetinde veya bir genel içerik yönetim sisteminde harici olarak barındırın. Uzantı kodunuzda bu harici görüntülere referans verin.
Harici kod dosyalarına ve içeriğe referans verme
Birincil uzantı kodunuzdaki kod dosyalarına ve içeriğe referans verebilirsiniz, ancak bunun için kiracıda bir İçerik Güvenliği Politikası (CSP) uygulanması gerekir. Daha fazla bilgi için bk. yönetimiContent Security Policy.
Uzantınız, harici kaynaklara yönelik isteklerde bulunuyorsa bu kaynak kökenleri, CSP'de izin verilenler listesine alınmış olmalıdır; aksi takdirde uzantının oluşturulması engellenir.
Desteklenmeyen özellikler
Aşağıdaki özellikler desteklenmemektedir:
Paket uzantılar
Qlik Cloud, diğer uzantı ZIP dosyalarını içeren ZIP dosyalarını desteklemez.
QVF ve QVD dosyaları
Qlik Sense QVF veya QVD dosyalarını uzantı ZIP dosyalarına eklemeyin, çünkü bunlara uzantı hizmetinden erişilemez. Uzantıyı yüklemeden önce bu dosyaları kaldırmalısınız.
Qlik Cloud kiracısına bir QVF ya da QVD dosyası yüklemek için aşağıdaki yöntemlerden birini kullanın:
-
Analiz etkinlik merkezinin Oluştur sayfasında uygulama yükleyin.
-
qlik-cli kullanarak bir uygulama yükleyin.
-
Analiz etkinlik merkezinin Oluştur sayfasında bir QVD yükleyin.
-
Qlik DataTransfer kullanarak bir QVD yükleyin.
Desteklenmeyen dosya biçimleri
Güvenlik nedeniyle uzantılar, izin verilmeyen MIME türlerine sahip dosyaları içeremez. MIME türleri (Çok Amaçlı İnternet Posta Uzantıları) bir dosyanın niteliğini ve biçimini belirtmenin standart bir yoludur. Uzantınız, örneğin yürütülebilir dosya ya da ZIP dosyası içeriyorsa yükleme başarısız olur.
Aşağıdaki MIME türlerine izin verilmez:
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'application/x-sharedlib'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
Bir uzantıdaki tüm dosyaların, dosya adı ve dosya uzantısı olmalıdır. Buna uymayan dosyalar yoksayılır. Yoksayılan dosya örnekleri arasında .gitignore ve README bulunmaktadır.
Uzantıları ekleme ve yönetme
Uzantılar, Yönetim etkinlik merkezindeki Uzantılar sayfasından yönetilir.
Uzantılar tablosunda:
-
Ad, QEXT dosyasındaki meta veri adını ifade eder.
-
QEXT sürümü, QEXT dosyasındaki meta veri sürümünü gösterir.
-
QEXT dosya adı, benzersiz tanımlayıcıdır ve uzantı tanım dosyasının adıdır.
Uzantıları etiketlere göre filtreleyebilirsiniz.
Yeni uzantı ekleme
Aşağıdakileri yapın:
- Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
-
Ekle'ye tıklayın.
-
Gözat seçeneğine tıklayarak bir uzantı dosyası seçin veya belirtilen alana bir dosyayı sürükleyip bırakın.
-
İsteğe bağlı olarak etiket ekleyin.
-
Yayınla'ya tıklayın.
Uzantıyı düzenleme
Aşağıdakileri yapın:
- Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
-
Düzenlemek istediğiniz uzantıda seçeneğine tıklayıp Düzenle'yi seçin.
Mevcut uzantıyı değiştirme ve etiket ekleme ya da çıkarma seçeneklerini içeren düzenleme paneli görüntülenir.
-
Değişikliklerinizi kaydedin.
Uzantıyı silme
Uzantıların silinmesi tüm kaynakları ve bu nedenle de kiracı içindeki tüm kullanıcıları etkileyebilir.
Aşağıdakileri yapın:
- Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
- Silmek istediğiniz uzantıları seçin.
- Sil'e tıklayın.