Bitrix24 User Field icon

Bitrix24 User Field

袪邪斜芯褌邪 褋 锌芯谢褜蟹芯胁邪褌械谢褜褋泻懈屑懈 锌芯谢褟屑懈 胁 Bitrix24

Actions20

Deal → Update

AI-generated

Overview

This node updates a user-defined field in the Bitrix24 CRM system specifically for the 'Deal' resource. It allows users to modify properties of an existing custom field such as the field label, whether the field supports multiple values, if it is mandatory, and visibility options like showing the field in filters or lists. For fields of type 'enumeration', it also supports updating the list of possible values. This node is useful for automating the management of custom fields in Bitrix24 deals, ensuring that field configurations stay up-to-date without manual intervention.

Use Case Examples

  1. Updating the label of a custom field in a deal to better reflect its purpose.
  2. Changing a custom field to allow multiple selections instead of a single value.
  3. Modifying the list of options for an enumeration-type custom field in deals.

Properties

Name Meaning
Field ID The unique identifier of the user field to update. Required to specify which field to modify.
Field Label The new label for the user field, which is displayed in forms and lists.
List Values For enumeration-type fields, the list of possible values that the field can take. Each value has a string representation.
Multiple Boolean flag indicating if the field supports multiple values (true) or a single value (false).
Mandatory Boolean flag indicating if the field is mandatory (true) or optional (false).
Show Filter Boolean flag indicating if the field should be shown as a filter option in the UI.
Show In List Boolean flag indicating if the field should be shown in list views.

Output

JSON

  • result - The response from the Bitrix24 API after updating the user field, indicating success or failure and details of the updated field.

Dependencies

  • Bitrix24 API authentication credential

Troubleshooting

  • Common issues include providing an invalid or non-existent Field ID, which will cause the API to return an error indicating the field could not be found.
  • Incorrect formatting of list values for enumeration fields may cause the update to fail; ensure the list values are provided as an array of objects with 'VALUE' and 'SORT' properties.
  • API authentication errors if the Bitrix24 API credential is missing or invalid.
  • If the node is set to continue on fail, errors will be returned as part of the output array instead of stopping execution.

Links

Discussion