Атрибут типа "Текст в формате RTF"

Описание атрибута

Атрибут типа "Текст в формате RTF" предназначен для ввода и отображения текстовой информации с сохранением форматирования и отображения размеченного текста, а также изображений (image).

Значение атрибута типа "Текст в формате RTF" может начинаться и заканчиваться пробелом.

Настройки атрибута

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

Добавление атрибута в классе или типе объектов приводит к повышенной нагрузке системы и занимает продолжительное время. Добавление атрибута рекомендуется выполнять во время минимальной нагрузки на систему или во время технологических блокировок.

Параметры атрибута

Название параметра Описание и возможные значения Зависимость от других параметров
Название Название атрибута на карточках объектов и формах, на которых размещен данный атрибут  
Скрывать название атрибута

Признак, управляющий отображением названия атрибута в интерфейсе.

  • флажок снят — название атрибута отображается.
  • флажок установлен:

    В интерфейсе оператора:

    • В контентах "Параметры объекта", "Параметры связанного объекта", блок Подробнее в "Комментарии": отображается значение атрибута (если оно заполнено) и пользовательская кнопка (если она настроена для атрибута).

      Если значение атрибута не заполнено, то атрибут не отображается и пустого места под атрибут не остается.

    • В контенте "Параметры на форме" и других формах отображается только поле ввода значения. Если атрибут обязательный, то вместо заголовка отображается звездочка обязательности.
    • В контентах со списками, включая контент "Иерархическое дерево", название атрибута не отображается в названии колонки списка.

      Название атрибута отображается на форме настройки полей сложного списка и формах настройки фильтрации и сортировки списка.

    • На форме расширенного поиска (если атрибут выведен на нее) название отображается.

    Если название располагается над атрибутом (представление для отображения "Текст в формате RTF (по всей ширине)"), то пустого места под название не остается.

    В интерфейсе администратора название отображается серым цветом в контентах на вкладке "Карточка объекта", "Форма добавления", "Форма редактирования" и на форме просмотра настроек атрибута

 
Код

Идентификатор атрибута в системе.

Код должен быть уникален в рамках типа объектов, без учета регистра. Код может содержать от 1 до 14 символов, должен состоять только из символов латинского алфавита и цифр, начинаться с символа

 

Вычислимый

Признак, определяющий что значение атрибута автоматически вычисляется по определенному алгоритму, указанному в скрипте.

Устанавливается только на форме добавления атрибута.

  • Флажок установлен — значение атрибута автоматически вычисляется по определенному алгоритму, указанному в скрипте.

    Каждый раз при обращении к атрибуту в интерфейсе оператора происходит вычисление скрипта и формирование значения. При невозможности корректного вычисления значения атрибута по скрипту, сообщение об ошибке записывается в лог. Вычислимый атрибут при этом остается пуст или заполняется значением по умолчанию, если оно задано.

  • Флажок снят — значение атрибута устанавливается вручную.

Значение вычислимого атрибута:

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

Во вложенные типы объектов наследуется значение параметра "Вычислимый" вместе со значением параметра "Скрипт"

 

Скрипт для вычисления значения атрибута

В скрипте для вычисления значения атрибута не допустимо обращаться к внешнему источнику. Для взаимодействия с внешними системами необходимо использовать действие по событию типа "Скрипт" с признаком "Взаимодействие с внешней системой" или/и задачу планировщика.

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

Отображается, если установлен флажок "Вычислимый"

Определяемый по таблице соответствий

Признак, определяющий вычисление значения атрибута по таблице соответствий.

  • Флажок установлен — значение атрибута автоматически вычисляется по таблице соответствий и не редактируется в интерфейсе оператора.

    Значение атрибута вычисляется при добавлении объекта. Для существующих объектов значение атрибута переопределяется при изменении хотя бы одного из определяющих атрибутов.

  • Флажок снят — значение атрибута редактируется в интерфейсе оператора.

 

Правило определения

Таблица соответствий, по которой вычисляется значение атрибута.

При добавлении атрибута в поле установлено значение [не указано].

