Сохранение БП

Модуль "Сохранение БП" предназначен для управления резервными копиями шаблонов бизнес-процессов Битрикс24.
Результатом работы модуля является возможность сохранения, просмотра, восстановления и управления резервными копиями шаблонов БП для последующего использования или восстановления после случайного удаления или изменения.

Описание функциональности модуля

Название функции	Описание и примеры использования
Сохранение резервной копии шаблона БП	Позволяет сохранить полную резервную копию шаблона бизнес-процесса в базу данных. Сохраняются все параметры шаблона: структура активити, переменные, константы, параметры, настройки автозапуска и другие данные. При сохранении автоматически проверяется лимит резервных копий согласно тарифу пользователя. Если лимит достигнут, система выводит предупреждение с предложением удалить часть существующих копий или приобрести другой тариф. При каждом сохранении в журнал операций записывается информация о пользователе, который выполнил операцию, и дате сохранения. Как использовать: - Откройте список шаблонов БП на странице модуля; - Найдите нужный шаблон в таблице; - Нажмите на иконку дискеты в столбце "Резервная копия"; - В появившемся всплывающем окне нажмите кнопку "Сохранить резервную копию"; - Система автоматически сохранит копию с указанием текущей даты и пользователя. Важно: Система ограничивает количество резервных копий согласно тарифному плану. При достижении лимита необходимо удалить часть существующих копий или приобрести другой тариф.
Просмотр списка сохраненных копий	Позволяет просмотреть все сохраненные резервные копии для конкретного шаблона БП. Для каждого шаблона можно сохранить несколько версий копий, и все они будут отображаться в списке с указанием даты сохранения и пользователя, который выполнил операцию. В таблице списка копий отображается информация: ID копии, название шаблона, дата сохранения, пользователь, который сохранил копию, и доступные действия. Как использовать: - Найдите шаблон БП в основной таблице; - Если у шаблона есть сохраненные копии, иконка дискеты будет отмечена как сохраненная (зеленая иконка); - Нажмите на иконку дискеты, чтобы открыть список резервных копий; - В модальном окне будет отображена таблица со всеми сохраненными копиями шаблона. Информация о копиях: Каждая копия содержит полную информацию о состоянии шаблона на момент сохранения, включая все активити, переменные, константы и настройки.
Восстановление шаблона из резервной копии	Позволяет восстановить шаблон БП из ранее сохраненной резервной копии. При восстановлении все текущие настройки шаблона заменяются настройками из выбранной копии. Операция восстановления создает запись в журнале операций для отслеживания изменений. Восстановление выполняется через REST API метод bizproc.workflow.template.update, что гарантирует корректность данных. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке (сортировка по дате сохранения - самые новые сверху); - Нажмите кнопку "Восстановить" рядом с нужной копией; - Подтвердите операцию восстановления; - Система автоматически восстановит шаблон из выбранной копии. Важно: Операция восстановления заменяет все текущие настройки шаблона. Рекомендуется сохранить текущую версию перед восстановлением, если есть риск потерять важные изменения.
Скачивание резервной копии в формате .bpt	Позволяет скачать резервную копию шаблона БП в стандартном формате .bpt для последующего использования на другом портале или в качестве архива. Файл .bpt содержит полную информацию о шаблоне в сжатом формате и может быть импортирован в любой портал Битрикс24. Имя файла формируется автоматически и включает домен портала, ID шаблона и метку времени. Операция скачивания также фиксируется в журнале операций. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Скачать" рядом с нужной копией; - Файл автоматически загрузится в папку загрузок браузера; - Имя файла будет в формате: домен_портала_ID_шаблона_время.bpt. Формат файла: Файл .bpt представляет собой сжатый архив с сериализованными данными шаблона в формате JSON, который может быть импортирован в Битрикс24 через интерфейс бизнес-процессов.
Создание нового шаблона БП на основе резервной копии	Позволяет создать новый шаблон БП на основе сохраненной резервной копии существующего шаблона. Это полезно для копирования настроек одного шаблона в другой или для создания вариаций одного шаблона для разных сценариев. При создании нового шаблона автоматически добавляется префикс с названием приложения и датой создания к оригинальному названию шаблона. Новый шаблон создается с теми же параметрами, что и исходный: типом сущности, настройками автозапуска, структурой активити и всеми переменными. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Создать новый шаблон" рядом с нужной копией; - Система автоматически создаст новый шаблон на основе выбранной копии; - Новый шаблон появится в списке шаблонов БП с названием в формате: "Оригинальное название [Лаборатория роботов - дата и время]". Важно: Новый шаблон создается как полностью независимый и не связан с исходным шаблоном. Все последующие изменения в новом шаблоне не влияют на оригинальный шаблон или резервную копию.
Удаление резервных копий	Позволяет удалить отдельную резервную копию шаблона БП из базы данных. Операция удаления создает запись в журнале операций для аудита. При удалении копии она полностью удаляется из базы данных и не может быть восстановлена. Также доступна функция массового удаления всех резервных копий для конкретного шаблона БП. Это полезно для освобождения места при достижении лимита резервных копий. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите копию, которую нужно удалить; - Нажмите кнопку "Удалить" рядом с нужной копией; - Подтвердите операцию удаления; - Копия будет удалена из базы данных. Массовое удаление: Для удаления всех копий конкретного шаблона используйте функцию "Удалить шаблон со всеми копиями" в основном списке шаблонов.
Фильтрация шаблонов БП	Позволяет фильтровать список шаблонов БП по различным критериям для быстрого поиска нужных шаблонов. Доступны фильтры: по ID бизнес-процесса, по названию, по типу сущности, по пользователю, который последним изменял шаблон, по наличию резервных копий, по шаблонам, созданным приложением, и по удаленным шаблонам. Фильтры могут использоваться как отдельно, так и в комбинации друг с другом. Система поддерживает сохранение параметров фильтрации для быстрого применения в будущем. Как использовать: - Заполните нужные поля фильтрации в верхней части страницы; - Используйте выпадающие списки для выбора типа сущности или пользователя; - Установите флажки для показа только шаблонов с копиями, удаленных шаблонов или шаблонов, созданных приложением; - Результаты фильтрации автоматически применяются к таблице шаблонов; - Используйте кнопку "Очистить параметры фильтра" для сброса всех фильтров. Сохранение фильтров: Система позволяет сохранить до 10 последних наборов параметров фильтрации для быстрого применения в будущем.
Просмотр истории операций	Позволяет просмотреть полную историю всех операций с резервными копиями шаблонов БП. В истории отображаются все действия: создание копии, восстановление шаблона, скачивание файла, создание нового шаблона, замена шаблона и удаление копий. Для каждой операции записывается тип операции, пользователь, который выполнил действие, ID шаблона БП, описание операции, дата и время выполнения. История доступна как в общем виде для всех шаблонов, так и по конкретному шаблону БП. Система поддерживает пагинацию для удобной навигации по большому количеству записей. Как использовать: - Нажмите кнопку "История операций" в верхней части страницы для просмотра общей истории; - Для просмотра истории конкретного шаблона откройте список его резервных копий; - В модальном окне будет отображена таблица с историей операций; - Используйте пагинацию для просмотра предыдущих или следующих страниц; - История отсортирована по дате - самые новые операции сверху. Информация в истории: Каждая запись содержит полную информацию об операции, включая тип операции (Создание, Обновление, Восстановление, Скачивание, Замена, Удаление), пользователя, ID шаблона и описание действия.
Обновление списка шаблонов БП	Позволяет обновить список шаблонов БП, загрузив актуальные данные с портала Битрикс24. Система кэширует список шаблонов для повышения производительности, но при необходимости можно принудительно обновить данные, удалив кэш и загрузив свежую информацию. При обновлении список шаблонов обновляется в реальном времени, включая новые созданные шаблоны и изменения в существующих. Как использовать: - Нажмите кнопку "Обновить список шаблонов БП" в верхней части страницы; - Система автоматически удалит кэш и загрузит актуальный список шаблонов; - Обновленный список отобразится в таблице на странице. Кэширование: Система автоматически кэширует список шаблонов для повышения скорости работы. Кэш обновляется при каждом обновлении списка или автоматически при изменениях в шаблонах.
Работа с удаленными шаблонами	Позволяет просматривать и работать с шаблонами БП, которые были удалены из портала Битрикс24, но имеют сохраненные резервные копии. Удаленные шаблоны отображаются в основной таблице с пометкой "Удален" и могут быть восстановлены или использованы для создания новых шаблонов. Это полезно для восстановления случайно удаленных шаблонов или для анализа удаленных шаблонов. Как использовать: - Установите флажок "Удаленные шаблоны" в блоке фильтров; - В таблице будут отображены только шаблоны, удаленные из портала, но имеющие резервные копии; - Для удаленных шаблонов доступны функции просмотра копий, скачивания и создания нового шаблона; - Функция восстановления недоступна для удаленных шаблонов, так как они не существуют на портале. Важно: Удаленные шаблоны можно использовать только для создания новых шаблонов или скачивания резервных копий. Прямое восстановление удаленного шаблона невозможно, так как шаблон отсутствует на портале.
Удаление шаблона БП	Позволяет удалить шаблон БП непосредственно из портала Битрикс24 через REST API. Операция удаления выполняется окончательно и необратимо. Система позволяет удалять только шаблоны, которые были созданы этим приложением. Для шаблонов, созданных другими способами, функция удаления недоступна для предотвращения случайного удаления важных шаблонов. Как использовать: - Найдите нужный шаблон в списке; - Убедитесь, что шаблон был создан этим приложением (иконка удаления будет активной); - Нажмите на иконку корзины в столбце "Удалить"; - Подтвердите операцию удаления; - Шаблон будет удален из портала Битрикс24. Важно: Удаление шаблона БП выполняется безвозвратно. Рекомендуется сохранить резервную копию перед удалением, если есть вероятность, что шаблон понадобится в будущем.

