Пример настройки отчета

Описание примера

Создать базовый отчет "Contact Data", который отображает следующую информацию о контактах:

• [ФИО] ([Full name]);
• [Дата рождения] ([Birthday]);
• [Пол] ([Gender]);
• [Контрагент] ([Account]).

Исходный код

Пакет с реализацией примера можно скачать по ссылке.

Алгоритм реализации примера

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

Установите следующие значения (рис. 2) в области настройки параметров отображения отчета (рис. 1, 2):

• [Название отчета] ([Report title]) — "Contact Data".
• [Раздел] ([Section]) — "Contacts".
• [Отображать в разделе] ([Show in section]).
• [Отображать на странице записи] ([Show in card]).
• [Отображать в аналитике раздела] ([Show in the section analytics view]).
• [Страница фильтрации] ([Filter page]) — SimpleReportFilterPage.

Рис. 1. — Страница настройки отчета

Рис. 2. — Настройка параметров отображения отчета

2. Укажите источники данных

В блоке [Укажите источники данных для отчета] ([Specify data sources for the report]) рабочей области страницы (рис. 1, 4) добавьте следующий код:

{
    // Название класса провайдера данных.
    "ProviderName": "ContactDataProvider",
    "Schemas": {
        "ContactData": {
            "Full name": {"DataValueType": 1},
            "Birthday": {"DataValueType": 1},
            "Gender": {"DataValueType": 1},
            "Account": {"DataValueType": 1}
        },
        // Добавляется для локализации.
        "LocalizableStrings": {
            "ReportTitle": {"DataValueType": 1},
            "FullNameLabel": {"DataValueType": 1},
            "BirthdayLabel": {"DataValueType": 1},
            "GenderLabel": {"DataValueType": 1},
            "AccountLabel": {"DataValueType": 1}
        }
    }
}

Для сохранения внесенных изменений нажмите кнопку [Применить] ([Apply]) на панели инструментов страницы (рис. 1, 1).

3. Создайте провайдер данных отчета

В разделе [Конфигурация] ([Configuration]) пользовательского пакета на вкладке [Схемы] ([Schemas]) выполните действие [Добавить] —> [Исходный код] ([Add] —> [Source Code]). Процесс создания схемы типа [Исходный код] ([Source Code]) описан в статье "Создание схемы [Исходный код]".

Для создаваемой схемы объекта установите (рис. 3):

• [Заголовок] ([Title]) — "Contact Data";
• [Название] ([Name]) — "UsrContactDataSourceCode".

Рис. 3. — Настройка схемы объекта типа [Исходный код] ([Source Code])

Полностью исходный код представлен ниже.

namespace Terrasoft.Configuration
{
    using System;
    using System.Collections.Generic;
    using System.Collections.ObjectModel;
    using System.Linq;
    using System.Threading.Tasks;
    using Terrasoft.Common;
    using Terrasoft.Configuration.Reporting.FastReport;
    using Terrasoft.Core;
    using Terrasoft.Core.Entities;
    using Terrasoft.Core.Factories;
    using Terrasoft.Nui.ServiceModel.Extensions;
    using EntitySchema = Terrasoft.Core.Entities.EntitySchema;
    using EntitySchemaColumn = Terrasoft.Core.Entities.EntitySchemaColumn;

    // Название класса провайдера данных для отчета, логику которого необходимо реализовать.
    [DefaultBinding(typeof(IFastReportDataSourceDataProvider), Name = "ContactDataProvider")]
    public class ContactDataProvider : IFastReportDataSourceDataProvider
    {

        private Guid _entitySchemaUId = new Guid("16BE3651-8FE2-4159-8DD0-A803D4683DD3");
        // Название схемы c исходным кодом.
        private readonly string _resourceManagerName = "UsrContactDataSourceCode";
        private readonly string[] _localizableStringNames = new[] {
            "ReportTitle",
            "FullNameLabel",
            "BirthdayLabel",
            "GenderLabel",
            "AccountLabel"
        };

        // Заполнение колонок в отчете.
        private IEnumerable<IReadOnlyDictionary<string, object>> GetContactData(
            UserConnection userConnection,
            Guid entitySchemaUId,
            IEntitySchemaQueryFilterItem filter) {
                // Получить схему объекта.
                var entitySchema = userConnection.EntitySchemaManager.GetInstanceByUId(entitySchemaUId);
                // Создание объекта класса EntitySchemaQuery.
                EntitySchemaQuery query = new EntitySchemaQuery(entitySchema);
                // Добавление колонок в запрос.
                query.AddColumn("Name");
                query.AddColumn("BirthDate");
                var gender = query.AddColumn("Gender.Name");
                var account = query.AddColumn("Account.Name");
                // Добавление созданного фильтра.
                query.Filters.Add(filter);
                // Получить коллекцию контактов.
                var contacts = query.GetEntityCollection(userConnection);
                var contactsCollection = new Collection<Dictionary<string, object>>();
                // Заполнение колонок в отчете.
                foreach (var entity in contacts)
                {
                    contactsCollection.Add(new Dictionary<string, object> {
                        ["Full name"] = entity.GetTypedColumnValue<string>("Name"),
                        ["Birthday"] = entity.GetTypedColumnValue<string>("BirthDate"),
                        ["Gender"] = entity.GetTypedColumnValue<string>(gender.Name),
                        ["Account"] = entity.GetTypedColumnValue<string>(account.Name)
                    });
                }
                return contactsCollection;
        }
        
