Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Информация
iconfalse

Корневой элемент schema. Пространство имен: <schemas xmlns="http://www.intertrust.ru/schema/palette/tn-schema">

Информация
iconfalse
titleКраткое описание
  • описывает структуру данных объекта
,
  • ;
  • содержит
в себе
  • код управления событиями объекта
, переадресацию на другую схему
  • .
Блок кода
languagexml
titleСтруктура XML
collapsetrue
<?xml version='1.0' encoding='UTF-8'?>
<schemas xmlns="http://www.intertrust.ru/schema/palette/tn-schema">
    <schema name="{name}" extends="{parent schema name}" recalc="true" workflow="false">
       
	 	<string name="{name}"/>    	

		<enum-ref name="{name}" ref="{enum name}"/> 
		
		<enum>
			<!--Свойство схемы -->
	 	<string name="{name}"/>
		</enum>
	    	
		<schema-ref name="{name}" ref="{schema name}"/>

		<schema name="{name}" extends="{schema name}">
		 	<string name="{name}"/>
	 	</schema>
        !-- Параметры конкретизации схемы -->
	  	<param-specification>
		 	<!--property-ref-->
            <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.

workflow

Используется для подключения движка самописного WorkFlow. Может принимать значение: true, false. Для движка WorkFlow Flowable он не используется.

string

Примитив

datetime

Примитив

date

Примитив

daterange

Примитив

time

Примитив

integer

Примитив

double

Примитив

boolean

Примитив

file

Примитив

richtext

Примитив

Примитив

email

Примитив

actor

Примитив

enum-ref

Перечисление

schema-ref

Объект

enum

Перечисление

schema

Объект

param-specification

Конкретизация Схемы позволяет

<property>

Своиства схемы могут быть трех видов:

  • Примитив;
  • Перечисление;
  • Объект.

Более детально рассматривается в разделе типы свойств

param-specification

Примечание

Сохранен для совместимости более ранних версий. Вместо него нужно использовать Условие применения

Параметр отвечает за конктретизацию Схемы.  Позволяет настроить отображение объекта по различным Формам в зависимости от определенных Свойств схемы. Результатом конкретизации является изменение Схемы данных объекта, а по измененной Схеме будет выбрана новая Форма для его отображения. Конкретизация доступна для Схем данных типа «Объект».

Примечание: Раздел «Параметры конкретизации» сохранен для совместимости с НР1. Вместо Параметров конкретизации в НР2 нужно использовать Условия применения (5. Условия применения).

Поскольку при конкретизации Схемы данных происходит изменение Схемы, то для ее использования в НР2 должно быть описано как минимум две Схемы данных: родительская и производная. Родительская Схема связывается с типом документа, а производная будет являться результатом конкретизации родительской. Конкретизация Схемы производится по значениям Свойств родительской Схемы.

Для описания конкретизации Схемы данных типа «Объект» (Рисунок 8):

  • Описать родительскую и производную Схемы данных типа «Объект», включая описание Свойств Схем.
  • Открыть родительскую Схему данных.
  • В разделе «Конкретизация» родительской Схемы данных в поле «Параметры конкретизации схемы» указать Свойства схемы, от значений которых зависит выбор Схемы данных объекта.
  • Сохранить родительскую Схему данных.
  • Открыть производную Схему данных.
  • В разделе «Параметры конкретизации родительской схемы» производной Схемы указать Свойства родительской Схемы и их значения, при которых должна использоваться текущая производная Схема данных. Свойства родительской Схемы добавляются по кнопке «добавить» и выбираются из Свойств родительской Схемы, указанных в поле «Параметры конкретизации схемы».
  • Сохранить производную Схему данных.

<property>-ref

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

ПараметрыОписание
ref
Название свойства родительской схемы
value
Значение свойства

custom-event-handler

Настраиваемый обработчик событий. Поддерживается настройка обработки событий для web-клиента:

  • queryCreate - вызывается при создании объекта. 
  • querySave - вызывается
    СобытиеОписание

    queryCreate

    Вызывается при создании объекта

    Без форматирования
    function queryCreate(object) {}

    Параметры:

      • object - объект Java API

    Пример

    querySave

    Вызывается непосредственно перед переносом данных из объекта Java API в документ, в котором этот объект хранится.

    Функция

    должна возвращать

    возвращает значение типа Boolean. Если функция вернула false - сохранение будет прервано.

    Обработчики события

    querySave

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

    querySave текущей

    querySave текущей Схемы объекта,

     потом

    потом событие

    querySave той

    querySave той Схемы, которую она уточняет, и так далее до события

    querySave базовой Схемы.postSave - вызывается

    querySave базовой Схемы.

    Без форматирования
    function querySave(object, document) {
    	return true;
    }

    Параметры:

      • object - объект Java API, содержащий все изменения
      • document - объект Notes Java API, notes-документ, сохраненный ранее (до внесения изменений).

    Пример

    postSave

    Вызывается сразу после сохранения документа в хранилище.

    Обработчики события

    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 - название Свойства схемы, изменение которого вызвало пересчет объекта

    Пример

    Обработчики событий могут быть созданы к нескольким схемам, объединенным в одну иерархию.

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

    Код обработчика событий имеет доступ к Java API системы CMJ системы и подключенным к ней сторонним библиотекам. Для работы с тем или иным Java классом его или пакет, в котором он расположен, предварительно необходимо импортировать в обработчик. Для этого можно использовать функции importPackage() или importClass ().

    Блок кода
    languagejs
    importPackage (Packages.java.util); -
     импортирует
     импортирует все классы, расположенные в пакете java.util.

    Как и в Java, импортируются только классы, находящиеся непосредственно в указанном пакете. Классы из дочерних пакетов импортированы не будут.

    Коду обработчика на JavaScript доступны все public методы реальных классов, реализующих те или иные интерфейсы Java API. Области видимости protected и private недоступны.

    Синтаксис работы с объектами Java классов точно такой же, как и с объектами JavaScript.

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

    Предупреждение

    Объекты

    Notes Java

    API CMJ, переданные в обработчик событий извне (например, параметр document), нельзя передавать в дополнительно объявленные функции. Работать с параметром document можно только внутри событий querySave и postSave.




    Свойства страницы
    Статус

    Статус
    colourGreen
    titleГотово

    Комментарий
    панель

    Теги и атрибуты:

    Оглавление