oqapi/webgui
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Added new Database Link tool, updated SQL Report to use database links

Browse source
This commit is contained in:
Andy Grundman 2003-06-21 02:02:34 +00:00
parent e814dd106c
commit 2fda426415
7 changed files with 331 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

45
docs/upgrades/upgrade_5.3.3-5.4.0.sql
View file

@ -3,4 +3,49 @@ insert into international (internationalId,languageId,namespace,message,lastUpda
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (980,1,'WebGUI','Empty this folder.',1055908341);
alter table HttpProxy add column rewriteUrls int;
update HttpProxy set rewriteUrls = 1;
CREATE TABLE databaseLink (
databaseLinkId int(11) NOT NULL default '0',
title varchar(255) default NULL,
DSN varchar(255) default NULL,
username varchar(255) default NULL,
identifier varchar(255) default NULL,
PRIMARY KEY (databaseLinkId)
) TYPE=MyISAM;
insert into databaseLinks values (1,'WebGUI','DBI:mysql:WebGUI','webgui','password');
insert into incrementer values ('databaseLinkId',1000);
alter table SQLReport add databaseLinkId int(11);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (12,1,'HttpProxy','Rewrite urls ?',1055908341);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (981,1,'WebGUI','Manage database links.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (982,1,'WebGUI','Add a database link.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (983,1,'WebGUI','Edit this database link.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (984,1,'WebGUI','Copy this database link.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (985,1,'WebGUI','Delete this database link.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (986,1,'WebGUI','Back to database links.',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (987,1,'WebGUI','Delete Database Link',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (988,1,'WebGUI','Are you certain you wish to delete this database link? The following items are using this link and will no longer work if you delete it:',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (989,1,'WebGUI','on page',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (990,1,'WebGUI','Edit Database Link',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (991,1,'WebGUI','Database Link ID',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (992,1,'WebGUI','Title',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (993,1,'WebGUI','DSN',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (994,1,'WebGUI','Database User',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (995,1,'WebGUI','Database Password',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (996,1,'WebGUI','Manage Database Links',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (997,1,'WebGUI','Database Links, Manage',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (998,1,'WebGUI','Database Link, Add/Edit',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (999,1,'WebGUI','Database Link, Delete',1056151382);
insert into international (internationalId, namespace, languageId, message, lastUpdated) values (1000, 'WebGUI', 1, '<p>\r\nDatabase Links enable a WebGUI administrator to add commonly used databases for use in SQL Reports. This frees the SQL Report author from having to know or enter a DSN, user, or password.<br>\r\n<br>\r\nBe aware that any database links you create here will be available to all content authors. While they will not be able to see the database connection info, they will be able to execute any select, show, or describe commands on the database.\r\n<p>', 1056151382);
insert into international (internationalId, namespace, languageId, message, lastUpdated) values (1001, 'WebGUI', 1, '<p>\r\nThe following fields make up a Database Link.\r\n<p>\r\n\r\n<b>Title</b><br>\r\nA title for the database link.\r\n<p>\r\n\r\n<b>DSN</b><br>\r\n<b>D</b>ata <b>S</b>ource <b>N</b>ame is the unique identifier that Perl uses to describe the location of your database. It takes the format of DBI:[driver]:[database name]:[host].<br>\r\n<p>\r\n\r\n\r\n<i>Example:</i> DBI:mysql:WebGUI:localhost\r\n<p>\r\n\r\nHere are some examples for other databases.<br>\r\n<a href="http://search.cpan.org/author/TIMB/DBD-Oracle-1.14/Oracle.pm#CONNECTING_TO_ORACLE">Oracle</a>:\r\n<ul>DBI:Oracle:SID<br>\r\nDBD::Oracle must be installed.<br>\r\nYou must be using mod_perl and configure <b>PerlSetEnv ORACLE_HOME /home/oracle/product/8.1.7</b> in httpd.conf. Without setting ORACLE_HOME, you can connect using DBI:Oracle:host=myhost.com;sid=SID\r\n</ul>\r\n\r\n<a href="http://search.cpan.org/author/OYAMA/DBD-PgPP-0.04/PgPP.pm#THE_DBI_CLASS">PostgreSQL</a>:\r\n<ul>DBI:PgPP:dbname=DBNAME[;host=hOST]<br>\r\nDBD::PgPP must be installed.\r\n</ul>\r\n\r\n\r\n<a href="http://search.cpan.org/author/MEWP/DBD-Sybase-1.00/Sybase.pm#Specifying_other_connection_specific_parameters">Sybase</a>:\r\n<ul>DBI:Sybase:[server=SERVERNAME][database=DATABASE]<br>\r\nDBD::Sybase must be installed.<br>\r\nYou must be using mod_perl and configure <b>PerlSetEnv SYBASE /opt/sybase/11.0.2</b> in httpd.conf.\r\n</ul>\r\n\r\n<p>\r\n<b>Database User</b><br>\r\nThe username you use to connect to the DSN.\r\n<p>\r\n\r\n\r\n<b>Database Password</b><br>\r\nThe password you use to connect to the DSN.\r\n<p>\r\n', 1056151382);
insert into international (internationalId, namespace, languageId, message, lastUpdated) values (1002, 'WebGUI', 1, '<p>\r\nWhen you delete a database link, all SQL Reports using that link will stop working. A list of all affected reports is shown on the confirmation screen.\r\n<p>\r\n\r\n\r\nAs with any delete operation, you are prompted to be sure you wish to proceed with the delete. If you answer yes, the delete will proceed and there is no recovery possible. If you answer no you\'ll be returned to the prior screen.\r\n<p>\r\n', 1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (19,1,'SQLReport','Choose a database link...',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (20,1,'SQLReport','Database Link',1056151382);
insert into international (internationalId,languageId,namespace,message,lastUpdated) values (21,1,'SQLReport','If you do not want to use a predefined database link, enter your own database connection info below.',1056151382);
delete from international where languageId=1 and namespace='SQLReport' and internationalId=71;
insert into international (internationalId, namespace, languageId, message, lastUpdated) VALUES ('71', 'SQLReport', '1', 'SQL Reports are perhaps the most powerful wobject in the WebGUI arsenal. They allow a user to query data from any database that they have access to. This is great for getting sales figures from your Accounting database or even summarizing all the message boards on your web site.\r\n<p>\r\n\r\n\r\n<b>Preprocess macros on query?</b><br>\r\nIf you\'re using WebGUI macros in your query you\'ll want to check this box.\r\n<p>\r\n\r\n\r\n<b>Debug?</b><br>\r\nIf you want to display debugging and error messages on the page, check this box.\r\n<p>\r\n\r\n\r\n<b>Query</b><br>\r\nThis is a standard SQL query. If you are unfamiliar with SQL, <a href="http://www.plainblack.com/">Plain Black Software</a> provides training courses in SQL and database management. You can make your queries more dynamic by using the ^FormParam(); macro.\r\n<p>\r\n\r\n\r\n<b>Report Template</b><br>\r\nLayout a template of how this report should look. Usually you\'ll use HTML tables to generate a report. An example is included below. If you leave this field blank a template will be generated based on your result set.\r\n<p>\r\n\r\n\r\nThere are special macro characters used in generating SQL Reports. They are ^-;, ^0;, ^1;, ^2;, ^3;, etc. These macros will be processed regardless of whether you checked the process macros box above. The ^- macro represents split points in the document where the report will begin and end looping. The numeric macros represent the data fields that will be returned from your query. There is an additional macro, ^rownum; that counts the rows of the query starting at 1 for use where the lines of the output need to be numbered.\r\n<p>\r\n\r\n<b>Database Link</b><br>\r\nThe administrator can configure common databases on which you can run SQL Reports, freeing you from having to know or enter the DSN, Username, and Password. If a database is selected from this list, the DSN, User, and Password fields will be ignored.<br>\r\n<br>\r\nIf the database you need to use is not configured as a Database Link, you can enter the DSN, User, and Password.\r\n<p>\r\n\r\n<b>DSN</b><br>\r\n<b>D</b>ata <b>S</b>ource <b>N</b>ame is the unique identifier that Perl uses to describe the location of your database. It takes the format of DBI:[driver]:[database name]:[host]. \r\n<p>\r\n\r\n\r\n<i>Example:</i> DBI:mysql:WebGUI:localhost\r\n<p>\r\n\r\n\r\n<b>Database User</b>\r\nThe username you use to connect to the DSN.\r\n<p>\r\n\r\n\r\n<b>Database Password</b>\r\nThe password you use to connect to the DSN.\r\n<p>\r\n\r\n\r\n<b>Paginate After</b>\r\nHow many rows should be displayed before splitting the results into separate pages? In other words, how many rows should be displayed per page?\r\n<p>\r\n\r\n\r\n<b>Convert carriage returns?</b>\r\nDo you wish to convert the carriage returns in the resultant data to HTML breaks (&lt;br&gt;).\r\n<p>\r\n\r\n', 1056151382);
insert into help (helpId, namespace, titleId, bodyId, seeAlso) VALUES ('68', 'WebGUI', '997', '1000', '69,WebGUI;70,WebGUI;1,SQLReport;');
insert into help (helpId, namespace, titleId, bodyId, seeAlso) VALUES ('69', 'WebGUI', '998', '1001', '68,WebGUI;70,WebGUI;1,SQLReport;');
insert into help (helpId, namespace, titleId, bodyId, seeAlso) VALUES ('70', 'WebGUI', '999', '1002', '68,WebGUI;69,WebGUI;1,SQLReport;');