﻿# Отчёт в ELMA365

> [HTML Version](report.html)

**Отчет** — это инструмент контроля, который собирает данные из нескольких компонентов системы и показывает их в виде таблицы.

Компоненты, которые добавляются в отчёт, называются источниками данных. Это могут быть любые приложения или бизнес-процессы системы. При настройке отчёта выбираются свойства источников, которые будут показываться в виде колонок таблицы.

Чтобы в одной таблице собрать данные из нескольких добавленных в отчёт компонентов, источники связываются между собой по парам. Для этого используются свойства из их контекста. При настройке связи можно определить, какие именно элементы или экземпляры источников будут отображаться в таблице.

Например, в системе присутствуют два приложения: **Заказы **и **Счета**. Их элементы не связаны между собой, т. е. в заказе не отображается выставленный для клиента счёт. Однако, у заказа и счёта есть общее поле **Договор**. Вы можете создать отчёт **Реестр заказов**, добавить эти два приложения в виде источников и объединить их данные. Элементы источников в отчёте свяжутся между собой по общему договору. В таблице для каждого заказа отобразится сумма всех выставленных по нему счетов.

**(report-app-1.png)**

Таким образом, данные из нескольких приложений можно сохранять, просматривать и фильтровать в одном интерфейсе.

## Особенности отчётов

Рассмотрим основные характеристики компонента **Отчет**:

1. Отчёт создается на уровне раздела и используется как обычное приложение. Вы можете настроить видимость отчёта в левом меню раздела для определённых групп пользователей.

2. В качестве источников отчёта можно использовать любые приложения и бизнес-процессы системы.

3. Источники отчёта связываются между собой по парам с помощью свойств из их контекста. Доступна настройка связи между источниками по типам: приложение – приложение, бизнес-процесс — приложение, бизнес-процесс — бизнес-процесс.

4. При связывании источников можно установить одно или несколько условий отбора данных. Например, показывать всю информацию из источников или исключать элементы с пустым значением в общем поле.

5. Таблица отчёта создаётся при добавлении источников. Колонки таблицы — это выбранные свойства источника. Порядок колонок можно редактировать. Свойства с включённой [опцией поиска и сортировки](360028941112.md#search) добавляются в отчёт в виде фильтров для поиска.

6. При настройке отчёта можно просматривать внешний вид таблицы с данными в режиме отладки.

7. Данные из отчёта можно получать путём выполнения [API-запросов](https://api.elma365.com/ru/public-api/reference/reports/). Также можно обращаться к ним в скриптах с помощью [методов TS SDK](https://tssdk.elma365.com/ru/latest/interfaces/_02_types_.reportfield.html).

8. Отчёт можно экспортировать в файл формата **.xlsx**, применяя пользовательские шаблоны выгрузки таблицы.

9. Создать новый отчёт можно, скопировав уже существующий компонент. Кроме того, доступно удаление отчёта из левого меню и его восстановление из корзины.

10. Чтобы визуализировать данные из отчёта, по нему можно построить [график](chart.md) или [таблицу](widget_reports.md) и разместить их на другой странице системы или на форме приложения.

11. На страницу отчёта можно переходить с формы приложения или другой страницы. Для этого используется поле типа [Отчет](360009707032.md#report-field), в котором в виде ссылки отображается указанный отчёт.

Подробнее о работе с отчётом читайте в статьях:

- [«Создать и настроить отчёт»](create-report.md);

- [«Настроить источники данных и таблицу отчёта»](set-report-sources.md);

- [«Связать источники и отладить отчёт»](bind-report-apps.md);

- [«Примеры настройки отчёта»](report-use-case.md);

- [«Работа с таблицей отчёта»](view-report-table.md);

- [«Экспорт данных отчёта»](report-export.md).