evaddudfvalues

Create one or more new UDF metadata values in a UDF list field

SYNOPSIS

evaddudfvalues [-f ] [-s ] dd_name value1[;value2;valuen]

DESCRIPTION

This command adds one or more values to an existing UDF field list. The display type of the field must be one of:

  • List
  • Tab
  • Pop-up

Values may optionally be embedded within double quote marks. This is mandatory if you want the semi-colon (;) character to appear within the metadata.

The default separator value of a semi-colon (;), can be altered to any other separator, with the -s option.

The -f option allows the input for the values to be derived from a text file.

The format of list values in the text file uses white space as a delimiter between each data dictionary name (the DD_NAME) and the list value (the LIST_VALUE).

You may have one DD_NAME and one LIST_VALUE per line in the text file, or you may have one DD_NAME with more than one LIST_VALUE per line. In this case, each LIST_VALUE is separated by the separator specified with the -s <separator> parameter.

When you use the -f <filename> parameter, you do not need to specify the DD_NAME in the command line.

EXAMPLE 1

DD_1 DD_1_LIST_VALUE1
DD_1 DD_1_LIST_VALUE2
DD_2 DD_2_LIST_VALUE1
DD_2 DD_2_LIST_VALUE2

EXAMPLE 2

DD_1 DD_1_LIST_VALUE1 DD_2 DD_2_LIST_VALUE1;DD_2_LIST_VALUE2

NOTES

  • You may only load values into UDF fields with this command. You may not load values into the database fields named ALT_ID, AREA_ID, ASSIGNED_TO, CATEGORY, ORIGINATOR, OWNER, PRIORITY, PRIVACY, PRODUCT_LINE, PRODUCT_NAME, PROJECT_ID, RELEASE_FIXED, RELEASE_FOUND, RESOLUTION, SEVERITY_LEVEL, and STATUS. At the present time, you must load values for these fields through the web-based interface
  • You may load any number of values with one invocation of the command
  • For each value successfully loaded, you will receive the message "value loaded OK"
  • Duplicate values are not allowed in UDF lists, and any duplicates will be rejected. Any rejects will be shown with the message "value not loaded"
  • The default separator of a semi-colon (;) must be escaped, if you are using the CLI from a Linux, Solaris or Unix operating system, as most shells interpret the semi-colon as the end of the command, with a new command beginning on the same line. Use a back-slash () before the semi-colon to achieve this, or use the -s option to set the separator to a different character.

EXAMPLE

Load a single value into the UDF named CUSTOMER from the command prompt –

DD_1 DD_1_LIST_VALUE1
$ evaddudfvalues CUSTOMER Big & Brash Inc.
Processing values for CUSTOMER: Big & Brash Inc.
loaded OK
$