crm-deal-userfield-update.md

Изменить существующее пользовательское поле сделок crm.deal.userfield.update

{% note warning "Мы еще обновляем эту страницу" %}

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

{% endnote %}

{% if build == 'dev' %}

{% note alert "TO-DO не выгружается на prod" %}

• не указаны типы параметров
• не указана обязательность параметров
• отсутствуют примеры (на других языках)
• отсутствует ответ в случае успеха
• отсутствует ответ в случае ошибки
• не прописаны ссылки на ещё не созданные страницы

{% endnote %}

{% endif %}

Scope: crm

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

Метод crm.deal.userfield.update обновляет существующее пользовательское поле сделок.

#| || Параметр | Описание || || id | Идентификатор пользовательского поля. || || fields | Набор полей – массив вида array("обновляемое поле"=>"значение"[, ...]), где "обновляемое поле" может принимать значения из возвращаемых методом crm.userfield.fields. || || LIST | Содержит набор значений списка для пользовательских полей типа Список. Указывается при создании/обновлении поля. Каждое значение представляет собой массив с полями:

• VALUE - значение элемента списка. Поле является обязательным в случае, когда создается новый элемент.
• SORT - сортировка.
• DEF - если равно Y, то элемент списка является значением по умолчанию. Для множественного поля допустимо несколько DEF=Y. Для не множественного, дефолтным будет считаться первое.
• XML_ID - внешний код значения. Параметр учитывается только при обновлении уже существующих значений элемента списка.
• ID - идентификатор значения. Если он указан, то считается что это обновление существующего значения элемента списка, а не создание нового. Имеет смысл только при вызове методов *.userfield.update.
• DEL - если равно Y, то существующий элемент списка будет удален. Применяется, если заполнен параметр ID. || |#

Пример

{% list tabs %}

• JS

  var id = prompt("Введите ID");
  var label = prompt("Введите новое название");
  BX24.callMethod(
      "crm.deal.userfield.update",
      {
          id: id,
          fields:
          {
              "EDIT_FORM_LABEL": label,
              "LIST_COLUMN_LABEL": label
          }
      },
      function(result)
      {
          if(result.error())
              console.error(result.error());
          else
          {
              console.dir(result.data());             
              if(result.more())
                  result.next();                        
          }
      }
  );

{% endlist %}

{% include Сноска о примерах %}