• Основы создания SSRS отчетов в Axapta (AX 2012)

Основы создания SSRS отчетов в Axapta (AX 2012)

Category: Статьи Post Date: 31.03.2020

В текущей версии Axapta, а именно Dynamics AX 2012 (далее AX2012) вся отчетность строится на базе MS Sql Server Reporting Services (SSRS), использование старой техники создания отчетов возможно, но не желательно, а создание отчетов в AX2012 на базе SSRS не совсем тривиально. Для помощи начинающим разработчикам мы и решили написать небольшую статью, описывающую минимально необходимые действия для создания отчета на базе SSRS.

Кроме создания отчета в среде Visual Studio, необходимо создать набор управляющих классов в AX2012 для разрабатываемого нами отчета. После создания нового отчета в среде Visual Studio необходимо определить тип источника данных. Источники данных, в основном, используются двух типов Query – используются Query AX2012 и ReportDataProvider. Использование источника данных Query не предполагает каких-либо дополнительных действий, кроме определения самого запроса, если нужному набору данных не удовлетворяет ни один из существующих запросов. При использовании типа источника данных ReportDataProvider все становится не так прозрачно, именно о такой реализации мы и расскажем ниже.

Для реализации отчета с типом источника данных ReportDataProvider, необходимо создать класс наследующий интерфейс от класса SysOperationValidatable и заполнить необходимые атрибуты этого класса. Атрибуты классов и методов, это новые конструкции в AX2012, они указываются перед определением класса или метода. Кроме этого класса необходимо создать класс «контроллер» нашего отчета, он должен быть наследником класса SRSReportRunController.

Пример для нашего случая:

1. Сначала определим класс для параметров нашего отчета с атрибутами (атрибуты указываются внутри конструкции «[ ]», через запятую), новый класс должен наследовать интерфейс системного класса «SysOperationValidatable». С помощью класса параметров и атрибутов данного класса можно указывать параметры отчета и их расположение внутри диалога выбора параметров, кроме этого можно написать методы для параметров, возвращающие специфические наборы значений параметра.

  1. [
  3. DataContractAttribute,
  5. SysOperationContractProcessingAttribute(classStr(SrsReportDataContractUIBuilder)),
  7. SysOperationGroupAttribute(“Customer”,”Настройки клиента”, “1”, FormArrangeMethod::Vertical)
  9. ]
  11. Class NewReportParams implements SysOperationValidatable
  13. {
  15. CustAccount custAccount;
  17. }

2. Метод описывающий параметр «CustAccount»

  1. [
  3. DataMemberAttribute(“CustAccount”),
  5. SysOperationGroupMemberAttribute(“Cust”),
  7. SysOperationDisplayOrderAttribute(“1”),
  9. SysOperationLabelAttribute(“Клиент”),
  11. SysOperationHelpTextAttribute(“Укажите код клиента”)
  13. ]
  15. Public CustAccount parmCustAccount(CustAccount _custAccount = custAccount)
  17. {
  19. ;
  21. custAccount = _custAccount;
  23. return custAccount;
  25. }

3. Класс провайдера нашего отчета:

  1. Class NewReportDataProvider extends SrsReportDataProviderPreProcess
  2. {
  3. }

 

Для определения классов провайдера, также можно использовать класс SrsReportDataProviderBase. Отладка класса наследуемого от SrsReportDataProviderBase не возможна, по этому наша рекомендация использовать класс SrsReportDataProviderPreProcess, т.к. в нем возможна отладка AX2012, кроме отладки, данные классы различаются по использованию внутри них работы с наборами данных.

Класс SrsReportDataProviderBase позволяет работать с временными таблицами, в SrsReportDataProviderPreProcess необходимо использовать обычные таблицы с включенными свойствами CreatedBy и CreatetransactionId, как временные. Предварительно мы создали таблицу NewReportTableTmp с включенными свойствами CreatedBy и CreatedTransactionID

4. Определение класса провайдера с атрибутами (атрибуты указываются внутри конструкции «[ ]», через запятую).

  1. [
  3. SRSReportQueryAttribute(queryStr(QFromNewReport)), // запрос на набор данных
  5. SRSReportParameterAttribute(classStr(NewReportParams)) // класс параметров отчета
  7. ]
  9. Class NewReportDataProvider extends SrsReportDataProviderPreProcess
  11. {
  13. }

5. Метод возвращающий источник данных, необходимо пометить следующим атрибутом:

  1. [
  3. SRSReportDataSetAttribute(‘RetSalesTable’)
  5. ]
  7. Public NewReportTableTmp NewRecord()
  9. {
  11. NewReportTableTmp NewReportTableTmp;
  13. ;
  15. Select NewReportTableTmp where NewReportTableTmp.custAccount == ‘000022’;
  19. Return NewReportTableTmp;
  21. }

 

6. Далее перекрываем метод провайдера processReport(), он используется для заполнения созданной нами «временной» таблицы необходимыми нам данными, то есть в этом методе мы можем определить необходимый нам алгоритм выборки данных.

  1. public void processReport()
  3. {
  5. NewReportTableTmp NewReportTableTmp;
  7. NewReportParams contract;
  9. Query q;
  11. QueryRun qr;
  15. ;
  19. NewReportTableTmp.setConnection(this.parmUserConnection());
  21. contract = this.parmDataContract() as NewReportParams;
  23. q = this.parmQuery();
  25. qr = new QueryRun(q);
  29. while ( qr.Next() )
  31. {
  33. …
  35. // Заполняем нашу таблицу NewReportTableTmp
  37. }
  41. }

 

7. Создание класса отчета (предварительно в AX2012 через Visual Studio был создан отчет «NewReport» в котором в качестве источника данных выбран созданный нами провайдер):

  1. Class NewReportControl extends SRSReportRunController
  3. {
  5. }

 

8. Метод main этого класса:

  1. Public static void main (Args _args)
  3. {
  5. NewReportControl controller;
  7. ;
  9. Controller = new NewReportControl();
  11. Controller.parmreportName(SsrsReportStr(NewReport, Report)); // какой отчет вызываем
  13. Controller.parmShowDialog(true); // диалог параметров отчета
  15. Controller.parmDialogCaption(“Шапка окна диалога”); // надпись в шапке окна диалога
  17. Controllrt.startOperation; // запуск отчета
  19. }

Используя выше описанные приемы, можно создавать очень гибкие параметры для отчетов и использовать наборы данных подготавливаемых «на лету». По сравнению со стандартной платформой построения отчетов MS Dynamics AX предыдущих версий, процесс создания дизайна отчетов стал проще и гибче, что позволяет сократить разработку нового отчета, не теряя времени на разработку и подгонку дизайна самого отчета.

Авторы статьи: Петров Евгений, Майстренко Олег

Подписывайтесь на канал @d365neti в Telegram

Подписаться

Добавить комментарий

Related Posts

15 Май

Как исправить неверное отображение метки в списке целей адреса/контактной информации

В последнее время у некоторых пользователей были проблемы с данными в Microsoft Dynamics 365. Вместо переведенного текста отображались идентификаторы... read more

01 Апр

Топ-10 проблем, обнаруженных при проверке работоспособности Dynamics AX

Команда квалифицированных специалистов по поддержке Dynamics AX провела несколько сотен тестов работоспособности Dynamics AX по всему миру. Думаю, вам будет... read more

01 Апр

Планирование Плана счетов в AX 2012 (часть 2 из 7)

План счетов Первая часть этой серии была обзором верхнего уровня компонентов, которые составляют план счетов в Microsoft Dynamics AX 2012.... read more