Оператор PRINT
Оператор PRINT
- создание действия, открывающего форму в печатном представлении.
Синтаксис
PRINT name
[OBJECTS objName1 = expr1, ..., objNameN = exprN]
[formActionOptions]
formActionOptions
- дополнительные опции этого действия. Существует несколько вариантов синтаксиса опций в этом операторе:
printFormat [SHEET sheetProperty] [PASSWORD passwordExpr] [TO propertyId]
[PREVIEW | NOPREVIEW] [syncType] [TO printerExpr]
MESSAGE [syncType] [TOP n]
Описание
Оператор PRINT
создает действие, которое печатает указанную форму. При печати формы в блоке OBJECTS
можно добавлять объектам формы дополнительные фильтры на равенство этих объектов переданным значениям.
Параметры
-
name
Имя формы. Составной идентификатор.
-
objName1 ... objNameN
Имена объектов формы, для которых задаются дополнительные фильтры. Простые идентификаторы.
-
expr1 ... exprN
Выражения, значения которых определяют фильтруемые (фиксированные) значения для объектов формы.
Дополнительные опции
-
printFormat
Формат печати, задается одним из ключевых слов:
PDF
- форма будет выгружена в файл формата PDF.XLS
,XLSX
- форма будет выгружена в файл в одном из указанных форматов EXCEL.DOC
,DOCX
- форма будет выгружена в файл в одном из указанных форматов WORD.RTF
- форма будет выгружена в файл формата RTF.HTML
- форма будет выгружена в файл формата HTML.
-
sheetProperty
Идентификатор свойства, значение которого применяется в качестве названия листа в выгружаемом файле. У свойства не должно быть параметров. Используется для форматов печати
XLS
,XLSX
. -
passwordExpr
Выражение, значение которого указывает на пароль для выгружаемого файла, устанавливающий режим read-only. Используется для форматов печати
XLS
,XLSX
. -
propertyId
Идентификатор свойства, в которое будет записан сформированный файл. У свойства не должно быть параметров. Если свойство не указано, сформированный файл передается клиенту и открывается у него средствами операционной системы
-
PREVIEW
Ключевое слово. Если указывается, то форма показывается в режиме предварительного просмотра. Этот режим используется по умолчанию, если другие режимы / форматы не заданы.
-
NOPREVIEW
Ключевое слово. Если указывается, то форма сразу (без предварительного просмотра) отправляется на печать.
-
printerExpr
Выражение, значение которого указывает на имя принтера, на который будет послана печать. Если принтер с указанным именем не найден (или не указан), выбирается принтер по умолчанию.
-
MESSAGE
Ключевое слово. Если указывается, то форма выдает данные пользователю в режиме сообщения.
-
TOP n
Выводит только первые
n
записей. Целочисленный литерал. -
syncType
Определяет, когда продолжить выполнение созданного действия:
WAIT
- после завершения действия клиентом (закрытия формы предпросмотра / сообщения). Используется по умолчанию.NOWAIT
- после подготовки информации для передачи клиенту (чтения данных формы).
Примеры
FORM printOrder
OBJECTS o = Order
PROPERTIES(o) currency, customer
OBJECTS d = OrderDetail
PROPERTIES(d) idSku, price
FILTERS order(d) == o
;
print (Order o) {
PRINT printOrder OBJECTS o = o; // выводим на печать
LOCAL file = FILE ();
PRINT printOrder OBJECTS o = o DOCX TO file;
open(file());
//v 2.0-2.1 syntax
LOCAL sheetName = STRING[255]();
sheetName() <- 'enctypted';
PRINT printOrder OBJECTS o = o XLS SHEET sheetName PASSWORD 'pass';
//v 2.2 syntax
//PRINT printOrder OBJECTS o = o XLS SHEET 'enctypted' PASSWORD 'pass';
}