1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Обработка (DataProcessor) |
| Имя | ВводКонтактнойИнформации |
| Полное имя | DataProcessors.ВводКонтактнойИнформации (Обработка.ВводКонтактнойИнформации) |
| Синоним | «Ввод контактной информации» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4.5.21 |
| Подсистема | «Контактная информация» (механизм БСП/SSL) |
| Где найти | e1cib/list/Обработка.ВводКонтактнойИнформации |
Назначение. Служебная обработка‑редактор структурированного ввода и разбора контактной информации (адрес, телефон, факс, e‑mail, веб‑сайт, «другое») для объектов конфигурации — справочников «Контрагенты», «Партнёры», «Организации», «Физические лица», «Склады (места хранения)», «Контактные лица» и т. п. Обработка не является учётным документом: она вызывается из полей контактной информации на формах объектов‑владельцев, формирует по введённым пользователем частям адреса нормализованное строковое представление и XML‑структуру и возвращает их в поле‑владелец. Хранение и последующее использование данных выполняет сам объект‑владелец и общий механизм контактной информации, а не эта обработка.
Важно: объект относится к инфраструктуре ввода данных и не участвует в налоговом и бухгалтерском учёте. Параметры РК‑учёта (ставка НДС 16 %, МРП 4 325 ₸, МЗП 85 000 ₸, вычет по ИПН 30 МРП, счета РК 1210/1030/3310/3130/6010 и т. д.) к логике этой обработки не применяются — здесь нет ни проводок, ни расчёта сумм. Числовые нормы приведены только как контекст конфигурации.
2. Реквизиты и табличные части
Обработка данного вида не хранит собственных данных в базе — реквизиты являются реквизитами формы и служат буфером ввода. Состав определяется видом редактируемой контактной информации.
Общие реквизиты (шапка формы)
| Реквизит | Назначение |
|---|---|
ТипКонтактнойИнформации |
Вид редактируемых данных: Адрес / Телефон / Факс / АдресЭлектроннойПочты / Скайп / АдресСайта / Другое |
Представление |
Итоговая строка контактной информации, возвращаемая в поле владельца |
ЗначенияПолей (XML) |
Структурированное XML‑представление разобранных частей (для адреса и телефона) |
Страна |
Страна адреса; для РК по умолчанию — Казахстан |
Комментарий |
Произвольный комментарий к контакту |
ДополнительнаяИнформация |
Служебные признаки (запрет редактирования, только просмотр и т. п.) |
Часть «Адрес»
| Реквизит | Назначение |
|---|---|
Индекс |
Почтовый индекс |
Регион / КодРегиона |
Область/регион (для РК — область/город республиканского значения) |
Район |
Район |
Город |
Город/населённый пункт городского типа |
НаселённыйПункт |
Село, посёлок и пр. |
Улица |
Улица/микрорайон |
Дом, Корпус, Квартира |
Уточнение адреса |
Часть «Телефон / Факс»
| Реквизит | Назначение |
|---|---|
КодСтраны |
Международный код (для РК — +7) |
КодГорода |
Код города/оператора |
Номер |
Основной номер |
Добавочный |
Добавочный номер |
Табличные части. В явном виде табличные части в обработке, как правило, отсутствуют. Для отображения и разбора набора частей адреса используются таблицы значений формы (не реквизиты объекта), например список полей адреса, формируемый динамически по стране.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаАдреса | Пораздельный ввод адреса (страна, регион, район, город, улица, дом), проверка и нормализация, сборка итогового представления |
| ФормаТелефона | Ввод телефона/факса по частям (код страны, код города, номер, добавочный) |
| ФормаДругое | Ввод произвольного значения для видов e‑mail, сайт, скайп, «другое» с базовой проверкой формата |
| Форма (основная) | Диспетчер, открывающий нужную форму ввода в зависимости от ТипКонтактнойИнформации |
Форма открывается модально/блокирующе из поля контактной информации объекта‑владельца по нажатию кнопки выбора («…»), после подтверждения возвращает представление и XML в вызвавшую форму.
4. Ключевые процедуры модулей
В приложенном evidence присутствует только фасет «назначение» (без путей
путь:строкаи текста BSL). Ниже — типовой состав обработчиков для обработки данного вида в механизме контактной информации.
ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)— разбор входного параметра (XML/строка), определение вида КИ и страны, инициализация полей формы под нужный набор частей.ПриОткрытии(Отказ)— донастройка видимости/доступности элементов, установка фокуса на первое поле ввода.ОК(Команда)/ЗаписатьИЗакрыть()— сборка представления из частей, формирование XML‑структуры, проверка заполнения и возврат результата в поле‑владелец черезОповеститьОВыборе/ЗакрытьФорму.ОбработкаВыбора(...)— приём результата из вложенных форм (например, выбор региона/страны из классификатора).ПредставлениеПриИзменении(Элемент)— обратный разбор: при ручном редактировании строки — попытка распарсить её на части.ПроверитьЗаполнение()/ серверные проверки — контроль корректности индекса, формата e‑mail, кода страны/города телефона.
Собственно разбор/сборка КИ выполняется через общий модуль механизма контактной информации (менеджер контактной информации БСП), а обработка выступает интерфейсом ввода поверх него.
5. Проведение и движения
Обработка не проводится и не формирует движений по регистрам накопления/сведений и бухгалтерских проводок — это не документ. Соответственно:
- проводки по плану счетов РК (1210, 1030, 1330, 3310, 3130, 6010, 7010) данной обработкой не создаются;
- налоговые движения (НДС 16 %, ИПН, ОПВ/ОПВР, ВОСМС/ОСМС, СО, соцналог) отсутствуют;
- электронные документы ЭСФ (ИС ЭСФ) и СНТ не формируются.
Результат работы обработки — нормализованные строка‑представление и XML контактной информации. Их сохранение выполняет объект‑владелец: значения записываются в регистр сведений «КонтактнаяИнформация» (в разрезе владельца и вида КИ) при записи самого справочника/документа‑владельца. Именно этот регистр, а не обработка, является местом хранения адресов, телефонов и e‑mail.
6. Связанные объекты и ввод на основании
- Виды контактной информации (справочник) — определяет доступные виды КИ у владельцев и их настройки.
- Регистр сведений «КонтактнаяИнформация» — хранилище введённых значений.
- Объекты‑владельцы: справочники «Контрагенты», «Партнёры», «Организации», «Физические лица», «Контактные лица», «Склады», а также объекты, где на формах размещены поля КИ.
- Ввод на основании к обработке неприменим (обработка не участвует в цепочках «на основании»); она вызывается из форм владельцев как редактор поля.
7. Точки расширения
- Расширение конфигурации: подключение к формам обработки (
ФормаАдреса,ФормаТелефона,Форма) обработчиковПриСозданииНаСервере/ПриОткрытиидля добавления собственных проверок, полей или предзаполнения по стране (например, обязательность области для РК). - Программные интерфейсы механизма КИ (БСП): переопределяемые общие модули менеджера контактной информации — для настройки правил разбора/сборки, состава полей адреса и валидаций.
- Виды контактной информации: настройка проверок заполнения, шаблонов представления и признаков обязательности без изменения самой обработки.
- Подписки/обработчики записи владельцев: дополнительная нормализация или синхронизация значений КИ при записи объекта‑владельца.
Требует проверки (версионно‑специфично): точный перечень форм и имён реквизитов может отличаться между редакциями БСП, встроенной в УТ для Казахстана 3.4.5.21 — уточняется по конкретному релизу конфигурации.