<string-ref ref="{property string name}" value="{string value}"/>
</param-specification>
<!-- Код управления событиями -->
<custom-event-handler lang="JavaScript"><![CDATA[...]]></custom-event-handler>
</schema>
</schemas> |
attributes
| Параметры | Описание |
|---|
name | Название схемы. Название должно быть уникально. |
extends | Родительская схема. Из родительской схемы наследуются все свойства схем и обработчики событий. |
recalc | Отвечает за обновление свойств схемы при событии обновлении объекта. Может принимать значение: true, false. |
<property>
Своиства схемы могут быть трех видов:
- Примитив;
- Перечисление;
- Объект.
Более детально рассматривается в разделе типы свойств
param-specification
| Примечание |
|---|
Сохранен для совместимости более ранних версий. Вместо него нужно использовать Условие применения |
Параметр отвечает за конктретизацию Схемы. Позволяет настроить отображение объекта по различным Формам в зависимости от определенных Свойств схемы. Результатом конкретизации является изменение Схемы данных объекта, а по измененной Схеме будет выбрана новая Форма для его отображения.
<property>-ref
Сопоставление свойства родительской схемы и значения, при котором будет включатся механизм конкретизации схемы
| Параметры | Описание |
|---|
ref | Название свойства родительской схемы |
value | Значение свойства |
custom-event-handler
Настраиваемый обработчик событий. Поддерживается настройка обработки событий для web-клиента:
| Событие | Описание |
|---|
queryCreate | Вызывается при создании объекта | Без форматирования |
|---|
function queryCreate(object) {} |
Параметры: Пример |
querySave | Вызывается непосредственно перед переносом данных из объекта Java API в документ, в котором этот объект хранится. Функция возвращает значение типа Boolean. Если функция вернула false - сохранение будет прервано. Обработчики события выполняются в порядке наследования схем снизу вверх: сначала событие querySave текущей Схемы объекта, потом событие querySave той Схемы, которую она уточняет, и так далее до события querySave базовой Схемы. | Без форматирования |
|---|
function querySave(object, document) {
return true;
} |
Параметры: - object - объект Java API, содержащий все изменения
- document - объект Notes Java API, notes-документ, сохраненный ранее (до внесения изменений).
Пример |
postSave | Вызывается сразу после сохранения документа в хранилище. Обработчики события выполняются в обратном порядке, сверху вниз: сначала событие postSave базовой Схемы, потом событие postSave уточняющей Схемы и так далее до текущей Схемы объекта. Обработчики события recalc выполняются аналогично postSave, сверху вниз. | Без форматирования |
|---|
function postSave(object, document) {} |
Параметры: - object - объект Java API
- document - документа Java API, который был сохранен со всеми изменениями.
|
recalc | Вызывается при пересчете ресурса, том числе вызов recalc может быть связан в изменением значения поля или нажатием на кнопку. | Без форматирования |
|---|
function recalc(object, changedField) {} |
Параметры: - object - объект Java API, содержащий все изменения
- changedField - название Свойства схемы, изменение которого вызвало пересчет объекта
Пример |
Обработчики событий могут быть созданы к нескольким схемам, объединенным в одну иерархию.
Если для какой-то из Схем в иерархии Обработчик событий не создан или не содержит описания соответствующего события, то эта Схема пропускается, и выполняется обработчик следующей по порядку обработки Схемы.
Код обработчика событий имеет доступ к API CMJ системы и подключенным к ней сторонним библиотекам. Для работы с тем или иным Java классом его или пакет, в котором он расположен, предварительно необходимо импортировать в обработчик. Для этого можно использовать функции importPackage() или importClass ().
| Блок кода |
|---|
|
importPackage (Packages.java.util); - импортирует все классы, расположенные в пакете java.util. |
Как и в Java, импортируются только классы, находящиеся непосредственно в указанном пакете. Классы из дочерних пакетов импортированы не будут.
Коду обработчика на JavaScript доступны все public методы реальных классов, реализующих те или иные интерфейсы Java API. Области видимости protected и private недоступны.
Синтаксис работы с объектами Java классов точно такой же, как и с объектами JavaScript.
В описании обработчика событий можно объявлять дополнительные функции и вызывать их из событий.
| Предупреждение |
|---|
Объекты API CMJ, переданные в обработчик событий извне (например, параметр document), нельзя передавать в дополнительно объявленные функции. Работать с параметром document можно только внутри событий querySave и postSave. |