Парное поле: ключ и значение с разными типами

«Парные поля для CRM» — приложение для портала, которое добавляет пользовательский тип поля «пара»: в одной ячейке хранятся связанные левая и правая части в виде строки `левая|||правая`, без необходимости заводить два отдельных пользовательских поля и связывать их вручную в отчётах и сценариях.


Для чего нужно приложение:
Когда в карточке сделки, лида, контакта, компании или смарт-процесса нужно рядом держать два связанных значения — удобно менеджеру в форме, понятно при выгрузке и в роботах; когда важно не плодить пары полей «подпись + число», «код + название», «флаг + комментарий»; когда нужен множественный список таких пар в одном пользовательском поле.


Что умеет приложение:
Регистрируется тип пользовательского поля с плейсментом: в карточке CRM отображается редактор строк «слева — справа» с настраиваемой шириной колонок. В меню приложения (доступно администраторам портала) создаются и удаляются парные поля: выбирается сущность CRM, название и код поля, тип левой и правой части (строка, число, сущность CRM, да/нет), множественность, оформление логических полей. Конфигурация хранится на стороне приложения в привязке к порталу (значения полей хранятся только внутри вашего портала). Для интеграций предусмотрено зеркальное строковое поле с тем же значением, что и в парном поле.


Активити в бизнес-процессах:
В конструкторе доступны три действия.
• Получить значение парного поля — на входе: тип сущности CRM, ID карточки, код поля приложения, режим «разделять на ключ и значение» (да/нет). На выходе: строки RAW и PAIRS_LIST с парами в формате `ключ|||значение` (несколько пар через запятую); при включённом разделении — ключи и значения (для одной строки поля — по одному, для множественного — наборы), карта «ключ → значение» (при повторе ключа в множественном поле в карте остаётся последняя пара).
• Записать значение по ключу — на входе: сущность, ID, поле, режим перезаписи или добавления строки, ключ (левая часть), новое значение (правая часть); на выходе: успех (Y/N), текст ошибки, число строк после записи.
• Удалить строку по ключу — на входе: сущность, ID, поле, ключ, область удаления (все совпадения или только первая строка); на выходе: успех, текст ошибки, признак что строка удалена, число строк после удаления.


Польза и решаемые проблемы:
Меньше «разъехавшихся» по карточке полей и ошибок при ручном согласовании двух значений; единый формат хранения пары; проще читать и менять данные из роботов и бизнес-процессов по одному коду поля. Администраторы задают структуру полей централизованно, сотрудники заполняют пары в привычной форме карточки.


Примеры использования:
В сделке поле «услуга — количество»;
В смарт-процессе каталога несколько строк «код товара — остаток»;
Активити по событию записывает правую часть по ключу из внешней системы;
На этапе БП читаются все пары и ветвление идёт по карте ключей.


Преимущества:
Нативное пользовательское поле CRM; гибкие типы левой и правой части; одиночное и множественное поле; три активити под чтение, запись и удаление строк; раздел настроек только для администраторов портала; установка из маркета без ручной настройки файлов на сервере приложения.