Microsoft Office için Qlik eklentilerini dağıtma ve yükleme

Kuruluşunuzdaki kullanıcıların rapor şablonları oluşturmasına izin vermek üzere Microsoft Office için Qlik eklentilerini dağıtın ve yükleyin. Rapor görevlerinden rapor çıktısı üretmek için eklentilerle oluşturulan rapor şablonlarını Qlik Cloud uygulamasına yükleyin.

Microsoft Office için Qlik eklentileri, Microsoft 365 içinde Excel, PowerPoint ve Word'in uyumlu web ve masaüstü sürümleri için dağıtılabilir ve yüklenebilir.

Eklentiler, bir bildirim dosyası kullanarak yüklenir. Bu bildirim dosyası, Microsoft 365 yöneticisinin (veya bazı yükleme yöntemlerinde bir kullanıcının) kendileri veya kuruluşlarındaki kullanıcılar için eklentileri dağıtması ve yüklemesi için gereklidir.Bir bildirim dosyası, tek bir Qlik Cloudkiracı için eklentilerin yüklenmesine izin verir.

Bildirim dosyasını veya URL'yi aldıktan sonra eklentileri dağıtmanın ve yüklemenin iki farklı yöntemi vardır:

• Merkezileştirilmiş dağıtım Merkezileştirilmiş dağıtım, yükleme ve etkinleştirme

• Başka bir cihazdan yükleme: Eklentileri başka bir cihazdan veya ağ paylaşımı ile yükleme

Daha fazla bilgi için şuraya bakın: Rapor şablonları tasarlama Qlik eklentileriyle Microsoft Office için.

Sistem ve yazılım gereksinimleri

Qlik Cloud Yönetimi notu

Microsoft Office için Qlik eklentileri, Qlik Cloud Government veya Qlik Cloud Government - DoD kiracılarındaki uygulamalara karşı rapor şablonları geliştirmek üzere desteklenir. Eklentiler yalnızca Office 365 Commercial için kullanılabilir.

Qlik eklentilerini yüklemek ve kullanmak için aşağıdaki gereklilikleri karşılamanız gerekir.

Microsoft Excel için Qlik eklentisi

Windows kurulumları için:

• Windows 10 v.1903 veya üstü

• Microsoft 365 v.16.0.11629 veya üstü

macOS kurulumları için:

• macOS v.14 veya üstü

• Microsoft 365 v.16.83 veya üstü

Ayrıca, Microsoft Excel için Qlik eklentisini çalıştırmak için ExcelAPI 1.9 veya daha yeni bir Microsoft Excel sürümünün yüklü olması gerekir. Excel yüklemenizin uyumlu olup olmadığını kontrol etmek için Excel JavaScript API gereklilik setleri sayfasındaki resmi Microsoft belgelerine başvurun.

Excel API'niz minimum gerekli sürümden daha eskiyse Qlik eklentisinin daha yeni bir Microsoft Excel sürümü gerektirdiğini belirten bir hata gösterilir.

Hatayı görmek için Microsoft Excel içinde sağdaki beyaz alana tıklamanız ve sayfayı güncellemek üzere F5 tuşuna basmanız gerekebilir.

Bu hatayı görürseniz Microsoft Excel yüklemenizi yükseltin.

Microsoft PowerPoint için Qlik eklentisi

Windows kurulumları için:

• Windows 10 v.1903 veya üstü

• Microsoft 365 version 2504 (derleme 18730.20030) veya üstü

macOS yüklemeleri için:

• macOS v.14 veya üstü

• Microsoft 365 v.16.96 veya üstü

Microsoft Word için Qlik eklentisi

Windows yüklemeleri için:

• Windows 10 v.1903 veya üstü

• Microsoft 365 2208 (derleme 15601.20148) sürümü veya üstü

macOS kurulumları için:

• macOS v.14 veya üstü

• Microsoft 365 v.16.64 veya üstü

Eklenti bilidrimini hazırlama ve alma

