Documentation

crm.requisite.userfield.update

crm.requisite.userfield.update(id, fields)

Updates existing user field for requisite.

Parameters

Parameter Description
idUser field ID.
fieldsSet of fields - is an array (“updated field"=>”value”[, ...]), containing user file description. Full description of fields can be returned by calling the crm.userfield.fields method.
LIST Contains set of values for custom field List. Specified when creating/updating a field. Each value is an array containing fields:
  • VALUE - list item value. Field is required when creating a new item.
  • SORT - sorting.
  • DEF - if Y, list item is a default value. A field with multiple values van have DEF=Y. For non-multiple value, first value is a default value.
  • XML_ID - external value code. Parameter is considered only when updating already existing list item value.
  • ID - value identifier. If specified, it's deemed as an update of existing list item and not creation of a new one. Useful only when calling methods *.userfield.update.
  • DEL - if set as Y, existing list item will be deleted. Applied, if ID parameter is complete.

Example

var id = prompt("Enter ID");
var label = prompt("Enter new name");
BX24.callMethod(
    "crm.requisite.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();						
        }
    }
);


© «Bitrix24», 2001-2024