Блог Горошко Андрея Bitrix24,PHP Событие при обновлении задачи OnTaskUpdate

Событие при обновлении задачи OnTaskUpdate

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

Событие при обновлении задачи OnTaskUpdate

> Scope: task
>
> Кто может подписаться: любой пользователь

Событие вызывается после обновления задачи.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса {.b24-info}

array(
    'event' => 'ONTASKUPDATE',
    'data' => array(
        'FIELDS_BEFORE' => array('ID' => 123),
        'FIELDS_AFTER' => array('ID' => 123),
        'IS_ACCESSIBLE_BEFORE' => 'undefined',
        'IS_ACCESSIBLE_AFTER' => 'undefined',
    ),
    'ts' => '1466439714',
    'auth' => array(
        'access_token' => 's6p6eclrvim6da22ft9ch94ekreb52lv',
        'expires_in' => '3600',
        'scope' => 'crm',
        'domain' => 'some-domain.bitrix24.com',
        'server_endpoint' => 'https://oauth.bitrix24.tech/rest/',
        'status' => 'F',
        'client_endpoint' => 'https://some-domain.bitrix24.com/rest/',
        'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
        'refresh_token' => '4s386p3q0tr8dy89xvmt96234v3dljg8',
        'application_token' => '51856fefc120afa4b628cc82d3935cce',
        ),
)
Параметр
тип
Описание
event
string
Символьный код события, в данном случае OnTaskUpdate
data
array
Массив с данными обновленной задачи
ts
timestamp
Дата и время отправки события из очереди событий
auth
array
Параметры авторизации и данные о портале, на котором произошло событие

Параметр data[]

Название
тип
Описание
FIELDS_BEFORE
undefined\
objectПоля задачи до события (подробное описание приведено ниже). В случае отсутствия доступных полей задачи данное поле будет содержать значение undefined
FIELDS_AFTER
undefined\
objectПоля задачи после события (подробное описание приведено ниже). В случае отсутствия доступных полей задачи данное поле будет содержать значение undefined
IS_ACCESSIBLE_BEFORE
string
Была ли доступна задача на чтение до события (подробное описание приведено ниже)
IS_ACCESSIBLE_AFTER
string
Стала ли доступна задача на чтение после события (подробное описание приведено ниже)

Поле FIELDS_BEFORE {#fields_before}

Название
тип
Описание
ID
integer
Идентификатор обновленной задачи

Поле FIELDS_AFTER {#fields_after}

Название
тип
Описание
ID
integer
Идентификатор обновленной задачи

Поле IS_ACCESSIBLE_BEFORE {#is_accessible_before}

Название
тип
Описание
IS_ACCESSIBLE_BEFORE
string
Возможные значения:
— Y (Yes) — да
— N (No) — нет
— undefined — не определено или проверка не производилась

Поле IS_ACCESSIBLE_AFTER {#is_accessible_after}

Название
тип
Описание
IS_ACCESSIBLE_AFTER
string
Возможные значения:
— Y (Yes) — да
— N (No) — нет
— undefined — не определено или проверка не производилась

Примеры кода

  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'event.bind',
    		{
    			"event": "onTaskUpdate",
    			"handler": "https://example.com/handler.php"
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'event.bind',
                [
                    'event'   => 'onTaskUpdate',
                    'handler' => 'https://example.com/handler.php',
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error binding event: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'event.bind',
        {
            "event": "onTaskUpdate",
            "handler": "https://example.com/handler.php"
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'event.bind',
        [
            'event' => 'onTaskUpdate',
            'handler' => 'https://example.com/handler.php'
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';
  • [](./index)
  • [](./on-task-add)
  • [](./on-task-delete)

💡 Экспертное мнение и рекомендации

Ключевые выводы по теме «Событие при обновлении задачи OnTaskUpdate»:

Использование современных стандартов D7 при работе с событие обновлении позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Создание кабинета дилера с автоматической генерацией счетов на оплату и договоровСоздание кабинета дилера с автоматической генерацией счетов на оплату и договоров

Разработка и внедрение профессионального B2B-портала и дилерского кабинета на 1С-Битрикс позволяет кардинально сократить издержки отдела оптовых продаж, перевести дилеров на самообслуживание 24/7 и исключить ошибки ручного ввода заказов. Услуга «Создание

Create Page: Руководство разработчикаCreate Page: Руководство разработчика

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

Внедрение Битрикс24 для клининговых компаний и сервисов клинингаВнедрение Битрикс24 для клининговых компаний и сервисов клининга

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