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

Сбросить параметры карточки элементов crm.item.details.configuration.reset

> Название метода: crm.item.details.configuration.reset
>
> Scope: crm
>
> Кто может выполнять метод: проверка прав при выполнении метода зависит от переданных данных:
> — Любой пользователь имеет право сбросить свои личные настройки
> — Пользователь имеет право сбрасывать общие и чужие настройки только если он является администратором

Метод сбрасывает настройки карточки элемента до значений по умолчанию. Удаляет личные настройки карточки указанного пользователя или общие настройки, заданные для всех пользователей.

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

extras

Параметр в extras зависит от объекта CRM.

Примеры кода

Сбросить общую конфигурацию для карточек сделок в воронке с id = 9 для пользователя с id = 1

• cURL (Webhook)

    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"entityTypeId":2,"userId":1,"scope":"C","extras":{"dealCategoryId":9}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.details.configuration.reset

• cURL (OAuth)

    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"entityTypeId":2,"userId":1,"scope":"C","extras":{"dealCategoryId":9},"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.item.details.configuration.reset

• JS

    try
    {
    	const response = await $b24.callMethod(
    		'crm.item.details.configuration.reset',
    		{
    			entityTypeId: 2,
    			userId: 1,
    			scope: "C",
    			extras: {
    				dealCategoryId: 9,
    			},
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }

• PHP

    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.item.details.configuration.reset',
                [
                    'entityTypeId' => 2,
                    'userId'       => 1,
                    'scope'        => "C",
                    'extras'       => [
                        'dealCategoryId' => 9,
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
            return;
        }
    
        echo 'Success: ' . print_r($result->data(), true);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error resetting details configuration: ' . $e->getMessage();
    }

• BX24.js

        BX24.callMethod(
            'crm.item.details.configuration.reset',
            {
                entityTypeId: 2,
                userId: 1,
                scope: "C",
                extras: {
                    dealCategoryId: 9,
                },
            },
            (result) => {
                if (result.error())
                {
                    console.error(result.error());

                    return;
                }

                console.info(result.data());
            },
        );

• PHP CRest

    require_once('crest.php');

    $result = CRest::call(
        'crm.item.details.configuration.reset',
        [
            'entityTypeId' => 2,
            'userId' => 1,
            'scope' => 'C',
            'extras' => [
                'dealCategoryId' => 9,
            ]
        ]
    );

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

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

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1720687072.190654,
        "finish": 1720687072.586945,
        "duration": 0.39629101753234863,
        "processing": 0.057084083557128906,
        "date_start": "2024-07-11T10:37:52+02:00",
        "date_finish": "2024-07-11T10:37:52+02:00",
        "operating": 0
    }
}

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Parameter 'entityTypeId' is not defined"
}

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

• [](./index)
• [](./crm-item-details-configuration-get)
• [](./crm-item-details-configuration-set)
• [](./crm-item-details-configuration-forceCommonScopeForAll)

[1]: ../../../data-types.md