Блог Горошко Андрея Bitrix24,PHP Обновить бэклог tasks.api.scrum.backlog.update

Обновить бэклог tasks.api.scrum.backlog.update

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Обновить бэклог tasks.api.scrum.backlog.update», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Обновить бэклог tasks.api.scrum.backlog.update

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

Метод обновляет бэклог.

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

Название
тип
Описание
id
integer
Идентификатор бэклога.

Можно получить методом tasks.api.scrum.backlog.get

fields
object
Объект содержащий записи о группе и пользователе (подробное описание приведено ниже) в виде структуры:

"fields": {
    "groupId": значение,
    "createdBy": значение,
    "modifiedBy": значение,
}    

Параметр fields

Название
тип
Описание
groupId
integer
Идентификатор группы, к которой принадлежит бэклог.

Идентификатор группы можно получить при создании новой группы sonet_group.create или при получении списка существующих групп socialnetwork-api-workgroup-list.md

createdBy
integer
Идентификатор пользователя, от кого будет создан бэклог
modifiedBy
integer
Идентификатор пользователя, от кого будет модифицирован бэклог

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":1, "fields": {"groupId": 125, "createdBy": 6}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/tasks.api.scrum.backlog.update
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":1, "fields": {"groupId": 125, "createdBy": 6}, "auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/tasks.api.scrum.backlog.update
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'tasks.api.scrum.backlog.update',
    		{
    			"id": 1,
    			"fields": {
    				"groupId": 125,
    				"createdBy": 6,
    			},
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'tasks.api.scrum.backlog.update',
                [
                    'id' => 1,
                    'fields' => [
                        'groupId'   => 125,
                        'createdBy' => 6,
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error updating backlog: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'tasks.api.scrum.backlog.update',
        {
            "id": 1,
            "fields": {
                "groupId": 125,
                "createdBy": 6,
            },
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'tasks.api.scrum.backlog.update',
        [
            'id' => 1,
            'fields' => [
                'groupId' => 125,
                'createdBy' => 6,
            ],
        ]
    );

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

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

HTTP-статус: 200

{
    "result": {
        "id": 1,
        "groupId": 125,
        "createdBy": 6,
        "modifiedBy": 1
    },
    "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"
    }
}

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

Название
тип
Описание
id
integer
Идентификатор бэклога
groupId
integer
Идентификатор группы, для которой был создан бэклог
createdBy
integer
Идентификатор пользователя, который создал бэклог
modifiedBy
integer
Идентификатор пользователя, который изменил бэклог

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"Access denied"
}

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

КодCообщение об ошибкеОписание
100Could not find value for parameter {fields}Не передан обязательный параметр fields
0Backlog not foundПередан невалидный идентификатор бэклога
0Access deniedОтсутствуют соответствующие права доступа
0Unknown errorДругая ошибка
  • [](./tasks-api-scrum-backlog-add)
  • [](./tasks-api-scrum-backlog-get)
  • [](./tasks-api-scrum-backlog-delete)
  • [](./tasks-api-scrum-backlog-get-fields)

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

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

  • Всегда используйте кэширование при частых запросах к tasks.api.scrum.backlog.update, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Обновить бэклог tasks.api.scrum.backlog.update».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

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

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

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

Related Post

Обновить универсальный список lists.updateОбновить универсальный список lists.update

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

Оптимизация таблиц базы данных MyISAM и перевод всех таблиц ядра Битрикс на InnoDBОптимизация таблиц базы данных MyISAM и перевод всех таблиц ядра Битрикс на InnoDB

Высокая скорость загрузки сайта и безупречная серверная безопасность — обязательные требования для успешного коммерческого проекта на 1С-Битрикс. Услуга «Оптимизация таблиц базы данных MyISAM и перевод всех таблиц ядра Битрикс на

Событие при удалении компании onCrmCompanyDeleteСобытие при удалении компании onCrmCompanyDelete

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