Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Updates the list of options of a picklist pick list custom field.

This method is used for custom fields of type: Combo, ComboEditable and ComboMultiSelect only.

 

Warning

Not implemented. Currently hidden page.

...

(PUT) /settings/customfields/{id}/options

PARAMETERS

Parameters URL parameters are:

domain

The job ID. Also see jobs/{id}/summary

string, Mandatory
customFieldId

Default: false.

If true then include comments for all jobs in the same workflow. Parameter is disregarded if the user does not have sufficient access rights.

bool, Optional

...

The result is a JSON array with one element per custom field:

od

domain

The object to which the custom field is attached. This can be any of:

  • Segment
  • Project
  • Resource
  • Order
  • Company
  • Person
  • Job
  • Invoice

 

string

customFieldId

The unique ID of the custom field for a given domain.The IDs are CustomStr1, CustomStr2….

string, Mandatory

 

The

...

title

...

The name of the custom field as provided by the administrator.

...

desc

...

Optional internal description.

...

type

...

The field type. Can be any of:

  • String - A free text field
  • Combo - A picklist
  • ComboEditable - A picklist but user can also type free text
  • ComboMultiSelect - A picklist with multiple choices
  • Hyperlink - A hyperlink
  • Checkbox - A checkbox

 

...

max

...

Maximum value length for String and ComboEditable fields. Disregarded for all other field types.

...

mandatory

...

Indicates if a value must be supplied when editing a field.

...

options

...

A list of picklist options proposed to user.

Used with field types Combo and ComboEditable.

...

Indicates if the field is enabled or not.

...

A numeric valie specifying the access to this field by internal users:

  • 0: No access
  • 1: Can view value
  • 2: Can view and edit value

...

A numeric valie specifying the access to this field by internal users:

  • 0: No access
  • 1: Can view value
  • 2: Can view and edit value

...

Optional list of advanced settings regarding use or accessibility of custom field.

Segment custom fields:

  • LOC: Language specific. Attached to each translation of the segment.
  • SEG / null: Not language specific. Attached to segment.

Resource custom fields:

  • TM: Used with translation memories only.
  • TERM: Used with term bases only.
  • TFHITS: If set then visible in global search.

Company custom fields:

  • CLIENT: Used with client companies only.
  • SUPP: Used with supplier companies only.

 

...

 

EXAMPLES

The following example is for a manager user accessing a job which is proposed to him/her. As a manager, the user has management level actions as well.

...

request body contains a json array with the options.

request body

JSON array of options.

If null or [] then the system clears all options. Note that with custom fields of type Combo and ComboMultiSelect you need to specify at least one option.

Double entries are automatically removed.

string[], Mandatory


RESULTS

The method returns no result.