При редактировании атрибута в поле выбирается таблица соответствий. Для выбора доступны таблицы соответствий, у которых данный атрибут указан как определяемый

Отображается, если установлен флажок

"Определяемый по таблице соответствий"

Редактируемый

Признак, определяющий редактируемость атрибута в интерфейсе оператора.

  • Флажок установлен — значение атрибута можно изменять на формах добавления и редактирования объекта в интерфейсе оператора.
  • Флажок снят — значение атрибута не редактируется в интерфейсе оператора.

Редактируемость атрибута не влияет на выполнение специальных действий, например, "Смена ответственного", "Смена типа".

Для системных атрибутов значение параметра "Редактируемый" можно изменить, только если системное значение параметра "Редактируемый" = "Да".

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

 

Редактируемый в списках

Признак, определяющий редактируемость атрибута в списках объектов в интерфейсе оператора.

  • Флажок установлен — значение атрибута можно изменять в списке объектов в интерфейсе оператора. При редактировании значения атрибута в ячейке списка будет использоваться представление для редактирования, указанное в параметре "Представление для редактирования".
  • Флажок снят (по умолчанию) — значение атрибута в списке объектов не изменяется.

Доступен, если установлен флажок "Редактируемый"

Обязательный

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

  • Флажок установлен — значение атрибута является обязательным для заполнения в системе.
  • Флажок снят — значение не обязательно для заполнения.

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

Если значение атрибута содержит только служебную информацию для форматирования (непечатаемые символы, пустые html теги) без видимого текста, то такой атрибут считается не заполненным.

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

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

Обязательность системного атрибута можно изменить, если установлен флажок "Редактируемый" и системное значение параметра "Обязательный" = "нет". Пользовательские атрибуты по умолчанию являются необязательными.

Если обязательность атрибута устанавливается при наличии в базе данных ранее созданных не архивных объектов с незаполненным обязательным атрибутом, то при попытке сохранить изменение выводится сообщение о подтверждении действия. Если действие подтверждено, то проверка на заполнение значения атрибута будет выполняться: при добавлении новых объектов и при изменении ранее созданных объектов с незаполненным значением обязательного атрибута

 

Обязательный для заполнения в интерфейсе

Признак, определяющий обязательность заполнения значения атрибута в интерфейсе оператора.

  • Флажок установлен —значение атрибута является обязательным для заполнения на формах добавления и редактирования в интерфейсе оператора, если атрибут выведен на формы.
  • Флажок снят — значение не обязательно для заполнения.

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

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

Если флажок "Обязательный" установлен, то флажок "Обязательный для заполнения в интерфейсе" снят и недоступен для изменения

Уникальный

Флажок снят и недоступен для изменения. Значения атрибутов не уникальны

 

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

Признак, определяющий автоматическое заполнение значения атрибута на формах добавления и редактирования в интерфейсе оператора.

  • Флажок установлен —значение атрибута автоматически заполняется (или перерасчитывается) на формах добавления и редактирования объекта. Для расчета значения атрибута используется скрипт.
  • Флажок снят — значение заполняется вручную

Параметр отображается, если установлен флажок "Редактируемый" и сняты флажки "Вычислимый", "Определяемый по таблице соответствий"

Поле ввода скрипта для вычисления значения атрибута

Скрипт возвращает значение атрибута.

Отображается, если установлен флажок "Вычисление значения при редактировании"

Представление для отображения

Указывает, как выглядит атрибут в интерфейсе оператора на карточке объекта. Отображение атрибута в списке определяется при настройке колонок списка (см. Особенности отображения текста RTF в списках)

  • "Текст в формате RTF" — название атрибута и его значение располагаются рядом, в одной строке.
  • "Текст в формате RTF (по всей ширине)" — название атрибута располагается над его значением.

