...
Download all options of a pick list. This method works with any kind of pick list.
Wordbee supports pick list custom fields. Such custom fields define different options from which a user can select from. Use settings/customfields to enumerate all fields and see which ones are pick lists (look for “Combo”). The present method returns the options configured for a specific custom field. Please note that options come in two flavors:
List of strings: Most field types only allow to configure a list of strings. This concerns fields Combo, ComboEditable and ComboMultiSelect.
List of strings with meta data: Fields of type ComboExt ComboAuto are like Combo regular pick lists but with a nice twist: You can also specify a list of strings but also add meta-data to each string. Read more.
URL
Code Block |
---|
(GET) /api/settings/customfields/{id}/options/items |
...
id | The unique ID of the custom field. Easily find all your fields' IDs with: settings/customfields Note: The ID is of the following format. The first number identifies the object to which the field relates (such as project, job, person, segment, etc.). The second number is a sequential field number.
The first number is the object:
| string, Mandatory |
RESULTS
The result is a JSON array with all the options. Each element represents one option with these properties:
...
Note: Options are always sorted alphabetically by their value.
Examples
Options with meta data:
Code Block |
---|
[
{
"value": "10009",
"meta": [
{ "title": "Project", "value": "Project A-10009 - Henderson", "show": true }
]
},
{
"value": "10054",
"meta": [
{ "title": "Project", "value": "Project X-33223 - IBM", "show": true },
{ "title": "Owner", "value": "John", "key": "owner", "show": false }
]
},
{
"value": "20092",
"meta": []
}
] |
Options for a pick list that does not support meta data. Here the “meta” node is always an empty array.
Code Block |
---|
[
{ "value": "London", "meta": [] },
{ "value": "Paris", "meta": [] }
] |