Ana içeriğe geç

Uzantıları yönetme

Uzantılar, Yönetim Konsolu'da Uzantılar sayfasından yönetilir.

Qlik Sense Enterprise SaaS Government notuÜçüncü taraf uzantıları Qlik Sense Enterprise SaaS - Government (US) tarafından desteklenir. Bununla birlikte, kuruluşunuzun izlediği güvenlik ve uyumluluk gereksinimlerine bağlı olarak, üçüncü taraf uzantılarının kullanımının bir Acente İşletme Yetkilisi kapsamında tanımlanması ve onaylanması gerekebilir.

Harici kaynaklara yönelik kaynak isteklerini içeren uzantıların kökenleri, Content Security Policy içinde izin verilenler listesine alınmış olmalıdır; aksi takdirde uzantının oluşturulması engellenir.

İpucu notuYüklemeden önce uzantıları ve kodlarını gözden geçirmenizi öneririz. Daha fazla bilgi için lütfen bkz. Görselleştirme uzantıları (yalnızca İngilizce).

Uzantı eklemek ve kullanımıyla ilgili bir görsel 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ı.

Uzantılara genel bakış

Yönetim Konsolu'un Uzantılar sayfasında aşağıdaki özellikler gösterilir.

Uzantıların özellikleri
Özellik Açıklama

Name

Bu, QEXT dosya adından farklı olan, QEXT dosyasında kapsanan meta veri adıdır.

Description

Uzantının kısa açıklaması.

Tags

Filtreleme etiketleri.

Author

Uzantıyı oluşturan.

QEXT dosya adı

Benzersiz olması gereken tanımlayıcı. Uzantı tanımı dosyasının dosya adı. Uzantı adından farklıdır.

QEXT sürümü

QEXT dosyasında kapsanan meta veri sürümü.

Yayınlananlar

Yayınlanma tarihi.

Tabloda, özellikler üst bilgisindeki okları kullanarak sıralayın. Etiketler açılır menüsünü kullanarak ve tablodaki etiketleri seçerek filtreleyin.

Harici kaynaklar ile uzantılar

Harici kaynaklara yönelik kaynak isteklerini içeren uzantıların kökenleri, Content Security Policy içinde izin verilenler listesine alınmış olmalıdır; aksi takdirde uzantının oluşturulması engellenir.

Ayrıca bkz.Content Security Policy yönetimi

Desteklenmeyen dosya biçimleri

Bir uzantı klasörü içindeki dosyanın maksimum boyutu 15 MB olabilir.

Güvenlik nedeniyle uzantıların izin verilmeyen MIME türlerine sahip dosyaları içermesi engellenir. 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'
Bilgi notuBir 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: .gitignore ve README.

Uzantı oluşturma ve yükleme ile ilgili yönergeler

Qlik Sense SaaS ve Qlik Sense Enterprise Client-Managed farklı uzantı hizmetleri kullanırlar, dolayısıyla farklı yeteneklere sahiptirler. Qlik Sense SaaS için görselleştirme uzantıları oluşturup yüklerken şu yönergeleri izlemelisiniz:

  • Bir uzantı zip dosyasının boyutu 15 MB'tan az olmalıdır. Bu, zaman aşımı veya sorun olmadan uzantıların yüklenmesini sağlar.

  • Kod dosyalarınızı küçültün.

  • Bir uzantı ZIP dosyasına yalnızca uzantınızın düzgün çalışması için gerekli dosyaları ekleyin. Tablo, görselleştirme uzantısı için gereken temel dosyaları gösterir.

    Dosya uzantısı Açıklama
    .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ı yüklemeyin. GIF, PNG, JPG ve diğer resim dosyaları, kişisel bir uygulama sunucusunda, bir S3 demetinde veya bir genel içerik yönetim sisteminde harici olarak barındırılmalıdır. Bunlara uzantı kodundan başvuru yapılabilir.

    Bilgi notuBirincil uzantı kodunuzdan bazı kod dosyalarına ve içeriğe başvuru yapmak mümkündür. Bir uzantıdan harici içeriğe başvurmak, kiracıda içerik güvenliği politikasının uygulanmasını gerektirir. Daha fazla bilgi için bkz. Content Security Policy yönetimi.
  • Qlik Sense SaaS uzantı hizmeti, paketlenmiş uzantıları (başka uzantı ZIP dosyalarını içeren bir ZIP dosyası) desteklemez.

  • Qlik Sense QVF veya QVD dosyalarını içeren uzantıları yüklemeyin, çünkü bu dosyalara uzantı hizmetinden erişilemez. Uzantıyı yüklemeden önce bu dosyaları kaldırmalısınız.

  • Qlik Sense SaaS kiracısına bir QVF ya da QVD dosyası yüklemek için aşağıdakilerden birini yapın:

    • Bulut hub'ından bir uygulama yükleyin.

    • qlik-cli kullanarak bir uygulama yükleyin.

    • Bulut hub'ından bir QVD yükleyin.

    • Qlik DataTransfer kullanarak bir QVD yükleyin.

Yeni uzantı ekleme

Aşağıdakileri yapın:

  1. Yönetim Konsolu'da Uzantılar bölümüne gidin ve sağ üst köşedeki Ekle seçeneğine tıklayın.
  2. Açılır pencerede Gözat seçeneğine tıklayarak bir uzantı dosyası seçin veya belirtilen alana bir dosyayı sürükleyip bırakın.

    Bilgi notuMevcut bir dosyayla aynı QEXT dosya adına sahip bir uzantıyı karşıya yükleyemezsiniz.
  3. İsteğe bağlı olarak etiket ekleyin.

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

  5. Karşıya yüklediğiniz uzantılar, harici kaynaklar içeriyorsa bunların kökenlerini Content Security Policy içinde izin verilenler listesine almanız gerekir. Bkz. Content Security Policy yönetimi.

Uzantıyı düzenleme

Tek seferde tek bir uzantıyı düzenleyebilirsiniz.

Aşağıdakileri yapın:

  1. Yönetim Konsolu'da, Uzantılar bölümüne giderek düzenlemek istediğiniz uzantının onay kutusunu seçin.
  2. Sağ üst köşedeki Düzenle'ye tıklayın.

    Mevcut uzantıyı değiştirme ve etiket ekleme ya da çıkarma seçeneklerini içeren düzenleme paneli görüntülenir.

  3. Düzenlemelerinizi gerçekleştirin ve kaydedin.

Uzantıyı silme

Aşağıdakileri yapın:

  1. Yönetim Konsolu'da, Uzantılar bölümüne giderek silmek istediğiniz uzantıların onay kutularını seçin.
  2. Sağ üst köşedeki Sil'e tıklayın.
Bilgi notuUzantıların silinmesi tüm kaynakları etkileyebilir. Silme işleminden kiracıda bulunan tüm kullanıcılar etkilenir.