Ana içeriğe geç Tamamlayıcı 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 Cloud Government 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 bk. Görselleştirme uzantıları (yalnızca İngilizce).

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

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

  • Genişleme içeren ZIP dosyalarında aşağıdaki sınırlar vardır:

    • 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

  • 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 bk. Content Security Policy yönetimi.
  • Qlik Cloud 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 Cloud 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 genişleme, harici kaynaklar içeriyorsa bunların kökenlerini Content Security Policy içinde izin verilenler listesine eklemeniz 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.

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, bize bildirin, düzeltelim!