Görselleştirme uzantılarını yükleme ve yönetme
Uzantılar, Qlik Cloud uygulamalarına özel görselleştirme yetenekleri ekler. Uzantıları Yönetim etkinlik merkezinde yükleyebilir ve yönetebilirsiniz.
Uzantıları kullanma
Qlik Cloud içindeki görselleştirme uzantıları, standart görselleştirmelerin ötesinde yeni görsel bileşenler ekler. Verileri nasıl sunduğunuzu ve keşfettiğinizi özelleştirmek için bunları kullanın.
Daha fazla bilgi için bkz. Qlik Geliştiricisi: Qlik'i Genişletme. Görsel bir demo için bkz. Qlik Cloud içinde üçüncü parti görselleştirme uzantılarının kullanımı ve Uzantılar ve API anahtarları.
Gerekli roller
Genişlemeleri yüklemek ve yönetmek için aşağıdaki rollerden birine sahip olmanız gerekir:
-
Kiracı yöneticisi
-
Analiz yöneticisi
-
Uzantıları yönet izni İzin verildi olarak ayarlanmış özel rol
Dosya gereklilikleri ve sınırları
Uzantınızın doğru şekilde yüklenip çalışmasını sağlamak için bu kurallara uyun.
Dosya sınırları
Uzantı ZIP dosyaları şu sınırlara sahiptir:
-
Maksimum ZIP dosya boyutu: 30 MB
-
ZIP içindeki tek bir dosya için maksimum boyut: 30 MB
-
ZIP biçiminde maksimum dosya sayısı: 500
-
Maksimum toplam sıkıştırılmamış boyut: 100 MB
Bir uzantı için gerekli temel dosyalar
Uzantı ZIP dosyanızın aşağıdaki dosyaları içerdiğinden emin olun:
-
.qext: Meta veri dosyası
-
.js: JavaScript kodu
-
.html: HTML işleme kodu
-
.css: Özel stil
Dosya adlandırma kuralları
Genişlemedeki her dosyanın bir dosya adı ve bir dosya uzantısı olmalıdır. Buna uymayan dosyalar yoksayılır. Yoksayılan dosya örnekleri arasında .gitignore ve README bulunmaktadır.
En iyi uygulamalar
-
Kod dosyalarınızı küçültün.
-
Genişlemenizin çalışması için yalnızca ihtiyaç duyduğu dosyaları ekleyin.
-
Genişlemeyi ve kodunu yüklemeden önce inceleyin.
Harici kaynaklar ve CSP
Görüntü dosyalarını harici olarak barındırın
Görüntü dosyalarını (GIF, PNG, JPG gibi) genişleme ZIP dosyasına dahil etmeyin. Bunun yerine, görüntüleri harici olarak (örneğin, bir uygulama sunucusunda, bir S3 demetinde veya genel bir içerik yönetim sisteminde) barındırın ve genişleme kodunuzdan bunlara başvurun.
Harici kod ve içeriğe referans verme
Genişlemenizde harici kod veya içeriğe başvurmak için, bir kiracı İçerik Güvenliği İlkesi (CSP) yapılandırın ve genişlemenizin erişmesi gereken harici kaynakları izin verilenler listesine ekleyin.
Bir kaynak izin verilenler listesinde değilse, genişlemeniz oluşturulmaz.
Daha fazla bilgi için şuraya bakın: İçerik Güvenliği Politikasını (Content Security Policy) (CSP) Yönetme.
Desteklenmeyen dosya biçimleri
Güvenlik nedenleriyle, genişlemeler izin verilmeyen MIME türlerine sahip dosyaları içeremez. MIME türleri (Çok Amaçlı İnternet Posta Uzantıları) bir dosyanın biçimini belirtir. Genişlemeniz izin verilmeyen bir MIME türü (örneğin, yürütülebilir bir dosya veya bir 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'
Desteklenmeyen özellikler
Aşağıdaki özellikler desteklenmemektedir:
-
Paketlenmiş genişlemeler: Başka genişleme ZIP dosyalarını içeren ZIP dosyaları desteklenmez.
-
QVF ve QVD dosyaları: Bu dosyalar genişleme hizmetinden erişilebilir değildir.
QVF veya QVD dosyalarını yüklemek için aşağıdaki yöntemlerden birini kullanın:
-
Analizetkinlik merkezindeki Oluştur sayfasından bir uygulama yükleyin.
-
qlik-cli kullanarak bir uygulama yükleyin.
-
Analiz etkinlik merkezindeki Oluştur sayfasından bir QVD yükleyin.
-
Qlik DataTransfer kullanarak bir QVD yükleyin.
Uzantıları yönetme
Uzantılar, Yönetim etkinlik merkezindeki Uzantılar sayfasından yönetilir.
Uzantılar tablosu bilgileri
-
Ad: QEXT dosyasındaki meta veri adı
-
QEXT sürümü: Meta veri sürümü
-
QEXT dosya adı: Uzantı tanım dosyası için benzersiz tanımlayıcı
-
Durum: Geçiş durumu (geçici)
Geçiş durumu hakkında
Qlik platformun genişlemeleri nasıl ele aldığını geliştiriyor. Bu geçiş sırasında, mevcut genişlemeler yeni bir hizmete taşınıyor. Geçiş durumu sütunu geçicidir ve yalnızca bu çalışma devam ederken görünür.
2025-11-17 tarihi itibarıyla, yüklediğiniz veya eriştiğiniz herhangi bir genişleme yeni hizmeti otomatik olarak kullanır. Genişlemeniz düzenli olarak kullanılıyorsa, herhangi bir işlem yapılması gerekmez.
Çoğu genişleme, kullanıldığında otomatik olarak taşınır. Son zamanlarda kullanmadığınız genişlemelerin, planlanmış bir taşıma çalıştırmasına dahil edilmek üzere manuel olarak sıraya alınması gerekebilir. Müşteriye ait içeriği korumak için, Qlik genişlemeleri erişilmedikçe veya taşımayı onaylamadığınız sürece taşımaz. Kullanılmayan bir genişlemeyi (Taşınmadı durumu) kullanılabilir tutmak isterseniz, bunu manuel olarak taşıyabilirsiniz.
Taşıma durumu değerleri:
-
Taşınmadı: Genişleme taşınmadı.
-
Taşıma için sıraya alındı: Genişleme sıraya alındı ve bir sonraki planlanmış taşıma çalıştırması sırasında taşınacak.
-
Taşıma devam ediyor: Genişleme şu anda taşınıyor.
-
Geçirildi: Genişleme başarıyla geçirildi.
Geçiş temalar için de geçerlidir. Ayrıntılı bilgi için bkz. Temaları yükleme ve yönetme.
Genişlemeler 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.
Genişlemeleri 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.
-
Genişlemeyi değiştirmek veya etiketleri güncellemek için düzenleme panelini kullanın.
-
Değişikliklerinizi kaydedin.
Genişlemeleri indirme
Bunu, bir genişlemeyi düzenlemeden önce yedeklemek veya başka bir kiracıya taşımak için kullanın.
Aşağıdakileri yapın:
- Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
-
İndirmek istediğiniz genişlemede,
öğesine tıklayın ve İndir öğesini seçin.
-
ZIP dosyasını kaydedin.
Genişlemeleri taşıma
Şu adımları kullanarak Taşınmadı durumundaki genişlemeleri taşıyın.
Aşağıdakileri yapın:
- Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
-
Taşımak istediğiniz genişlemede
öğesine tıklayın ve Taşı öğesini seçin.
Taşıma ilerledikçe durum güncellenir: Taşıma için sıraya alındı, Taşıma devam ediyor ve son olarak Taşındı.
Genişlemeleri 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.