Дизайнер отчетов
AKReport

содержание
 

Оглавление страницы:

Меню

Панель кнопок быстрого доступа

Панель "Структура отчета"

Панель "Инспектор"

Редактор скрипта

Редактор SQL запросов

Меню:

Файл

      Новый - создать новый отчет. При этом будет задан вопрос о типе используемого в отчете шаблона (Word, Excel, Text).

      Открыть - открыть существующий отчет (*.xrp).

      Закрыть - закрыть текущий отчет.

      Сохранить - сохранить текущий отчет (*.xrp).

      Сохранить как - сохранить отчет с новым именем (*.xrp).

      ==Перечень последних отчетов==

      Выход - выход из дизайнера отчетов.

Правка

      Вырезать - вырезать выделенный объект (параметр, группа, текст) в буфер обмена.

      Копировать - копировать выделенный объект (параметр, группа, текст) в буфер обмена.

      Вставить - вставить объект (параметр, группа, текст) из буфера обмена.

      Найти - найти слово в тексте. Пункт меню активирован, когда активна панель с текстом (Script или SQL).

      Найти следующий - искать дальше по тексту.

      Заменить - замена по тексту одного слова другим.

Отчет

      Выполнить - выполнить отчет.

      Шаг вне - выполнить функцию скрипта без входа в вфункцию.

      Шаг внутрь - выполнить функцию скрипта с пошаговым выполнением кода функции.

      Остановить - Прервать процесс выполнения скрипта.

      Заполнить дерево по шаблону - выполнить считывание архитектуры групп из шаблона документа. Таким образом можно упростить процесс построения групп.

База данных

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

      Редактировать алиас - редактирование текущего алиаса.

Окно

      Окна каскадом - при работе с несколькими отчетами, выстроить все окна каскадом.

      Окна сверху вниз - при работе с несколькими отчетами, выстроить все окна друг за другом сверху вниз.

      Окна слева направо - при работе с несколькими отчетами, выстроить все окна друг за другом слева на право.

      Минимизировать все окна - свернуть все окна в минимизированную форму в виде ярлыков в нижней части экрана.

      Расположить все окна - располагает все окна.

      ==Список открытых окон==

Помощь

      О программе

      Справка

 

Панель кнопок быстрого доступа:

- Создать новый отчет. При этом будет задан вопрос о типе используемого в отчете шаблона (Word, Excel, Text).

- Открыть существующий отчет (*.xrp).

- Сохранить текущий отчет (*.xrp).

/ - Редактирование шаблона документа. Выбор редактора из выпадающего списка для открытия шаблона

- Выполнить отчет.

- Выполнить считывание архитектуры групп из шаблона документа. Таким образом можно упростить процесс построения групп.

- Выход из дизайнера отчетов.

- Копировать выделенный объект (параметр, группа, текст) в буфер обмена.

- Вырезать выделенный объект (параметр, группа, текст) в буфер обмена.

- Вставить объект (параметр, группа, текст) из буфера обмена.

- Отменить последнюю операцию.

- Выбрать алиас.

- Выбрать файл инициализации параметров отчета в run-time режиме.

 

Панель "структура отчета"

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

Далее первый уровень структуры состоит из двух основных разделов: " Параметры" и " Группы".

 

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

Для каждого параметра задается "Имя", "Заголовок", определяется тип, и вводится информация соответствующая выбранному типу. Параметр может быть одного из следующих типов: "Edit", "Combobox", "Date", "Lookup", "StaticText", "Grid", "List". Доступ к значению параметра из скрипта или SQL запроса осуществляется по имени. Заголовок отображается в окне при запросе параметра рядом с полем ввода значения.

Подробнее о параметрах см. раздел документации "Параметры"

 

Раздел "Группы" содержит структуру формируемого документа. Например, если отчетом является список работников отдела, то в разделе группы будет располагаться единственная группа, пусть ее имя " dsWorkers". Эта группа будет содержать SQL запрос к базе и выводить в документ список работников отдела согласно введенного параметра "Department".

Demo

Параметры

      Department

Группы

      dsWorkers

 

Для группы dsWorkers, вводится SQL:

     select W.WORKER from WORKERS W where W.DEPARTMENT = :Department

 

