# Использование переменных и выражений в шаблонах отчетов с надстройками Qlik для Microsoft Office

Добавляйте переменные и выражения в качестве объектов отчета в шаблон отчета Excel, PowerPoint или Word. Можно использовать переменную или выражение для динамического сохранения значения, которое можно централизованно модифицировать и повторно использовать в отчете.

[Using variables in a report template](https://play.vidyard.com/Vndm4GuDFYLCC12mP7Ez52)

## Применяется к

Это содержимое применяется к следующим типам Qlik Cloud шаблонов отчетов:

* Excel

  [Надстройка Qlik для Microsoft Excel](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Excel)

* PowerPoint

  [Надстройка Qlik для Microsoft PowerPoint](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#PowerPoint)

* Word

  [Надстройка Qlik для Microsoft Word](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Word)

## Переменные

Можно вставлять переменные из Qlik Sense в шаблон. Как и другие создаваемые объекты шаблона, переменная добавляется в виде объекта в конфигурацию шаблона и доступна из окна надстройки. Добавьте экземпляр объекта переменной в виде тега переменной.

Можно добавлять и переменные скрипта и переменные, определенные в виде листа.

### Добавление переменной

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

1. Щелкните значок the Переменные icon на верхней панели инструментов надстройки.

2. Щелкните Добавить переменную. Появится список переменных.

   Вкладка Переменные и выражения в надстройке, где можно добавить новую переменную или пересмотреть уже добавленную переменную

   Вкладка Переменные и выражения в надстройке, где можно добавить новую переменную или пересмотреть уже добавленную переменную

   Вкладка Переменные и выраженияПеременные и выражения в надстройке, где можно добавить новую переменную или пересмотреть уже добавленную переменную ![Вкладка «Переменные и выражения» в надстройке, где можно изменять существующие объекты переменных, которые вы добавили, или добавлять новую переменную](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_AddVariable.png)

3. Щелкните значок the Символ «плюс» icon справа от существующей переменной приложения, чтобы добавить ее.

   Выберите переменную, которую требуется добавить в шаблон

   Выберите переменную, которую требуется добавить в шаблон

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

4. Тег переменной вставлен. Откроется страница параметров для переменной. В области Выражение можно открыть предварительный просмотр текущего значения переменной.

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

5. По необходимости настройте другие параметры.

В любой момент пересматривайте любую добавленную переменную для внесения изменений в ее конфигурацию, для определения ее места в файле Excel, PowerPoint или Word, или для добавления еще одного ее экземпляра. Щелкните значок the Переменные icon в надстройке, чтобы открыть целевую страницу Переменные и выражения, и щелкните the Стрелка вправо icon, чтобы перейти к области, куда она вставляется. По необходимости настраивайте параметры в надстройке.

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

* [Форматирование переменной или выражения](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Formatti)

* [Удаление переменной или выражения](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Removing)

## Выражения

Добавление выражений в качестве объектов с использованием синтаксиса и функций Qlik Sense. Как и другие создаваемые объекты шаблона, выражение добавляется в виде объекта в конфигурацию шаблона и доступно из окна надстройки. Добавьте экземпляр объекта выражения в качестве тега выражения.

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

* `=Count(distinct <your dimension field>)`: возвращает несколько уникальных значений для поля измерения, определенного в выражении (например, `Customer` или `Product`).

* `=today()`: возвращает текущую дату.

* `=year(now)`: возвращает текущий год.

### Добавление выражения

1. Щелкните значок the Переменные icon на верхней панели инструментов надстройки.

2. Щелкните Добавить выражение. Появится список доступных переменных.

   Вкладка Переменные и выражения в надстройке, где можно добавить новое выражение или пересмотреть добавленное ранее

   Вкладка Переменные и выражения в надстройке, где можно добавить новое выражение или пересмотреть добавленное ранее

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

3. Щелкните значок the Символ «плюс» icon справа от существующего выражения, чтобы добавить ее. Выполните эти же действия для добавления существующего значения: [Добавление переменной](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Adding).

4. Если вместо этого необходимо создать новое выражение, щелкните Создать выражение.

5. Настройте новое выражение, добавив Имя и Описание (необязательно), а затем определите Выражение.

   Выберите переменную, которую требуется добавить в шаблон

   Выберите переменную, которую требуется добавить в шаблон

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

6. Проверьте значение параметра Предварительный просмотр под полем Выражение и убедитесь, что выражение настроено правильно, затем нажмите кнопку Создать.

Создается объект выражения, который будет доступен в окне надстройки. Тег выражения также вставляется в выбранном местоположении.

В любой момент пересматривайте добавленные выражения для внесения изменений в конфигурацию, для определения его места в файле Excel, PowerPoint или Word, или для добавления еще одного его экземпляра. Щелкните значок the Переменные icon в надстройке, чтобы открыть целевую страницу Переменные и выражения, затем щелкните the Стрелка вправо icon, чтобы перейти к области, куда он вставлен. По необходимости настраивайте параметры в надстройке.

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

* [Форматирование переменной или выражения](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Formatti)

* [Удаление переменной или выражения](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Removing)

## Форматирование переменной или выражения

Применяйте встроенное форматирование Excel, PowerPoint или Word к тегам переменной и выражения. С его помощью можно настраивать стиль шрифта, форматирование чисел и другие параметры. Форматирование применяется к выходному файлу отчета.

## Удаление переменной или выражения

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

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

1. Выберите область, куда добавлен объект.

2. Щелкните Удалить в нижней части окна надстройки.

В результате этого удаляются теги и объект из соответствующего списка объектов.

Если вместо этого для удаления объекта используются функции Microsoft Office, он не будет вставляться в создаваемый отчет. Однако объект все равно будет отображаться в списке добавленных объектов. Это значит, что объект можно будет без труда добавить позже.

## Подробнее

* [Добавление содержимого в шаблоны отчетов с помощью надстроек Qlik для Microsoft Office](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-content.htm)

* [Работа с уровнями и страницами в шаблонах табличных отчетов](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/Excel/add-in-excel-levels-pages.htm)

* [Использование переменных в выражениях](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)

* [Работа с переменными в редакторе загрузки данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/work-with-variables-in-data-load-editor.htm)