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

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

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

Eklentiler bir bildirim dosyası kullanılarak yüklenir. Bu bildirim dosyası, Microsoft 365 yöneticisinin (veya belirli yükleme yöntemlerinde muhtemelen bir kullanıcının) eklentileri kendileri veya kuruluşlarındaki kullanıcılar için dağıtması ve yüklemesi için gereklidir. Bir bildirim dosyası, eklentilerin tek bir Qlik Cloud kiracısı için yüklenmesine olanak tanır.

Bildirim dosyasını veya URL'sini aldıktan sonra, eklentileri dağıtmak ve yüklemek için iki farklı yöntem vardır:

• Merkezi dağıtım: Merkezi dağıtım, yükleme ve etkinleştirme

• Dışarıdan yükleme (Sideloading): Dışarıdan yükleme veya ağ paylaşımı kullanarak eklentileri yükleme

Daha fazla bilgi için bkz. Rapor şablonları tasarlama Qlik eklentileriyle Microsoft Office için.

Eklenti bildirimini hazırlama ve alma

Microsoft ortamında Microsoft Office için Qlik eklentilerini bir bildirim dosyası kullanarak yüklersiniz. Bu bir XML dosyasıdır. Merkezi bir dağıtım için, bildirim dosyasına giden bir URL'nin muhtemelen Microsoft yöneticisi tarafından sağlanması gerekecektir.

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

Eklentiyi yüklemek için bir OAuth istemci yapılandırması gereklidir. 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. Tam talimatlar için bkz. Microsoft Office için Qlik eklentilerine yönelik OAuth istemcileri oluşturma.

2. Yönetim etkinlik merkezine gidin ve bildirim bağlantısını oluşturun. Alternatif kullanım durumları için bildirim dosyasını doğrudan da indirebilirsiniz. Bkz. Microsoft Office için Qlik eklentilerine yönelik 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.

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

Microsoft Office için Qlik eklentilerinin merkezi dağıtım ve yükleme ile kullanıma sunulması önerilir. Merkezi dağıtım, kuruluşunuzdaki bir Microsoft 365 yöneticisinin işlem yapmasını gerektirir.

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

Aşağıdaki durumlarda merkezi 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 izleyin.

Merkezi dağıtım ve yükleme

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

Aşağıdakileri yapın:

1. Bir OAuth istemcisi oluşturduktan sonra eklenti bildirim dosyasını veya bildirim URL'sini edinin. Bkz. Eklenti bildirimini hazırlama ve alma.

2. Eklentiyi resmi Microsoft belgelerine göre dağıtın: Deploy and publish Office Add-ins. Merkezi dağıtım yoluyla dağıtımın yalnızca Microsoft 365 yönetim merkezi kullanılarak mümkün olduğunu unutmayın.

Yukarıdaki prosedürle eklentiler, kendilerine erişim izni verilen kullanıcılar için yüklenir. Kullanıcılar daha sonra eklentileri kendi Excel, PowerPoint veya Word sürümlerinde etkinleştirir.

Eklentileri merkezi dağıtım olmadan Excel, PowerPoint veya Word uygulamasının masaüstü sürümüne yüklemek için bir ağ paylaşımı ayarlayabilir ve bildirimi buraya yükleyebilirsiniz. Bu yalnızca bir Windows işletim sisteminde yapılabilir.

Merkezi dağıtımdan sonra bir 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

Bir eklentiyi kaldırma

Yüklemeniz merkezi bir dağıtım kullanıyorsa eklentiyi kaldıramayabilirsiniz. Bu, Microsoft 365 yöneticiniz tarafından kullanılan ilkeye bağlıdır.

Dışarıdan yükleme veya ağ paylaşımı kullanarak eklentileri yükleme

Dışarıdan yükleme ve ağ paylaşımı yüklemesi, test veya deneme amacıyla eklentilere hızlı bir şekilde erişim sağlamak için uygun yollardır. Üretim ve kurumsal ölçekli kullanım durumları için eklentileri dağıtmak için uygun yöntemler değildirler.

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

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

Eklentileri merkezi dağıtım olmadan Excel, PowerPoint veya Word uygulamasının masaüstü sürümüne yüklemek için bir ağ paylaşımı ayarlayabilir ve bildirimi buraya yükleyebilirsiniz. Bu yalnızca bir Windows işletim sisteminde yapılabilir.

Ağ paylaşımı aracılığıyla eklentileri dışarıdan yüklemek için aşağıdaki yönergeleri izleyin. Talimatlar resmi Microsoft belgelerinden uyarlanmıştır. Daha fazla bilgi için bkz. Sideload Office Add-ins for testing from a network share veya diğer Microsoft kaynakları.

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. Örneğin: C:\Qlik Office add-ins

2. Windows Dosya Gezgini'nde, paylaşılan klasör kataloğunuz olarak kullanmak istediğiniz klasörün üst klasörüne veya sürücü harfine gidin. Örneğin: 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. İletişim penceresinde, kendinizi ve eklentinizi paylaşmak istediğiniz diğer kullanıcıları ve/veya grupları ekleyin. Klasör için en az Okuma/Yazma iznine ihtiyacınız olacaktır. Paylaşılacak kişileri 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ın hemen ardından görüntülenen tam ağ yolunu not edin. İletişim penceresini kapatmak için Bitti'ye tıklayın.

   

7. Özellikler iletişim penceresini kapatmak için Kapat'a tıklayın.

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

Aşağıdakileri yapın:

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

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

3. Güven Merkezi'ne tıklayın 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 Güven Merkezi iletişim penceresini kapatmak için Tamam'a tıklayın.

   

8. İletişim penceresini kapatmak için Tamam'a tıklayın.

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

3. Adım: Eklentiyi dışarıdan yükleme

Aşağıdakileri yapın:

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

2. ExcelPowerPoint veya Word uygulamasında, şeridin Giriş sekmesindeki Eklentiler'e tıklayın.

3. Diğer Eklentiler'e tıklayın.

4. Office Eklentileri iletişim kutusunun üst kısmındaki PAYLAŞILAN KLASÖR'e tıklayın.

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

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

Ağ paylaşımı aracılığıyla 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çeriğini silin: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Seçenek 3: Masaüstü macOS uygulamalarında bir eklentiyi dışarıdan yükleme

macOS için eklentiler, Excel, PowerPoint veya Word uygulamalarının 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. Tam talimatlar için resmi Microsoft belgelerine başvurun: Sideload an add-in in Office on Mac

Aşağıdakileri yapın:

1. Bilgisayarınızda Finder 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

   Bilgisayarınızda wef klasörü henüz mevcut olmayabilir. Öyleyse, bu konumda oluşturun.

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

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

6. Şerit sütununda Giriş > Eklentiler'e gidin.

7. Qlik eklentisini seçin.

Qlik eklentisi artık şerit sütununuzda mevcut olmalıdır.

Masaüstü macOS uygulamalarından dışarıdan yüklenen bir eklentiyi kaldırma

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

• Remove a sideloaded add-in

• Clear the Office cache

Sorun Giderme

Bu bölüm, yaygın dağıtım ve yükleme sorunlarını çözmek için ipuçları sağlar.

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

Microsoft Office için bir Qlik eklentisinin dağıtımından sonra kimlik doğrulama sırasında boş iletişim kutusu gösteriliyor

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