Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Закрыть окно с приложением BX24.closeApplication». Вы узнаете экспертные методики работы с закрыть окно и научитесь избегать типичных ошибок начинающих разработчиков.

Закрыть окно с приложением BX24.closeApplication

Тут может не хватать некоторых данных — дополним в ближайшее время

• нужны правки под стандарт написания
• отсутствуют примеры
• отсутствует ответ в случае успеха
• отсутствует ответ в случае ошибки

void BX24.closeApplication();

Метод BX24.closeApplication закрывает открытое модальное окно с приложением (открытым как через BX24.openApplication, так и через модальное окно обработчика мест встраивания CRM_*_LIST_MENU).

Рекомендуется к использованию в CRM_*_LIST_MENU, например, для показа кнопки закрытия. (По умолчанию у пользователей нет никакого способа вернуться в CRM кроме закрытия всплывающего окна по крестику в углу окна.)

Практический пример и готовый код на PHP

Единый пример для BX24.openApplication и BX24.closeApplication.

<script src="//api.bitrix24.com/api/v1/"></script>
<?
// разбор входных данных
$placementOptions = array();
if(array_key_exists('PLACEMENT_OPTIONS', $_REQUEST))
{
    $placementOptions = json_decode($_REQUEST['PLACEMENT_OPTIONS'], true);
}

// если приложение не развернуто, выводим кнопку открытия, в противном случае закрытия
if(!isset($placementOptions['opened']))
{
?>
    <span onclick="openApplication()">Open</span>
<?
}
else
{
?>
    <span onclick="closeApplication()">Close</span>
<?
}

?>
<script>
    function openApplication()
    {
        BX24.openApplication(
            {
                'opened': true // данные, передаваемые открываемому приложению
            },
            function()
            {
                // этот обработчик сработает, когда приложение будет закрыто
                alert('Application closed!')
            }
        );

        setTimeout(closeApplication, 15000); // автоматически закрыть через 15 секунд
    }

    function closeApplication()
    {
        BX24.closeApplication();
    }
</script>