Развертывание и установка надстроек Qlik для Microsoft Office

Разверните и установите надстройки Qlik для Microsoft Office, чтобы пользователи в вашей организации могли создавать шаблоны отчетов. Загрузите шаблоны отчетов, созданные с помощью надстроек, в приложение Qlik Cloud для создания выходного файла отчета из задач отчета.

Надстройки Qlik для Microsoft Office можно развернуть и установить для совместимых веб- и настольных версий Excel, PowerPoint и Word в Microsoft 365.

Надстройки устанавливаются с помощью файла манифеста. Этот файл манифеста необходим администратору Microsoft 365 (или, возможно, пользователю при определенных методах установки), чтобы развернуть и установить надстройки для себя или пользователей в своей организации. Файл манифеста позволяет устанавливать надстройки для одного клиента Qlik Cloud.

После получения файла манифеста или URL-адреса существует два различных метода развертывания и установки надстроек:

• Централизованное развертывание: Централизованное развертывание, установка и активация

• Загрузка неопубликованного приложения (sideloading): Установка надстроек с помощью загрузки неопубликованного приложения (sideloading) или сетевого ресурса

Для получения дополнительной информации см. Разработка шаблонов отчетов с Qlik надстройками для Microsoft Office.

Подготовка и получение манифеста надстройки

Установка надстроек Qlik для Microsoft Office в среде Microsoft выполняется с помощью файла манифеста. Это файл XML. Для централизованного развертывания URL-адрес файла манифеста, скорее всего, должен быть предоставлен администратором Microsoft.

Файл манифеста специфичен для одного клиента Qlik Cloud. Один и тот же файл манифеста используется для установки надстроек для Excel, PowerPoint и Word.

Для установки надстройки требуется конфигурация клиента OAuth. После настройки клиента OAuth получите ссылку на файл манифеста, а также сам файл манифеста в центре активности Администрирование.

Выполните следующие действия.

1. Создайте клиент OAuth в клиенте Qlik Cloud, используя требуемую конфигурацию. Полные инструкции см. в разделе Создание клиентов OAuth для надстроек Qlik для Microsoft Office.

2. Перейдите в центр активности Администрирование и сгенерируйте ссылку на манифест. Вы также можете загрузить файл манифеста напрямую для альтернативных вариантов использования. См. Управление манифестами установки для надстроек Qlik для Microsoft Office.

Создание клиентов OAuth для надстроек Qlik для Microsoft Office

Чтобы установить Qlik надстройки для Microsoft Office, требуется конфигурация клиента OAuth. Надстройки используются разработчиками отчетов для подготовки шаблонов отчетов для отчетности в приложении с помощью Qlik Cloud.

Чтобы в надстройках работал протокол OAuth, необходимо настроить клиент OAuth, в точности соблюдая приведенную ниже конфигурацию.

Выполните следующие действия.

1. В центре активности Администрирование в Qlik Cloud выберите OAuth.

2. Нажмите Создать.

3. В раскрывающемся списке Тип клиента выберите Одностраничное приложение. Появятся дополнительные поля.

4. Вставьте Имя. По желанию заполните поле Описание

5. Как минимум, установите флажок, чтобы включить область user_default. В конфигурацию можно включить другие области, но без user_default установленный экземпляр работать не будет.

   Полное описание каждой доступной области см. в Доступные области действия OAuth.

6. В поле Добавить URL-адреса перенаправления вставьте URL-адрес Qlik Cloud клиента, за которым следует эта фиксированная строка: /office-add-ins/oAuthLoginSuccess.html

   Результат должен выглядеть так, как показано ниже: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Например: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Щелкните команду Добавить.

8. В поле Добавление разрешенных источников вставьте URL-адрес клиента и нажмите кнопку Добавить.

9. Нажмите Создать.

10. Откроется окно Копирование идентификатора клиента. По желанию можно скопировать идентификатор клиента в буфер обмена или нажать кнопку Готово, чтобы закрыть окно.

После создания клиента OAuth получите ссылку на обновленный манифест XML из центра активности Администрирование. Перейдите на страницу Настройки и выберите вкладку Электронная почта и отчеты. В разделе Общий доступ и отчеты выберите надстройки Qlik для Microsoft Office. Используйте предоставленную ссылку для развертывания и установки надстройки.

Централизованное развертывание, установка и активация

Рекомендуется предоставлять доступ к надстройкам Qlik для Microsoft Office с помощью централизованного развертывания и установки. Централизованное развертывание требует действий от администратора Microsoft 365 в вашей организации.

