Перейти к основному содержимому
Версия: 5.x

Блок свойств и действий

Блок свойств и действий инструкции FORM - добавление свойств и действий в структуру формы.

Синтаксис

PROPERTIES [(cparam1, ..., cparamN)] [formPropertyOptions] formPropertyDecl1, ..., formPropertyDeclM

Каждый formPropertyDecl - это описание свойства или действия, добавляемого в структуру формы, которое имеет следующий синтаксис:

Если были указаны общие параметры блока (cparam1, ..., cparamN):

[[alias1] [caption1] =] [ACTION] formPropertyId1 [formPropertyOptions1], ..., [[aliasK] [captionK] =] [ACTION] formPropertyIdK [formPropertyOptionsK] 

Если же общие параметры блока указаны не были, то:

[[alias1] [caption1] =] formMappedProperty1 [formPropertyOptions1], ..., [[aliasK] [captionK] =] formMappedPropertyK [formPropertyOptionsK] 

Каждый formMappedProperty это описание реализации свойства или действия, добавляемого на форму, которое имеет один из следующих синтаксисов

[ACTION] formPropertyId(param1, ..., paramN1) 
formPropertyExpression

{ formActionOperator }

Каждый formPropertyOptions - это опции свойства или действия, добавляемого в структуру формы. Они могут указываться друг за другом в произвольном порядке:

changeType
SHOWIF propertyExpression
READONLYIF propertyExpression
BACKGROUND propertyExpression
FOREGROUND propertyExpression
HEADER propertyExpression
FOOTER propertyExpression
COLUMNS [groupid] (groupName1, ..., groupNameM)
viewType
NEWSESSION | NESTEDSESSION
DRAW groupObjectName
BEFORE formPropertyName
AFTER formPropertyName
QUICKFILTER formPropertyName
ON eventType actionId(param1, ..., paramZ) | { actionOperator }
ATTR
EXTID extID
IN propertyGroup

Описание

Один блок PROPERTIES добавляет свойства и действия в структуру формы. Для добавления одного свойства (действия) необходимо указать его идентификатор, а также указать, значения каких объектов формы будут передаваться этому свойству (действию) в качестве аргументов. Иногда удобно перечислить эти объекты формы для всего блока PROPERTIES. Это можно сделать, указав общие параметры блока. В этом случае при добавлении свойства (действия) нужно указывать только его идентификатор, а в качестве аргументов будут браться общие параметры.

Каждое добавляемое в структуру формы свойство (действие) должно иметь имя на форме, уникальное в пределах формы. Это имя может задаваться либо явно, либо оно будет формироваться из имени свойства и передаваемых ему параметров - имен объектов, перечисленных через запятую.

FORM order
OBJECTS o=Order
PROPERTIES(o) d=date, Order.number;

В приведенном примере именами добавленных свойств date и Order.number будут d и number(o).

При добавлении свойства (действия) в структуру формы можно указать набор его опций. Также можно указать общие опции для всего блока PROPERTIES. Если какая-то из опций задана как для всего блока, так и для конкретного объявления, то будет использоваться значение опции для объявления.

Во всех выражениях и контекстно-зависимых операторах-действиях в качестве параметров можно использовать имена уже объявленных объектов на форме.

Параметры

  • cparam1, ..., cparamN

    Список общих параметров блока. Каждый параметр задается именем объекта формы. Если этот список задан, то при добавлении свойства (действия) нужно указывать только его идентификатор без параметров. Имя объекта задается простым идентификатором.

  • alias

    Имя добавляемого свойства или действия на форме. Простой идентификатор. Если имя не задано, то именем свойства (действия) на форме будет имя самого свойства (без имени пространства имен и сигнатуры) вместе с параметрами - именами объектов, перечисленными через запятую и заключенными в скобки.

  • caption

    Заголовок добавляемого свойства или действия на форме. Строковый литерал. Если заголовок не задан, то заголовком свойства (действия) на форме будет заголовок самого свойства.

