Ana içeriğe geç Tamamlayıcı içeriğe geç

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.

Qlik Cloud Yönetimi notuÜçü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 ş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:

  1. Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
  2. Ekle'ye tıklayın.

  3. Gözat seçeneğine tıklayarak bir uzantı dosyası seçin veya belirtilen alana bir dosyayı sürükleyip bırakın.

  4. İsteğe bağlı olarak etiket ekleyin.

  5. Yayınla'ya tıklayın.

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

Genişlemeleri düzenleme

Aşağıdakileri yapın:

  1. Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
  2. Düzenlemek istediğiniz uzantıda Daha fazla seçeneğine tıklayıp Düzenle'yi seçin.

  3. Genişlemeyi değiştirmek veya etiketleri güncellemek için düzenleme panelini kullanın.

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

  1. Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
  2. İndirmek istediğiniz genişlemede, Daha fazla öğesine tıklayın ve İndir öğesini seçin.

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

  1. Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
  2. Taşımak istediğiniz genişlemede Daha fazla öğ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:

  1. Yönetim etkinlik merkezinde Uzantılarbölümüne gidin.
  2. Silmek istediğiniz uzantıları seçin.
  3. 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!