Обработать событие первого запуска приложения пользователем BX24.install

BX24.install(someCallback: function|string): void;

Функция BX24.install даёт возможность установить обработчик события «приложение запускается первый раз для текущего пользователя». Событие возникает сразу после события «библиотека готова к работе», но до запуска обработчиков, установленных в BX24.init. Обработчик должен сигнализировать о завершении процесса настройки вызовом функции BX24.installFinish.

Если в качестве обработчика передана строка, то она считается ссылкой на js-файл, который нужно загрузить и выполнить при срабатывании события. В любом случае, если текущий пользователь первый раз запускает приложение, и установлен хоть один обработчик этого события, BX24.init сработает только после вызова BX24.installFinish.

Параметры функции

Название
тип

Описание

someCallback
function

Принимает на вход функцию, которую в случае успеха выполняет

someCallback
string

Если передана строка, то это путь к js-файлу. Сначала будет загружен файл, потом вызвана функция BX24.installFinish

Пример

BX24.install(function(){
            BX24.callMethod('user.current', {}, function(res){
                alert('Приложение Hello World приветствует вас, ' + res.data().NAME + '!');
                BX24.installFinish();
            });
        });

Как использовать примеры в документации

Продолжите изучение

Предыдущая
Инициализировать библиотеку
Следующая
Оповестить об окончании работы инсталлятора