к сведению

В текущей реализации платформы, если имя и заголовок не заданы одновременно, то при использовании выражений и операторов-действий = - обязательно (то есть f(a,b), но =a*b+5)

  • formPropertyId

    Идентификатор свойства или действия, добавляемого в структуру формы.

    Также в этом правиле, вместо идентификаторов свойств / действий, можно использовать операторы работы с объектами:

    • VALUE - показывает значение объекта (для пользовательских классов - код объекта).
    • NEW - создание нового объекта.
    • EDIT - редактирование объекта.
    • DELETE - удаление объекта.
    • NEWEDIT - создание и редактирование нового объекта.

    При этом для операторов NEW, EDIT, NEWEDIT, также как и для идентификаторов свойств / действий, можно в квадратных скобках явно указывать класс, объект которого будет добавляться / редактироваться (например NEW[A]).

  • ACTION

    Ключевое слово. Если задано, то считается, что в formPropertyId задается действие. Если не задано, первоначально считается, что в formPropertyId задается свойство, и только если оно не найдено, что в formPropertyId задается действие.

  • param1, ..., paramNk

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

  • formPropertyExpression

    Выражение, добавляемое в структуру формы.

  • formActionOperator

    Контекстно-зависимый оператор-действие, добавляемый в структуру формы

Опции свойства или действия

  • changeType

    Указание стандартных обработок событий изменений свойства или действия. Задается одним из ключевых слов:

    • CHANGEABLE - вызывается соответствующая обработка возникшего события. Является значением по умолчанию. Имеет смысл использовать явно только в случае, когда для всего блока задан какой-то другой модификатор, а для одного конкретного свойства необходимо его убрать.
    • READONLY - при попытке редактирования свойства, будет либо включен механизм фильтрации, либо событие просто проигнорируется.
    • SELECTOR - при попытке редактирования свойства, будет вызван диалог для изменения текущего значения объекта (а не значения свойства). Применимо только для свойств с одним параметром.
  • SHOWIF propertyExpression

    Указание свойства, определяющего видимость на форме добавляемого свойства или действия. Если значение этого свойства будет равно NULL, то добавляемое свойство (действие) не будет отображаться. Не может использоваться одновременно с опцией HEADER.

  • READONLYIF propertyExpression

    Указание свойства, определяющего возможность редактирования добавляемого свойства (выполнения добавляемого действия). Если значение этого свойства будет равно NULL, то добавляемое свойство не будет иметь возможности редактирования, а добавляемое действие возможности быть выполненным. По поведению аналогично опции READONLY, только с дополнительным условием зависящим от данных.

  • BACKGROUND propertyExpression

    Указание свойства, определяющего цвет фона ячейки значения добавляемого свойства (действия). Свойство может иметь как тип COLOR (в этом случае, будет использоваться его значение), так и любой другой тип. В таком случае, если значение не равняется NULL, то будет использоваться в качестве фона цвет по умолчанию, хранящийся в глобальном свойстве System.defaultBackgroundColor (задаваемый в настройках) или желтый (если цвет по умолчанию не задан).

  • FOREGROUND propertyExpression

    Указание свойства, определяющего цвета текста ячейки значения добавляемого свойства (действия). Свойство может иметь как тип COLOR (в этом случае, будет использоваться его значение), так и любой другой тип. В таком случае, если значение не равняется NULL, то будет использоваться цвет текста по умолчанию, хранящийся в глобальном свойстве System.defaultForegroundColor (задаваемый в настройках) или красный (если цвет по умолчанию не задан).

  • HEADER propertyExpression

    Указание свойства, определяющего заголовок колонки добавляемого свойства (действия). В качестве заголовка будет взято возвращаемое значение этого свойства. Если же возвращаемое значение равно NULL, то добавляемое свойство (действие) будет автоматически скрыто.

  • FOOTER propertyExpression

    Указание свойства, определяющего колонтитул добавляемого свойства (действия). Используется только в печатном представлении формы.

  • COLUMNS [groupid] (groupName1, ..., groupNameM)

    Указание верхних групп объектов, значения которых будут формировать набор колонок для отображения добавляемого свойства (действия). Чаще всего, вместе с опцией COLUMNS используется опция HEADER, чтобы задать заголовки этим колонкам.

    • groupid

    Идентификатор группы колонок. Строковый литерал. Если для нескольких добавляемых свойств (действий) указывается опция COLUMNS с одинаковым набором групп объектов, то по умолчанию сначала будут располагаться все колонки одного свойства (действия), а затем другого. Чтобы сгруппировать колонки разных свойств (действий) по значению верхних объектов, можно задать им одинаковый строковый идентификатор группы колонок. В этом случае колонки для разных свойств (действий) будут чередоваться.

  • DRAW groupObjectName

    Указание имени группы объектов на форме, в таблице которой будет отображаться добавляемое свойство или действие.

  • viewType

    Указание типа представления добавляемого свойства или действия:

    • GRID - колонка таблицы
    • TOOLBAR - тулбар
    • PANEL - панель

    Если не указана, используется соответствующая опция из опций свойств. Если и она не указана, используется тип представления по умолчанию для группы отображения этого свойства или действия.

  • NEWSESSION | NESTEDSESSION

    Модификаторы, указывающие, что операции работы с объектами (NEW, EDIT, DELETE, NEWEDIT) должны выполняться в новой (вложенной) сессии.

  • BEFORE formPropertyName | AFTER formPropertyName

    Указание того, что свойство или действие должно быть добавлено в структуру формы перед (ключевое слово BEFORE) или после (ключевое слово AFTER) уже добавленного свойства или действия. Чаще всего используется в механизме расширения форм.

  • QUICKFILTER formPropertyName

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

  • ON eventType actionId(param1, ..., paramZ) | { actionOperator }

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

    • eventType

      Тип события формы. Задается одним из следующих ключевых слов:

      • CHANGE - попытка изменения значения добавляемого свойства (вызова добавляемого действия).

      • CHANGEWYS - попытка изменения непосредственно отображаемого значения свойства. Наступает при редактировании добавляемого свойства с помощью вставки текста (имеется ввиду Ctrl+V и аналогичные способы).

      • GROUPCHANGE - попытка изменения значения свойства для всех объектов в таблице (групповое редактирование).

      • EDIT - редактирование объекта, идущего на вход свойству.

      • CONTEXTMENU [caption] - при указании этого типа события в контекстное меню свойства (действия) на форме будет добавлен пункт, выполняющий указанное действие. Также при необходимости можно задать заголовок этого пункта меню (строковый литерал). Если этого не сделать, то, по умолчанию, он будет равен заголовку действия.

        • caption

          Заголовок пункта в контекстном меню. Строковый литерал. Если заголовок не указан явно, то он будет равен заголовку вызываемого по событию действия.

    • actionId

      Идентификатор действия.

    • param1, ..., paramZ

      Список параметров действия. Каждый параметр задается именем объекта формы. Имя объекта, в свою очередь, задается простым идентификатором.

    • actionOperator

      Контекстно-зависимый оператор-действие.

  • ATTR

    Ключевое слово. Используется только в иерархическом представлении. Указание того, что:

    • при импорте из XML данные импортируется из аттрибутов тега, а не из дочернего тега.
    • при экспорте в XML данные экспортируются в аттрибуты тега, а не в дочерний тег.
  • EXTID extID

    Указание имени, которое будет использоваться для экспорта / импорта этого свойства. Используется только в структурированном представлении.

    • extId

      Строковый литерал.

  • EXTNULL

    Ключевое слово. Используется только в иерархическом представлении. Указание того, что при экспорте в XML / JSON NULL значение не будет проигнорировано и будет выгружено:

    • при экспорте в JSON как 'null'.
    • при экспорте в XML как пустое значение.
  • IN propertyGroup

    Указание группы свойств и действий, которой принадлежит свойство (действие) на форме. Если эта опция не задана, то группой свойства (действия) на форме будет группа самого свойства.