        // Локализация заголовков отчета.
        private IEnumerable<IReadOnlyDictionary<string, object>> GetLocalizableStrings(UserConnection userConnection) {
            var localizableStrings = _localizableStringNames.ToDictionary(
                x => x,
                x => (object)(new LocalizableString(userConnection.ResourceStorage, _resourceManagerName, $"LocalizableStrings.{x}.Value")).Value);
            return new[] { localizableStrings };
        }
        
        // Добавление фильтров интерфейса.
        private IEntitySchemaQueryFilterItem ExtractFilterFromParameters(UserConnection userConnection, Guid entitySchemaUId,
                IReadOnlyDictionary<string, object> parameters) {
            var managerItem = userConnection.EntitySchemaManager.GetItemByUId(entitySchemaUId);
            return parameters.ExtractEsqFilterFromReportParameters(userConnection, managerItem.Name) ?? throw new Exception();
        } 

        // Получить данные.
        public Task<ReportDataDictionary> GetData(UserConnection userConnection, IReadOnlyDictionary<string, object> parameters) {
            var filter = ExtractFilterFromParameters(userConnection, _entitySchemaUId, parameters);
            var result = new ReportDataDictionary {
                // Заполнить колонки в отчете.
                ["ContactData"] = GetContactData(userConnection, _entitySchemaUId, filter),
                ["LocalizableStrings"] = GetLocalizableStrings(userConnection)
            };
            return Task.FromResult(result);
        }
    }
}

Присвойте локализуемым строкам шаблона отчета следующие значения (табл. 1):

Табл. 1. — Настройка локализованных строк

Больше о работе с локализуемыми строками в статье "Дизайнер исходного кода".

Опубликуйте схему.

4. Скачайте шаблон из Creatio и настройте его внешний вид в FastReport

Скачайте файл ContactData.frx. Для этого в блоке [Скачайте файл с источниками данных и сформируйте шаблон отчета] ([Download file with data sources to design a report in the FastReport Designer]) рабочей области страницы (рис. 1, 4) нажмите кнопку [Скачать файл] ([Download file]).

Чтобы открыть шаблон в дизайнере отчетов, выполните следующие действия:

1. Откройте дизайнер отчетов FastReport, запустив файл Terrasoft.Reporting.FastReport.Designer.exe из zip-архива (рис. 4).

   Рис. 4. — Файл с дизайнером отчетов FastReport

   

2. Нажмите кнопку [Open...] в появившимся окне (рис. 5).

   Рис. 5. — Кнопка [Open...]

   
   Также перейти к выбору шаблона отчета можно в меню [File] по нажатию кнопки [Open...] (рис. 6) или по нажатию клавиш [Ctrl+O].

   Рис. 6. — Кнопка [Open...] в меню [File]

   

3. Перейдите в папку со скачанным отчетом (обычно Downloads), выберите файл с шаблоном и нажмите кнопку [Open] (рис. 7).

   Рис. 7. — Открытие шаблона отчета в FastReport

   

Настройте внешний вид шаблона (рис. 8).

Рис. 8. — Настройка шаблона в дизайнере отчетов FastReport

5. Загрузите настроенный шаблон в Creatio

Чтобы загрузить файл ContactData.frx, нажмите кнопку [Загрузить шаблон] ([Upload template]) в блоке [Загрузите настроенный шаблон отчета в Creatio] ([Import a file with the report template]) рабочей области страницы (рис. 1, 4). Подтвердите успешность загрузки шаблона.

В результате отчет "Contact Data" будет доступен на странице контакта по кнопке [Печать] ([Print]) (рис. 9).

Рис. 9. — Отображение отчета "Contact Data" на странице записи раздела [Контакты] ([Contacts])

Также отчет доступен в аналитике раздела [Контакты] ([Contacts]) по кнопке [Отчеты] ([Reports]) (рис. 10).

Рис. 10. — Отображение отчета "Contact Data" в аналитике раздела [Контакты] ([Contacts])

Формирование отчета выполняется в соответствии с выбранной опцией [По отфильтрованным в разделе записям] ([Filtered records in list]) на странице фильтрации (рис. 11). Для загрузки отчета нажмите кнопку [Создать отчет] ([Create report]), для закрытия страницы фильтрации и отмены формирования отчета нажмите [Отмена] ([Cancel]).

Рис. 11. — Страница фильтрации отчета "Contact Data"

Отчет имеет следующий вид (рис. 12).

Рис. 12. — Пример отчета "Contact Data"

Отчет по нескольким записям раздела

Получить отчет, состоящий из данных нескольких записей, можно следующими способами:

1. При установленном признаке [Отображать в разделе] ([Show in section]) (рис. 2) необходимо в реестре раздела выбрать несколько записей.
2. При установленном признаке [Отображать в аналитике раздела] ([Show in the section analytics view]) (рис. 2) можно использовать фильтры раздела или страницу фильтрации (рис. 11).

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

1. Перейдите в раздел.
2. При необходимости установите фильтр.
3. Выполните [Действия] —> [Выбрать несколько записей] ([Actions] —> [Select multiple records]).
4. Выберите необходимый отчет в выпадающем списке кнопки [Печать] ([Print]).

Рис. 13. — Получение отчета "Contact Data" из нескольких записей раздела [Контакты] ([Contacts])

Отчет имеет следующий вид (рис. 14).

Рис. 14. — Пример отчета "Contact Data" по нескольким записям раздела

Смотрите также:

• Раздел "Настройка отчетов"
• Настройка отчетов в Creatio
• Пример настройки отчета с изображением