Блог Горошко Андрея Bitrix24,PHP Удалить пользовательское поле контактов crm.contact.userfield.delete

Удалить пользовательское поле контактов crm.contact.userfield.delete

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

Удалить пользовательское поле контактов crm.contact.userfield.delete

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

Метод crm.contact.userfield.delete удаляет пользовательское поле контактов.

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

Название
тип
Описание
id*
integer
Идентификатор пользовательского поля, привязанного к контакту.

Идентификатор можно получить с помощью методов crm.contact.userfield.add или crm.contact.userfield.list

Примеры кода

Удалить пользовательское поле с id = 432

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":432}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.contact.userfield.delete
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":432,"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.contact.userfield.delete
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'crm.contact.userfield.delete',
    		{
    			id: 432,
    		}
    	);
    	
    	const result = response.getData().result;
    	result.error()
    		? console.error(result.error())
    		: console.info(result)
    	;
    }
    catch( error )
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $userfieldId = 123; // Replace with the actual userfield ID you want to delete
        $result = $serviceBuilder
            ->getCRMScope()
            ->contactUserfield()
            ->delete($userfieldId);
        if ($result->isSuccess()) {
            print("Deleted item successfully.");
        } else {
            print("Failed to delete item.");
        }
    } catch (Throwable $e) {
        print("An error occurred: " . $e->getMessage());
    }
  • BX24.js
    BX24.callMethod(
        'crm.contact.userfield.delete',
        {
            id: 432,
        },
        (result) => {
            result.error()
                ? console.error(result.error())
                : console.info(result.data())
            ;
        },
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.contact.userfield.delete',
        [
            'id' => 432
        ]
    );

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

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

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1724316817.995457,
        "finish": 1724316818.640754,
        "duration": 0.6452970504760742,
        "processing": 0.3215677738189697,
        "date_start": "2024-08-22T10:53:37+02:00",
        "date_finish": "2024-08-22T10:53:38+02:00",
        "operating": 0
    }
}

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

Название
тип
Описание
result
boolean
Корневой элемент ответа, содержит true в случае успеха
time
time
Информация о времени выполнения запроса

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

HTTP-статус: 400

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

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

КодОписаниеЗначение
-ID is not defined or invalidПереданный id либо меньше или равен нулю, либо же не передан вовсе
-Access deniedВозникает в случаях, когда:
— у пользователя нет административных прав
— пользователь пытается удалить пользовательское поле, не привязанное к контактам
ERROR_NOT_FOUNDThe entity with ID 'id' is not foundПользовательское поле с переданным id не существует
-Ошибка удаления FIELD_NAME для объекта ENTITY_IDНеизвестная ошибка при удалении
  • [](./crm-contact-userfield-add)
  • [](./crm-contact-userfield-update)
  • [](./crm-contact-userfield-get)
  • [](./crm-contact-userfield-list)

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

Ключевые выводы по теме «Удалить пользовательское поле контактов crm.contact.userfield.delete»:

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

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

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

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

Related Post

Удалить СМС-провайдер или провайдер сообщений messageservice.sender.deleteУдалить СМС-провайдер или провайдер сообщений messageservice.sender.delete

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

Получить поля пользовательского типа crm.type.fieldsПолучить поля пользовательского типа crm.type.fields

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

Тариф Битрикс24 «Enterprise»: для крупных корпораций и холдинговТариф Битрикс24 «Enterprise»: для крупных корпораций и холдингов

Выбор редакции, расчет точной сметы и покупка официальных лицензий 1С-Битрикс и Битрикс24 — это ключевой этап планирования любого цифрового проекта. Информация по теме «Тариф Битрикс24 «Enterprise»: для крупных корпораций и