-
Оценка
-
Установок20
-
РазработчикКононов Р.А.
Описание
Приложение предназначено для облегчения процесса разработки приложений, регистрирующих пользовательские типы полей в Битрикс24, а также для упрощения администрирования таких типов. Теперь разработчикам не нужно писать инсталлятор (что вызывает затруднение у многих начинающих разработчиков), а администратор видит все встройки в одной табличке и может легко устанавливать и удалять их. Интеграторам, использующим пакет своих приложений, нет необходимости устанавливать их по одному - можно воспользоваться импортом из csv-файла, установив все разом (а также сохранить конфигурацию встроек, экспортировав их в csv-файл). Более того: приложение можно вообще не устанавливать на портал, если оно может работать через вебхуки: достаточно прописать нужный вебхук самом приложении и указать ссылку на него в качестве обработчика. Можно встроить статичную html-страницу, не содержащую никакого кода, а только текст и HTML-разметку. Можно встраивать даже статичные приложения, работающие через библиотеку BX24, то есть не нужен собственный сервер с доменом и SSL-сертификатом!
Интерфейс и работа приложения
Основная часть интерфейса - таблица со списком зарегистрированных через приложение пользовательских типов полей (строковый код типа; текстовое название типа; описание, которое выводится в списке типов полей в карточке CRM; URL обработчика; дополнительные настройки и кнопка удаления). Кнопки "Экспорт" и "Импорт" позволяют, соответственно, сохранить список созданных типов полей в csv-файл и массово зарегистрировать их из csv-файла. Если список зарегистрированных типов полей пуст, по кнопке "Экспорт" сохраняется образец файла для импорта, содержащий колонки в нужном порядке.
ВАЖНО! Приложение отображает только типы, зарегистрированные через него. Если вы создавали тип поля через собственный инсталлятор, в списке приложения она отображаться не будет. Вы можете удалить установленный ранее тип поля и зарегистрировать его через приложение - тогда он будет отображаться в списке.
Последняя строка в таблице - форма для регистрации нового типа полей. Заполните необходимые поля, нажмите кнопку "Установить" - и новый тип поля будет доступен в CRM.
ВАЖНО!
- строковый код типа должен состоять только из латинских букв, цифр, символов "-" и "_";
- URL обработчика должен быть доступен по протоколу https;
- в поле "Дополнительные настройки" передаётся JSON-строка, задающая дополнительные параметры. В настоящее время можно задать только один параметр: height, задающий высоту поля в пикселях.
Если вы хотите установить в качестве обработчика пользовательского типа статичное приложение, то сначала установите его (Разработчикам - Готовые сценарии - Другое - Локальное приложение - Статичное приложение - загрузите архив с приложением и установите все настройки - Сохранить - закрыть слайдер), затем снова открыть настройки приложения (Разработчикам - Интеграции - контекстное меню приложения, пункт "Редактировать"), скопируйте из строки "Путь вашего обработчика" ссылку вида https://cdn-ru.bitrix24.ru/***/index.html и вставьте её в колонку "URL обработчика" в приложении. Готово! Вы создали пользовательский тип поля без сервера и домена!
После нажатия кнопки "Установить" в случае успешной установки кнопка заменится на кнопку "Удалить", а поля ввода - на простой текст. В случае ошибки будет выведено окно с описанием её причины.
При удалении обработчика места встраивания в случае успеха соответствующая строка пропадает из таблицы, в случае ошибки выводится окно с её описанием.
При импорте обработчиков из файла по результатам этот процесса выводится окно с таблицей, где отображается результат установки каждого из них (успех либо описание ошибки).
Параметры зарегистрированных типов полей можно отредактировать, кликнув на любую ячейку, кроме "Строкового кода типа". Отредактировав параметры, нажмите кнопку "Обновить".
Интерфейс и работа приложения
Основная часть интерфейса - таблица со списком зарегистрированных через приложение пользовательских типов полей (строковый код типа; текстовое название типа; описание, которое выводится в списке типов полей в карточке CRM; URL обработчика; дополнительные настройки и кнопка удаления). Кнопки "Экспорт" и "Импорт" позволяют, соответственно, сохранить список созданных типов полей в csv-файл и массово зарегистрировать их из csv-файла. Если список зарегистрированных типов полей пуст, по кнопке "Экспорт" сохраняется образец файла для импорта, содержащий колонки в нужном порядке.
ВАЖНО! Приложение отображает только типы, зарегистрированные через него. Если вы создавали тип поля через собственный инсталлятор, в списке приложения она отображаться не будет. Вы можете удалить установленный ранее тип поля и зарегистрировать его через приложение - тогда он будет отображаться в списке.
Последняя строка в таблице - форма для регистрации нового типа полей. Заполните необходимые поля, нажмите кнопку "Установить" - и новый тип поля будет доступен в CRM.
ВАЖНО!
- строковый код типа должен состоять только из латинских букв, цифр, символов "-" и "_";
- URL обработчика должен быть доступен по протоколу https;
- в поле "Дополнительные настройки" передаётся JSON-строка, задающая дополнительные параметры. В настоящее время можно задать только один параметр: height, задающий высоту поля в пикселях.
Если вы хотите установить в качестве обработчика пользовательского типа статичное приложение, то сначала установите его (Разработчикам - Готовые сценарии - Другое - Локальное приложение - Статичное приложение - загрузите архив с приложением и установите все настройки - Сохранить - закрыть слайдер), затем снова открыть настройки приложения (Разработчикам - Интеграции - контекстное меню приложения, пункт "Редактировать"), скопируйте из строки "Путь вашего обработчика" ссылку вида https://cdn-ru.bitrix24.ru/***/index.html и вставьте её в колонку "URL обработчика" в приложении. Готово! Вы создали пользовательский тип поля без сервера и домена!
После нажатия кнопки "Установить" в случае успешной установки кнопка заменится на кнопку "Удалить", а поля ввода - на простой текст. В случае ошибки будет выведено окно с описанием её причины.
При удалении обработчика места встраивания в случае успеха соответствующая строка пропадает из таблицы, в случае ошибки выводится окно с её описанием.
При импорте обработчиков из файла по результатам этот процесса выводится окно с таблицей, где отображается результат установки каждого из них (успех либо описание ошибки).
Параметры зарегистрированных типов полей можно отредактировать, кликнув на любую ячейку, кроме "Строкового кода типа". Отредактировав параметры, нажмите кнопку "Обновить".