При выборе представлений "Текст в формате RTF" и "Текст в формате RTF (по всей ширине)" исключается возможность влияния стилей, определенных в значении атрибута, на отображение html страницы приложения. Содержимое текста RTF выводится внутри IFRAME, таким образом обеспечивая изоляцию содержимого RTF от основной страницы и запрет выполнения JavaScript.

  • "Текст в формате RTF, небезопасный".
  • "Текст в формате RTF, небезопасный (по всей ширине)".

    При выборе представлений "Текст в формате RTF, небезопасный" и "Текст в формате RTF, небезопасный (по всей ширине)" появляется возможность выполнения JavaScript, указанного в значении атрибутов-обработчиков событий тегов HTML — "onhover", "onclick", и т.д. (скрипты, размещенные в теге <script>, не выполняются).

Поддержка работоспособности и корректной работы JavaScript, выполняемых в поле атрибута "Текст в формате RTF, небезопасный", не входит в ответственность технической поддержки компании NAUMEN

 

Скрывать при отображении, если не заполнен

Признак, определяющий отображение атрибута, у которого не заполнено значение, на карточке объекта.

  • Флажок установлен — если значение атрибута не указано, то атрибут не отображается в контентах "Параметры объекта", "Параметры связанного объекта", "Информация о пользователе".
  • Флажок снят — атрибут всегда отображается.

Значение параметра не влияет на отображение атрибута на формах добавления и редактирования

Отображается, если снят флажок "Обязательный"

Представление для редактирования

Вид поля выбора значения атрибута на формах добавления и редактирования объекта и вид поля значения атрибута по умолчанию на текущей форме.

 

Описание

Подробное описание атрибута и рекомендации по его использованию, отображаемые в интерфейсе оператора.

