Дерево страниц
Skip to end of metadata
Go to start of metadata

Элемент string в корневом элементе 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}">
        
        <!--Свойства схемы -->
		<string name="{name}" createlog="true">
      		<storage-field name="{name}"/>
		   	<calc-values>
       			<script event="open" lang="SPEL"><![CDATA[...]]></script>
      		</calc-values> 
	 	</string>

	 	<string name="{name}">
      		<storage-field name="{name}"/>
        		<validate-regex>^[0-9]*$</validate-regex> 
	 	</string>

	 	<string name="{name}" default-value="default">
      		<storage-field name="{name}"/>
	 	</string>
     
	 	<string name="{name}" array="true">
      		<storage-field name="{name}"/>
		  	<default-values>
        		<default-value>default_1</default-value>
       			<default-value>default_2</default-value>
      		</default-values>
	 	</string>
         
    </schema>
</schemas>

attributes

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

name

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

computed

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

array

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

required

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

temporal

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

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

default-value

Текстовое значение по умолчанию

createlog

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

storage-field

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

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

name

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

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

calc-values

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

script

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

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

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

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

locale
Язык. Используется в мультиязычной инсталляции системы. Указывает, какое вычисление будет применено для выбранного языка. Учитывается локализация пользователя. Если выражения для локали пользователя нет, то выражение с locale="default" или без locale
Пример SpEL. Вычисление статуса
<string name="showState" temporal="true">
	<calc-values>
		<script event="open" lang="SPEL"><![CDATA[status.deleted == true ? 'Удален' : 
(registration==null || registration.number==null)? 'Проект' :'Зарегистрирован']]></script
	</calc-values>
</string>

default-values

Используется, если свойство схемы является массивом и нужно задать значения по умолчанию

ПараметрыОписание
default-value
Текстовое значение по умолчанию

validate

Валидация значения

ПараметрыОписание
regex
Маска валидации использует регулярные выражения (regex). С помощью регулярного выражения можно задать маску (шаблон) для значения Свойства схемы. Значение, введенное в соответствующее Свойству поле, будет проверено на соответствие указанному шаблону. С помощью маски для валидации можно контролировать правильный формат e-mail-адресов, номеров телефонов и т.п.
message

Текст сообщения, который выдается ввиде подсказки

Проверка на числа
<validate>
  <regex>^[0-9]*$</regex>
  <message locale="ru">Допустимый формат - арабские цифры без разделителей</message>
</validate>

recalc-processing-class

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

Пример. Вычисление формулы счетчика по умолчанию
<recalc-processing-class>ru.intertrust.cmj.rest.admin.so.employee.counter.RecalcSetDefaultCounterFormulaContracts</recalc-processing-class>
Статус

ГОТОВО

Комментарий

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