Примеры использования модуля

Описание примера	Решение
Создание резервной копии перед важными изменениями шаблона БП	Перед внесением изменений в шаблон БП сохраните его резервную копию. Откройте список шаблонов, найдите нужный шаблон, нажмите на иконку дискеты и выберите "Сохранить резервную копию". После сохранения можно безопасно вносить изменения в шаблон, зная, что при необходимости можно восстановить предыдущую версию.
Восстановление шаблона после неудачных изменений	Если после изменений шаблон работает некорректно, восстановите его из резервной копии. Откройте список копий нужного шаблона, найдите нужную версию (обычно самая последняя перед изменениями), нажмите "Восстановить" и подтвердите операцию. Шаблон будет восстановлен в состояние на момент сохранения копии.
Создание копии шаблона для другого отдела	Для создания шаблона для другого отдела на основе существующего используйте функцию "Создать новый шаблон". Откройте список резервных копий исходного шаблона, выберите нужную копию и нажмите "Создать новый шаблон". Новый шаблон будет создан с теми же настройками, и его можно будет адаптировать под нужды отдела без изменения оригинального шаблона.
Экспорт шаблона БП для использования на другом портале	Для переноса шаблона БП на другой портал скачайте его резервную копию в формате .bpt. Откройте список копий нужного шаблона, выберите нужную копию и нажмите "Скачать". Файл будет загружен в папку загрузок. Затем этот файл можно импортировать на другой портал Битрикс24 через интерфейс бизнес-процессов.
Восстановление случайно удаленного шаблона БП	Если шаблон был случайно удален, используйте фильтр "Удаленные шаблоны" для поиска. Установите флажок "Удаленные шаблоны" в фильтрах, найдите нужный шаблон в списке. Откройте его резервные копии и используйте функцию "Создать новый шаблон" для восстановления. Новый шаблон будет создан на основе последней сохраненной копии.
Архивирование старых резервных копий	Для освобождения места при достижении лимита резервных копий скачайте старые копии в формате .bpt для архивации. Откройте список копий шаблона, отсортируйте по дате (старые внизу), скачайте нужные копии и сохраните их локально. Затем удалите скачанные копии из системы для освобождения места.
Отслеживание изменений в шаблонах БП через историю операций	Для аудита и отслеживания изменений используйте функцию просмотра истории операций. Нажмите кнопку "История операций" в верхней части страницы для просмотра всех операций или откройте историю конкретного шаблона через список его копий. История покажет всех пользователей, которые работали с шаблоном, и все выполненные операции.
Быстрый поиск шаблонов определенного типа сущности	Для поиска всех шаблонов определенного типа сущности используйте фильтр "Тип сущности бизнес-процесса". Выберите нужный тип из выпадающего списка (например, "CRM Сделка" или "CRM Контакт"), и в таблице будут отображены только шаблоны этого типа. Это упрощает работу с большим количеством шаблонов.
Поиск шаблонов, измененных конкретным пользователем	Для поиска шаблонов, которые изменял конкретный пользователь, используйте фильтр "Кто изменил бизнес-процесс". Выберите пользователя из выпадающего списка, и в таблице будут отображены только шаблоны, которые последний раз изменял этот пользователь. Это полезно для отслеживания работы команды или конкретного сотрудника.
Работа только с шаблонами, имеющими резервные копии	Для фильтрации только шаблонов с сохраненными резервными копиями установите флажок "Шаблоны с копиями" в блоке фильтров. В таблице будут отображены только шаблоны, для которых были созданы резервные копии. Это помогает быстро найти шаблоны, у которых есть возможность восстановления.

