Блог Горошко Андрея Bitrix24,PHP Получить поля шаблона реквизитов по id crm.requisite.preset.get

Получить поля шаблона реквизитов по id crm.requisite.preset.get

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

Получить поля шаблона реквизитов по id crm.requisite.preset.get

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

Метод возвращает шаблон реквизитов по идентификатору.

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

Название
тип
Описание
id*
integer
Идентификатор шаблона реквизита. Можно получить с помощью метода crm.requisite.preset.list

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":347}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.requisite.preset.get
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":347,"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.requisite.preset.get
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		"crm.requisite.preset.get",
    		{ id: 347 }    // Идентификатор шаблона реквизита.
    	);
    	
    	const result = response.getData().result;
    	console.dir(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.requisite.preset.get',
                [
                    'id' => 347,
                ]
            );
    
        $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 requisite preset: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        "crm.requisite.preset.get",
        { id: 347 },    // Идентификатор шаблона реквизита.
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.requisite.preset.get',
        [
            'id' => 347
        ]
    );

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

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

HTTP-статус: 200

{
    "result": {
        "ID": "347",
        "ENTITY_TYPE_ID": "8",
        "COUNTRY_ID": "1",
        "DATE_CREATE": "2024-05-24T15:45:44+02:00",
        "DATE_MODIFY": "",
        "CREATED_BY_ID": "1",
        "MODIFY_BY_ID": null,
        "NAME": "ИП",
        "XML_ID": "EXAMPLE_COMPANY__VALUE_1",
        "ACTIVE": "Y",
        "SORT": "520"
    },
    "time": {
        "start": 1716558423.336056,
        "finish": 1716558424.695338,
        "duration": 1.3592820167541504,
        "processing": 0.06150317192077637,
        "date_start": "2024-05-24T15:47:03+02:00",
        "date_finish": "2024-05-24T15:47:04+02:00",
        "operating": 0
    }
}

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

Название
тип
Описание
result
object
Объект, содержащий значения полей шаблона
time
time
Информация о времени выполнения запроса

Описание полей шаблона реквизитов

Название
тип
Описание
ID
integer
Идентификатор реквизита. Создается автоматически и уникален в рамках портала
ENTITY_TYPE_ID
integer
Идентификатор типа родительского объекта.

Идентификаторы типов объектов CRM отдает метод crm.enum.ownertype

COUNTRY_ID
integer
Идентификатор страны, которой соответствует набор полей шаблона реквизита (для получения доступных значений смотрите метод crm.requisite.preset.countries)
DATE_CREATE
datetime
Дата создания
DATE_MODIFY
datetime
Дата изменения. Содержит пустую строку, если шаблон не менялся после создания
CREATED_BY_ID
user
Идентификатор пользователя, создавшего реквизит
MODIFY_BY_ID
user
Идентификатор пользователя, изменившего реквизит
NAME
string
Название реквизита
XML_ID
string
Внешний ключ. Используется для операций обмена. Идентификатор объекта внешней информационной базы.

Назначение поля может меняться конечным разработчиком.

Каждое приложение обеспечивает уникальность значений в этом поле. Рекомендуется использовать уникальный префикс для избежания коллизий с другими приложениями.

В CRM зарезервированы значения вида #CRM_REQUISITE_PRESET_DEF_... для идентификации шаблонов, которые используются по умолчанию. Не следует использовать эти идентификаторы для своих целей, так как это может привести к нарушению логики

ACTIVE
char
Признак активности. Используются значения Y или N. Определяет доспупность шаблона в списке выбора при добавлении реквизитов
SORT
integer
Сортировка

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

HTTP-статус: 40x, 50x

{
    "error": "",
    "error_description": "The Preset with ID '347' is not found"
}

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

КодОписание
The Preset with ID '347' is not foundШаблон с указанным идентификатором не найден
Access deniedНедостаточно прав доступа для получения шаблона
  • [](./crm-requisite-preset-add)
  • [](./crm-requisite-preset-update)
  • [](./crm-requisite-preset-countries)
  • [](./crm-requisite-preset-list)
  • [](./crm-requisite-preset-delete)
  • [](./crm-requisite-preset-fields)

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

Практические рекомендации:

  • При написании кастомных компонентов для «Получить поля шаблона реквизитов по id crm.requisite.preset.get» всегда разделяйте бизнес-логику и представление (шаблон).
  • Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

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

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

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

Related Post

Настройка автоматической очистки кэша по тегам (TagCache) без полного сброса всего сайтаНастройка автоматической очистки кэша по тегам (TagCache) без полного сброса всего сайта

Высокая скорость загрузки сайта и безупречная серверная безопасность — обязательные требования для успешного коммерческого проекта на 1С-Битрикс. Услуга «Настройка автоматической очистки кэша по тегам (TagCache) без полного сброса всего сайта»

Как использовать метод SDK crm.contact.company.items.delete в Битрикс24Как использовать метод SDK crm.contact.company.items.delete в Битрикс24

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Как использовать метод SDK crm.contact.company.items.delete в Битрикс24». Вы узнаете экспертные методики работы с

Добавить связь записи таймлайна с элементом CRM crm.timeline.bindings.bindДобавить связь записи таймлайна с элементом CRM crm.timeline.bindings.bind

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Добавить связь записи таймлайна с элементом CRM crm.timeline.bindings.bind»,