Create one or more new UDF metadata values in a UDF list field
SYNOPSIS
evaddudfvalues [-f
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
$