Печать BS

Материал из ODANT Wiki
Перейти к: навигация, поиск

Сервис "Печать"

Данный сервис служит для осуществления функции печати документа. Настройка печатного бланка документа сводится к созданию шаблона документа и настройки связей полей шаблона с полями документа. В дальнейшем и сам шаблон, и связи полей можно изменять. Шаблон - это практически готовый документ, но не наполненный данными этого документа. Если в документе, который вы настраивайте для печати, нет готовых шаблонов, то его надо создать. Шаблоны создаются с помощью следующих редакторов - FastReport, Microsoft Excel, Microsoft Word. Для того, чтобы начать использовать данный сервис, первое, что надо сделать, - это его установить. После этого в дереве домена появится папка "Для документов", которая будет содержать наш сервис "Печать". При необходимости просмотра всех созданных шаблонов для печати надо открыть данный сервис в папке "Для документов".


Рис.1 окно "Настройка класса"
Рис. 2 окно "Создание нового шаблона"
Рис. 3
Рис. 4
Рис. 5
Рис. 6
Рис. 7
Рис. 8

Для добавления сервиса "Печать" в объект ODA необходимо в Настройках класса (для этого щелкнуть правой кнопкой мыши по наименованию класса и выбрать пункт меню "Настройка класса"), в который входит объект установить значение для метода "Печать" - True. См. рисунок "Окно "Настройка класса"". После этого в окне объекта появится кнопка <Печать>.

Далее необходимо создать и сохранить шаблон для печати данного документа.

Для этого необходимо выполнить следующие действия:

  • Нажать на кнопку <Печать>;
  • В открывшемся окне выбрать пункт меню Новый шаблон (см. Рис. "Создание нового шаблона")
  • Выбрать домен, класс, в котором будет хранится шаблон и формат, в котором будет создан шаблон (FastReport, Excel, Word).

Рассмотрим создание шаблона с помощью MS Word.

  • Задать имя шаблону, нажать OK (см. Рис.3)
  • В новом окне, нажмите на кнопку "Шаблон". Откроется окно редактора MS Word, с помощью которого мы создадим новый шаблон,либо же можно выбрать уже готовый шаблон на Вашем компьютере. При этом, для того, что бы в дальнейшем связать наш шаблон с объектом ODA необходимо рядом с теми полями, которые мы хотим видеть на печатной форме напечать соответствующие названия полей объекта в квадратных скобках, как показано на Рис.4. При создании шаблона необходимо соблюдать уникальность (неповторимость) полей. В шаблоне одноименное поле должно встречаться не более одного раза, если только оно не предназначено для многократного вывода в тексте документа одного и того же значения.
  • Сохранить созданный шаблон и закрыть окно редактора.
  • Настройка связей полей шаблона и объекта ODA. В окне "Настройки шаблона" в левой части отобразятся поля, которые мы заключили в квадратные скобки (см. Рис.5). А в правой части окна, как и в конфигураторе класса документов, отображаются поля объекта в виде дерева с раскрывающимися (при щелчке мышью на [+]) подчиненными полями. В колонку "Выражение" для каждого поля шаблона вводятся ссылки на поля документа. В самом простом случае текст ссылки состоит из префикса @ и идентификатора поля класса в том виде, в котором он задан в конфигураторе класса данного документа. Исключением является ссылка на таблицу. В этом случае просто указывается идентификатор табличного поля класса. Связи между полями объекта и шаблона настраиваются путем перетаскивания мышкой полей объекта из правой части окна к соответсвующим полям шаблона в левой части окна в колонку "Выражение". (см. Рис.6)
  • Сохранить шаблон, нажав на кнопку Rep3.jpg

Если шаблон содержит табличную часть, то необходимо выполнить следующие действия:

  • В редакторе MS Word разбить таблицу на отдельные строки;
  • Над второй строкой (под заголовком таблицы) напечатать символ #Состав, а под строкой символ - /#Состав, как показано на Рис.7. Поля [#Состав] и [/#Соста] обозначают соответственно начало и конец размножаемой части документа. Строка (или любой другой текст), расположенная между этими полями повторится в таблице печатного бланка столько раз, сколько строк в самом документе. Например, для документа на Рис.8 табличная часть будет содержать 2 строки. Для вывода автоматической нумерации строк в таблице в раз-множаемой строке достаточно ввести поле [№№].

Настройка шаблона документа с подчиненными таблицами

Иногда возникает необходимость для значения, содержащегося в табличной части показать более детальную информацию так же в табличном виде. Например, существует список бригад на выполнение работ, каждая из которых оплачивается общей для бригады суммой. Однако сумма, предназначенная для бригады, распределена для каждого из ее членов. Эту информацию необходимо вывести также в табличном виде, поскольку придется перечислить в списке всех членов бригады и заработок каждого:

Print8.jpg

В этом примере таблица : Print9.jpg и есть подчиненная таблица для строки Print10.jpg

Для вывода на печать подобного документа, табличная часть шаблона должна выглядеть следующим образом: Print11.jpg

Поля [#Бригады] и [/#Бригады] предназначены для вывода (размножения) строк из таблицы бригад. Поля [#Состав Бригады] и [/#Состав Бригады] для вывода строк подчиненной таблицы состава бригады. Обратите внимание что, подчиненность (вложенность) таблицы для вывода состава бригад определена в шаблоне тем, что строки для вывода подчиненной таблицы:

Print12.jpg

находятся между полями [#Бригады] и [/#Бригады], другими словами внутри текста предназначенного для вывода строк основной таблицы списка бригад. В данном примере показана вложенность одного уровня. Следуя вышеописанному правилу, можно построить табличную часть с неограниченным уровнем вложенности.


Рис. 9
Рис. 10
Рис. 11

Создание шаблона с помощью MS Excel

  • При создании шаблона в редакторе MS Excel, для отображения полей в левой части окна "Настройка шаблона", квадратные скобки не используются. Для этого необходимо задать имя ячейке или группе ячеек, если создаем таблицу, как показано на Рис. 9. Имя мы можем присваивать любое, несвязанное с именем поля (столбца) в объекте ODA. После присвоения имен стоблцам таблицы, присваиваем имя всей таблицы. Для этого выделяем область ячеек, которые входят в таблицы и задаем имя группе ячеек, см. Рис.11.
  • Сохранить шаблон.
  • Окно "Настройка шаблона" будет выглядеть следующим образом см. Рис.10. В левой части окна мы видим имена ячеек, которые мы задали в шаблоне
  • Далее связываем поля шаблона и объекта, так же как описано выше для MS Word.

Создание шаблона с помощью FastReport

Подробное описание работы с генератором отчетов FastReport см. на сайте FastReport раздел "Документация" --> Руководство пользователя


Настройка сервиса одинакова для любого класса ODA.


Ссылка на видео по настройке сервиса "Печать" Сервис "Печать"