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

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

[Deploying and installing the Qlik Add-in for Microsoft Office](https://play.vidyard.com/FM3Fc4mT9h1ouVMGHpT5qy)

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

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

Примечание к информацииДля создания файла манифеста и ссылки требуется конфигурация клиента OAuth. Инструкции смотрите [Подготовьте и получите манифест надстройки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Manifest).

## Что такое Qlik надстройки для Microsoft Office?

Qlik надстройки для Microsoft Office это:

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

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

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

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

## Выберите рабочий процесс установки

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

* Рабочий процесс 1: Централизованное развертывание для управляемого распространения Microsoft 365 администратором. См. [Рабочий процесс 1: Централизованное развертывание](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Centrali).

* Рабочий процесс 2: Загрузка неопубликованных приложений через веб для быстрого тестирования без централизованного развертывания. См. [Рабочий процесс 2: Загрузка неопубликованной надстройки в Интернете](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Workflow2Web).

* Рабочий процесс 3: Установка на настольные Microsoft Office приложения через Windows сетевую папку. См. [Рабочий процесс 3: Установка надстройки на настольные Microsoft Office приложения с использованием Windows сетевой папки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Workflow3Windows).

* Рабочий процесс 4: Боковая загрузка на настольные macOS приложения. См. [Рабочий процесс 4: Загрузка неопубликованной надстройки в настольные macOS приложения](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Workflow4Mac).

Рабочий процесс 1 является рекомендуемым вариантом для производственных развертываний. Рабочие процессы 2–4 лучше всего подходят для тестирования, пробного использования или изолированных пользовательских настроек.

Qlik кнопка надстройки в веб-версии Microsoft Excel

Qlik кнопка надстройки в веб-версии Microsoft Excel

QlikQlik кнопка надстройки в веб-версии Microsoft ExcelMicrosoft Excel ![Панель ленты в Microsoft Excel со значком надстройки Qlik, который указывает на то, что надстройка активирована](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_QlikIconInRibbon.png)

Для получения дополнительной информации см. раздел [Разработка шаблонов отчетов с Qlik надстройками для Microsoft Office](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm).

## Перед началом работы

Эти шаги применимы ко всем рабочим процессам установки.

* Убедитесь, что вы и ваши пользователи соответствуют системным и программным требованиям.

  [Системные и программные требования](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#SystemReqsAddIns)

* Создайте клиент OAuth в Qlik Cloud.

  [Создать OAuth-клиент](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Creating)

* Получите файл манифеста или ссылку.

  [Подготовьте и получите манифест надстройки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Manifest)

### Требование 1: Соответствие системным и программным требованиям

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Системные и программные требования

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

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

Чтобы установить и использовать 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](https://learn.microsoft.com/en-us/javascript/api/requirement-sets/excel/excel-api-requirement-sets?view=common-js-preview).

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

Пример сообщения об ошибке во время установки надстройки

Пример сообщения об ошибке во время установки надстройки

Пример сообщения об ошибке во время установки надстройки ![Сообщение об ошибке во время установки надстройки Qlik Excel о том, что используемая версия Microsoft Excel слишком старая и не поддерживает надстройку](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_ExcelVersionError.png)

Может потребоваться щелкнуть белую область справа в 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 или более поздней версии

### Требование 2: Создайте клиент OAuth

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Создать OAuth-клиент

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

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

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

1. В Qlik Cloud, нажмите the Открыть меню навигации icon в верхнем левом углу.

2. Выберите Администрирование.

3. Перейти к OAuth.

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

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

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

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

   Полное описание каждой доступной области см. в [Доступные области OAuth](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#Availabl).

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

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

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

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

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

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

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

### Требование 3: Подготовьте и получите манифест надстройки

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

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

Вы устанавливаете Qlik надстройки для Microsoft Office в среде Microsoft, используя файл манифеста XML или ссылку на него.

* Для централизованного развертывания манифест часто требуется предоставить в виде URL-адреса.

* Для самостоятельно управляемых установок манифест часто предоставляется в виде файла.

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

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

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

1. Создайте клиент OAuth в клиенте Qlik Cloud, используя необходимую конфигурацию. Полные инструкции см. [Создать OAuth-клиент](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Creating).

2. В Qlik Cloud, нажмите the Открыть меню навигации icon в верхнем левом углу.

3. Выберите Администрирование.

4. Перейдите в Настройки.

5. В разделе Общий доступ и отчеты перейдите к Qlik надстройки для Microsoft Office.

6. В раскрывающемся меню выберите конфигурацию клиента OAuth, настроенную для активации OAuth в надстройке.

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

## Рабочий процесс 1: Централизованное развертывание

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

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

Примечание к информацииПри централизованном развертывании надстройки устанавливаются для Excel, PowerPoint, и Word. Нет возможности устанавливать надстройки по отдельности.

Используйте этот рабочий процесс, когда:

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

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

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

Заполните следующие разделы по порядку.

### Развертывание и установка с помощью Центра администрирования Microsoft 365

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

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

1. Получите файл манифеста надстройки или URL-ссылку на манифест после создания клиента OAuth. См. [Подготовьте и получите манифест надстройки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Manifest).

2. Распространите надстройку, следуя инструкциям в официальной документации Microsoft: [Разверните и опубликуйте надстройки Office](https://learn.microsoft.com/en-us/office/dev/add-ins/publish/publish). Обратите внимание, что распределение в рамках централизованного развертывания возможно только с помощью центра администрирования Microsoft 365.

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

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

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

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

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

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

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

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

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

[Просмотр, управление и установка надстроек для Excel, PowerPoint и Word](https://support.microsoft.com/en-gb/office/view-manage-and-install-add-ins-for-excel-powerpoint-and-word-16278816-1948-4028-91e5-76dca5380f8d)

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

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

## Рабочие процессы 2-4: Варианты установки с самостоятельным управлением

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

Примечание к предупреждениюДля самостоятельной установки надстроек с использованием неопубликованной установки (sideloading) или сетевой папки вам могут потребоваться разрешения от вашей организации и на вашем локальном компьютере. Эти разрешения могут управляться вашей организацией или Microsoft 365 администратором. Если вы не можете самостоятельно установить надстройку, обратитесь к [официальной документации Microsoft по надстройкам Office](https://learn.microsoft.com/en-us/office/dev/add-ins/), или свяжитесь с системным администратором.

Примечание к предупреждениюОтсутствуют ограничения по загрузке манифеста и установке надстроек путем загрузки неопубликованных приложений. Манифест можно установить, даже если отсутствует доступ к Qlik Cloud. Однако после установки немедленно появляется запрос на вход в Qlik Cloud. Надстройки не будут работать, если не выполнен вход.

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

В Office 365 Government Community Cloud High (GCCH) надстройки Qlik для Microsoft Office можно установить только через [централизованное развертывание](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Centrali). Установка путем загрузки неопубликованных приложений (sideloading) или через сетевой ресурс не поддерживается.

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

### Рабочий процесс 2: Загрузка неопубликованной надстройки в Интернете

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Рабочий процесс 2: Загрузка неопубликованной надстройки в Интернете

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

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

Используйте этот рабочий процесс, когда:

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

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

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

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

1. Подготовьте и загрузите файл манифеста. См. [Подготовьте и получите манифест надстройки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Manifest).

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

3. Откройте новый документ Excel, PowerPoint или Word.

4. На вкладке Главная нажмите Надстройки.

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

6. В диалоговом окне Надстройки Office нажмите Загрузить мою надстройку.

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

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

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

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

### Рабочий процесс 3: Установка надстройки на настольные Microsoft Office приложения с использованием Windows сетевой папки

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Рабочий процесс 3: Установка надстройки в настольные Microsoft Office приложения с использованием Windows сетевой папки

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

Следуйте приведенным ниже инструкциям по установке надстроек путем загрузки неопубликованных приложений через сетевой ресурс. Инструкции разработаны путем адаптации на основе официальной документации Microsoft. Для получения дополнительной информации см. документ [Загрузка неопубликованных надстроек Office для тестирования из сетевой папки](https://learn.microsoft.com/en-us/office/dev/add-ins/testing/create-a-network-shared-folder-catalog-for-task-pane-and-content-add-ins) или другие ресурсы Microsoft.

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

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

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

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

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

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

   Кнопка Совместное использование...

   Кнопка Совместное использование...

   Кнопка Совместное использование...Совместное использование... ![Кнопка «Совместное использование...» при настройке общей папки Windows](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_SideloadNetworkShare_Share.png)

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

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

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

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

   Подтверждение успешной настройки общего доступа к папке с указанием полного пути ![Диалоговое окно «Сетевой доступ»: подтверждение успешной настройки общего доступа к папке с указанием полного пути](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_SideloadNetworkShare_ShareConfirmation.png)

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

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

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

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

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

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

   Кнопка Параметры центра управления безопасностью...

   Кнопка Параметры центра управления безопасностью...

   Кнопка Параметры центра управления безопасностью...Параметры центра управления безопасностью... ![Кнопка «Параметры центра управления безопасностью...» в параметрах Microsoft Excel](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_SideloadNetworkShare_TrustCenterSettings.png)

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

   Вкладка Доверенные каталоги надстроек

   Вкладка Доверенные каталоги надстроек

   Вкладка Доверенные каталоги надстроекДоверенные каталоги надстроек ![Кнопка «Доверенные каталоги надстроек» в Центре доверия Microsoft Excel](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_SideloadNetworkShare_TrustedCatalogs.png)

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

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

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

   Вкладка Доверенные каталоги надстроек в диалоговом окне «Центр доверия» с указанием пути к вновь добавленному каталогу

   Вкладка Доверенные каталоги надстроек в диалоговом окне «Центр доверия» с указанием пути к вновь добавленному каталогу

   Вкладка Доверенные каталоги надстроекДоверенные каталоги надстроек в диалоговом окне «Центр доверия» с указанием пути к вновь добавленному каталогу ![Вкладка «Доверенные каталоги надстроек» с указанием пути к вновь добавленному каталогу](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_SideloadNetworkShare_CatalogURL.png)

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\

### Рабочий процесс 4: Загрузка неопубликованной надстройки в настольные macOS приложения

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Рабочий процесс 4: Загрузка неопубликованной надстройки в настольные приложения macOS

Для macOS надстройки можно установить в Microsoft 365 настольных версиях Excel, PowerPoint или Word. Для ознакомления с требованиями к системе и программному обеспечению см. раздел [Системные и программные требования](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#SystemReqsAddIns).

Придерживайтесь приведенных ниже рекомендаций. Инструкции разработаны путем адаптации на основе официальной документации Microsoft. Полные инструкции см. в официальной документации Microsoft: [Загрузка надстройки в обход магазина в Office на Mac](https://learn.microsoft.com/en-us/office/dev/add-ins/testing/sideload-an-office-add-in-on-mac#sideload-an-add-in-in-office-on-mac)

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

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

2. Нажмите следующее сочетание клавиш: Command+Shift+G

   Откроется меню Перейти к папке.

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

   * Excel: /Users/&lt;username&gt;/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   * PowerPoint: /Users/&lt;username&gt;/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   * Word: /Users/&lt;username&gt;/Library/Containers/com.microsoft.Word/Data/Documents/wef

   Может случиться, что на компьютере пока нет папки wef. В таком случае ее необходимо создать.

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

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

6. В строке ленты выберите Главная &gt; Надстройки.

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

Теперь надстройка Qlik должна появиться в строке ленты.

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

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

* [Удаление надстройки, установленной путем загрузки неопубликованного приложения](https://learn.microsoft.com/en-us/office/dev/add-ins/testing/sideload-an-office-add-in-on-mac#remove-a-sideloaded-add-in)

* [Очистить Office кэш](https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache)

## Добавление нескольких Qlik надстроек в Excel, PowerPoint, или Word

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

Поведение и ограничения следующие:

* В вашем Excel, PowerPoint или Word приложении поддерживается только одна надстройка (подключенная к одному Qlik Cloud клиенту) для использования в один момент времени.

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

* Наличие Qlik надстройки, [централизованно развернутой](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Centrali) для одного Qlik Cloud клиента, может помешать вам загружать эту надстройку неопубликованным способом для других клиентов.

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

* В Office 365 Government Community Cloud High (GCCH) надстройки Qlik для Microsoft Office можно установить только через [централизованное развертывание](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Centrali). Установка путем загрузки неопубликованных приложений (sideloading) или через сетевой ресурс не поддерживается. Office 365 GCC и GCCH поддерживают работу с одним Qlik Cloud для правительства или Qlik Cloud Government ― DoD клиентом одновременно.

## Поиск и устранение неисправностей

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

Для получения дополнительных советов по устранению неполадок см. раздел [Устранение неполадок — отчеты в приложении](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Troubleshooting/troubleshooting-reporting.htm).

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Пустое диалоговое окно, отображаемое во время аутентификации после развертывания надстройки 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](https://learn.microsoft.com/en-us/office/dev/add-ins/develop/dialog-best-practices)

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

#### Всплывающие окна запрещены при первом открытии надстройки Qlik для Microsoft Office

При первом открытии надстройки Qlik для Microsoft Office после ее активации может появиться следующее сообщение об ошибке:

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

Ваш веб-браузер блокирует открытие диалогового окна аутентификации надстройки в виде всплывающего окна.

Если вы используете веб-версию Microsoft Office приложения, вам необходимо разрешить браузеру открывать всплывающие окна. Это зависит от вашего браузера и его версии, но возможные решения включают:

* Выбор опции в адресной полосе для разрешения всплывающих окон.

* Открытие настроек браузера и выбор опции для разрешения всплывающих окон.

## Подробнее

* [Создание клиентов OAuth и управление ими](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm)