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

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

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

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

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

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

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

Microsoft Excel требования к версии

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

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

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

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

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

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

Файл манифеста создается специально для одного Qlik Cloud клиента.

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

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

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

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

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

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

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

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

1. В Консоль управления в Qlik Cloud перейдите в раздел OAuth.

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

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

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

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

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

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

   Результат должен выглядеть так, как показано ниже: https://YourServer/office-add-ins/oAuthLoginSuccess.html

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

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

9. Щелкните Создать.

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

После создания клиента OAuth получите ссылку на обновленный файл манифеста XML из Консоль управления. Перейдите на страницу Параметры выберите Контроль функции > Excel Надстройка в Консоль управления. Используйте эту ссылку для развертывания и установки надстройки.

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

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

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

Централизованное развертывание необходимо использовать, когда:

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

• требуется управлять распространением среди сотрудников организации.

Полный рабочий процесс описан в приведенных ниже разделах с процедурами.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Просмотр, организация и установка надстроек для программ Microsoft 365

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

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

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

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

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

Вариант 1. Установка настройки путем загрузки неопубликованного приложения через Интернет

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

Установка путем загрузки неопубликованного приложения поддерживается веб-версиями Excel, предоставляемыми Microsoft 365.

Установку путем загрузки неопубликованного приложения следует использовать, когда:

• Требуется быстрый доступ к надстройке.

• Требуется протестировать функции надстройки в изолированном порядке.

• Требуется протестировать надстройку без участия администратора Microsoft 365.

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

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

2. Откройте Microsoft Office в Интернете с сайта https://office.live.com/.

3. Откройте новый документ Excel.

4. Откройте вкладку Вставить на ленте и в разделе Надстройки выберите Надстройки Office.

5. В диалоговом окне Надстройки Office перейдите на вкладку МОИ НАДСТРОЙКИ выберите Управление моими надстройками, а затем Загрузить мою надстройку.

6. Щелкните Обзор, чтобы указать файл манифеста надстройки, а затем выберите Загрузить.

7. Если требуется, выполните вход в учетную запись Qlik Cloud.

Удаление надстройки, установленной путем загрузки неопубликованного приложения

Чтобы удалить надстройку, установленную путем загрузки неопубликованного приложения, очистите кэш веб-браузера, в котором используется надстройка.

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

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

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

Этап 1. Создание папки и ее предоставление для совместного использования

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

1. Создайте папку, в которой будет размещаться надстройка Qlik. Например: C:\Qlik Excel add-in

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

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

4. На вкладке «Совместное использование», затем нажмите кнопку Совместное использование....

   

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

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

   

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

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

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

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

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

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

   

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

   

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

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

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

   

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

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

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

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

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

2. В Excel щелкните Мои надстройки на вкладке Вставить ленты.

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

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

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

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

Чтобы удалить надстройку, установленную методом загрузки неопубликованного приложения, удалите содержимое этой папки: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

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

Добавление нескольких надстроек Qlik в Microsoft Excel

Каждую добавленную надстройку Qlik можно использовать для одного Qlik Cloud клиента. Для работы с несколькими клиентами необходимо развернуть манифест надстройки для каждого отдельного клиента.

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

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