Блог Горошко Андрея Bitrix24,PHP Получить параметры карточки crm.deal.details.configuration.get

Получить параметры карточки crm.deal.details.configuration.get

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

Получить параметры карточки crm.deal.details.configuration.get

Тут может не хватать некоторых данных — дополним в ближайшее время

  • нужны правки под стандарт написания
  • не указаны типы параметров
  • не указана обязательность параметров
  • отсутствуют примеры
  • отсутствует ответ в случае успеха
  • отсутствует ответ в случае ошибки

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

Метод crm.deal.details.configuration.get получает настройки карточки сделок. Метод читает личные настройки карточки указанного пользователя или общие настройки, заданные для всех пользователей.

Предупреждение
Обратите внимание, что настройки карточки сделок разных направлений (или воронок) могут отличаться друг от друга.
Для переключения между настройками карточек сделок разных направлений применяется параметр dealCategoryId.

ПараметрОписание
scope
unknown
Область применения настроек. Допустимые значения:

— P — личные настройки,
— C — общие настройки.

userId
unknown
Идентификатор пользователя. Если не задан, то берётся текущий. Нужен только при запросе личных настроек.
extras
unknown
Дополнительные параметры. Здесь для сделок может быть задан параметр dealCategoryId.

Практические примеры использования в коде

  • PHP
    try {
        //Запрос личных настроек карточки сделок для пользователя с идентификатором 1.
        $response1 = $b24Service
            ->core
            ->call(
                "crm.deal.details.configuration.get",
                [
                    'scope'  => "P",
                    'userId' => 1
                ]
            );
    
        $result1 = $response1
            ->getResponseData()
            ->getResult();
    
        echo 'Personal deal details configuration for user 1: ' . print_r($result1, true);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting personal deal details configuration: ' . $e->getMessage();
    }
    
    try {
        //Запрос общих настроек карточки сделок для общего направления.
        $response2 = $b24Service
            ->core
            ->call(
                "crm.deal.details.configuration.get",
                [
                    'scope' => "C"
                ]
            );
    
        $result2 = $response2
            ->getResponseData()
            ->getResult();
    
        echo 'Common deal details configuration for general direction: ' . print_r($result2, true);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting common deal details configuration: ' . $e->getMessage();
    }
    
    try {
        //Запрос общих настроек карточки сделок для направления с идентификатором 1.
        $response3 = $b24Service
            ->core
            ->call(
                "crm.deal.details.configuration.get",
                [
                    'scope'  => "C",
                    'extras' => ['dealCategoryId' => 1]
                ]
            );
    
        $result3 = $response3
            ->getResponseData()
            ->getResult();
    
        echo 'Common deal details configuration for direction with ID 1: ' . print_r($result3, true);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting common deal details configuration for direction with ID 1: ' . $e->getMessage();
    }
  • BX24.js
    //--
    //Запрос личных настроек карточки сделок для пользователя с идентификатором 1.
    BX24.callMethod(
        "crm.deal.details.configuration.get",
        {
            scope: "P",
            userId: 1
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
    //Запрос общих настроек карточки сделок для общего направления.
    BX24.callMethod(
        "crm.deal.details.configuration.get",
        {
            scope: "C"
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
    //Запрос общих настроек карточки сделок для направления с идентификатором 1.
    BX24.callMethod(
        "crm.deal.details.configuration.get",
        {
            scope: "C",
            extras: { dealCategoryId: 1 }
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
    //--

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

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

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

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

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

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

Related Post

Как использовать CIBlockSection::GetByID() в 1С-Битрикс: пример кодаКак использовать CIBlockSection::GetByID() в 1С-Битрикс: пример кода

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

Как использовать метод SDK crm.lead.userfield.get в Битрикс24Как использовать метод SDK crm.lead.userfield.get в Битрикс24

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

Изменить роль documentgenerator.role.updateИзменить роль documentgenerator.role.update

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Изменить роль documentgenerator.role.update». Вы узнаете экспертные методики работы с documentgenerator.role.update и научитесь избегать