Microsoft Office için Qlik eklentileri, bir bildirim dosyası kullanılarak Microsoft ortamında yüklenir. Bu bir XML dosyasıdır. Merkezileştirilmiş dağıtım için büyük olasılıkla bildirim dosyasının URL'sinin, Microsoft yöneticisi tarafından sağlanması gerekecektir.

Bir bildirim dosyası tek bir Qlik Cloudkiracısına özeldir. Excel, PowerPoint ve Word için eklentileri yüklemek üzere aynı bildirim dosyasını kullanırsınız.

Eklentiyi yüklemek için OAuth istemci yapılandırması gerekir. OAuth istemcisini yapılandırdıktan sonra bildirim dosyası bağlantısını ve bildirim dosyasının kendisini Yönetim etkinlik merkezinden alın.

Aşağıdakileri yapın:

1. Gerekli yapılandırmayı kullanarak Qlik Cloud kiracısında OAuth istemcisini oluşturun. Tüm talimatlar için bkz. Microsoft Office için Qlik eklentilerine yönelik OAuth istemcileri oluşturma.

2. Yönetim etkinlik merkezine gidin ve bildirim dosyasını oluşturun. Bildirim dosyasını doğrudan alternatif kullanım alanları için de indirebilirsiniz. bk. Microsoft Office için Qlik eklentilerinin yükleme bildirimlerini yönetme.

Microsoft Office için Qlik eklentilerine yönelik OAuth istemcileri oluşturma

Microsoft Office için Qlik eklentilerini yüklemek üzere OAuth istemci yapılandırması gerekir. Eklentiler, rapor geliştiricileri tarafından Qlik Cloud ile uygulama içi raporlama için rapor şablonları hazırlamak üzere kullanılır.

OAuth istemcisinin eklentilerde çalışması için tam olarak aşağıdaki gösterilen yapılandırmayla yapılandırılması gerekir.

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde Qlik Cloud içindeki OAuth bölümüne gidin.

2. Yeni oluştur'a tıklayın.

3. İstemci türü açılır menüsünde Tek sayfalı uygulama'yı seçin. Daha fazla alan görünecektir.

4. Bir Ad girin. Açıklama isteğe bağlıdır.

5. En azından user_default kapsamını dahil edecek onay kutusunu seçin. Yapılandırmaya diğer kapsamları dahil edebilirsiniz ancak user_default olmadan yükleme çalışmayacaktır.

   Mevcut her bir kapsamın tam açıklaması için bkz. Kullanılabilir OAuth kapsamları.

6. Yönlendirme URL'leri ekle alanına Qlik Cloud kiracısının URL'sini ve şu sabit dizeyi girin: /office-add-ins/oAuthLoginSuccess.html

   Sonuç bunun gibi görünmelidir: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Örneğin: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Ekle'ye tıklayın.

8. İzin verilen kaynaklar ekle alanına kiracınızın URL'sini girin ve Ekle'ye tıklayın.

9. Oluştur'a tıklayın.

10. İstemci kimliğinizi kopyalayın penceresi görünür. İstemci kimliğini panoya kopyalamayı veya pencereyi kapatmak için Bitti'ye tıklamayı seçebilirsiniz.

OAuth istemcisini oluşturduktan sonra, Yönetim etkinlik merkezinden güncellenmiş bildirim XML bağlantısını alın. Ayarlar sayfasına gidin ve E-posta ve raporlar sekmesini seçin. Paylaşım ve raporlar bölümünde Microsoft Office için Qlik eklentilerini seçin. Eklentiyi dağıtmak ve yüklemek için sağlanan bağlantıyı kullanın.

Merkezileştirilmiş dağıtım, yükleme ve etkinleştirme

Microsoft Office için Qlik eklentilerinin merkezileştirilmiş dağıtım ve yükleme ile kullanılabilir hale getirilmesi önerilir. Merkezileştirilmiş dağıtım için kuruluşunuzdaki bir Microsoft 365 yöneticisinin müdahalesi gerekir.

