The Fields field

The p4 jobspec field named Fields lists the fields to be tracked by your jobs and specifies the order in which they appear on the p4 job form.

The default Fields field includes these fields:

Fields:
      101 Job word 32 required
      102 Status select 10 required
      103 User word 32 required
      104 Date date 20 always
      105 Description text 0 required

Warning

Do not attempt to change, rename, or redefine fields 101 through 105. Fields 101 through 105 are used by Helix Server and should not be deleted or changed. Use p4 jobspec only to add new fields (106 and above) to your jobs.

Each field must be listed on a separate line. A field is defined by a line containing each of the following five field descriptors.

Field descriptor	Meaning
ID#	A unique integer identifier by which this field is indexed. After a field has been created and jobs entered into the system, the name of this field can change, but the data becomes inaccessible if the ID number changes. ID numbers must be between `106` and `199`.
Name	The name of the field as it should appear on the `p4 job` form. No spaces are permitted.
Data type	One of six datatypes (`word`, `text`, `line`, `select`, `date` or `bulk`), as described in the next table.
Length	The recommended size of the field’s text box as displayed in P4V, the Helix Visual Client. To display a text box with room for multiple lines of input, use a length of `0`; to display a single line, enter the `Length` as the maximum number of characters in the line. The value of this field has no effect on jobs edited from the Helix Server command line, and it is not related to the actual length of the values stored by the server.
Field type	Determines whether a field is read-only, contains default values, is required, and so on. The valid values for this field are: optional: the field can take any value or can be deleted. default: a default value is provided, but it can be changed or erased. required: a default is given; it can be changed but the field can’t be left empty. once: read-only; the field is set once to a default value and is never changed. always: read-only; the field value is reset to the default value when the job is saved. Useful only with the `$now` variable to change job modification dates, and with the `$user` variable to change the name of the user who last modified the job.

Fields have the following six datatypes.

Field Type	Explanation	Example
`word`	A single word (a string without spaces).	A userid: edk
`text`	A block of text that can span multiple lines.	A job’s description.
`line`	One line of text.	A user’s real name: Ed K.
`select`	One of a set of user-defined values. Each field with datatype `select` must have a corresponding line in the `Values:` field entered into the job specification.	A job’s status. One of: open/suspended/closed
`date`	A date value: year/month/day:hours:minutes:seconds	The date and time of job creation: 1998/07/15:13:21:46
`bulk`	A block of text that can span multiple lines, but which is not indexed for searching with `p4 jobs -e`.	Alphanumeric data for which text searches are not expected.