При централизованном развертывании манифест надстройки загружается в центр администрирования Microsoft 365 вашей организации и распространяется среди пользователей как предварительно настроенная установка. Распространение может быть ограничено членами определенных групп безопасности.

Вам следует использовать централизованное развертывание, если:

• Вы хотите, чтобы надстройка была постоянно установлена для членов вашей организации

• Вы хотите управлять распространением среди членов вашей организации

Для ознакомления с полным рабочим процессом следуйте процедурным разделам ниже.

Централизованное развертывание и установка

Централизованное развертывание выполняется системным администратором Microsoft 365.

Выполните следующие действия.

1. Получите файл манифеста надстройки или URL-адрес манифеста после создания клиента OAuth. См. Подготовка и получение манифеста надстройки.

2. Распространите надстройку в соответствии с официальной документацией Microsoft: Развертывание и публикация надстроек Office. Обратите внимание, что распространение через централизованное развертывание возможно только с использованием центра администрирования Microsoft 365.

С помощью описанной выше процедуры надстройки устанавливаются для пользователей, которым предоставлен к ним доступ. Затем пользователи активируют надстройки в своей версии Excel, PowerPoint или Word.

Чтобы установить надстройки в настольной версии Excel, PowerPoint или Word без централизованного развертывания, вы можете настроить сетевой ресурс и загрузить в него манифест. Это можно сделать только в операционной системе Windows.

Активация надстройки после централизованного развертывания

После того как администратор Microsoft установит надстройку Qlik для организации, можно активировать и использовать ее при наличии соответствующего доступа.

В зависимости от версии вашего Microsoft Office приложения, эти действия могут незначительно отличаться. Полные сведения приводятся в официальной документации Microsoft.

Выполните следующие действия.

1. Откройте локальную или веб-версию Excel, PowerPoint или Word.

2. Выберите Главная > Надстройки > Получить надстройки.

3. На вкладке ПОД УПРАВЛЕНИЕМ АДМИНИСТРАТОРА в диалоговом окне выберите надстройку Qlik.

Значок надстройки Qlik добавляется на панель ленты.

Просмотр, управление и установка надстроек для Excel, PowerPoint и Word

Удаление надстройки

Если в вашей установке используется централизованное развертывание, возможно, вы не сможете удалить надстройку. Это зависит от политики, используемой вашим администратором Microsoft 365.

Установка надстроек с помощью загрузки неопубликованного приложения (sideloading) или сетевого ресурса

Загрузка неопубликованного приложения и установка через сетевой ресурс — это подходящие способы быстрого получения доступа к надстройкам для тестирования или ознакомления. Они не являются подходящими методами для развертывания надстроек в производственных средах и сценариях использования в масштабах предприятия.

В зависимости от вашей версии Excel, PowerPoint или Word, а также других факторов, надстройки, загруженные этими методами, могут в конечном итоге быть удалены с вашей ленты. Когда это произойдет, повторно загрузите манифест в приложение Microsoft Office.

Вариант 2: Установка надстройки в настольных приложениях Microsoft Office с использованием сетевого ресурса Windows

Чтобы установить надстройки в настольной версии Excel, PowerPoint или Word без централизованного развертывания, вы можете настроить сетевой ресурс и загрузить в него манифест. Это можно сделать только в операционной системе Windows.

Следуйте приведенным ниже рекомендациям для загрузки неопубликованных надстроек через сетевой ресурс. Инструкции адаптированы из официальной документации Microsoft. Для получения дополнительной информации см. Загрузка неопубликованных надстроек Office для тестирования из сетевой папки или другие ресурсы Microsoft.

Шаг 1: Создание и предоставление общего доступа к папке

Выполните следующие действия.

1. Создайте папке для размещения надстройки Qlik. Например: C:\Qlik Office add-ins

2. В проводнике Windows перейдите к родительской папке или букве диска папки, которую вы хотите использовать в качестве каталога общих папок. Например: C:\

3. Щелкните папку правой кнопкой мыши и выберите Свойства.

4. Откройте вкладку «Доступ» и нажмите кнопку Общий доступ....

   

5. В диалоговом окне добавьте себя и любых других пользователей и/или группы, с которыми вы хотите поделиться своей надстройкой. Вам потребуется как минимум разрешение на чтение/запись для папки. После того как вы закончите выбор людей, с которыми хотите поделиться, нажмите Поделиться.

6. Когда вы увидите подтверждение того, что к вашей папке предоставлен общий доступ, обратите внимание на полный сетевой путь, который отображается сразу после имени папки. Нажмите Готово, чтобы закрыть диалоговое окно.

   

7. Нажмите Закрыть, чтобы закрыть диалоговое окно Свойства.

