.. _gs3_rtf_template:

RTF-шаблоны (``.rtf``)
======================

RTF-шаблон — текстовый файл с форматированием.
В AS используется обработчик, общий с Word-шаблонами (Aspose.Words).

Если в данном разделе встречается пометка "не подтверждено", это означает:

- Функциональность отчетов, работавшая в :term:`Global 1`, может не работать при построении
  отчета на сервере приложений Global.
- Работу функциональности необходимо проверить на реальном решении для сервера
  приложений Global.

Базовая разметка
----------------

Разметка аналогична Word/TXT:

- Подстановка значения: ``[#AttributeName#]``
- Открытие секции: ``[#&SectionName#]``
- Закрытие секции: ``[#/SectionName  <macro code>#]``
- Обращение к мастер-выборке: ``[#super$AttributeName#]``

Секции и SQL
------------

Открывающий тег может ссылаться на выборку или содержать SQL:

- Выборка: ``[#&EntityName.Representation#]``
- SQL: ``[#&SectionName = select ...#]``

Тело секции повторяется для каждой строки выборки.

Колонтитулы
-----------

Поддержка колонтитулов для RTF в AS **не подтверждена** и требует проверки
на целевом решении.

Макроязык
---------

Поддержка встроенных функций для RTF в AS **не подтверждена**.
Если используется, функции должны быть внутри тегов
(аналогично TXT/Excel).

Пример
------

.. code-block:: text

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

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

  [#&ChildSelect= select t.ID, t.IDDemoReport, t.sName, t.nCount, t.fSumma
  from DemoReportCollection t where t.IDDemoReport = :super$id#]

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

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