CREATE TABLE ticket( -- Do not change any column that begins with tkt_ tkt_id INTEGER PRIMARY KEY, tkt_uuid TEXT UNIQUE, tkt_mtime DATE, tkt_ctime DATE, -- Add as many fields as required below this line type TEXT, status TEXT, subsystem TEXT, priority TEXT, severity TEXT, foundin TEXT, private_contact TEXT, resolution TEXT, title TEXT, comment TEXT )
The SQL must consist of a single SELECT statement
If a column of the result set is named "#" then that column is assumed to hold a ticket number. A hyperlink will be created from that column to a detailed view of the ticket.
If a column of the result set is named "bgcolor" then the content of that column determines the background color of the row.
The text of all columns prior to the first column whose name begins with underscore ("_") is shown character-for-character as it appears in the database. In other words, it is assumed to have a mimetype of text/plain.
The first column whose name begins with underscore ("_") and all subsequent columns are shown on their own rows in the table and with wiki formatting. In other words, such rows are shown with a mimetype of text/x-fossil-wiki. This is recommended for the "description" field of tickets.
The query can join other tables in the database besides TICKET.
In this example, the first column in the result set is named "bgcolor". The value of this column is not displayed. Instead, it selects the background color of each row based on the TICKET.STATUS field of the database. The color key at the right shows the various color codes.
|new or active|
SELECT CASE WHEN status IN ('new','active') THEN '#f2dcdc' WHEN status='review' THEN '#e8e8bd' WHEN status='fixed' THEN '#cfe8bd' WHEN status='tested' THEN '#bde5d6' WHEN status='defer' THEN '#cacae5' ELSE '#c8c8c8' END as 'bgcolor', tn AS '#', type AS 'Type', status AS 'Status', sdate(origtime) AS 'Created', owner AS 'By', subsystem AS 'Subsys', sdate(changetime) AS 'Changed', assignedto AS 'Assigned', severity AS 'Svr', priority AS 'Pri', title AS 'Title' FROM ticket
To base the background color on the TICKET.PRIORITY or TICKET.SEVERITY fields, substitute the following code for the first column of the query:
SELECT CASE priority WHEN 1 THEN '#f2dcdc' WHEN 2 THEN '#e8e8bd' WHEN 3 THEN '#cfe8bd' WHEN 4 THEN '#cacae5' ELSE '#c8c8c8' END as 'bgcolor', ... FROM ticket
To see the TICKET.DESCRIPTION and TICKET.REMARKS fields, include them as the last two columns of the result set and given them names that begin with an underscore. Like this:
SELECT tn AS '#', type AS 'Type', status AS 'Status', sdate(origtime) AS 'Created', owner AS 'By', subsystem AS 'Subsys', sdate(changetime) AS 'Changed', assignedto AS 'Assigned', severity AS 'Svr', priority AS 'Pri', title AS 'Title', description AS '_Description', -- When the column name begins with '_' remarks AS '_Remarks' -- content is rendered as wiki FROM ticket