Шаг 2: Настройка общей папки в качестве доверенного каталога вручную

Выполните следующие действия.

1. Откройте новую пустую книгу в настольной версии Excel, PowerPoint или Word.

2. Перейдите на вкладку Файл, а затем нажмите Параметры в левом нижнем углу.

3. Нажмите Центр управления безопасностью, а затем нажмите кнопку Параметры центра управления безопасностью....

   

4. Нажмите Доверенные каталоги надстроек.

   

5. В поле URL-адрес каталога введите полный сетевой путь к папке, к которой вы ранее предоставили общий доступ.

6. Нажмите Добавить каталог.

7. Установите флажок Показывать в меню для только что добавленного элемента, а затем нажмите ОК, чтобы закрыть диалоговое окно центра управления безопасностью.

   

8. Нажмите ОК, чтобы закрыть диалоговое окно.

9. Закройте и снова откройте приложение, чтобы изменения вступили в силу.

Шаг 3: Загрузка неопубликованной надстройки

Выполните следующие действия.

1. Добавьте файл манифеста надстройки XML в общую папку.

2. В Excel, PowerPoint или Word нажмите Надстройки на вкладке Главная на ленте.

3. Нажмите Другие надстройки.

4. Нажмите ОБЩАЯ ПАПКА в верхней части диалогового окна Надстройки Office.

5. Выберите Qlik, чтобы вставить надстройку.

6. Вы можете увидеть диалоговое окно с примерно следующим текстом: Qlik хочет отобразить новое окно. Нажмите Разрешить.

Удаление надстройки, установленной через сетевой ресурс

Выполните следующие действия.

1. Если у вас открыт Excel, PowerPoint или Word, закройте его.

2. Удалите содержимое этой папки: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Вариант 3: Загрузка неопубликованной надстройки в настольных приложениях macOS

Для macOS надстройки можно установить в настольных версиях Excel, PowerPoint или Word в Microsoft 365. Требования к системе и программному обеспечению см. в разделе Требования к системе и программному обеспечению.

Следуйте приведенным ниже рекомендациям. Инструкции адаптированы из официальной документации Microsoft. Полные инструкции см. в официальной документации Microsoft: Загрузка неопубликованной надстройки в Office на Mac

Выполните следующие действия.

1. Откройте приложение Finder на вашем компьютере.

2. Введите следующую комбинацию клавиш: Command+Shift+G

   Откроется меню Переход к папке.

3. Введите один из следующих путей в зависимости от приложения Microsoft Office:

   • 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 еще не существует на вашем компьютере. Если это так, создайте ее в этом расположении.

4. В папку wef добавьте копию файла манифеста XML.

5. Откройте Excel, PowerPoint или Word. Если оно уже открыто, вам потребуется перезапустить его.

6. На ленте перейдите к Главная > Надстройки.

7. Выберите надстройку Qlik.

Надстройка Qlik теперь должна быть доступна на вашей ленте.

Удаление неопубликованной надстройки из настольных приложений macOS

Чтобы удалить надстройку Qlik, вам необходимо очистить кэш Office на вашем компьютере. Для получения дополнительной информации см.:

• Удаление неопубликованной надстройки

• Очистка кэша Office

Устранение неполадок

В этом разделе приведены советы по устранению распространенных проблем с развертыванием и установкой.

Дополнительные советы по устранению неполадок см. в разделе Устранение неполадок — отчеты в приложении.

Пустое диалоговое окно, отображаемое во время аутентификации после развертывания надстройки Qlik для Microsoft Office

Когда пользователь пытается выполнить вход в надстройку для отчетов для Microsoft Excel, Microsoft PowerPoint или Microsoft Word, может открыться пустое всплывающее окно проверки подлинности. Или может появиться ошибка в диалоговом окне (в частности, 12006).

Чтобы пользователь мог работать с надстройкой Qlik для Microsoft Office, при выполнении потока проверки подлинности выполняется перенаправление между вашим клиентом и поставщиком удостоверений, размещенных на другом домене. Поставщик удостоверений задает Cross-Origin-Opener-Policy с ограничительными настройками. В результате этого проверка подлинности блокируется на этапе взаимодействия между доменами, что предотвращает правильную передачу данных для входа в надстройку.

Предлагаемые меры  

Администратор сети, ответственный за настройку поставщиков удостоверений, должен выполнить следующие действия.

Выполните следующие действия.

• Задайте заголовок ответа, направляемого поставщиком удостоверений в диалоговое окно:

  Cross-Origin-Opener-Policy: unsafe-none

Для получения дополнительной информации см. официальную документацию Microsoft: Рекомендации и правила Office Dialog API