ticket¶

vb ticket SUBCOMMAND [OPTIONS]

Description¶

Run various subcommands to control tickets

Note that the values in set|add are not validated against the definitions given in Ticket Common Script.

Subcommands¶

vb ticket show¶

vb ticket show (REPORTTITLE|REPORTNR) [TICKETFILTER] [OPTIONS]

Description¶

Run the ticket report, identified by the report format title used in the GUI. The data is written as flat file on stdout, using TAB as separator. The separator can be changed using the -l or --limit option.

If --quote is used, the tickets are encoded by quoting special chars (space -> \s, tab -> \t, newline -> \n, cr -> \r, formfeed -> \f, vtab -> \v, nul -> \0, \ -> \\). Otherwise, the simplified encoding as on the show report raw page in the GUI is used. This has no effect in JSON mode.

Instead of the report title it’s possible to use the report number; the special report number 0 lists all columns defined in the ticket table.

If TICKETFILTER is given on the commandline, the query is limited with a new WHERE-condition:

example:    Report lists a column # with the uuid
            TICKETFILTER may be [#]='uuuuuuuuu'
example:    Report only lists rows with status not open
            TICKETFILTER: status != 'open'

Options¶

-l, --limit LIMITCHAR¶: Set the separator character for the output

-q, --quote¶: Quote special characters

-R, --repository REPO¶: Use the given repository

vb ticket list fields (ls fields)¶

vb ticket list|ls fields

Description¶

List all fields defined for ticket in the vb repository.

vb ticket list reports (ls reports)¶

vb ticket list|ls reports

Description¶

List all ticket reports defined in the vb repository.

vb ticket set (change)¶

vb ticket set|change TICKETUUID (FIELD VALUE)+ [-q|--quote]

Description¶

Change ticket identified by TICKETUUID to set the values of each field FIELD to VALUE.

Field names as defined in the TICKET table. By default, these names include: type, status, subsystem, priority, severity, foundin, resolution, title, and comment, but other field names can be added or substituted in customized installations.

If you use +FIELD, the VALUE is appended to the field FIELD. You can use more than one field/value pair on the commandline. Using –quote enables the special character decoding as in ticket show, which allows setting multiline text or text with special characters.

vb ticket add¶

vb ticket add FIELD VALUE [FIELD VALUE ...] [-q|--quote]

Description¶

Like set, but create a new ticket with the given values.

vb ticket history¶

vb ticket history TICKETUUID

Description¶

Show the complete change history for the ticket

Examples¶

List ticket fields and reports

$ vb ticket list fields
comment
foundin
icomment
login
mimetype
priority
private_contact
resolution
severity
status
subsystem
title
type
username
$ vb ticket list reports
Available reports:
report number	report title
0	full ticket export
1	All Tickets

Create a ticket

$ vb ticket add type bug status open priority high severity major subsystem ui title "Button not responding" comment "Steps to reproduce:\n1. Click button\n2. Nothing happens" --quote
ticket add succeeded for d39d786974e55ce4f5fcb00fba2acfad357561ae

Show all tickets

$ vb ticket show 1
bgcolor	#	mtime	type	status	subsystem	title
#c8c8c8	d39d786974	2026-03-31 13:00:45	bug	open	ui	Button not responding