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