CLI для файлов бизнес-процессов Bitrix

Bitrix BPT CLI Tool

Консольная утилита на .NET распаковывает, собирает и показывает содержимое файлов *.bpt с шаблонами бизнес-процессов Bitrix

  • 1 ★ репозитория
  • Последний коммит
  • MIT
CLI

Расширенный доступ

Почему такой уровень

  • CLI на .NET распаковывает и собирает файлы бизнес-процессов .bpt на диске
  • К порталу Битрикс24 не подключается
Все причины и проверки
Российский стек

bslie/bitrix-bpt-cli-tool

Установка

Ручная установка

git clone https://github.com/bslie/bitrix-bpt-cli-tool.git && cd bitrix-bpt-cli-tool && dotnet build

Сборка из исходников, нужен .NET 9.0 SDK.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • CLI на .NET распаковывает и собирает файлы бизнес-процессов .bpt на диске
  • К порталу Битрикс24 не подключается

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Файлы .bpt в Bitrix это PHP-сериализованные данные, сжатые одним из четырех способов: gzip, zlib, deflate или без сжатия. Утилита дает три команды: dump достает содержимое в текст (с флагом --pretty можно получить читаемое дерево вместо сырого сериализованного текста), build собирает файл обратно с нужным способом сжатия, info показывает сводку о файле и определяет формат упаковки по заголовку. Поддерживается работа через stdin и stdout, так что команды можно соединять в конвейер, а при сборке недостающие директории создаются автоматически.

Для кого. Для разработчиков и администраторов Bitrix, которым нужно редактировать или анализировать шаблоны бизнес-процессов вне визуального редактора.

Подходит, если

  • Нужно достать текст шаблона бизнес-процесса из файла .bpt для просмотра или версионирования в git
  • Нужно собрать .bpt обратно после ручной правки текста
  • Нужно определить, каким способом сжат конкретный .bpt перед пересборкой

Не подходит, если

  • Нужно редактировать бизнес-процесс визуально: для этого есть штатный редактор Bitrix
  • Нужна проверка целостности ссылок внутри процесса: эта утилита только упаковывает и распаковывает, без валидации

Пример запроса к агенту

Распакуй файл bp-179.bpt в читаемый вид и покажи, какие активности в нем используются

Ограничения

Нужен .NET 9.0 SDK для сборки из исходников либо готовый релиз под свою платформу. При правке текста между dump и build нельзя менять длины строк внутри блоков s:<длина>:"...", иначе сборка не совпадет байт-в-байт. Инструмент не проверяет ссылки на активности и константы внутри процесса, для этого нужен отдельный анализ. Одна звезда, README только на русском и английском в одном файле.

Как отключить. Удалите скачанный бинарь или папку с исходниками, инструмент не устанавливает ничего в систему.

Частые вопросы

Как понять, каким способом сжат мой .bpt?

Командой info: она показывает заголовок и фактический формат, который сработал при распаковке.

Можно ли передавать данные через pipe между dump и build?

Да, обе команды поддерживают stdin и stdout через флаг -o - или --in/--out -.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

CLI, который превращает бинарные .bpt-файлы бизнес-процессов Битрикс24 в читаемый JSON для гита и диффа

CLIРасширенный доступ1Звезды репозитория
Российский стек

PowerShell CLI для безопасной выгрузки компаний и контактов Bitrix24 в CSV через входящий вебхук

CLIРасширенный доступ1Звезды репозитория
Российский стек

Адаптер Symfony Console для 1С-Битрикс и Bitrix24: готовые консольные команды для модулей, кеша, базы данных, сайтов и пользователей

CLIШирокий доступ
Российский стек

CLI с полным CRUD для сделок, лидов, контактов и компаний Битрикс24, все команды с флагом --json для агентов

CLIШирокий доступ
Официальный

CLI для сборки, тестирования, линтинга и диагностики JS-расширений Bitrix с поддержкой TypeScript

CLIРасширенный доступ20Звезды репозитория

Коротко о README

README перечисляет три команды с примерами (dump, build, info), четыре формата сжатия, требование .NET 9.0, ссылку на готовые сборки в Releases, предупреждение о сохранении длин сериализованных строк при ручной правке и инструкцию, где в интерфейсе Bitrix on-premise взять файл .bpt: путь Настройки, Инструменты, Бизнес-процессы, Шаблоны.

Бейдж для README

Сообщить о проблеме