/*
** Copyright (c) 2002 D. Richard Hipp
**
** This program is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public
** License as published by the Free Software Foundation; either
** version 2 of the License, or (at your option) any later version.
**
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
**
** You should have received a copy of the GNU General Public
** License along with this library; if not, write to the
** Free Software Foundation, Inc., 59 Temple Place - Suite 330,
** Boston, MA 02111-1307, USA.
**
** Author contact information:
** drh@hwaci.com
** http://www.hwaci.com/drh/
**
*******************************************************************************
**
** Code to generate the bug report listings
*/
#include "config.h"
#include "view.h"
/* Forward references to static routines */
static void report_format_hints();
/*
** WEBPAGE: /reportlist
*/
void view_list(void){
char **az;
int i;
login_check_credentials();
if( !g.okRead ){ login_needed(); return; }
throttle(1,0);
common_standard_menu("reportlist", "search?t=1");
if( g.okQuery ){
common_add_action_item("rptnew", "New Report Format");
}
common_add_help_item("CvstracReport");
common_header("Available Report Formats");
az = db_query("SELECT rn, title, owner FROM reportfmt ORDER BY title");
cgi_printf("
\n");
}
cgi_printf("\n");
common_footer();
}
/*
** Remove whitespace from both ends of a string.
*/
char *trim_string(const char *zOrig){
int i;
while( isspace(*zOrig) ){ zOrig++; }
i = strlen(zOrig);
while( i>0 && isspace(zOrig[i-1]) ){ i--; }
return mprintf("%.*s", i, zOrig);
}
/*
** Extract a numeric (integer) value from a string.
*/
char *extract_integer(const char *zOrig){
if( zOrig == NULL || zOrig[0] == 0 ) return "";
while( *zOrig && !isdigit(*zOrig) ){ zOrig++; }
if( *zOrig ){
/* we have a digit. atoi() will get as much of the number as it
** can. We'll run it through mprintf() to get a string. Not
** an efficient way to do it, but effective.
*/
return mprintf("%d", atoi(zOrig));
}
return "";
}
/*
** Remove blank lines from the beginning of a string and
** all whitespace from the end. Removes whitespace preceeding a NL,
** which also converts any CRNL sequence into a single NL.
*/
char *remove_blank_lines(const char *zOrig){
int i, j, n;
char *z;
for(i=j=0; isspace(zOrig[i]); i++){ if( zOrig[i]=='\n' ) j = i+1; }
n = strlen(&zOrig[j]);
while( n>0 && isspace(zOrig[j+n-1]) ){ n--; }
z = mprintf("%.*s", n, &zOrig[j]);
for(i=j=0; z[i]; i++){
if( z[i+1]=='\n' && z[i]!='\n' && isspace(z[i]) ){
z[j] = z[i];
while(isspace(z[j]) && z[j] != '\n' ){ j--; }
j++;
continue;
}
z[j++] = z[i];
}
z[j] = 0;
return z;
}
/*********************************************************************/
/*
** wiki_key(), tkt_key() and chng_key() generate what should be unique
** wrappers around field values which indicate the desired formatting of
** the field. output_report_field() takes care of the formatting when
** it detects a specific wrapper. The wrapper should not be something
** which ever occurs in user-content. Right now, the wrapper is just some
** random junk with a keyword, but if there's collisions we can tweak it,
** maybe to something more dependent on the field contents?
*/
static const char* wiki_key(){
static char key[64];
if( key[0]==0 ){
bprintf(key,sizeof(key),"wiki_%d:",rand());
}
return key;
}
static const char* tkt_key(){
static char key[64];
if( key[0]==0 ){
bprintf(key,sizeof(key),"tkt_%d:",rand());
}
return key;
}
static const char* chng_key(){
static char key[64];
if( key[0]==0 ){
bprintf(key,sizeof(key),"chng_%d:",rand());
}
return key;
}
static void f_wiki(sqlite3_context *context, int argc, sqlite3_value **argv){
char *zText;
if( argc!=1 ) return;
zText = (char*)sqlite3_value_text(argv[0]);
if(zText==0) return;
zText = mprintf("%s%s",wiki_key(),zText);
sqlite3_result_text(context, zText, -1, SQLITE_TRANSIENT);
free(zText);
}
static void f_tkt(sqlite3_context *context, int argc, sqlite3_value **argv){
char *zText;
int tn;
if( argc!=1 ) return;
tn = sqlite3_value_int(argv[0]);
zText = mprintf("%s%d",tkt_key(),tn);
sqlite3_result_text(context, zText, -1, SQLITE_TRANSIENT);
free(zText);
}
static void f_chng(sqlite3_context *context, int argc, sqlite3_value **argv){
char *zText;
int cn;
if( argc!=1 ) return;
cn = sqlite3_value_int(argv[0]);
zText = mprintf("%s%d",chng_key(),cn);
sqlite3_result_text(context, zText, -1, SQLITE_TRANSIENT);
free(zText);
}
static void view_add_functions(){
sqlite3 *db = db_open();
sqlite3_create_function(db, "wiki", 1, SQLITE_ANY, 0, &f_wiki, 0, 0);
sqlite3_create_function(db, "tkt", 1, SQLITE_ANY, 0, &f_tkt, 0, 0);
sqlite3_create_function(db, "chng", 1, SQLITE_ANY, 0, &f_chng, 0, 0);
}
/*********************************************************************/
/*
** Check the given SQL to see if is a valid query that does not
** attempt to do anything dangerous. Return 0 on success and a
** pointer to an error message string (obtained from malloc) if
** there is a problem.
*/
char *verify_sql_statement(char *zSql){
int i;
extern int sqlite3StrNICmp(const char*,const char*,int);
extern int sqlite3StrICmp(const char*,const char*);
/* First make sure the SQL is a single query command by verifying that
** the first token is "SELECT" and that there are no unquoted semicolons.
*/
for(i=0; isspace(zSql[i]); i++){}
if( sqlite3StrNICmp(&zSql[i],"select",6)!=0 ){
return mprintf("The SQL must be a SELECT statement");
}
for(i=0; zSql[i]; i++){
if( zSql[i]==';' ){
int bad;
int c = zSql[i+1];
zSql[i+1] = 0;
bad = sqlite3_complete(zSql);
zSql[i+1] = c;
if( bad ){
/* A complete statement basically means that an unquoted semi-colon
** was found. We don't actually check what's after that.
*/
return mprintf("Semi-colon detected! "
"Only a single SQL statement is allowed");
}
}
}
return 0;
}
/*
** WEBPAGE: /rptsql
*/
void view_see_sql(void){
int rn;
char *zTitle;
char *zSQL;
char *zOwner;
char *zClrKey;
char **az;
login_check_credentials();
if( !g.okRead ){
login_needed();
return;
}
throttle(1,0);
rn = atoi(PD("rn","0"));
az = db_query("SELECT title, sqlcode, owner, cols "
"FROM reportfmt WHERE rn=%d",rn);
common_standard_menu(0, 0);
common_add_help_item("CvstracReport");
common_add_action_item( mprintf("rptview?rn=%d",rn), "View");
common_header("SQL For Report Format Number %d", rn);
if( az[0]==0 ){
cgi_printf("
\n");
report_format_hints();
common_footer();
}
/*
** WEBPAGE: /rptnew
** WEBPAGE: /rptedit
*/
void view_edit(void){
int rn;
const char *zTitle;
const char *z;
const char *zOwner;
char *zClrKey;
char *zSQL;
char *zErr = 0;
login_check_credentials();
if( !g.okQuery ){
login_needed();
return;
}
throttle(1,1);
db_add_functions();
view_add_functions();
rn = atoi(PD("rn","0"));
zTitle = P("t");
zOwner = PD("w",g.zUser);
z = P("s");
zSQL = z ? trim_string(z) : 0;
zClrKey = trim_string(PD("k",""));
if( rn>0 && P("del2") ){
db_execute("DELETE FROM reportfmt WHERE rn=%d", rn);
cgi_redirect("reportlist");
return;
}else if( rn>0 && P("del1") ){
zTitle = db_short_query("SELECT title FROM reportfmt "
"WHERE rn=%d", rn);
if( zTitle==0 ) cgi_redirect("reportlist");
common_add_action_item(mprintf("rptview?rn=%d",rn), "Cancel");
common_header("Are You Sure?");
cgi_printf("\n",zTitle,rn);
common_footer();
return;
}else if( P("can") ){
/* user cancelled */
cgi_redirect("reportlist");
return;
}
if( zTitle && zSQL ){
if( zSQL[0]==0 ){
zErr = "Please supply an SQL query statement";
}else if( (zTitle = trim_string(zTitle))[0]==0 ){
zErr = "Please supply a title";
}else if( (zErr = verify_sql_statement(zSQL))!=0 ){
/* empty... zErr non-zero */
}else{
/* check query syntax by actually trying the query */
int access = db_restrict_access(1);
zErr = db_query_check("%s", zSQL);
if( zErr ) zErr = mprintf("%s",zErr);
db_restrict_access(access);
}
if( zErr==0 ){
if( rn>0 ){
db_execute("UPDATE reportfmt SET title='%q', sqlcode='%q',"
" owner='%q', cols='%q' WHERE rn=%d",
zTitle, zSQL, zOwner, zClrKey, rn);
}else{
db_execute("INSERT INTO reportfmt(title,sqlcode,owner,cols) "
"VALUES('%q','%q','%q','%q')",
zTitle, zSQL, zOwner, zClrKey);
z = db_short_query("SELECT max(rn) FROM reportfmt");
rn = atoi(z);
}
cgi_redirect(mprintf("rptview?rn=%d", rn));
return;
}
}else if( rn==0 ){
zTitle = "";
zSQL =
"SELECT\n"
" CASE WHEN status IN ('new','active') THEN '#f2dcdc'\n"
" WHEN status='review' THEN '#e8e8bd'\n"
" WHEN status='fixed' THEN '#cfe8bd'\n"
" WHEN status='tested' THEN '#bde5d6'\n"
" WHEN status='defer' THEN '#cacae5'\n"
" ELSE '#c8c8c8' END AS 'bgcolor',\n"
" tn AS '#',\n"
" type AS 'Type',\n"
" status AS 'Status',\n"
" sdate(origtime) AS 'Created',\n"
" owner AS 'By',\n"
" subsystem AS 'Subsys',\n"
" sdate(changetime) AS 'Changed',\n"
" assignedto AS 'Assigned',\n"
" severity AS 'Svr',\n"
" priority AS 'Pri',\n"
" title AS 'Title'\n"
"FROM ticket\n"
;
zClrKey =
"#ffffff Key:\n"
"#f2dcdc Active\n"
"#e8e8e8 Review\n"
"#cfe8bd Fixed\n"
"#bde5d6 Tested\n"
"#cacae5 Deferred\n"
"#c8c8c8 Closed\n"
;
}else{
char **az = db_query("SELECT title, sqlcode, owner, cols "
"FROM reportfmt WHERE rn=%d",rn);
if( az[0] ){
zTitle = az[0];
zSQL = az[1];
zOwner = az[2];
zClrKey = az[3];
}
if( P("copy") ){
rn = 0;
zTitle = mprintf("Copy Of %s", zTitle);
zOwner = g.zUser;
}
}
if( zOwner==0 ) zOwner = g.zUser;
common_add_action_item("reportlist", "Cancel");
if( rn>0 ){
common_add_action_item( mprintf("rptedit?rn=%d&del1=1",rn), "Delete");
}
common_add_help_item("CvstracReport");
common_header(rn>0 ? "Edit Report Format":"Create New Report Format");
if( zErr ){
cgi_printf("
%h
\n",zErr);
}
cgi_printf("\n",zOwner);
report_format_hints();
common_footer();
return;
}
cgi_printf("\n");
if( rn>0 ){
cgi_printf("\n");
}
cgi_printf("\n");
report_format_hints();
common_footer();
}
/*
** Output a bunch of text that provides information about report
** formats
*/
static void report_format_hints(void){
cgi_printf("
TICKET Schema
\n"
"
\n"
"CREATE TABLE ticket(\n"
" tn integer primary key, -- Unique tracking number for the ticket\n"
" type text, -- code, doc, todo, new, or event\n"
" status text, -- new, review, defer, active, fixed,\n"
" -- tested, or closed\n"
" origtime int, -- Time this ticket was first created\n"
" changetime int, -- Time of most recent change to this ticket\n"
" derivedfrom int, -- This ticket derived from another\n"
" version text, -- Version or build number\n"
" assignedto text, -- Whose job is it to deal with this ticket\n"
" severity int, -- How bad is the problem\n"
" priority text, -- When should the problem be fixed\n"
" subsystem text, -- What subsystem does this ticket refer to\n"
" owner text, -- Who originally wrote this ticket\n"
" title text, -- Title of this bug\n"
" description text, -- Description of the problem\n"
" remarks text -- How the problem was dealt with\n"
");\n"
"
\n"
"
Notes
\n"
"
\n"
"
The SQL must consist of a single SELECT statement
\n"
"\n"
"
If a column of the result set is named \"#\" then that column\n"
"is assumed to hold a ticket number. A hyperlink will be created from\n"
"that column to a detailed view of the ticket.
\n"
"\n"
"
If a column of the result set is named \"bgcolor\" then the content\n"
"of that column determines the background color of the row.
\n"
"\n"
"
Times in the TICKET table are expressed as seconds since 1970.\n"
"Convert these values to human-friendly date formats using the\n"
"sdate() and ldate() SQL functions.
\n"
"\n"
"
The now() SQL function returns the current time and date\n"
"in seconds since 1970. The user() SQL function returns a string\n"
"which is the login of the current user.
\n"
"\n"
"
The first column whose name begins with underscore (\"_\") and all\n"
"subsequent columns are shown on their own rows in the table. This is\n"
"useful for displaying the TICKET.DESCRIPTION and TICKET.REMARKS fields.\n"
"
\n"
"\n"
"
The aux() SQL function takes a parameter name as an argument\n"
"and returns the value that the user enters in the resulting HTML form. A\n"
"second optional parameter provides a default value for the field.
\n"
"\n"
"
The option() SQL function takes a parameter name\n"
"and a quoted SELECT statement as parameters. The query results are\n"
"presented as an HTML dropdown menu and the function returns\n"
"the currently selected value. Results may be a single value column or\n"
"two value,description columns. The first row is the default.
\n"
"\n"
"
The cgi() SQL function takes a parameter name as an argument\n"
"and returns the value of a corresponding CGI query value. If the CGI\n"
"parameter doesn't exist, an optional second argument will be returned\n"
"instead.
\n"
"\n"
"
If a column is wrapped by the wiki() SQL function, it will\n"
"be rendered as wiki formatted content.
\n"
"\n"
"
If a column is wrapped by the tkt() SQL function, it will\n"
"be shown as a ticket number with a link to the appropriate page
\n"
"\n"
"
If a column is wrapped by the chng() SQL function, it will\n"
"be shown as a checkin number with a link to the appropriate page.
\n"
"\n"
"
The path() SQL function can be used to extract complete filename\n"
"from FILE table. For example:\n"
"
SELECT path(isdir, dir, base) AS 'filename' FROM file
\n"
"
\n"
"\n"
"
The dirname() SQL function takes filename as only argument\n"
"and extracts parent directory name from it.
\n"
"\n"
"
The basename() SQL function takes filename as only argument\n"
"and extracts basename from it.
\n"
"\n"
"
The search() SQL function takes a keyword pattern and\n"
"a search text. The function returns an integer score which is\n"
"higher depending on how well the search went.
\n"
"\n"
"
The query can join other tables in the database besides TICKET.\n"
"
\n"
"
\n"
"\n"
"
Examples
\n"
"
In this example, the first column in the result set is named\n"
"\"bgcolor\". The value of this column is not displayed. Instead, it\n"
"selects the background color of each row based on the TICKET.STATUS\n"
"field of the database. The color key at the right shows the various\n"
"color codes.
\n"
"
\n"
"
new or active
\n"
"
review
\n"
"
fixed
\n"
"
tested
\n"
"
defer
\n"
"
closed
\n"
"
\n"
"
\n"
"SELECT\n"
" CASE WHEN status IN ('new','active') THEN '#f2dcdc'\n"
" WHEN status='review' THEN '#e8e8bd'\n"
" WHEN status='fixed' THEN '#cfe8bd'\n"
" WHEN status='tested' THEN '#bde5d6'\n"
" WHEN status='defer' THEN '#cacae5'\n"
" ELSE '#c8c8c8' END as 'bgcolor',\n"
" tn AS '#',\n"
" type AS 'Type',\n"
" status AS 'Status',\n"
" sdate(origtime) AS 'Created',\n"
" owner AS 'By',\n"
" subsystem AS 'Subsys',\n"
" sdate(changetime) AS 'Changed',\n"
" assignedto AS 'Assigned',\n"
" severity AS 'Svr',\n"
" priority AS 'Pri',\n"
" title AS 'Title'\n"
"FROM ticket\n"
"
\n"
"
To base the background color on the TICKET.PRIORITY or\n"
"TICKET.SEVERITY fields, substitute the following code for the\n"
"first column of the query:
\n"
"
\n"
"
1
\n"
"
2
\n"
"
3
\n"
"
4
\n"
"
5
\n"
"
\n"
"
\n"
"SELECT\n"
" CASE priority WHEN 1 THEN '#f2dcdc'\n"
" WHEN 2 THEN '#e8e8bd'\n"
" WHEN 3 THEN '#cfe8bd'\n"
" WHEN 4 THEN '#cacae5'\n"
" ELSE '#c8c8c8' END as 'bgcolor',\n"
"...\n"
"FROM ticket\n"
"
\n");
#if 0
cgi_printf("
You can, of course, substitute different colors if you choose.\n"
"Here is a palette of suggested background colors:
\n"
"
\n"
"
\n"
"
#ffbdbd
\n"
"
#f2dcdc
\n"
"
#ffffbd
\n"
"
#e8e8bd
\n"
"
#c0ebc0
\n"
"
#cfe8bd
\n"
"
#c0c0f4
\n"
"
#d6d6e8
\n"
"
#d0b1ff
\n"
"
#d2c0db
\n"
"
#bbbbbb
\n"
"
#d0d0d0
\n"
"
\n"
"
\n");
#endif
cgi_printf("
To see the TICKET.DESCRIPTION and TICKET.REMARKS fields, include\n"
"them as the last two columns of the result set and given them names\n"
"that begin with an underscore. Like this:
\n"
"
\n"
" SELECT\n"
" tn AS '#',\n"
" type AS 'Type',\n"
" status AS 'Status',\n"
" sdate(origtime) AS 'Created',\n"
" owner AS 'By',\n"
" subsystem AS 'Subsys',\n"
" sdate(changetime) AS 'Changed',\n"
" assignedto AS 'Assigned',\n"
" severity AS 'Svr',\n"
" priority AS 'Pri',\n"
" title AS 'Title',\n"
" description AS '_Description', -- When the column name begins with '_'\n"
" remarks AS '_Remarks' -- the data is shown on a separate row.\n"
" FROM ticket\n"
"
\n"
"\n"
"
Or, to see part of the description on the same row, use the\n"
"wiki() function with some string manipulation. Using the\n"
"tkt() function on the ticket number will also generate a linked\n"
"field, but without the extra edit column:\n"
"
\n"
"
\n"
" SELECT\n"
" tkt(tn) AS '',\n"
" title AS 'Title',\n"
" wiki(substr(description,0,80)) AS 'Description'\n"
" FROM ticket\n"
"
\n"
"\n");
}
/*********************************************************************/
static void output_report_field(const char *zData){
const char *zWkey = wiki_key();
const char *zTkey = tkt_key();
const char *zCkey = chng_key();
if( !strncmp(zData,zWkey,strlen(zWkey)) ){
output_formatted(&zData[strlen(zWkey)],0);
}else if( !strncmp(zData,zTkey,strlen(zTkey)) ){
output_ticket(atoi(&zData[strlen(zTkey)]));
}else if( !strncmp(zData,zCkey,strlen(zCkey)) ){
output_chng(atoi(&zData[strlen(zCkey)]));
}else{
cgi_printf("%h\n",zData);
}
}
/*********************************************************************/
/*
** The callback function for db_query
*/
static int generate_html(
void *pUser, /* Pointer to row-count integer */
int nArg, /* Number of columns in this result row */
char **azArg, /* Text of data in all columns */
char **azName /* Names of the columns */
){
int *pCount = (int*)pUser;
int i;
int tn; /* Ticket number. (value of column named '#') */
int rn; /* Report number */
int ncol; /* Number of columns in the table */
int multirow; /* True if multiple table rows per line of data */
int newrowidx; /* Index of first column that goes on a separate row */
int iBg = -1; /* Index of column that determines background color */
char *zBg = 0; /* Use this background color */
char zPage[30]; /* Text version of the ticket number */
/* Get the report number
*/
rn = atoi(PD("rn","0"));
/* Figure out the number of columns, the column that determines background
** color, and whether or not this row of data is represented by multiple
** rows in the table.
*/
ncol = 0;
multirow = 0;
newrowidx = -1;
for(i=0; i\n"
"
\n",ncol);
return 0;
}
++*pCount;
/* Output the separator above each entry in a table which has multiple lines
** per database entry.
*/
if( newrowidx>=0 ){
cgi_printf("
\n",ncol);
}
/* Output the data for this entry from the database
*/
if( zBg==0 ) zBg = "white";
cgi_printf("
\n");
return 0;
}
/*
** Output the text given in the argument. Convert tabs and newlines into
** spaces.
*/
static void output_no_tabs(const char *z){
while( z && z[0] ){
int i, j;
for(i=0; z[i] && (!isspace(z[i]) || z[i]==' '); i++){}
if( i>0 ){
cgi_printf("%.*s", i, z);
}
for(j=i; isspace(z[j]); j++){}
if( j>i ){
cgi_printf("%*s", j-i, "");
}
z += j;
}
}
/*
** Output a row as a tab-separated line of text.
*/
static int output_tab_separated(
void *pUser, /* Pointer to row-count integer */
int nArg, /* Number of columns in this result row */
char **azArg, /* Text of data in all columns */
char **azName /* Names of the columns */
){
int *pCount = (int*)pUser;
int i;
if( *pCount==0 ){
for(i=0; i\n",zTabArgs);
if( horiz ){
cgi_printf("
\n",
i, zSafeKey, k-j, &zSafeKey[j]);
}else{
cgi_printf("
%.*s
\n",
i, zSafeKey, k-j, &zSafeKey[j]);
}
zSafeKey += k;
}
free(zToFree);
if( horiz ){
cgi_printf("\n");
}
cgi_printf("\n");
}
/*
** Outputs a report, rn.
**
** zTableOpts may be used to control things like table alignment or width. It
** goes in the HTML
tag.
*/
void embed_view(int rn, const char *zCaption, const char *zTableOpts){
int count = 0;
int last_access;
char **az;
char *zSql;
const char *zTitle;
char *zClrKey;
static int nDepth = 0;
/* report fields can be wiki formatted. Let's not get into infinite
** recursions...
*/
if(nDepth) return;
db_add_functions();
view_add_functions();
az = db_query( "SELECT title, sqlcode, cols FROM reportfmt WHERE rn=%d", rn);
if( az[0]==0 ) return;
nDepth++;
zTitle = az[0];
if( zCaption==0 || zCaption[0]==0 ){
zCaption = zTitle;
}
zSql = az[1];
zClrKey = az[3];
db_execute("PRAGMA empty_result_callbacks=ON");
/* output_color_key(zClrKey, 1, "border=0 cellpadding=3 cellspacing=0"); */
cgi_printf("