3.4.5.1. Шаблон MS Word (*.doc)

3.4.5.1.1. Доступные параметры

Имя параметра Возможные значения Описание
CurrentSession 0,1 По умолчанию, построение отчёта происходит в новой сессии. Это не всегда удобно для печати каких-то сиюминутных данных. Используйте данный параметр для построения отчёта в текущей сессии (без сохранения данных перед печатью).
FileName строка, содержащая имя файла

Указывает имя файла, куда будет сохранён отчет после построения.

Параметр FileName не указан: Уникальное имя файла будет сформировано автоматически. При отображении построенного отчёта, в заголовке приложения будет автосформированное имя файла. Перед сохранением построенного отчёта, имя файла будет запрошено у пользователя.

Параметр FileName указан: Если на диске уже существует файл, с указанным именем, и он не занят другим приложением, файл будет перезаписан. Если на диске уже существует файл, с указанным именем, и он занят другим приложением, к указанному имени файла будет добавляться окончание «_#», где # - целое число, до тех пор, пока не будет получено имя не занятого или не существующего файла. При отображении построенного отчёта, в заголовке приложения будет указанное имя файла (если файл был занят, имя файла с окончанием «_#») Если указано имя файла в несуществующем каталоге, будет произведена попытка создания каталога с заданным именем. В случае неудачи, будет выдана ошибка. Имя файла может быть указано как полностью (с указанием диска и каталога), так и частично (только имя файла), в последнем случае в качестве каталога будет использоваться каталог для временных файлов, указанный в ОС Windows. Если имя файла указано с расширением не *.doc, то файл будет сохранён в соответствующем расширению формате. Поддерживаются следующие форматы экспорта:

  • Microsoft Windows текст (*.txt)
  • Rich text format (*.rtf)
  • Standard HTML (*.htm; *.html)
  • Extensible Markup Language format(*.xml)
  • DOCX (*.docx)
  • PDF (*.pdf) (поддерживается начиная с MS Office 2007)
  • Формат виртуального принтера Windows (*.xps) (поддерживается начиная с MS Office 2007)
  • OpenDocument текст (*.odt)
Limit Целое число Указывает, какое максимальное кол-во записей может быть выведено в отчёт. Если кол-во суммарное кол-во записей, выведенных в отчёт, превысит заданное значение, пользователю будет задан вопрос о продолжении печати.
ShowProcess 0,1 По умолчанию, построение отчёта скрыто от пользователя (разработчика), но иногда необходимо видеть процесс построения отчёта (например: для отладки). Для визуализации построения отчёта необходимо указать сей параметр.

3.4.5.1.2. Пример шаблона

Наименование [#sCaption#] номер: [#nDocNum#] дата [#dDocDate#]

[#&SEL_DemoReportCollection.CLList_IDDemoReport#]

Наименование - [#sName#]
Количество - [#nCount#]
Сумма - [#fSumma#]

[#/SEL_DemoReportCollection.CLList_IDDemoReport#]

[#&MainSelect=select t.ID, t.dDocDate, t.nDocNum, t.sCaption,
t.idClass from DemoReport t Where id = :super$id #]

Наименование [#sCaption#] номер: [#nDocNum#] дата [#dDocDate#]

[#&ChildSelect= select t.ID, t.IDDemoReport,
DemoReportCollectionAPI.GetIDDemoReport_HL(t.IDDemoReport) as
IDDemoReport_HL, t.sName, t.nCount, t.fSumma, t.idClass from
DemoReportCollection t where t.IDDemoReport = :super$id#]

Наименование - [#sName#]
Количество - [#nCount#]
Сумма - [#fSumma#]

[#/ChildSelect#]
[#/MainSelect#]

3.4.5.1.3. Ограничения

Существует ограничение на длину значения строкового параметра, выводимого в отчёт. Максимальная длина строки может составлять 254 символа.

3.4.5.1.4. Колонтитулы

В MS Word шаблонах поддерживаются все виды колонтитулов и настройки для них. Содержимое каждого колонтитула обрабатывается отдельно от основного тела документа и других колонтитулов.

Про использование колонтитулов в MS Word можно почитать на сайте MS Office: Страницы и макеты страниц.