Проверка данных ЭУ
Данный раздел содержит описание примера проверки, изменения и отмены изменения состояния карточки. Подписаться на событие изменения состояния, провести проверку какого-нибудь поля и случае, если проверка не прошла, выдать предупреждающее сообщение и состояние не менять.
Ссылка на пример на GitHub: ValidateOnStateChanging.
Проект-расширение клиентской части Web-клиент. Содержит клиентский скрипт с функцией-обработчиком события validateOnStateChanging, проверку данных ЭУ
при смене состояния.
Пример рассчитан на версию Web-клиента dv6 или выше.
Сборка и установка
-
Откройте консоль в папке
ValidateOnStateChangingWebExtensionи выполните командуnpm install, затемnpm updateи в концеnpm run build:prod. -
Скопируйте каталог
SamplesOutput\Content\Modules\ValidateOnStateChangingWebExtensionв каталогПуть к сайту Web-клиента\Content\Modules. -
Перезапустите dvwebclient для Linux и Docsvision Web-client для Windows.
Проверка примера
-
Запустите конструктор разметок.
-
Импортируйте решение из файла
ValidateOnStateChangingLayout.xml. -
Сделайте решение
ValidateOnStateChangingLayoutактивным для карточки типа Документ вида ДокументУД/Исходящий. -
На разметке расположен ЭУ
Тексти кнопки операций (Start approving и др.) по изменению состояния карточки. -
Перезапустите dvwebclient для Linux и Docsvision Web-client для Windows.
-
Откройте новый документ ДокументУД\Исходящий и нажать кнопку редактировать. При этом должна открыться разметка с ЭУ
Тексти кнопками изменения состояния. Часть кнопок будет неактивна, это зависит от настроек ролевой модели. -
Если в ЭУ
Текстнет текста или длина текста превышает 100 символов, то при нажатии на кнопку изменения состояния возникает сообщение об ошибке и состояние не изменяется. -
В случае, если ЭУ
Текстпроходит валидацию, то состояние карточки меняется. Например при выполнении операцииStart approvingс состоянияDraftingна состояниеIs approving. -
При этом кнопки перехода исчезают, т.к. в состоянии
Is approvingоперацииStart approvingи др. не доступны.
| Данный пример демонстрирует только доступ к элементу разметки. При реализации расширений рекомендуется использовать экспорт разметок в виде Решения. |