Merkezileştirilmiş dağıtım ile eklenti bildirimi, kuruluşunuzun Microsoft 365 yönetici merkezine yüklenir ve kullanıcılara önceden yapılandırılmış yükleme olarak dağıtılır. Dağıtım, belirli güvenlik gruplarının üyeleriyle sınırlanabilir.

Aşağıdaki durumlarda merkezileştirilmiş dağıtımı kullanmalısınız:

• Eklentinin kuruluşunuzun üyeleri için kalıcı olarak yüklenmesini istiyorsanız

• Kuruluş üyelerinize dağıtımı yönetmek istiyorsanız

Tam iş akışı için aşağıdaki prosedür bölümlerini takip edin.

Merkezileştirilmiş dağıtım ve yükleme

Merkezileştirilmiş dağıtım bir Microsoft 365 sistem yöneticisi tarafından tamamlanır.

Aşağıdakileri yapın:

1. OAuth istemcisi oluşturduktan sonra eklenti bildirim dosyasını veya bildirim URL'sini alın. bk. Eklenti bilidrimini hazırlama ve alma.

2. Eklentiyi resmi Microsoft belgelerine göre dağıtın: Office Eklentilerini dağıtın ve yayınlayın. Merkezişleştirilmiş dağıtım aracılığıyla dağıtımın sadece Microsoft 365 yönetici merkezi kullanılarak yapılabileceğini unutmayın.

Yukarıdaki prosedür ile eklentiler, onlara erişimi olan kullanıcılar için yüklenir. Daha sonra kullanıcılar eklentileri kendi Excel, PowerPoint veya Word sürümlerinde etkinleştirir.

Merkezileştirilmiş dağıtım olmadan eklentileri bir Excel, PowerPoint veya Word masaüstü sürümüne yüklemek için bir ağ paylaşımı ayarlayabilir ve bildirimi buraya yükleyebilirsiniz. Bu sadece bir Windows işletim sisteminde yapılabilir.

Merkezileştirilmiş dağıtımdan sonra eklentiyi etkinleştirme

Bir Microsoft yöneticisi kuruluşunuz için Qlik eklentisini yükledikten sonra erişiminiz varsa bu eklentiyi etkinleştirip kullanabilirsiniz.

Microsoft Office uygulamanızın sürümüne bağlı olarak, bu adımlar biraz farklı olabilir. Tüm ayrıntılar için resmi Microsoft belgelerine bakın.

Aşağıdakileri yapın:

1. Excel, PowerPoint veya Word masaüstü veya web sürümünü açın.

2. Ana Sayfa > Eklentiler > Eklentileri Al bölümüne gidin.

3. İletişim kutusunun YÖNETİCİ TARAFINDAN YÖNETİLEN sekmesinde Qlik eklentisini seçin.

Qlik eklenti simgesi, şerit çubuğunuza eklenir.

Excel, PowerPoint ve Word için eklentileri görüntüleme, yönetme ve yükleme

Eklentiyi kaldırma

Yüklemeniz merkezileştirilmiş bir yapılandırma kullanıyorsa eklentinin yüklemesini kaldıramayabilirsiniz. Bu, Microsoft 365 yöneticiniz tarafından kullanılan politikaya bağlıdır.

Eklentileri başka bir cihazdan veya ağ paylaşımı ile yükleme

Başka bir cihazdan ve ağ paylaşımı ile yükleme, test veya deneme amaçları için eklentilere hızlıca erişim elde etmenin uygun yollarıdır. Eklentileri üretim ve kurumsal ölçekte kullanım alanları için dağıtmaya uygun yöntemler değillerdir.

Excel, PowerPoint veya Word sürümünüze ve diğer faktörlere bağlı olarak, bu yöntemlerle yüklenen eklentiler sonuç olarak şerit çubuğunuzdan kaldırılabilir. Bu durumda, bildirimi Microsoft Office uygulamasına yeniden yükleyin.

2. Seçenek: Eklentiyi bir Windows ağ paylaşımı kullanarak masaüstü Microsoft Office uygulamalarına yükleme