Примеры

CLASS Order;
date = DATA DATE (Order);
time = DATA TIME (Order);
number = DATA INTEGER (Order);
series = DATA BPSTRING[2] (Order);

note = DATA ISTRING[255] (Order);

CLASS OrderDetail;
order = DATA Order (OrderDetail) NONULL DELETE;
date(OrderDetail d) = date(order(d));

index (OrderDetail d) = PARTITION SUM 1 ORDER d BY order(d) CHARWIDTH 4;

sku = DATA Sku (OrderDetail);
nameSku (OrderDetail d) = name(sku(d));

quantity = DATA NUMERIC[10,2] (OrderDetail);
price = DATA NUMERIC[10,2] (OrderDetail);
sum = DATA NUMERIC[12,2] (OrderDetail);

sum (Order o) = GROUP SUM sum(OrderDetail d) BY order(d);

quantity (Order o, Sku s) = GROUP SUM quantity(OrderDetail d) BY order(d), sku(d);
lastDetail (Order o, Sku s) = GROUP MAX OrderDetail d BY order(d), sku(d);
changeQuantity (Order o, Sku s) {
INPUT n = NUMERIC[10,2] DO {
IF lastDetail(o, s) THEN {
IF n THEN
quantity(OrderDetail d) <- n WHERE d == lastDetail(o, s);
ELSE
DELETE OrderDetail d WHERE d == lastDetail(o, s);
} ELSE IF n THEN {
NEW d = OrderDetail {
order(d) <- o;
sku(d) <- s;
quantity(d) <- n;
}
}
}
}

