Блог Горошко Андрея Bitrix24 Очистить записи в очереди офлайн-событий event.offline.clear

Очистить записи в очереди офлайн-событий event.offline.clear

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Очистить записи в очереди офлайн-событий event.offline.clear». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Очистить записи в очереди офлайн-событий event.offline.clear

> Кто может выполнять метод: любой пользователь

Метод event.offline.clear производит очистку записей в очереди офлайн-событий. Доступность офлайн-событий можно проверить через метод feature.get.

Метод работает только в контексте авторизации приложения.

Параметры метода

Название
тип
Описание
process_id*
string
Идентификатор процесса, который занимается обработкой записей
id
array
Массив идентификаторов записей, которые нужно вычистить. По умолчанию будут вычищены все записи, помеченные переданным process_id
message_id
array
Массив значений поля MESSAGE_ID записей, которые нужно вычистить. Игнорируется, если указан параметр id. По умолчанию будут вычищены все записи, помеченные переданным process_id

Примеры кода

  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{
        "process_id": "yh3gu929sf0d32lsfysqas2y1hlpp09q",
        "id": [2],
        "auth": "**put_access_token_here**"
    }' \
    https://**put_your_bitrix24_address**/rest/event.offline.clear
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'event.offline.clear',
    		{
    			'process_id': 'yh3gu929sf0d32lsfysqas2y1hlpp09q',
    			'id': [2]
    		}
    	);
    	
    	const result = response.getData().result;
    	if(result.error())
    	{
    		console.error(result.error());
    	}
    	else
    	{
    		console.dir(result);
    	}
    }
    catch(error)
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'event.offline.clear',
                [
                    'process_id' => 'yh3gu929sf0d32lsfysqas2y1hlpp09q',
                    'id'        => [2],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Data: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error clearing offline event: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        "event.offline.clear",
        {
            "process_id": "yh3gu929sf0d32lsfysqas2y1hlpp09q",
            "id": [2]
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'event.offline.clear',
        [
            'process_id' => 'yh3gu929sf0d32lsfysqas2y1hlpp09q',
            'id' => [2]
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1721300421.210707,
        "finish": 1721300421.331026,
        "duration": 0.12031912803649902,
        "processing": 0.0022459030151367188,
        "date_start": "2024-07-18T13:00:21+02:00",
        "date_finish": "2024-07-18T13:00:21+02:00",
        "operating": 0
    }
}

Возвращаемые данные

Название
тип
Описание
result
boolean
Успешность выполнения
time
time
Информация о времени выполнения запроса

Обработка ошибок

  • [](./events)
  • [](./event-bind)
  • [](./event-get)
  • [](./event-unbind)
  • [](./safe-event-handlers)
  • [](./offline-events)
  • [](./event-offline-list)
  • [](./event-offline-get)
  • [](./event-offline-error)
  • [](./on-offline-event)

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

Ключевые выводы по теме «Очистить записи в очереди офлайн-событий event.offline.clear»:

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

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

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

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

Related Post

Получить элементы перечисления «Тип описания» crm.enum.contenttypeПолучить элементы перечисления «Тип описания» crm.enum.contenttype

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

Получить поля валюты crm.currency.fieldsПолучить поля валюты crm.currency.fields

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить поля валюты crm.currency.fields», проанализируем лучшие практики и

Удалить валюту crm.currency.deleteУдалить валюту crm.currency.delete

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