# Настроить источники данных и таблицу отчёта

> [HTML Version](set-report-sources.html)

**Источник** — это компонент системы, данные из которого будут отображаться на странице отчёта в виде таблицы. В отчёт можно добавить несколько компонентов и связать их между собой. В качестве источников могут выступать: 

- системные и пользовательские приложения типа [Стандартное](360006963072.md), [Событие](360028290132.md), [Документ](/ru/help/platform/360009923631.html) из любых разделов;

- системные и пользовательские бизнес-процессы системы. 

Использование [контракта](contract.md) как источника для отчёта недоступно. Указать один отчёт источником для другого также нельзя.

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

- приложение — приложение;

- бизнес-процесс — приложение;

- бизнес-процесс — бизнес-процесс.  

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

Перед добавлением источников в отчёт определите, по каким полям они будут связываться между собой. Создайте эти поля в контексте источников и включите для них [опцию поиска и сортировки](360028941112.md#search). 

С доступными способами объединения источников и типами полей для связи можно ознакомиться в статье [«Связать источники и отладить отчёт».](bind-report-apps.md) 

## Выбрать источники данных

1. Откройте отчёт и в центре страницы нажмите кнопку **Добавить источник**. 

2. В правом верхнем углу открывшейся страницы нажмите **+ Источник данных**.

3. Укажите название источника и выберите компонент из любого раздела системы:

**(report-app-4.png)**

- **Имя\*** — укажите название источника, которое будет отображаться на странице настроек отчёта;

- **Тип источника данных** — добавьте компонент системы, контекст которого необходимо отобразить в отчёте: приложение или бизнес-процесс;

- **Источник данных\*** — выберите любое приложение или процесс в системе;

- **Ссылка на элемент приложения** — опция доступна для источника типа **Приложение**. Когда опция включена, в таблицу отчёта можно добавить поле **Название** из контекста приложения, и оно будет отображаться в виде ссылки на элемент. Нажав на ссылку, пользователи смогут перейти в карточку элемента, добавленного в отчёт. 

4. Нажмите **Сохранить**.

5. Таким образом добавьте все источники, данные из которых необходимо отображать в таблице отчёта. 

Добавить в отчёт можно более двух компонентов системы. Чтобы корректно настроить отчёт, для каждого источника создаётся хотя бы одна связь с другим источником. 

После того как вы указали все источники, настройте колонки таблицы отчёта. 

## Добавить колонки таблицы

Каждая колонка таблицы в отчёте — это добавленное свойство из контекста указанного источника.

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

Добавленные в виде колонок свойства, для которых включена [опция поиска и сортировки](360028941112.md#search), используются в качестве фильтров для поиска на готовой странице отчёта.

Чтобы добавить данные в таблицу, выполните следующие действия: 

1. Напротив названия источника нажмите **Добавить колонку**. 

**(report-app-5.png)**

2. Заполните поля в открывшемся окне:

**(report-app-6.png)**

- **Источник данных** — в поле отображается название выбранного источника;

- **Поле **— из контекста приложения или процесса, указанного в качестве источника;

- **Код поля**, **Тип поля** — значения заполняются автоматически в соответствии с выбранным полем из контекста источника;  

- **Имя колонки\*** — укажите, как будет называться отображаемая в таблице колонка; 

- **Код колонки\*** — код необходим для [экспорта данных из колонки](report-export.md) и используется при составлении шаблона для выгрузки таблицы. Поле заполняется автоматически по указанному имени колонки. Значение можно изменить вручную, чтобы код каждой добавленной в отчёт колонки был уникальным; 

- **Агрегация** — опция позволяет применять функции агрегации к данным из источника для создания сводных таблиц или статистики. Выбрать можно: **суммирование**, **подсчёт количества, отображение среднего значения, максимума **или **минимума**. В колонке таблицы будет отображаться не указанное в поле значение, а результат группировки записей из нескольких элементов или экземпляров, соответствующий заданному условию. Например, вы можете агрегировать данные о заказах для каждого месяца или подсчитать общую сумму продаж за определённый период. При выборе **Нет** в таблице будет отображаться значение, указанное в карточке элемента источника;

- **Поиск по полю** — отмеченная опция показывает, что свойство будет использоваться в качестве фильтра для поиска данных на странице отчёта. Включается автоматически, если для поля в контексте источника активирована опция поиска и сортировки или для колонки в отчёте задана агрегация данных.

3. Сохраните добавленную колонку. 

4. Настройте аналогичным образом колонки таблицы, выбрав свойства для отображения из добавленных источников. 

5. Вы можете отредактировать название колонки в таблице и изменить настройки агрегации. Для этого нажмите на добавленное свойство в списке. 

6. Чтобы убрать колонку из таблицы, напротив свойства нажмите **Удалить**. Если при этом отобразилась ошибка о нарушении связей между источниками, можно добавить свойство повторно и указать заданный ранее код удалённой колонки.

В примере в отчёт добавлены приложения-источники **Заказы**, **Договоры**, **Счета**. В таблице показываются поля с названием заказа, компанией-контрагентом, названием договора и суммой счетов по нему. Настройки на странице выглядят следующим образом:

**(report-app-7.png)**

## Настроить таблицу

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

1. Нажмите на значок шестерёнки в левом верхнем углу страницы **Настройка источника**. 

2. В открывшемся окне укажите настройки на двух доступных вкладках: 

- **Общее** — в поле **Периодичность обновления данных в минутах** укажите время, после которого внесённые в источники изменения будут отображаться в отчёте. По умолчанию указано 5 минут. Это значит, что новые элементы приложения или экземпляры процессов отобразятся в отчёте спустя 5 минут после их создания.

Минимальное значение — 1 минута. Чтобы таблица обновлялась без задержек, обратитесь в техподдержку ELMA365 для установки в поле значения **0**. Обратите внимание, данная опция приведёт к дополнительной нагрузке на систему;

- **Порядок колонок** — настройте порядок отображения колонок в таблице отчёта. Для этого напротив названия колонки нажмите значок стрелки вверх или вниз. 

**(report-app-10.png)**

3. Сохраните дополнительные настройки таблицы. 

После добавления источников и их свойств для отображения в отчёте необходимо [связать источники между собой](bind-report-apps.md), т. е. объединить разные компоненты, например, элементы нескольких приложений, в одну таблицу с данными. Если не установить связь, при сохранении списка источников вы увидите оповещение об ошибке.