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

Изменить цифровое рабочее место crm.automatedsolution.update

• здесь есть ссылка на файл data-types, надо проверить что там описан тип crm_dynamic_type (из смарт-процессов)

> Scope: crm
>
> Кто может выполнять метод: пользователи с административным доступом к разделу crm

Метод обновляет существующие настройки цифрового рабочего места с идентификатором id. Если какое-то из полей не было передано, его значение останется прежним.

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

"fields": {
    "title": "значение",
    "typeIds": []
}

Параметр fields

Примеры кода

1. Изменить название цифрового рабочего места

• cURL (Webhook)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"title":"HR & Customer Success"}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.automatedsolution.update

• cURL (OAuth)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"title":"HR & Customer Success"},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.automatedsolution.update

• JS

        BX24.callMethod(
            'crm.automatedsolution.update',
            {
                "id": 238,
                "fields": {
                    "title": "HR & Customer Success"
                }
            },
            function(result) {
                if (result.error()) {
                    console.error(result.error());
                } else {
                    console.info(result.data());
                }
            }
        );

• PHP

        require_once('crest.php');

        $result = CRest::call(
            'crm.automatedsolution.update',
            [
                'id' => 238,
                'fields' =>
                [
                    'title' => 'HR & Customer Success'
                ]
            ]
        );

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

2. Изменить список привязанных смарт-процессов

Допустим к цифровому рабочему месту с id = 267 были привязаны два смарт-процесса — один с id = 14, а другой — с id = 158. Если мы хотим, чтобы в цифровом рабочем месте остался только один смарт-процесс, то передаем поле typeIds, содержащее только нужные смарт-процессы:

• cURL (Webhook)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"typeIds":[14]}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.automatedsolution.update

• cURL (OAuth)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"typeIds":[14]},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.automatedsolution.update

• JS

        BX24.callMethod(
            'crm.automatedsolution.update',
            {
                "id": 238,
                "fields": {
                    "typeIds": [
                        14
                    ]
                }
            },
            function(result) {
                if (result.error()) {
                    console.error(result.error());
                } else {
                    console.info(result.data());
                }
            }
        );

• PHP

        require_once('crest.php');

        $result = CRest::call(
            'crm.automatedsolution.update',
            [
                'id' => 238,
                'fields' =>
                [
                    'typeIds' => [14]
                ]
            ]
        );

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

3. Отвязать все смарт-процессы

Чтобы отвязать все смарт-процессы от цифрового рабочего места, нужно передать пустой массив в качестве typeIds.

• cURL (Webhook)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"typeIds":[]}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.automatedsolution.update

• cURL (OAuth)

        curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"id":238,"fields":{"typeIds":[]},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.automatedsolution.update

• JS

        BX24.callMethod(
            'crm.automatedsolution.update',
            {
                "id": 238,
                "fields": {
                    "typeIds": []
                }
            },
            function(result) {
                if (result.error()) {
                    console.error(result.error());
                } else {
                    console.info(result.data());
                }
            }
        );

• PHP

        require_once('crest.php');

        $result = CRest::call(
            'crm.automatedsolution.update',
            [
                'id' => 238,
                'fields' =>
                [
                    'typeIds' => []
                ]
            ]
        );

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

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

HTTP-статус: 200

{
    "result": {
        "automatedSolution": {
            "id": 1,
            "title": "HR",
            "typeIds": [
                1,
                2,
                3
            ]
        }
    },
    "time": {
        "start": 1715849396.642359,
        "finish": 1715849396.954623,
        "duration": 0.31226396560668945,
        "processing": 0.0068209171295166016,
        "date_start": "2024-05-16T11:49:56+03:00",
        "date_finish": "2024-05-16T11:49:56+03:00",
        "operating_reset_at": 1715849996,
        "operating": 0
    }
}

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

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

HTTP-статус: 400

{
    "error":"BX_EMPTY_REQUIRED",
    "error_description":"Не заполнено обязательное поле"
}

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

• [](./index)
• [](./crm-automated-solution-add)
• [](./crm-automated-solution-get)
• [](./crm-automated-solution-list)
• [](./crm-automated-solution-delete)
• [](./crm-automated-solution-fields)