Компонент подтверждения персональных данных (ConfirmPersonalUserData)

Скопировать прямую ссылку на статью

Общая информация

Компонент ConfirmPersonalUserData предназначен для подтверждения пользователем своих персональных данных, с возможностью перейти на редактирование этих данных в ЛК

Поддерживаемые экраны

Компонент может быть задействован на экране типа:

Экран со сложным компонентом (UNIQUE)

Компонент в стандартной услуге

Внешний вид компонента

В конструкторе

Структура компонента ConfirmPersonalUserData

ВКУ		JSON
№	В конструкторе	Атрибут	Тип	Описание
1	Идентификатор компонента	id	string	Уникальный идентификатор компонента в JSON
2	Имя компонента	name	string	Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент
Дополнительные атрибуты
3	Документ	docType	string	Тип документа Возможный список документов: Паспорт РФ Загранпаспорт Паспорт иностранного гражданина Вид на жительство лица без гражданства Разрешение на временное проживание лица без гражданства Свидетельство о предоставлении временного убежища в РФ Удостоверение беженца Свидетельство о рождении (РФ) Иностранное свидетельство о рождении Свидетельство о рождении СССР Свидетельство о рождении старого образца
4	Документ	docName	string	Используется для отображения названия группы полей
5	Приоритет	priority	number	Задает приоритетность документов при поиске в ЛК. Приоритетность документа должна начинаться с 1, где 1 наивысший приоритет. Если настройка не задана, то приоритетность документов должна определяться по умолчанию в следующем порядке: Паспорт РФ Загранпаспорт Паспорт иностранного гражданина Вид на жительство лица без гражданства Разрешение на временное проживание лица без гражданства Свидетельство о предоставлении временного убежища в РФ Удостоверение беженца Свидетельство о рождении (РФ) Иностранное свидетельство о рождении Свидетельство о рождении СССР Свидетельство о рождении старого образца
6	Возвращать Имя и Фамилию пользователя из документа	nameFromDoc	boolean	Если true, то фамилия и имя должны браться из указанного документа, отчество не заполняется Если false, то ФИО полностью заполняются из ЛК
7	Тип	fields	array of objects	Массив возвращаемых полей и настройки их валидаций
8	Поле обязательное	required	string	Если атрибут установлен и в ЛК нет сведений, отобразится дисклеймер с ошибкой
9	Регулярное выражение	value	string	Позволяет указать регулярное выражение, по которому будет проверяться значение поля из ЛК
10	Заголовок ошибки	errorMsg	string	Позволяет указать заголовок дисклеймера, может быть с html тегами
11	Текст ошибки	errorDesc	string	Позволяет указать текст, который отобразится пользователю в случае, если значение не соответствует правилу валидации
12	Название группы	groupName	string	Позволяет задать название группы в html форме. Пример: ${lastName} ${firstName} ${middleName}. Если не задавать, отобразится группировка по умолчанию
13	Наименование	label	string	Наименование подписи для атрибута, которое отобразится пользователю
14	Значение	value	string	Позволяет выбрать поле, значение которого должно отобразиться
14.1	Скрывать поле при отсутствии значения	hideEmptyValue	boolean	Атрибут отвечает за отображение поля, если значение пришло пустое. Если true - то при пустом значении поле скрывается Если false - то поле отображается с прочерком. По умолчанию false
15.1	Включение поиска по загранпаспорту, если паспорт РФ не найден	checkFRG	boolean	Даёт возможность поиска по загранпаспорту. Для этого необходимо добавить поле «Серия паспорта РФ» Если в компоненте заданы настройки availableDocs, то атрибут будет скрыт
15.2	Пропуск поиска по паспорту РФ	vkuSkipCheckRf	boolean	Даёт возможность пропустить поиск по паспорту РФ. Если нужен поиск по загранпаспорту, необходимо добавить поле «Серия паспорта РФ». Иначе будет осуществляться поиск по паспорту иностранного гражданина Если в компоненте заданы настройки availableDocs, то атрибут будет скрыт
15.3	Документ должен быть верифицирован	docMustBeVerified	boolean	Если документ не верифицирован, то отобразится блокирующий дисклеймер
16	Надпись на кнопке	label	string	Название действия
17	Значение для передачи	value	string	Позволяет указать ссылку, если необходимо перейти на сторонний сайт
18	Действие	action	string	Позволяет выбрать тип действия — «Переход на редактирование персональных данных в ЛК», «Переход на редактирование паспортных данных в ЛК» или «Переход на сторонний сайт»
19	Заголовок сообщения при отсутствии документа в ЛК	title	string	Заголовок ошибки, отображаемой, если у пользователя нет ни одного документа из указанных в availableDocs документов. Если настройка не задана, то должна отображаться ошибка по умолчанию
20	Текст	value	string	Описание ошибки. Поддерживает возможность подстановки значений из аргументов (linkedValues)
21	Цвет	type	string	Цвет элемента: warn - желтый цвет info -серый error-красный
22	Заголовок сообщения	title	string	Позволяет настроить заголовок жёлтого дисклеймера
23	Текст сообщения	desc	string	Позволяет указать текст дисклеймера
24	Модальные окна с пояснениями	clarifications	array of objects	Позволяет раскрыть блок «Настроить модальное окно с пояснением вручную» или сделать список ссылок на пояснительные переходы
25	Настроить модальное окно с пояснением вручную	acceptableTypes	additionalProperties	Позволяет настроить модальные окна
26	Вычисляемые аргументы компонента (linkedValues)	linkedValues	array of objects	Атрибуты компонента, позволяющие реализовать сложный функционал
27	Создавать заявление на экране с данным компонентом	createOrder	boolean	Если атрибут установлен, то заявление будет создано только после ответа на этот компонент