stopOrder = DATA BOOLEAN (Sku);
onStock = DATA NUMERIC[10,2] (Sku);
ordered = DATA NUMERIC[10,2] (Sku);

CLASS Customer;
name = DATA ISTRING[100] (Customer);
FORM customers
OBJECTS c = Customer
PROPERTIES(c) READONLY name
LIST Customer OBJECT c
;

customer = DATA Customer (Order);
nameCustomer (Order o) = name(customer(o));

customer(OrderDetail d) = customer(order(d));

CLASS Region;
name = DATA STRING[100] (Region);

region = DATA Region (Customer);

// объявляем форму заказы
FORM order 'Заказ'
OBJECTS o = Order PANEL // добавляем объект заказ на форму
PROPERTIES VALUE(o), // добавляем идентификатор заказа в базе данных
// добавляем свойства дата/время заказа, серия/номер заказа
date(o), time(o), series(o), number(o),
// добавляем наименование покупателя, которое по умолчанию будет доступным для редактирования
// при этом, при попытке его редактирования, будет вызываться диалог по выбору покупателя -
// форма, для которой установлен параметр LIST customer
nameCustomer(o),

note(o), // добавляем примечание
// добавляем сумму по заказу без возможности редактирования,
// так как оно автоматически считается на основе суммы строк
sum(o) READONLY

OBJECTS d = OrderDetail // добавляем объект строка заказа
PROPERTIES(d) // все свойства в этом блоке будут иметь вход строка заказа
// добавляем порядковый номер строки и делаем, чтобы его нельзя было редактировать
index READONLY,
nameSku, // добавляем наименование
quantity, price, sum, // добавляем количество, цена, сумму
// добавляем предопределенное действие NEW, которое добавляет новую строку заказа
NEW,
DELETE // добавляем действие, которое будет удалять строку заказа
// указываем, что должны показываться только строки, относящиеся к данному заказу
FILTERS order(d) == o

// добавляем объект sku, в который мы будем выводить итоги по каждому sku в заказе
OBJECTS s = Sku
// добавляем наименование, при этом делая пометку, что его нельзя редактировать на этой форме
PROPERTIES(s) name READONLY

