Чтобы настроить получение и отправку форматированных полей для всей Системы, в настройках приложения в 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 соответственно.