edit_record

Modifies the fields and states of a record.

Synopsis

edit_record [common options] [-t/ype record type] [–a/ction name] [-delete] [-dup/licate id] [-undup/licate ] [-field name value]* [-f/ield name value]* [-ask] record id | -r/ecord "type id" | -dbid num | -input file name

Description

Modifies a record by entering an action that is appropriate for the current state of the record. The action can be provided on the command line or you can be prompted to select an action from a list of applicable actions based on the current state of the record.

Options and arguments

-t/ype record_type
The type of record you are modifying. If no value is provided, the default record type is used.
-a/ction name
The name of the action to perform. A possible action can be "Modify", which allows modification of fields with no state change or actions that perform a state transition.
-delete
Deletes the record.
-dup/licate id
Marks the record as a duplicate of the record ID provided.
-undup/licate
Deletes the duplicate relationship between two records.
-field name value
The alternate format for specifying a field and its value. Use this format if the field is the same name as a subcommand option.
-ask
Interactively prompts for optional and required fields to be set. Required fields are always prompted if not set on the command line.
-rid id
The record or records to modify.
-dbid number
The internal database ID of the record to modify.
-input file name
The file that contains the record ID of the record. The record IDs must be grouped by record type. Within each group, each record ID must be on a separate line.

Examples

Assign a defect in the "Submitted" state to an engineer by running the Assign action. You are prompted for the required fields.

CQTOOL> edit_record SAMPL00000011

Possible actions are listed below.
Modify
Assign
Close
Duplicate
Postpone
Delete
Enter an action name: Assign
Value required for field Priority [SHORT_STRING] (? to see list): 1
Value required for field Owner [REFERENCE] (? to see list) ?
tom
sandy
jim
Value required for field Owner [REFERENCE] (? to see list) sandy Defect
SAMPL00000011 edited with action Assign

Feedback