При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Удаление приложений», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Удаление приложений

Локальные приложения

Особенность локальных приложений состоит в том, что это средство предназначено, прежде всего, для внутренней автоматизации. Иными словами, разработчик локального приложния — это, чаще всего, не стороннее лицо, а сотрудник или подразделение компании, использующей свой Битрикс24.

Поэтому удаление локального приложения — это, чаще всего, не та операция, реакцию на которую нужно автоматизировать в коде приложения.

Тем не менее, у вас есть возможность добавить обработчик события OnAppUninstall в локальном приложении. Если такой обработчик существует, то при удалении приложения, Битрикс24 вызовет этот обработчик.

При удалении локального приложения из Битрикс24 автоматически удаляются:

• Зарегистрированные приложением обработчики событий;
• Зарегистрированные приложением обработчики виджетов, включая пользовательские типы полей;
• Созданные приложением хранилища приложения;
• Созданные приложением настройки;
• Зарегистрированные приложением коннекторы открытых линий;
• Зарегистрированные приложением платежные системы;
• Зарегистрированные приложением кассы.

Отменить удаление локального приложения нельзя. Добавление локального приложения, пусть даже с теми же URL, фактически, создаст новое приложение с новой парой client_id/client_secret для OAuth-авторизации.

Тиражные приложения

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

Ведь если приложение удалено из конкретного Битрикс24, то сохраненные токены будут уже неработоспособны, при этом попытки обратиться к такому Битрикс24 просто создадут лишнюю нагрузку на серверах приложения.

Чтобы получить информацию об удалении, приложение должно добавить обработчик события OnAppUninstall. Если такой обработчик существует, то при удалении приложения, Битрикс24 вызовет этот обработчик.

При удалении приложения из Битрикс24 автоматически удаляются:

• Зарегистрированные приложением обработчики событий;
• Зарегистрированные приложением обработчики виджетов, включая пользовательские типы полей;
• Зарегистрированные приложением коннекторы открытых линий;
• Зарегистрированные приложением платежные системы;
• Зарегистрированные приложением кассы.

Перед удалением приложения Битрикс24 запрашивает подтверждение и предлагает опцию «Удалить настройки и данные приложения». В случае, если опция не включена, несмотря на удаление приложения в Битрикс24 останутся:

• Созданные приложением хранилища приложения;
• Созданные приложением настройки;

Отменить удаление приложения нельзя. Однако, можно повторно установить приложение на тот же Битрикс24. В этом случае приложение снова получит доступ к неудаленным хранилищам и настройкам.