Для ввода описания используется поле ввода "Текст в формате RTF".

Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке контента, в котором отображается атрибут (параметр "Показывать описание атрибутов)

Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке пользовательских форм:

Описание атрибута может применяться в качестве контекстной справки по каждому атрибуту.

Если значение параметра не указано, то описание атрибута в интерфейсе оператора не отображается.

Пример. При реализации процесса проведения опросов, в атрибутах класса "Анкета" (questionary) описание атрибутов служит для расширенной формулировки вопросов

 

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

Значение по умолчанию — используется для быстрого заполнения значений атрибутов при добавлении объекта в систему. В качестве значения по умолчанию рекомендуется выбирать наиболее вероятное значение атрибута.

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

Виды значения по умолчанию: фиксированное или вычислимое.

Фиксированное значение по умолчанию (флажок "Вычислимое" снят):

  • указывается в поле "Значение", вид поля соответствует выбранному для атрибута представлению для редактирования;
  • отображается в списке атрибутов (столбец "По умолчанию") в выбранном для атрибута представлении для отображения;
  • отображается в контентах на карточке объекта или формах добавления и редактирования объекта (для пользовательских атрибутов).

Вычислимое значение по умолчанию (флажок "Вычислимое" установлен):

Правила использования значения по умолчанию:

  • Если атрибут размещен на форме добавления объекта, то при открытии формы добавления значение атрибута будет заполнено значением по умолчанию. Пользователь может изменить значение по умолчанию вручную.
  • Если атрибут отсутствует на форме добавления объекта, то при добавлении объекта значение атрибута автоматически заполняется значением по умолчанию.
  • Если атрибут скрыт с формы добавления объекта, так как набор допустимых значений данного атрибута пуст, то при добавлении объекта значение по умолчанию не устанавливается.
  • Если на форме добавления объекта изменяется тип объекта, то значение атрибута заменяется на значение по умолчанию, при выполнении следующих условий:

    • для атрибута в выбранном типе указано значение по умолчанию;
    • до этого момента пользователь не изменял значение по умолчанию вручную на форме добавления.
  • Если параметр "Значение по умолчанию" устанавливается для существующего атрибута, то значение данного атрибута у существующих объектов не меняется.
  • Если параметр "Значение по умолчанию" устанавливается для нового атрибута, то во всех ранее созданных объектах значение атрибута остается пустым

Флажок "Вычислимое" (значение по умолчанию) отображается, если снят флажок "Вычислимый" (для атрибута)

Метки

Одна или несколько меток, определяющих процессы, в которых используется данный атрибут. Метка устанавливается для пользовательских атрибутов основных классов и типов объектов

 

Особенности отображения текста RTF в списках

При настройке набора колонок списка объектов для атрибутов типа "Текст в формате RTF" доступны следующие представления:

  • "Текст в формате RTF в соответствии с системной настройкой (очищенный от стилей) или (с сохранением стилей)" — значение по умолчанию.

    Вариант (очищенный от стилей) или (с сохранением стилей) зависит от системной настройки сложных списков (см. Настройка отображения атрибутов типа "Текст в формате RTF" в списке).

    Если в системной настройке выбрано значение "Да, кроме представлений с пометкой "небезопасное", то представление в списке принимает разные значения для "безопасных" и "небезопасных" представлений атрибута.

  • "Текст в формате RTF, очищенный от стилей" — стили очищаются во всех представлениях, для безопасных представлений текст RTF не вставляется в IFRAME;
  • "Текст в формате RTF с сохранением стилей" — текст RTF отображается со стилями, для безопасных представлений текст RTF вставляется в IFRAME.

Настройка колонок списка объектов:

Изображения в тексте RTF

Сжатие изображений в атрибутах "Текст в формате RTF"

Применение сжатия изображений в атрибутах "Текст в формате RTF" позволяет уменьшить объем памяти, занимаемый изображениями, и снизить нагрузку на систему.

Сжатие изображений в атрибутах "Текст в формате RTF" настраивается в разделе "Настройка системы" → "Администрирование" → блок "Прочие настройки", см. Прочие настройки.

Параметры сжатия изображений:

  • "Сжатие изображений в атрибутах "Текст в формате RTF" — определяет сжимается ли в системе изображение, добавленное в тексте RTF:

    • флажок снят (по умолчанию) — изображение не сжимается;
    • флажок установлен — изображение будет сжиматься до n %, указанных в коэффициенте.
  • "Коэффициент сжатия изображений в атрибутах "Текст в формате RTF" — % сжатия изображения. По умолчанию 0.75 (сжатие до 75% от оригинального размера). Если 1, то остается исходное изображение.

Чтобы изменить значение параметра, нажмите кнопку "Редактировать", установите значения параметров и нажмите кнопку Сохранить.

Особенности изображений в тексте RTF

Особенности изображений, хранящихся в атрибуте типа "Текст в формате RTF":

  • Изображение, загруженное в систему, хранится в виде файла в базе данных или в файловом хранилище.
  • Изображение, размер которого хотя бы по одной из величин (высота, ширина) превышает установленный максимальный размер, пропорционально сжимается.

    В системе хранятся сразу оба варианта изображения: в уменьшенном и оригинальном размере.

    В интерфейсе оператора изображение отображается в уменьшенном варианте. Для просмотра изображения в оригинальном размере используется окно просмотра файла.

    Максимальный размер изображения устанавливается в файле dbaccess.properties (параметр "max.rtf.image.size", по умолчанию 700 пикселей).

  • Отображение изображений в окне просмотра файла:

    • если изображение сжато до максимального размера (параметр "max.rtf.image.size") и выключен параметр "Сжатие изображений в атрибутах "Текст в формате RTF",

      то в окне просмотра файлов отображается файл в оригинальном размере;

    • если изображение сжато до максимального размера (параметр "max.rtf.image.size") и включен параметр "Сжатие изображений в атрибутах "Текст в формате RTF",

      то в окне просмотра файлов отображается сжатый файл.

  • При отображении атрибута данного типа в списке объектов изображения не показываются.
  • При копировании объектов с изображением в RTF атрибуте для объекта-копии создается отдельный файл с копией изображения.

Изображения в тексте RTF не отображаются, если источник изображения расположен по ссылке и URL этой ссылки содержит обратные слеши.

Способы добавления изображения поле ввода текста в формате RTF:

  • с помощью кнопки "Вставить изображение" в панели редактирования;
  • из буфера обмена;
  • при создании объекта скриптом, например, по письму.