Merkezileştirilmiş dağıtım olmadan eklentileri bir Excel, PowerPoint veya Word masaüstü sürümüne yüklemek için bir ağ paylaşımı ayarlayabilir ve bildirimi buraya yükleyebilirsiniz. Bu sadece bir Windows işletim sisteminde yapılabilir.

Eklentileri ağ paylaşımı aracılığıyla başka bir cihazdan yüklemek için aşağıdaki yönergeleri takip edin. Talimatlar, resmi Microsoft belgelerinden uyarlanmıştır. Daha fazla bilgi için Office Eklentilerini test için bir ağ paylaşımı üzerinden başka bir cihazdan yükleme veya diğer Microsoft kaynaklarına bakın.

1. Adım: Bir klasörü oluşturma ve paylaşma

Aşağıdakileri yapın:

1. Qlik eklentisini barındırmak için bir klasör oluşturun. Örnek: C:\Qlik Office add-ins

2. Windows Dosya Gezgini'nde, paylaşılan klasör kataloğunuz olarak kullanmak istediğiniz klasörün bulunduğu üst klasöre veya sürücü harfine gidin. Örnek: C:\

3. Klasöre sağ tıklayın ve Özellikler'i seçin.

4. Paylaşım sekmesini açın ve ardından Paylaş... düğmesine tıklayın.

   

5. Diyalog penceresinde kendinizi ve eklentinizi paylaşmak istediğiniz diğer kullanıcıları ve/veya grupları ekleyin. Klasör için en azından Okuma/Yazma iznine ihtiyacınız olacaktır. Paylaşacağınız insanları seçmeyi bitirdikten sonra Paylaş'a tıklayın.

6. Klasörünüzün paylaşıldığına dair onayı gördüğünüzde, klasör adınızdan hemen sonra görüntülenen tam ağ yolu adını not edin. Diyalog penceresini kapatmak için Bitti seçeneğine tıklayın.

   

7. Özellikler diyalog penceresini kapatmak için Kapat seçeneğine tıklayın.

2. Adım: Paylaşılan klasörü güvenilir bir katalog olarak manuel şekilde yapılandırma

Aşağıdakileri yapın:

1. Excel, PowerPoint veya Word masaüstü sürümünde yeni bir boş çalışma kitabı açın.

2. Dosya sekmesine ve ardından sol alt köşedeki Seçenekler'e tıklayın.

3. Güven Merkezi'ne ve ardından Güven Merkezi Ayarları... düğmesine tıklayın.

   

4. Güvenilir Eklenti Katalogları'na tıklayın.

   

5. Katalog URL'si kutusuna, daha önce paylaştığınız klasörün tam ağ yolunu girin.

6. Katalog ekle'ye tıklayın.

7. Yeni eklenen öğe için Menüde Göster onay kutusunu işaretleyin ve ardından Tamam'a tıklayarak Güven Merkezi diyalog penceresini kapatın.

   

8. Diyalog penceresini kapatmak için Tamam seçeneğine tıklayın.

9. Değişikliklerinizin uygulanması için uygulamayı kapatıp yeniden açın.

3. Adım: Eklentiyi başka bir cihazdan yükleme

Aşağıdakileri yapın:

1. Eklenti bildirimi XML dosyasını paylaşılan klasöre ekleyin.

2. ExcelPowerPoint veya Word içinde şeritteki Ana Sayfa sekmesinde bulunan Eklentiler'e tıklayın.

3. Diğer Eklentiler öğesine tıklayın.

4. Office Eklentileri diyalog kutusunun üstündeki PAYLAŞILAN KLASÖR'e tıklayın.

5. Eklentiyi eklemek için Qlik'i seçin.

6. Aşağıdakine benzer bir mesaj ileten bir diyalog penceresi görebilirsiniz: Qlik yeni bir pencere görüntülemek istiyor. İzin Ver'e tıklayın.

Ağ paylaşımı üzerinden yüklenen bir eklentiyi kaldırma

