CM. Руководство разработчика
Дерево страниц
Skip to end of metadata
Go to start of metadata

Элементы date, time, datetime и daterange в корневом элементе schema. Пространство имен: <schemas xmlns="http://www.intertrust.ru/schema/palette/tn-schema">

Краткое описание

Используется для работы с временными значениями

Структура XML 
<?xml version='1.0' encoding='UTF-8'?>
<schemas xmlns="http://www.intertrust.ru/schema/palette/tn-schema">
    <schema name="{name}">
     
         <!--Свойства схемы -->
		<datetime name="{name}" createlog="true">
      		<storage-field name="{name}"/>
		   	<calc-values>
       			<script event="open" lang="SPEL"><![CDATA[...]]></script>
      		</calc-values> 
	 	</datetime>

	 	<daterange name="{name}">
      		<storage-field name="{name}"/>
	 	</daterange>

	 	<date name="{name}" default-value="current">
      		<storage-field name="{name}"/>
	 	</date>
     
	 	<time name="{name}" array="true" computed="true">
      		<storage-field name="{name}"/>
	 	</time>
         
    </schema>
</schemas>

attributes

ПараметрыОписание

name

Название свойства

computed

Вычисляемое. Значение true указывает на то, что:
- выражение, заданное для вычисления значения свойства схемы, будет вычисляться при каждом вызове recalc ресурса;
- вычисленное значение всегда будет сохраняться в Системе при сохранении объекта, описанного родительской Схемой данных (поле «Не сохранять в документе» свойства схемы принимает значение false и становится не редактируемым);
- поле формы, связанное с этим свойством схемы, всегда будет не редактируемым.

array

Массив. Значение true указывает на то, что в качестве своего значения Свойство может содержать массив строк. 

Не используется для элемента daterange

required

Обязательное. Значение true означает, что Свойство является обязательным, и отсутствие его значения приводит к нарушению корректности структуры данных

temporal

Временное поле. Значение true означает, что значение данного Свойства не будет сохранено в Системе при сохранении объекта, описанного родительской Схемой данных. При этом выражение, заданное для вычисления значения свойства схемы, будет вычисляться при каждом вызове recalc ресурса.

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

default-value

Значение по умолчанию.

Для datetime следующие варианты current - Текущая дата и время, empty - Пусто

Для time следующие варианты current - Текущее время, empty - Пусто

Для date следующие варианты current - Текущая дата, offset - Смещение относительно текущей даты, empty - Пусто

Не используется для элемента daterange

offset

Смещение относительно текущей даты.  Для date указывается кол-во дней смещения.

Не используется для элемента daterange, datetime, time

createlog

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

storage-field

Информация о названии полей, которые будут использоваться при написании SQL-запроса.

ПараметрыОписание

name

Имя поля хранится в таблице tn_field в колонке cmjfield

Для datetime значений используется таблица tn_field_datetime.

Для date значений используется таблица tn_field_dateonly.

Для time значений используется таблица tn_field_timeonly.

Для daterange значений используется таблица tn_field_string.

calc-values

Формула вычисления значения на момент открытия и сохранения объекта

script

ПараметрыОписание
event

Тип события. Варианты: 

  • open - вычисление при открытии
  • save - вычисление при сохранении
lang

Язык программирования. Используется SpEL. 

Пример SpEL. Вычисление даты создания
 <datetime name="createdate" temporal="true">
 	<calc-values>
		<script event="open" lang="SPEL"><![CDATA[#this.creationDate != null ?
T(ru.intertrust.cmj.af.misc.AFDateTime).convertFromDate(T(java.util.Date).from(#this.creationDate.toInstant())) : null]]></script>
 	</calc-values>
 </datetime>

recalc-processing-class

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

Пример.Расчетный час
<time name="checkTime" system="true" temporal="true">
	<recalc-processing-class>
		ru.intertrust.cmj.rest.admin.so.RecalcForChangeWorkCycleIsType
	</recalc-processing-class>
</time>
Статус

ГОТОВО

Комментарий

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