Формат значений для форматированных полей в файле конфигурации

Чтобы настроить получение и отправку форматированных полей для всей Системы, в настройках приложения в appsettings.json измените значение флага IsFormattedTextInPublicApiEnabled (bool):

  • true — значение форматированных полей выводятся/принимаются в формате HTML (значение по умолчанию).
  • false — значение форматированных полей выводятся/принимаются в формате PlainText.

В методах публичного API для работы с сущностями с форматированными полями за отображение форматированного поля отвечает необязательный параметр IsFormattedTextEnabled:

  • true — значение форматированных полей выводятся/принимаются в формате HTML.
  • false — значение форматированных полей выводятся/принимаются в формате PlainText.
  • null — для определения формата значения применяется общесистемный флаг IsFormattedTextInPublicApiEnabled (значение по умолчанию).

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

  • Text — в месте расположения ссылки в значении поля выводится заголовок ссылки (значение по умолчанию).
  • Url — в месте расположения ссылки в значении поля выводится значение атрибута href-ссылки.
  • Both — в месте расположения ссылки в значении поля выводится заголовок и значение атрибута href-ссылки в формате: [заголовок] (ссылка).

При изменении формата ссылки (значение параметра LinkFormatInPlaintText) не выполняется миграция данных — т.е. старые данные, когда в PlainText уже отображается ссылка в формате, который был установлен ранее, данные не обновятся до перезаписи сущности с форматированным полем.

При получении через публичный API данных поля, содержащего ссылку, и при выключенном форматировании (IsFormattedTextInPublicApiEnabled = false или IsFormattedTextEnabled = false) и последующей записи полученных значений допускается потеря информации о ссылке или о заголовке ссылки для форматов ссылки Text и URL соответственно.