Сценарий работы модуля

Модуль "Сохранение БП" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

Создание резервных копий перед важными изменениями шаблонов БП для возможности отката изменений;
Восстановление шаблонов после неудачных изменений или случайного удаления;
Копирование шаблонов БП между отделами или порталами Битрикс24;
Архивирование старых версий шаблонов для хранения истории изменений;
Экспорт и импорт шаблонов БП для использования на других порталах;
Аудит и отслеживание изменений в шаблонах БП через журнал операций;
Быстрый поиск и фильтрация шаблонов по различным критериям;
Управление версиями шаблонов БП для поддержания различных вариантов одного процесса;
Восстановление работы бизнес-процессов после ошибок или сбоев;
Создание тестовых копий шаблонов для экспериментов без риска потери рабочей версии.

Важная информация об ограничениях:
- Количество резервных копий ограничено тарифным планом. При достижении лимита необходимо удалить часть существующих копий или приобрести другой тариф;
- Восстановление шаблона заменяет все текущие настройки. Рекомендуется сохранить текущую версию перед восстановлением;
- Удаление шаблона БП выполняется безвозвратно. Рекомендуется сохранить резервную копию перед удалением;
- Удаленные шаблоны можно использовать только для создания новых шаблонов или скачивания копий, прямое восстановление невозможно;
- Функция удаления шаблона доступна только для шаблонов, созданных этим приложением, для предотвращения случайного удаления важных шаблонов.

Возвращаемые данные модуля:
- Список шаблонов БП с информацией об ID, названии, типе сущности, дате изменения и пользователе;
- Список резервных копий для каждого шаблона с информацией о дате сохранения и пользователе;
- История операций с резервными копиями с указанием типа операции, пользователя, даты и описания;
- Файлы .bpt для скачивания, содержащие полные данные шаблона в формате для импорта в Битрикс24;
- Информация о количестве сохраненных резервных копий и оставшемся лимите;
- Статус операций (успешно выполнено, ошибка) с описанием результата.

Ваша корзина пуста

Сохранение БП