Aşağıdakileri yapın:

1. Excel, PowerPoint veya Word açıksa kapatın.

2. Şu klasörün içindekileri silin: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Seçenek 3: Masaüstü macOS uygulamalarında bir eklentiyi yan yükleme

macOS için eklentiler, Excel, PowerPoint veya Word'nin Microsoft 365 masaüstü sürümlerine yüklenebilir. Sistem ve yazılım gereksinimleri için bkz. Sistem ve yazılım gereksinimleri.

Aşağıdaki yönergeleri izleyin. Talimatlar, resmi Microsoft belgelerinden uyarlanmıştır. Talimatların tamamı için resmi Microsoft belgelerine bakın: Bir eklentiyi başka bir cihazdan Mac üzerinde Office içine yükleyin

Aşağıdakileri yapın:

1. Bilgisayarınızda Bulucu uygulamasını açın.

2. Şu klavye kombinasyonunu girin: Command+Shift+G

   Klasöre git menüsü açılır.

3. Microsoft Office uygulamasına bağlı olarak aşağıdaki yollardan birini girin:

   • Excel: /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint: /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word: /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   wef klasörü bilgisayarınızda henüz mevcut olmayabilir. Böyle bir durumda, klasörü bu konumda oluşturun.

4. wef klasörüne XML bildirim dosyasının bir kopyasını ekleyin.

5. Excel, PowerPoint veya Word açın. Zaten açıksa yeniden başlatmanız gerekecektir.

6. Şerit çubuğunda Ana Sayfa > Eklentiler bölümüne gidin.

7. Qlik eklentisini seçin.

Qlik eklentisi artık şerit çubuğunuzda mevcut olmalıdır.

Başka bir cihazdan yüklenen bir eklentiyi masaüstü macOS uygulamalarından kaldırma

Qlik eklentisini kaldırmak için bilgisayarınızdaki Office önbelleğini temizlemeniz gerekir. Daha fazla bilgi için şuraya bakın:

• Başka bir cihazdan yüklenen bir eklentiyi kaldırın

• Office önbelleğini temizleyin

Sorun giderme

Bu bölümde, sık karşılaşılan dağıtım ve yükleme sorunlarını çözmeye yönelik ipuçları sağlanmaktadır.

Ek sorun giderme ipuçları için bkz. Sorun giderme - Uygulama içi raporlama.

Microsoft Office için bir Qlik eklentisinin dağıtılmasından sonra kimlik doğrulaması sırasında gösterilen boş diyalog penceresi

Bir kullanıcı Microsoft Excel, Microsoft PowerPoint veya Microsoft Word için bir raporlama eklentisinde kimlik doğrulaması yapmayı denediğinde, kimlik doğrulama açılır penceresi boş olabilir. Kullanıcı bunun yerine alternatif olarak diyalog penceresinde bir hata (özellikle 12006) görebilir.

Bir kullanıcının Microsoft Office için bir Qlik eklentisiyle çalışması adına, kimlik doğrulama akışı, kiracınız ile farklı bir etki alanında barındırılan kimlik sağlayıcısı arasında bir yönlendirme gerektirir. Kimlik sağlayıcınız kısıtlı ayarlarla bir Cross-Origin-Opener-Policy ayarlıyor. Sonuç olarak, kimlik doğrulama akışının etki alanları arası iletişim bölümü engellenerek oturum açma bilgilerinin eklentiye doğru şekilde döndürülmesi önlenir.

Önerilen eylem  

Aşağıdaki çözüm, kimlik sağlayıcıları ayarlamaktan sorumlu bir ağ yöneticisi tarafından uygulanmalıdır.

Aşağıdakileri yapın:

• Diyaloğunuz için IDP'nizden gelen yanıt başlığını şuna ayarlayın:

  Cross-Origin-Opener-Policy: unsafe-none

Daha fazla bilgi için resmi Microsoft belgelerine başvurun: Office Diyalog API'si için en iyi uygulamalar ve kurallar