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

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

Ключ

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

Элемент string в корневом элементе 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}">
        
        <!--Свойства схемы -->
		<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.

Блок кода
languagesql
titleПример SQL. Получение значение из поля stage
select tfs."value" as v
from tn_field
JOIN tn_field_string tfs ON tn_field.id = tfs.id AND tn_field.cmjfield = 'stage'

calc-values

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

script

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

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

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

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

locale
Язык. Используется в мультиязычной инсталляции системы. Указывает, какое вычисление будет применено для выбранного языка. Учитывается локализация пользователя. Если выражения для локали пользователя нет, то выражение с locale="default" или без locale
Блок кода
languagexml
titleПример 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

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

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

recalc-processing-class

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

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

Статус
colourGreen
titleГОТОВО

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

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

Оглавление