При создании приложения в режиме Код встречаются термины деплой, API-ключ, превью и другие. Они относятся к разным этапам работы: от описания приложения и проверки результата до публикации и настройки доступа.
В статье разберем основные термины режима Код:
Режим Код. В приложении Битрикс24 Коворк/Код доступны два режима. Коворк помогает выполнять конкретные рабочие задачи, например собирать сводку по сделкам. Режим Код предназначен для создания приложений и инструментов для работы — например, дашборда с такими сводками.
Что такое режим Код и какие приложения в нем можно создать
Запрос. Описание приложения или изменения обычными словами. В запросе можно указать цель, пользователей, источники данных, основные возможности, ограничения и критерии готовности. Например: Создай приложение для учета офисного оборудования. Сотрудники смогут находить оборудование и видеть, свободно оно или выдано.
Как формулировать запросы в режиме Код
Код приложения. Программные файлы, которые агент создает и изменяет, чтобы приложение выполняло запрос пользователя. Код определяет, как выглядит и работает приложение: какие данные оно показывает, как реагирует на действия пользователя и выполняет расчеты. Не обязательно уметь писать код самостоятельно — достаточно проверить, как работает готовое приложение.
Приложение. Готовый инструмент, созданный в режиме Код. Например, редактор скриншотов, дашборд по сделкам или сервис для учета оборудования. Приложение можно открыть во встроенном браузере, доработать в диалоге с агентом и опубликовать.
Предварительный просмотр или превью. Просмотр приложения во встроенном браузере режима Код. Он помогает проверить внешний вид и основные функции, не выходя из сеанса. Например, в дашборде можно применить фильтры и проверить, правильно ли пересчитываются показатели.
Как создать и опубликовать приложение для Битрикс24 в режиме Код
Публикация. Размещение готового приложения по адресу, который можно открыть вне сеанса режима Код. После публикации приложение доступно по ссылке — ею можно поделиться с коллегами.
Деплой. Процесс размещения подготовленной версии приложения на сервере. В режиме Код запускается кнопкой Деплой. После успешного деплоя приложение считается опубликованным и становится доступно по ссылке.
Повторный деплой. Повторная публикация приложения после изменений. Например, если вы добавили новый фильтр или исправили расчет, выполните деплой еще раз, чтобы изменения появились в опубликованной версии.
Сервер Black Hole. Сервер, на котором размещается опубликованное приложение. Он обеспечивает работу приложения и доступ к нему по ссылке. Для приложения можно выбрать уровень доступа: только владелец, отдельные сотрудники, отдел, весь Битрикс24 или другие варианты.
Что такое серверы Black Hole
Ссылка на приложение. Адрес, по которому открывается опубликованное приложение. Перед отправкой ссылки коллегам откройте приложение и убедитесь, что оно работает и показывает нужные данные.
API-ключ. Секретный набор символов, который связывает приложение с вашим Битрикс24. В режиме Код ключ привязывают к сеансу перед первым деплоем.
Полное значение ключа показывается один раз. Сохраните его в безопасном месте, не передавайте посторонним и не показывайте на скриншотах.
Битрикс24 Вайбкод: как создать и подготовить приложение к работе
Права доступа API-ключа. Настройки, которые определяют, с какими инструментами и данными Битрикс24 сможет работать приложение. Например, для дашборда по сделкам нужны права на CRM, а для бота со сводкой по задачам — права на задачи. Выдавайте ключу только те права, которые нужны приложению.
Логи. Диагностические данные о работе приложения Битрикс24 Коворк/Код. Они помогают найти причину ошибки и нужны при обращении в поддержку. Логи собирают через настройки приложения и передают специалисту поддержки.
Как отправить логи в поддержку Битрикс24