Миграции конфигурации Битрикс24 CRM: как мы перестали делать это руками

• isBuilderEnabled() — проверяет доступность нужного модуля (crm, bizproc, humanresources). Если модуль не подключён, билдер не показывается в UI.
  
• initialize() — задаёт название, группу, описание, вызывает addVersionFields().
  
• execute() — интерактив: через addFieldAndReturn() рендерит виджет выбора, собирает данные, вызывает createVersionFile().

class CrmFunnelBuilder extends VersionBuilder
{
    protected function isBuilderEnabled(): bool
    {
        return Loader::includeModule('crm');
    }
    protected function initialize(): void
    {
        $this->setTitle('Воронки и смарт-процессы CRM');
        $this->setGroup('CRM');
        $this->addVersionFields();
    }
    protected function execute(): void
    {
        $selected = $this->addFieldAndReturn('entity_keys', [
            'title'    => 'Выберите воронки и смарт-процессы',
            'multiple' => true,
            'items'    => $this->buildEntitySelect(),
        ]);
        if (empty($selected)) {
            $this->rebuildField('entity_keys');
        }
        $this->createVersionFile(
            __DIR__ . '/../templates/CrmFunnelExport.php',
            ['items' => $this->collectData($selected)]
        );
    }
}

// ##STAGE_IN(SmartTitle|FunnelName|StageName)## → локальный statusId
$value = preg_replace_callback(
    '/##STAGE_IN\((.+?)\|(.+?)\|(.+?)\)##/',
    function (array $m): string {
        $entityKey = 'SMART_PROCESS:' . $this->uesc($m[1]);
        $catId     = $this->resolveFunnelName($this->uesc($m[2]), $entityKey);
        $statusId  = $this->resolveStageByNameInCat($this->uesc($m[3]), $entityKey, $catId);
        return $statusId ?? $m[0];
    },
    $value
);

• Стадии сделок и смарт-процессов в условиях и переходах
  
• ID смарт-процессов в активити типа CrmGetDynamicInfo, CrmCreateDynamic
  
• Пользователи в полях «Ответственный», «Наблюдатели», условиях
  
• Подразделения и группы
  
• ID воронок (CATEGORY_ID) для CreateDynamic-активити — причём воронка принадлежит не документу, а создаваемой сущности
  
• UUID значений пользовательских полей типа enumeration
  
• ID чатов, объектов Диска