// добавляем свойство, в котором будет показываться заказанное количество по sku в данном заказе
PROPERTIES quantity(o, s)
// по умолчанию, несмотря на то, что свойство не помечено как READONLY, и при попытке
// его изменения ничего происходить не будет, так как quantity - это агрегированное свойство
// в данном случае делается пометка, что при попытке изменения будет вызвано действие changeQuantity
// в этом свойство написан алгоритм, который будет создавать/удалять строки заказа
// или изменять в них количество
ON CHANGE changeQuantity(o, s)
// делаем, чтобы свойство было недоступно для редактирования, в случае,
// если выставлен запрет на заказ по данному sku
READONLYIF stopOrder(s)
// кроме того, подсвечиваем в таком случае эту ячейку своим фоном,
// чтобы пользователь заранее видел такие позиции
BACKGROUND stopOrder(s)

EDIT Order OBJECT o // помечаем форму, как форму для редактирования заказов
;

EXTEND FORM order // расширяем форму при помощи концепции Mixin
// добавляем на форму свойство текущего остатка перед количеством в заказе
PROPERTIES onStock(s) BEFORE quantity(d),
// добавляем на форму количество уже заказанного товара в рамках всех заказов
ordered(s) BEFORE quantity(d)
;

FORM orders 'Заказы'
OBJECTS o = Order
// все свойства в этом блоке недоступны для редактирования
PROPERTIES(o) READONLY VALUE, date, number
// добавляем предопределенные действия NEW и EDIT, которые будут вызывать форму order для добавления заказов
PROPERTIES(o) NEWSESSION NEW, EDIT, DELETE
;

// создаем "отчет", в котором будут видны заказы за определенный интервал в разрезе покупателей в конкретном регионе
FORM orderReport 'Продажи по складам'
// объявляем группу объектов, состоящую из 2х объектов класса Дата с соответствующими заголовками,
// которая будет всегда отображаться в виде панели
OBJECTS interval = (dateFrom 'Дата (с)' = DATE, dateTo 'Дата (по)' = DATE) PANEL
// добавляем на форму свойства значений объектов даты, при помощи которых пользователь сможет выбирать даты
// кроме того, присваиваем этим свойствам имена на форме dateFrom и dateTo соответственно
PROPERTIES dateFrom = VALUE(dateFrom), dateTo = VALUE(dateTo)

// добавляем объект регион, по которому будет происходить фильтрация покупателей
OBJECTS r = Region PANEL
// добавляем свойство наименование региона, при этом помечаем, что при его редактировании должен вызываться
// диалог по выбору региона, выбранное значение которого будет использовано как текущее значение
PROPERTIES(r) name SELECTOR

OBJECTS c = Customer // добавляем объект покупатели
// специально не добавляем ни одного свойства, чтобы он был "невидимым",
// но он нужен для того, чтобы отображать покупателей в колонки
FILTERS region(c) == r // ставим фильтр на то, чтобы покупатели были только из этого региона

// добавляем объект sku, в таблице которого и будет показываться основная информация
OBJECTS s = Sku
// добавляем наименование sku и не забываем сделать его READONLY, иначе пользователь сможет изменять
// наименования товара непосредственно в отчете
PROPERTIES(s) name READONLY

// добавляем свойство, в котором рассчитано количество заказанного sku по покупателям в определенный интервал дат
PROPERTIES =
[GROUP SUM quantity(OrderDetail d) IF date(d) >= dateFrom AND date(d) <= dateTo BY sku(d), customer(d)](s, c)
// помечаем, что покупатели должны отображаться в колонки, при этом колонок будет столько же,
// сколько и рядов с учетом фильтров будет в объекте покупателя, и идти они будут в том же порядке
COLUMNS (c)
// задаем, что в качестве заголовка колонок будет использоваться имя покупателя
HEADER name(c)
;