Пример JSON структуры компонента передаваемой в DTO без настройки availableDocs

{

"visited": true,

"value": {

"states": [

{

"groupName": "Иванов Иван Иванович",

"fields": [

{

"label": "Дата рождения",

"value": "02.04.1995"

}

]

{

"groupName": "Паспорт гражданина РФ",

"fields": [

{

"label": "Серия и номер",

"value": "9138 776355"

{

"label": "Дата выдачи",

"value": "02.02.2021"

{

"label": "Кем выдан",

"value": "МВД России"

{

"label": "Код подразделения",

"value": "443-322"

{

"label": "Место рождения",

"value": "Москва"

{

"label": "СНИЛС",

"value": "015-656-704 74"

}

]

}

"storedValues": {

"firstName": "Иван",

"lastName": "Иванов",

"middleName": "Иванович",

"birthDate": "02.04.1995",

"birthPlace": "Москва",

"gender": "M",

"genderFull": "Мужской",

"docType": "RF_PASSPORT",

"rfPasportSeries": "9138",

"rfPasportNumber": "776355",

"rfPasportIssueDate": "02.02.2021",

"rfPasportIssuedBy": "МВД России",

"rfPasportIssuedById": "443322",

"rfPasportIssuedByIdFormatted": "443-322",

"citizenship": "РОССИЯ",

"citizenshipCode": "RUS",

"snils": "015-656-704 74"

"errors": []

}

Пример JSON структуры компонента передаваемой в DTO c настройкой availableDocs для ИГ

{

"visited": true,

"value":

{
  "states": [
    {
      "groupName": "Fisher Rufina ",
      "fields": [
        {
          "label": "Дата рождения",
          "value": "13.12.1976"
        },
        {
          "label": "Место рождения",
          "value": "Lake Tennieshire"
        }
      ]
    },
    {
      "groupName": "Документ, удостоверяющий личность",
      "fields": [
        {
          "label": "Серия и номер",
          "value": "4565 0793565007"
        },
        {
          "label": "Дата выдачи",
          "value": "04.12.2019"
        },
        {
          "label": "Кем выдан",
          "value": "OMVD russia"
        }
      ]
    }
  ],
  "storedValues": {
    "firstName": "Rufina",
    "lastName": "Fisher",
    "middleName": "",
    "birthDate": "13.12.1976",
    "birthPlace": "Lake Tennieshire",
    "gender": "M",
    "genderFull": "Мужской",
    "docType": "FID_DOC",
    "docName": "Паспорт иностранного гражданина",
    "series": "4565",
    "number": "0793565007",
    "issueDate": "04.12.2019",
    "issuedBy": "OMVD russia",
    "citizenship": "РУАНДА",
    "citizenshipCode": "RWA"
  },
  "errors": [
    {
      "type": "warn",
      "title": "Проверьте, чтобы данные в точности совпадали с паспортом",
      "desc": "Если нет, в услуге откажут.<p><a id='howto'> Как редактировать данные</a></p>",
      "icon": "yellow-line"
    }
  ]
}

Варианты использования

Данный компонент можно использовать для группировки определённых полей, содержащих информацию, и отображения в требуемом порядке. Для этого необходимо в расширенном режиме настройки компонента в блоке «Группировка» указать следующие настройки:

В поле «Название группы» указать ${lastName} ${firstName} ${middleName}
Создать в необходимой очередности поля для отображения:

Дата рождения
СНИЛС

Добавить ещё одну группу, указать название «Паспорт РФ» и создать следующие поля:

Серия и номер
Дата выдачи
Кем выдан
Код подразделения
Место рождения

Рисунок3.png

Компонент в услуге Робота Макса

Внешний вид компонента

В конструкторе

Структура компонента ConfirmPersonalUserData

ВКУ		JSON
№	В конструкторе	Атрибут	Тип	Описание
1	Идентификатор компонента	id	string	Уникальный идентификатор компонента в JSON
2	Имя компонента	name	string	Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент
Дополнительные атрибуты
4	Поле обязательное	required	string	Если атрибут установлен и в ЛК нет сведений, отобразится дисклеймер с ошибкой
5	Регулярное выражение	value	string	Позволяет указать регулярное выражение, по которому будет проверяться значение поля из ЛК
6	Заголовок ошибки	errorMsg	string	Позволяет указать заголовок дисклеймера, может быть с html тегами
7	Текст ошибки	errorDesc	string	Позволяет указать текст, который отобразится пользователю в случае, если значение не соответствует правилу валидации
8	Название группы	groupName	string	Позволяет задать название группы в html форме. Пример: ${lastName} ${firstName} ${middleName}. Если не задавать, отобразится группировка по умолчанию
9	Наименование	label	string	Наименование подписи для атрибута, которое отобразится пользователю
10	Значение	value	string	Позволяет выбрать поле, значение которого должно отобразиться
11	Включение поиска по загранпаспорту, если паспорт РФ не найден	checkFRG	boolean	Даёт возможность поиска по загранпаспорту. Для этого необходимо добавить поле «Серия паспорта РФ» Если в компоненте заданы настройки availableDocs, то атрибут будет скрыт
12	Пропуск поиска по паспорту РФ	vkuSkipCheckRf	boolean	Даёт возможность пропустить поиск по паспорту РФ. Если нужен поиск по загранпаспорту, необходимо добавить поле «Серия паспорта РФ». Иначе будет осуществляться поиск по паспорту иностранного гражданина Если в компоненте заданы настройки availableDocs, то атрибут будет скрыт
13	Документ должен быть верифицирован	docMustBeVerified	boolean	Если документ не верифицирован, то отобразится блокирующий дисклеймер
14	Надпись на кнопке	label	string	Название действия
15	Значение для передачи	value	string	Позволяет указать ссылку, если необходимо перейти на сторонний сайт
16	Действие	action	string	Позволяет выбрать тип действия — «Переход на редактирование персональных данных в ЛК», «Переход на редактирование паспортных данных в ЛК» или «Переход на сторонний сайт»
17	Заголовок сообщения	title	string	Позволяет настроить заголовок жёлтого дисклеймера
18	Текст сообщения	desc	string	Позволяет указать текст дисклеймера
19	Модальные окна с пояснениями	clarifications	array of objects	Позволяет раскрыть блок «Настроить модальное окно с пояснением вручную» или сделать список ссылок на пояснительные переходы
20	Настроить модальное окно с пояснением вручную	acceptableTypes	additionalProperties	Позволяет настроить модальные окна
21	Вычисляемые аргументы компонента (linkedValues)	linkedValues	array of objects	Атрибуты компонента, позволяющие реализовать сложный функционал
22	Создавать заявление на экране с данным компонентом	createOrder	boolean	Если атрибут установлен, то заявление будет создано только после ответа на этот компонент

Пример JSON структуры компонента передаваемой в DTO

{

    "visited": true,
    "value": {
        "states": [
            {
                "groupName": "Иванов Иван Иванович",
                "fields": [
                    {
                        "label": "Дата рождения",
                        "value": "02.04.1995"
                    }
                ]
            },
            {
                "groupName": "Паспорт гражданина РФ",
                "fields": [
                    {
                        "label": "Серия и номер",
                        "value": "9138 776355"
                    },
                    {
                        "label": "Дата выдачи",
                        "value": "02.02.2021"
                    },
                    {
                        "label": "Кем выдан",
                        "value": "МВД России"
                    },
                    {
                        "label": "Код подразделения",
                        "value": "443-322"
                    },
                    {
                        "label": "Место рождения",
                        "value": "Москва"
                    },
                    {
                        "label": "СНИЛС",
                        "value": "015-656-704 74"
                    }
                ]
            }
        ],

        "storedValues": {
            "firstName": "Иван",
            "lastName": "Иванов",
            "middleName": "Иванович",
            "birthDate": "02.04.1995",
            "birthPlace": "Москва",
            "gender": "M",
            "genderFull": "Мужской",
            "docType": "RF_PASSPORT",
            "rfPasportSeries": "9138",
            "rfPasportNumber": "776355",
            "rfPasportIssueDate": "02.02.2021",
            "rfPasportIssuedBy": "МВД России",
            "rfPasportIssuedById": "443322",
            "rfPasportIssuedByIdFormatted": "443-322",
            "citizenship": "РОССИЯ",
            "citizenshipCode": "RUS",
            "snils": "015-656-704 74"
        },
        "errors": []
    }
}

Варианты использования

В поле «Название группы» указать ${lastName} ${firstName} ${middleName}
Создать в необходимой очередности поля для отображения:

Дата рождения
СНИЛС

Добавить ещё одну группу, указать название «Паспорт РФ» и создать следующие поля:

Серия и номер
Дата выдачи
Кем выдан
Код подразделения
Место рождения

, чтобы оставить комментарий к статье