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

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

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

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

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

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

• Установка путем загрузки неопубликованного приложения: Установка надстроек путем загрузки неопубликованных приложений или с использованием общего сетевого ресурса

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

Требования к системе и программному обеспечению

Примечание о Qlik Cloud для правительства

Qlik надстройки для Microsoft Office позволяют разрабатывать шаблоны отчетов для приложений в клиентах Qlik Cloud для правительства или Qlik Cloud Government ― DoD. Надстройки доступны только для Office 365 Commercial.

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

Надстройка Qlik для Microsoft Excel

Для Windows установок:

• Windows 10 1903 или более поздней версии

• Microsoft 365 16.0.11629 или более поздней версии

Для macOS установок:

• macOS 14 или более поздней версии

• Microsoft 365 16.83 или более поздней версии

Также, чтобы запустить надстройку Qlik для Microsoft Excel, должен быть установлен экземпляр Microsoft Excel с ExcelAPI 1.9 или более поздней версии. Чтобы проверить, соответствует ли установленный экземпляр требованиям Excel, см. официальную документацию Microsoft в разделе Наборы требований к Excel JavaScript API.

Если используется ExcelAPI более ранней версии, чем указана в минимальных требованиях, появляется ошибка с сообщением, что для работы надстройки Qlik требуется более новая версия Microsoft Excel.

Может потребоваться щелкнуть белую область справа в Microsoft Excel и нажмите клавишу F5, чтобы обновить страницу и увидеть ошибку.

Если эта ошибка появилась, установите более новую версию Microsoft Excel.

Надстройка Qlik для Microsoft PowerPoint

Для Windows установок:

• Windows 10 1903 или более поздней версии

• Microsoft 365 версии 2504 (сборка 18730.20030) или выше

Для macOS установок:

• macOS 14 или более поздней версии

• Microsoft 365 16.96 или более поздней версии

Надстройка Qlik для Microsoft Word

Для Windows установок:

• Windows 10 1903 или более поздней версии

• Microsoft 365 версии 2208 (сборка 15601.20148) или выше

Для macOS установок:

• macOS 14 или более поздней версии

• Microsoft 365 16.64 или более поздней версии

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

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

Файл манифеста создается специально для одного 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.

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

Установка путем загрузки неопубликованного приложения или с использованием общего сетевого ресурса позволяет быстро получить доступ к надстройкам для тестирования и ознакомления. Эти способы не подходят для развертывания надстроек в рабочей среде и в корпоративных масштабах.

В зависимости от используемой версии 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. В ExcelPowerPoint или Word нажмите Надстройки на вкладке Главная ленты.

3. Нажмите Дополнительные надстройки.

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

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

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

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

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

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

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

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

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

Придерживайтесь приведенных ниже рекомендаций. Инструкции разработаны путем адаптации на основе официальной документации 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