Менеджер типов полей

Приложение предназначено для облегчения процесса разработки приложений, регистрирующих пользовательские типы полей в Битрикс24, а также для упрощения администрирования таких типов. Теперь разработчикам не нужно писать инсталлятор (что вызывает затруднение у многих начинающих разработчиков), а администратор видит все встройки в одной табличке и может легко устанавливать и удалять их. Интеграторам, использующим пакет своих приложений, нет необходимости устанавливать их по одному - можно воспользоваться импортом из csv-файла, установив все разом (а также сохранить конфигурацию встроек, экспортировав их в csv-файл). Более того: приложение можно вообще не устанавливать на портал, если оно может работать через вебхуки: достаточно прописать нужный вебхук самом приложении и указать ссылку на него в качестве обработчика. Можно встроить статичную html-страницу, не содержащую никакого кода, а только текст и HTML-разметку. Можно встраивать даже статичные приложения, работающие через библиотеку BX24, то есть не нужен собственный сервер с доменом и SSL-сертификатом!


Интерфейс и работа приложения
Основная часть интерфейса - таблица со списком зарегистрированных через приложение пользовательских типов полей (строковый код типа; текстовое название типа; описание, которое выводится в списке типов полей в карточке CRM; URL обработчика; дополнительные настройки и кнопка удаления). Кнопки "Экспорт" и "Импорт" позволяют, соответственно, сохранить список созданных типов полей в csv-файл и массово зарегистрировать их из csv-файла. Если список зарегистрированных типов полей пуст, по кнопке "Экспорт" сохраняется образец файла для импорта, содержащий колонки в нужном порядке.

ВАЖНО! Приложение отображает только типы, зарегистрированные через него. Если вы создавали тип поля через собственный инсталлятор, в списке приложения она отображаться не будет. Вы можете удалить установленный ранее тип поля и зарегистрировать его через приложение - тогда он будет отображаться в списке.

Последняя строка в таблице - форма для регистрации нового типа полей. Заполните необходимые поля, нажмите кнопку "Установить" - и новый тип поля будет доступен в CRM.

ВАЖНО!
- строковый код типа должен состоять только из латинских букв, цифр, символов "-" и "_";
- URL обработчика должен быть доступен по протоколу https;
- в поле "Дополнительные настройки" передаётся JSON-строка, задающая дополнительные параметры. В настоящее время можно задать только один параметр: height, задающий высоту поля в пикселях.

Если вы хотите установить в качестве обработчика пользовательского типа статичное приложение, то сначала установите его (Разработчикам - Готовые сценарии - Другое - Локальное приложение - Статичное приложение - загрузите архив с приложением и установите все настройки - Сохранить - закрыть слайдер), затем снова открыть настройки приложения (Разработчикам - Интеграции - контекстное меню приложения, пункт "Редактировать"), скопируйте из строки "Путь вашего обработчика" ссылку вида https://cdn-ru.bitrix24.ru/***/index.html и вставьте её в колонку "URL обработчика" в приложении. Готово! Вы создали пользовательский тип поля без сервера и домена!

После нажатия кнопки "Установить" в случае успешной установки кнопка заменится на кнопку "Удалить", а поля ввода - на простой текст. В случае ошибки будет выведено окно с описанием её причины.
При удалении обработчика места встраивания в случае успеха соответствующая строка пропадает из таблицы, в случае ошибки выводится окно с её описанием.
При импорте обработчиков из файла по результатам этот процесса выводится окно с таблицей, где отображается результат установки каждого из них (успех либо описание ошибки).
Параметры зарегистрированных типов полей можно отредактировать, кликнув на любую ячейку, кроме "Строкового кода типа". Отредактировав параметры, нажмите кнопку "Обновить".