Блог Горошко Андрея Bitrix24,PHP Получить запись о затраченном времени по идентификатору task.elapseditem.get

Получить запись о затраченном времени по идентификатору task.elapseditem.get

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

Получить запись о затраченном времени по идентификатору task.elapseditem.get

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

Метод возвращает запись о затраченном времени по ее идентификатору.

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

Название
тип
Описание
TASKID
integer
Идентификатор задачи.

Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач

ITEMID
integer
Идентификатор записи о затраченном времени.

Его можно получить при создании новой записи или методом получения списка записей о затраченном времени

Предупреждение
Соблюдать указанный в таблице порядок следования параметров в запросе — обязательно. Иначе запрос выполнится с ошибками.

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"TASKID": 691,"ITEMID": 1,}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/task.elapseditem.get
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"TASKID": 691,"ITEMID": 1,"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/task.elapseditem.get
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'task.elapseditem.get',
    		{
    			"TASKID": 691,
    			"ITEMID": 1,
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'task.elapseditem.get',
                [
                    'TASKID' => 691,
                    'ITEMID' => 1,
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting elapsed item: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'task.elapseditem.get',
        {
            "TASKID": 691,
            "ITEMID": 1,
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'task.elapseditem.get',
        [
            'TASKID' => 691,
            'ITEMID' => 1,
        ]
    );

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

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

HTTP-статус: 200

{
    "result":[
        {
            "ID": "1",
            "TASK_ID": "691",
            "USER_ID": "1",
            "COMMENT_TEXT": "1",
            "SECONDS": "3600",
            "MINUTES": "60",
            "SOURCE": "2",
            "CREATED_DATE": "2024-05-16T10:33:00+02:00",
            "DATE_START": "2024-05-16T10:33:15+02:00",
            "DATE_STOP": "2024-05-16T10:33:15+02:00"
        }
    ],
    "time":{
        "start":1712137817.343984,
        "finish":1712137817.605804,
        "duration":0.26182007789611816,
        "processing":0.018325090408325195,
        "date_start":"2024-04-03T12:50:17+03:00",
        "date_finish":"2024-04-03T12:50:17+03:00"
    }
}

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

Название
тип
Описание
result
object
Информация о записи о затраченном времени
time
time
Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error":"ERROR_CORE",
    "error_description":"Задача не найдена"
}

Возможные коды ошибок

КодОписание
0x000001Задача не найдена
0x100002Доступ запрещен
0x000004Действие не разрешено
0x000040Неизвестная ошибка
  • [](./index)
  • [](./task-elapsed-item-add)
  • [](./task-elapsed-item-update)
  • [](./task-elapsed-item-get-list)
  • [](./task-elapsed-item-delete)
  • [](./task-elapsed-item-is-action-allowed)
  • [](./task-elapsed-item-get-manifest)

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

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к task.elapseditem.get, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Получить запись о затраченном времени по идентификатору task.elapseditem.get».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

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

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

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

Related Post

Добавить пользователя к существующему заданию rpa.task.addUserДобавить пользователя к существующему заданию rpa.task.addUser

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

Разработка B2B-каталога с авторизацией по ИНН и автоматической проверкой контрагентовРазработка B2B-каталога с авторизацией по ИНН и автоматической проверкой контрагентов

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

Создание дилерского кабинета с интерактивными схемами узлов оборудования (Взрыв-схемы)Создание дилерского кабинета с интерактивными схемами узлов оборудования (Взрыв-схемы)

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