Если необходим список работников всех отделов, то такая структура отчета будет называться мастер-деталь и создается группа деталь:" dsWorkers" как подчиненная к группе мастер: " dsDepartments". (В таком отчете нет необходимости в параметре "Department"). Структура отчета должна выглядеть следующим образом:

Demo

Параметры

Группы

      dsDepartments

           dsWorkers

 

Для группы dsDepartment, вводится SQL:

select D.DEPARTMENTID, D.DEPARTMENT from DEPARTMENTS D

Для группы dsWorkers, вводится SQL:

select W.WORKER from WORKERS W where W.DEPARTMENTID = ?MAS_DEPARTMENTID

 

Панель "Инспектор"

Панель "Инспектор" содержит набор свойств текущего объекта на панели "Структура отчета". Для раздела "Параметры" и для каждой группы из раздела "Группы" инспектор содержит помимо списка свойств список обработчиков событий.

Например, выберите в структуре отчета группу " dsWorkers" (из последнего примера). В инспекторе появится список свойств и список обработчиков событий. Свойство "Master" должно содержать ссылку на мастер-группу "dsDepartments". Если есть необходимость форматировать в отчете поле "DEPARTMENT", например, выводить в документ название отдела в кавычках, следует создать обработчик события "OnGetFieldData" для группы "dsDepartments". Кликните дважды на соответствующем событии и в тексте скрипта будет сгенерирована процедура "dsDepartments_OnGetFieldData".

Заполните событие следующим текстом:

procedure dsDepartments_OnGetFieldData(Field: TDBFieldInfo);

begin

     if (Field.FieldName = 'DEPARTMENT') then Field.Value := '"' + Field.Value + '"';

end;

Надо отметить, здесь 'DEPARTMENT' - наименование соответствующего поля в шаблоне и это поле должно быть включено (находиться между ~Begin dsDepartment~ и ~End dsDepartment~) в группу "dsDepartment".

Пример шаблона (Demo.RTF):

 

Cписок работников всех отделов.

~Begin dsDepartments~

Отдел: ~DEPARTMENT~

~Begin dsWorkers~

      ~WORKER~

~End dsWorkers~

~End dsDepartments~

 

Редактор скрипта

Закладка "Скрипт" на основной панели открывает редактор скрипта проекта. Синтаксис скрипта - Object Pascal. На правой панели приведен справочник поддерживаемых функций. Если в скрипте содержится хоть какой-то текст, то этот текст должен завершаться "BEGIN" "END.".

Это удобно!

Для построения обращения из скрипта к пользовательским параметрам отчета перетяните левой клавишей мышки параметр в необходимое место скрипта.

Для построения обращения из скрипта к датасету (группа должна быть датасетом, иметь SQL запрос) достаточно левой клавишей мышки перетянуть датасет в необходимое место скрипта.

Интегрированная среда разработки отчетов "AKReport" поддерживает закладки.

Для установки закладки переместите текстовый курсор в строку, на которой необходимо сделать закладку. Нажмите "Ctrl+Shift+<N>", где N - номер закладки от "0" до "9". На полях отобразится номер закладки (в редакторе скрипта).

Для того, чтобы перейти к закладке следует нажать "Ctrl+<N>".

Для того, чтобы убрать закладку следует перейти текстовым курсором на строку, на которой установлена закладка, и нажать "Ctrl+Shift+<N>", где N - номер убираемой закладки.

 

Пример (пронумерованный список отделов):

Var

     A : Integer;

procedure dsDepartments_OnGetFieldData(Field: TDBFieldInfo);

begin

     if (Field.FieldName = 'DEPARTMENT') then Field.Value := StrToInt(A) + '. "' + Field.Value + '"';

     Inc(A);

end;

Begin

     A := 1;

End.

Код программы между основными "Begin" и "End." будет выполняться перед созданием отчета и может служить, например, для инициализации переменных.

 

Редактор SQL запросов

Закладка "SQL" на основной панели открывает редактор SQL запросов. По умолчанию редактор SQL запросов отображает все запросы всех групп из раздела " Группы", в таком режиме запросы отображаются только для чтения. Для редактирования следует выбрать конкретную группу.

Для написания и отладки SQL запросов рекомендуется использовать IB-Expert.

содержание

Copyright © 2004: Alexander Krepky, Eugeny Makalish