Что такое валидация документа в еис
Валидация
Валидация — это проверка значений, указанных пользователем, и отображение найденных ошибок.
Описанное здесь поведение валидаций и отображение ошибок реализовано в библиотеке «React UI Validations», по возможности используйте эту библиотеку в продукте.
Принципы
Валидация на только что открытой пустой форме запрещена. Исключение — черновики, когда пользователь уже заполнял эту форму, через какое-то время вернулся к ней, а она заполнена с ошибками.
Виды валидации
Существует три вида валидаций: мгновенная, по потере фокуса и по отправке формы.
Чем раньше интерфейс сообщает об ошибке, тем лучше — пользователю проще вернуться и исправить ошибку.
Самый быстрый способ сообщить об ошибке — мгновенная валидация. Но она возможна только в тех случаях, когда в процессе ввода понятно, что значение некорректное. Обычно такие ошибки связаны с неправильной раскладкой клавиатуры (кириллица вместо латиницы) или вводом букв в цифровое поле (ИНН, КПП и др.) Для этих случаев мы используем поля с масками: ввод неподходящих символов в них заблокирован. Поэтому в наших интерфейсах есть только два вида валидации:
Валидация по потере фокуса
Когда использовать
Этот вид валидации подходит для большинства случаев.
Как работает
Не валидируйте поля на пустоту по потере фокуса — не показывайте ошибку если поле не заполнено, возможно пользователь вернется и заполнит поле чуть позже. Показывать ошибку в таких случаях можно только после отправки формы.
Валидация срабатывает сразу после потери фокуса, если значение в поле заполнено. Если найдена ошибка, поле подсвечивается красным. Фокус в это поле автоматически не возвращается:
Текст ошибки появляется в тултипе, когда поле получает наведение или фокус:
Поле с ошибкой должно остаться подсвеченным, если оно получило фокус, его значение не исправляли, а затем оно потеряло фокус.
Красная подсветка снимается с поля, как только пользователь начал исправлять ошибочное значение.
Валидация при отправке формы
Когда использовать
Используйте этот вид валидации, когда нельзя проверить поля по потере фокуса. Например, для проверки заполнения обязательных полей.
Как работает
Проверка происходит после того, как пользователь нажал кнопку отправки данных: все поля с ошибками на форме подсвечиваются, страница прокручивается к первому полю с ошибкой, фокус перемещается в это поле, курсор встает в конец строки, рядом с полем появляется тултип с подсказкой.
При прокрутке к первому полю от верхней границы окна до ошибочного поля остается отступ 48px — шесть модулей.
Блокирование кнопки отправки
В небольших формах вместо проверки заполнения обязательных полей можно блокировать кнопку отправки формы. Используйте это поведение, когда очевидно, почему кнопка отправки формы неактивна. Например, на форме входа:
Как только заполнены все обязательные поля — кнопка становится активной. Если после этого пользователь стер значение в одном из полей — кнопка снова должна стать не активной.
Сообщения об ошибках
Об ошибках можно сообщать двумя способами:
Из этих двух способов мы рекомендуем использовать тултипы. Они идут отдельным слоем, поэтому не раздвигают форму и легко размещаются, даже если поля на форме расположены плотно.
Тултипы
Как работают
Тултип с подсказкой появляется в двух случаях:
Если значение в поле с ошибкой было изменено, потеряло фокус, а потом заново оказалось в фокусе — тултип с текстом старой ошибки уже не возникает. Это правило одинаково работает для всех типов валидаций: и по потере фокуса, и при отправке формы.
Тултип исчезает, когда:
Тултип по наведению перекрывает тултип по фокусу.
Тултип может появляться сверху или справа от контрола с ошибкой, так чтобы он не перекрывал полезную информацию:
Единообразие поведения и внешнего вида
Показывайте тултипы справа от полей. Eсли в этом случае они перекрывают важное содержимое на странице, выводите тултипы сверху. Придерживайтесь единообразия, но помните, что контент важнее него.
Красные тексты на странице
Как работают
Красный текст ошибки появляется сразу, как только произошла валидация и ошибочное поле подсветилось.
Как только пользователь начал исправлять значение, красная подсветка поля исчезает, и цвет текста ошибки меняется на черный — #333.
Текст ошибки пропадает по потере фокуса и больше не появляется, если поле заново получает фокус. Это правило одинаково работает для всех типов валидаций: и по потере фокуса, и при отправке формы.
Выводите текст ошибки справа, если на форме есть место, а само сообщение короткое. Так форму не придется раздвигать, чтобы показать ошибку.
Если справа от поля нет места для текста, раздвигайте форму и выводите сообщение под полем.
На более сложных формах выводите сообщение об ошибке в тултипе.
Валидация зависимых полей
Зависимые поля — это поля, значение которых зависит друг от друга.
Ошибки, которые связаны с нарушением зависимости полей, мы показываем после сабмита формы. Например, ИНН и КПП. Если пользователь указал ИНН из 10 цифр, а поле с КПП оставил пустым, после отправки формы пустое поле с КПП будет подсвечено.
ИНН может быть двух видов:
Если пользователь указал ИНН из 12 цифр, значит организация — индивидуальный предприниматель, и у нее нет КПП, значит поле КПП заполнять не нужно. И наоборот, если заполнено КПП, а ИНН указан 12-значный, возможно неверно указан ИНН.
Подсветка зависимых полей пропадает, как только пользователь начал исправлять значение в одном из этих полей.
Если при заполнении зависимого поля нарушен формат значения, сообщайте о такой ошибке при потере фокуса. Например, пользователь ввел 3 цифры в поле ИНН и убрал фокус. Такое поле должно подсветиться сразу же.
Пример
Есть форма из 5 полей:
Пользователь пропустил поле с названием организации, заполнил ИНН значением из 10 цифр, перешел в поле почты, указал некорректный адрес, перешел в поле с телефоном и указал некорректный номер, но из поля пока не ушел:
Пользователь навел курсор на поле с почтой, появился тултип. Но исправлять значение пользователь не стал:
Пользователь нажал кнопку «Отправить» — фокус перешел в поле «Название организации», так как оно обязательное и незаполненное:
Поле с телефоном также подсветилось красным, так как заполнено некорректно. ИНН и КПП подсветились, так как ИНН состоит из 10 цифр, значит должен быть заполнен и КПП — валидация зависимых полей произошла только после отправки формы.
Пользователь начинает вводить название организации, подсветка поля гаснет, а текст подсказки остается:
Заполнил название организации, перешел в поле ИНН:
Понял, что ИНН правильный, и нужно заполнить КПП:
Начал заполнять поле КПП. Красная рамка у ИНН и КПП исчезла — пользователь изменил значение в одном из зависимых полей:
Заполнил КПП, перешел в следующее поле:
Исправил почту, перешел в следующее поле:
Исправил телефон, кликнул за пределами поля:
Теперь по нажатию кнопки «Отправить» все будет хорошо.
Реализованный пример этой формы можно посмотреть в библиотеке валидаций.
Перечень ошибок и пути их решения, которые возникают при формировании документов в ГИС
Сформирован перечень ошибок и пути их решения, которые возникают при формировании документов в государственной системе Омской области в сфере закупок товаров, работ, услуг.
1. Планы закупок
Вопрос 1. При переводе плана закупок в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. Следующие идентификационные коды закупок не уникальны в пределах планов закупок, размещенных организацией xxxxxxxxxxxxxxxxxxxxxxxxxxxx»:
172553500299055350100101040002120244
172553500299055350100101690000000244″.
Ответ: Данная ошибка связана с тем, что в ЕИС план закупок был опубликован(изменен) напрямую в личном кабинете (далее — ЛК) ЕИС и статус контроля такого документа указан «На контроле». Необходимо чтобы финансовый орган (далее — ФО) подписал в ЛК ЕИС отрицательный результат контроля, т.е. «Контроль не пройден», а в ГИС план закупок необходимо перевести в состояние «На доработку от ФО». Затем заказчики переводят план закупок в состояние «Редактируется», все позиции плана закупок переходят в состояние «Редактируется». Затем позиции плана закупок переводят в состояние «Ввод завершен». План закупок необходимо перевести в состояние «На размещении» и он должен появится в ЛК ЕИС, где заказчик должен направить его на контроль в ФО.
Вопрос 2. При переводе плана закупок в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. У плана закупок с реестровым номером 201703522000327001 уже присутствует более поздняя версия 1 или редакция 0».
Ответ: Данная ошибка связана с тем, что в ЕИС план закупок был изменен напрямую в ЛК ЕИС и статус контроля такого документа указан «На контроле». Необходимо чтобы финансовый орган (далее — ФО) подписал в ЛК ЕИС отрицательный результат контроля, т.е. «Контроль не пройден», а в ГИС план закупок необходимо перевести в состояние «На доработку от ФО». Затем заказчики переводят план закупок в состояние «Редактируется», все позиции плана закупок переходят в состояние «Редактируется». Затем позиции плана закупок переводят в состояние «Ввод завершен». План закупок необходимо перевести в состояние «На размещении» и он должен появится в ЛК ЕИС, где заказчик должен направить его на контроль в ФО.
Вопрос 3. При переводе плана закупок в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. Объект с внешним идентификатором krista.52000000.0.703914 уже существует на ООС для организации с кодом СПЗ 03523000344».
Ответ: Данная ошибка связана с тем, что в ЕИС план закупок был заведен напрямую в ЛК ЕИС и статус контроля такого документа указан «На контроле». Необходимо чтобы финансовый орган (далее — ФО) подписал в ЛК ЕИС отрицательный результат контроля, т.е. «Контроль не пройден», а в ГИС план закупок необходимо перевести в состояние «На доработку от ФО». Затем заказчики переводят план закупок в состояние «Редактируется», все позиции плана закупок переходят в состояние «Редактируется». Затем позиции плана закупок переводят в состояние «Ввод завершен». План закупок необходимо перевести в состояние «На размещении» и он должен появится в ЛК ЕИС, где заказчик должен направить его на контроль в ФО.
2. Планы-графики
Вопрос 4. При переводе плана-графика в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. Следующий номер версии плана-графика с номером 2017036820000850020001 должен быть 4».
Ответ: Данная ошибка связана с тем, что в ЕИС изменения в план-график были внесены напрямую в ЛК ЕИС и статус контроля такого документа указан «На контроле». Необходимо чтобы финансовый орган (далее — ФО) подписал в ЛК ЕИС отрицательный результат контроля, т.е. «Контроль не пройден», а в ГИС план-график необходимо перевести в состояние «Редактируется», все позиции плана-графика переходят в состояние «Редактируется». Затем позиции плана-графика переводят в состояние «Ввод завершен». В плане-графике в поле «Номер версии» необходимо указать номер версии. Затем план-график необходимо перевести в состояние «На размещении» и он должен появится в ЛК ЕИС, где заказчик должен направить его на контроль в ФО.
Вопрос 5. При переводе плана-графика(изменения плана-графика) в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. Непредвиденная ошибка в интеграционном адаптере РПГ java.lang.NullPointerException at ru.lanit.fz44.validation.rpg.impl.PlanGraphValidatorImpl$2.validate(PlanGraphValidatorImpl.java:152) at ru.lanit.fz44.validation.rpg.impl.PlanGraphValidatorImpl$2.validate(PlanGraphValidatorImpl.java:105) at ru.lanit.fz44.validation.rpg.impl.ValidationFacadeImpl.validateForPublish(ValidationFacadeImpl.java:58) at ru.lanit.fz44.ejb.validation.rpg.impl.PlanGraphValidationBean.validateForPublish(PlanGraphValidationBean.java:57) at ru.lanit.fz44.ejb.validation.rpg.api.EJSRemote0SLplanGraphValidationBean_35ef598a.validateForPublish(EJSRemote0SLplanGraphValidationBean_35ef598a.java) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:60) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:37) at java.lang.reflect.Method.invoke(Method.java:611) at com.ibm.CORBA.iiop.ClientDelegate$3.run(ClientDelegate.java:1190) at java.security.AccessController.doPrivileged(AccessController.java:338) at com.ibm.CORBA.iiop.ClientDelegate.invoke0(ClientDelegate.java:1187) at com.ibm.CORBA.iiop.ClientDelegate$ClientDelegate0.invoke(ClientDelegate.java:1424) at com.sun.proxy.$Proxy195.validateForPublish(Unknown Source) at ru.lanit.fz44.ejb.validation.rpg.api._PlanGraphValidation_Stub.validateForPublish(_PlanGraphValidation_Stub.java) at ru.lanit.fz44.ejb.service.rpg.business_transaction.UnitOfWorkIntegration.validate(UnitOfWorkIntegration.java:56) at ru.lanit.fz44.ejb.facade.rpg.integration.impl.IntegrationSaveServiceBean.saveAndPublishPlanGraph(IntegrationSaveServiceBean.java:64) at sun.reflect.GeneratedMethodAccessor1395.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:37) at java.lang.reflect.Method.invoke(Method.java:611) at com.ibm.ejs.container.EJSContainer.invokeProceed(EJSContainer.java:5882) at co».
Ответ: Данная ошибка связана с ошибками приема файлов со стороны ЕИС. ЕИС должен устранить данную проблему. Пробуйте периодически отправлять план-график. Если данная ошибка не устранена, то необходимо написать в ТП ЕИС о данной проблеме.
Вопрос 6. После прохождения финансового контроля по п.5 ст. 99 44-ФЗ ФО переводит документа в состояние «Согласовано ФО», но через некоторое время документ переходит в состояние «В работе ФО» и возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: Непредвиденная ошибка в интеграционном адаптере Бюджетного контроля. В ЛК органа контроля не найден контролируемый документ в статусе «На контроле» с идентификатором, равным значению поля «Внешний идентификатор документа, направленного на контроль» (refExternalId) 689243 или значению поля «Идентификатор документа, направленного на контроль» (refId) 313658».
Ответ: До ЛК ЕИС не доходит результат контроля. Если документ будет размещен в ЕИС, то такие документы будут переведены в состояние «Утвержден» автоматически на следующий день после публикации. Ошибка со стороны ЕИС.
3. Определение поставщика (подрядчика, исполнителя)
Вопрос 7. При формировании изменений по закупкам, кроме закупок по единственному поставщику(подрядчику, исполнителю) и переводе в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Некорректные данные; Описание: IDE. Поскольку извещение в ЕИС находится в статусе Контроль не пройден изменения извещения на ЕИС ожидаются с тем же номером изменения 1, что и номер изменения в ранее принятом извещении. Уровень ошибки: error; Ошибка: Некорректные данные; Описание: IDE. Для требования Заказчика с кодом по СПЗ 03523000034 сведения о связи с планом-графиком не могут быть изменены».
Ответ: Данная ошибка связана с ошибками приема файлов со стороны ЕИС. ЕИС должен устранить данную проблему. Пробуйте периодически отправлять изменения в закупку. Если данная ошибка не устранена, то необходимо написать в ТП ЕИС о данной проблеме.
Вопрос 8. При формировании изменений по закупкам, кроме закупок по единственному поставщику(подрядчику, исполнителю) и переводе в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Некорректные данные; Описание: IDE. Для требования Заказчика с кодом по СПЗ 03523001838 сведения о связи с планом-графиком не могут быть изменены».
Ответ: Данная ошибка связана с ошибками приема файлов со стороны ЕИС. ЕИС должен устранить данную проблему. Пробуйте периодически отправлять изменения в закупку. Если данная ошибка не устранена, то необходимо написать в ТП ЕИС о данной проблеме.
Вопрос 9. При формировании извещения по закупкам и переводе в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Некорректные данные; Описание: IDE. Текущее значение статуса извещения (изменения извещения) — «Контроль не пройден». Размещение извещения (изменения извещения) может выполняться, только если статус извещения (изменения извещения) равен Формирование извещения, Формирование изменения извещения, Согласовано УО, На согласовании УО».
Ответ: Необходимо данный документ удалить и сформировать заново извещение о закупке и отправить в ЛК ЕИС.
4. Сведения о контракте (его изменении)
Вопрос 10. При переводе первичных сведений о контракте в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: Непредвиденная ошибка в интеграционном адаптере РГК. У организации-заказчика уже существует контракт с таким же номером с поставщиками Открытое акционерное общество «ОмскВодоканал», не находящийся в статусе «Исполнение прекращено»».
Ответ: Необходимо проверить существуют ли такие первичные сведения о контракте (его изменении) в ЛК ЕИС. Если данные сведения отсутствуют в ЛК ЕИС, то с данной ошибкой необходимо обращаться в ТП ЕИС.
Вопрос 11. При переводе первичных сведений о контракте в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: UE. Для юридических лиц не может быть указан код ОКОПФ соответствующий значению «Индивидуальный предприниматель». Информацию об индивидуальном предпринимателе необходимо указывать как для физических лиц».
Ответ: Необходимо проверить поле ОКОПФ в ГИС в справочнике «Контрагенты»/»Физические лица». Если данное поле заполнено(не заполнено) не корректно, то необходимо поправить значение в данном поле и повторить выгрузку в ЕИС.
Вопрос 12. При переводе первичных сведений о контракте в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: Непредвиденная ошибка в интеграционном адаптере РГК. В ЕИС уже существует проект контракта с внешним идентификатором документа externalID krista.52000000.0.717891 и кодом организации заказчика по СПЗ 03522000235.».
Ответ: Первичные сведения были отправлены успешно в ЛК ЕИС, но затем ФО провел контроль в ГИС и контроль в ГИС «Не пройден». Затем ФО перевел сведения о контракте в состояние «На доработку от ФО», но результат контроля, по техническим причинам со стороны ЕИС, не пришел в ЛК ФО. Такие сведения о контракт находятся в ЛК заказчика в состоянии «На контроле». Чтобы повторить повторную выгрузку сведений о контракте из ГИС в ЕИС необходимо чтобы сведения о контракте, которые находятся в ЛК ЕИС ФО сменил статус контроля в «Контроль не пройден». Затем повторить экспорт сведений из ГИС в ЕИС.
Вопрос 13. При переводе измененных сведений о контракте в состояние «На размещении» документ отправляется в личный кабинет ЕИС, но через некоторое время возвращается с ошибкой вида: «Документ не загружен на ООС из за ошибок: Уровень ошибки: error; Ошибка: Непредвиденная ошибка в ходе обработки; Описание: Непредвиденная ошибка в интеграционном адаптере РГК. Поскольку документ в ЕИС находится в статусе На контроле, изменения документа в ЕИС не принимаются.».
Ответ: Измененные сведения были отправлены успешно в ЛК ЕИС, но затем ФО провел контроль в ГИС и контроль в ГИС «Не пройден». Затем ФО перевел сведения о контракте в состояние «На доработку от ФО», но результат контроля, по техническим причинам со стороны, не пришел в ЛК ФО. Такие сведения о контракт находятся в ЛК заказчика в состоянии «На контроле». Чтобы повторить повторную выгрузку сведений о контракте из ГИС в ЕИС необходимо чтобы сведения о контракте, которые находятся в ЛК ЕИС ФО сменил статус контроля в «Контроль не пройден», но на данный момент ФО ничего с ними сделать не может, т.к. результат контроля не экспортируется из ГИС. Ошибка на данный момент не устранена.
Вопрос 14. При переводе измененных сведений о контракте из состояния «Согласовано ФО» в состояние «Подписан», документ возвращается с ошибкой вида: «Ошибка отправки данных через сервис обмена: [Ошибка при импорте контрактов Определение места документа: последнее уточнение не утверждено]».
Ответ: Ошибка означает, что в первичной версии контракта в поле «Состояние бюджетных обязательств» указано «На согласовании ФО» и сведения присутствуют в программе АС Бюджет. Изменения в сведения о контракте возможно отправлять в ЕИС (АС Бюджет) только в 2-х случаях: 1. Если в поле «Состояние бюджетных обязательств» указано значение
«Приняты» или 2. Если в поле «Состояние бюджетных обязательств» указано значение «Отклонены».