mirror of
https://github.com/netbox-community/netbox.git
synced 2024-05-10 07:54:54 +00:00
cf1b1a83eb
* Initial work on custom field choice sets * Rename choices to extra_choices (prep for #12194) * Remove CustomField.choices * Add & update tests * Clean up table columns * Add order_alphanetically boolean for choice sets * Introduce ArrayColumn for choice lists * Show dependent custom fields on choice set view * Update custom fields documentation * Introduce ArrayWidget for more convenient editing of choices * Incorporate PR feedback * Misc cleanup * Initial work on predefined choices for custom fields * Misc cleanup * Add IATA airport codes * #13241: Add support for custom field choice labels * Restore ArrayColumn * Misc cleanup * Change extra_choices back to a nested ArrayField to preserve choice ordering * Hack to bypass GraphQL API test utility absent support for nested ArrayFields
28 lines
949 B
Markdown
28 lines
949 B
Markdown
# Custom Field Choice Sets
|
|
|
|
Single- and multi-selection [custom fields](../../customization/custom-fields.md) must define a set of valid choices from which the user may choose when defining the field value. These choices are defined as sets that may be reused among multiple custom fields.
|
|
|
|
A choice set must define a base choice set and/or a set of arbitrary extra choices.
|
|
|
|
## Fields
|
|
|
|
### Name
|
|
|
|
The human-friendly name of the choice set.
|
|
|
|
### Base Choices
|
|
|
|
The set of pre-defined choices to include. Available sets are listed below. This is an optional setting.
|
|
|
|
* IATA airport codes
|
|
* ISO 3166 - Two-letter country codes
|
|
* UN/LOCODE - Five-character location identifiers
|
|
|
|
### Extra Choices
|
|
|
|
A set of custom choices that will be appended to the base choice set (if any).
|
|
|
|
### Order Alphabetically
|
|
|
|
If enabled, the choices list will be automatically ordered alphabetically. If disabled, choices will appear in the order in which they were defined.
|