Görselleştirme uzantılarını yükleme ve yönetme

Son güncelleme: 20.10.2026

Uzantılar, Qlik Cloud uygulamalarına özel görselleştirme yetenekleri ekler. Uzantıları Yönetim etkinlik merkezinde yükleyebilir ve yönetebilirsiniz.

Üçüncü taraf uzantıları Qlik Cloud Government tarafından desteklenir. Bunları kullanmak, kuruluşunuzun güvenlik ve uyumluluk gereksinimlerine bağlı olarak bir Ajans Çalışma Yetkisi'nin bir parçası olarak onay gerektirebilir.

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 bkz. İç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. Uzantınız 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:

Analiz etkinlik 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: Genişlemenin geçiş durumu

Geçiş durumu hakkında

Qlik uzantıları eski depolama alanından uzantıları yönetmek için kullanılan hizmete taşıdı. Geçiş durumu, bir genişlemenin mevcut geçiş durumunu gösterir.

Taşıma durumu değerleri:

Geçirildi: Genişleme başarıyla geçirildi ve kullanılabilir.
Kullanılamıyor: Genişleme artık mevcut değil ve geçirilemez. Yönetim etkinlik merkezinden genişlemeyi silin.

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.

Mevcut bir dosyayla aynı QEXT dosya adına sahip bir uzantıyı karşıya yükleyemezsiniz.

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 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.

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 lütfen bize bildirin!

Geri bildiriminizi buradan iletin