Using SQL Reports WebGUI User s Conference

Transcription

1 Using SQL Reports 2004 WebGUI User s Conference

2 Huh? SQL Reports are used to: Build alternate interfaces to WebGUI Wobjects Display internal WebGUI data Display data from your business applications

3 Why? Creating new wobjects is more difficult than just writing some SQL You already have the data you need, and just need to output it

4 Why not? Complex outputs should be handled by macros If you also need data entry / management then use a wobject

5 SQL Report Basics Database Link SQL query Template

6 Database Links A place to manage database connections (data sources) Uses Perl standard DSNs

7 Data Sources Anything with a DBI Driver MySQL, Oracle, Postgres, SyBase, MSSQL, Firebird, Informix, CSV, BerkleyDB, ODBC Really, just about anything useful.

8 DSN DBD:<dbtype>:<dbname>:;options DBD:mysql:WebGUI;host=localhost

9 Basic SQL Query SELECT fields FROM tables WHERE limiting claues SELECT userid, username FROM users where username like a%

10 Template <ul> <tmpl_loop rows_loop> <li> <tmpl_var row.field.username.value> (<tmpl_var row.field.userid.value>) </li> </tmpl_loop> </ul>

11 Bring it Together SELECT userid, username FROM users where username like a% <ul> <tmpl_loop rows_loop> <li> <tmpl_var row.field.username.va (<tmpl_var row.field.userid.value </li> </tmpl_loop> </ul>

12 Bring it Together SELECT userid, username FROM users where username like a% <ul> <tmpl_loop rows_loop> <li> <tmpl_var row.field.username.va (<tmpl_var row.field.userid.value </li> </tmpl_loop> </ul>

13 Bring it Together SELECT userid, username FROM users where username like a% <ul> <tmpl_loop rows_loop> <li> <tmpl_var row.field.username.va (<tmpl_var row.field.userid.value </li> </tmpl_loop> </ul>

14 Layout In Your Hands Tables Lists CSS layout Whatever

15 What have we learned? Database link manages connection SQL Query retrieves the data Template displays the data

16 Gotcha: SQL Functions SELECT username, from_unixtime(datecreated) FROM users where username like a%

17 Gotcha: SQL Functions Problem Field name = Template Variable Solution Use an SQL alias in the Query from_unixtime(datecreated) as date_created

18 Example: Search Engine Problem Got data Can t code Need to search Solution SQL Report!

19 The Trick ^FormParam(); Accepts a value from a form Place it into your query Turn on Preprocess macros on query

20 The Template Add a query form to your template: <form method= post > <input type= text name= query value= ^FormParam( query ); > <input type= submit value= search > </form>

21 The Output california Search

22 The Query SELECT city, county, zipcode FROM mapinfo WHERE state like %^FormParam( query );%

23 The Resulting Query SELECT city, county, zipcode FROM mapinfo WHERE state like %california%

24 The Output california Search Beverly Hills Orange Silverado Broward Blue Hill Lake 91236

25 Example: Drill Down Problem Got lots of data Can t display it all at once Solution SQL Report!

26 The Trick Multiple SQL Reports Chain them together with ^FormParam(); The data from the first seeds the next

27 The Data artist id name album id name artist_id song id name album_id

28 The Template Add a link to your template: <a href= ^\;albums?artistid=<tmpl_var row.field.artist_id.value> ><tmpl_var row.field.name.value></a>

29 The Query SELECT id, name FROM artist

30 The Output Prince Metallica Hank Williams Eminem George Clinton and the P-Funk

31 The Template Add a link to your template: <a href= ^\;songs?albumid=<tmpl_var row.field.album_id.value> ><tmpl_var row.field.name.value></a>

32 The Query SELECT id,name FROM album WHERE artist_id = ^FormParam( artistid );

33 The Resulting Query SELECT id,name FROM album WHERE artist_id = 335

34 The Output And Justice For All Master of Puppets The Black Album Load Reload Garage, Inc.

35 The Query SELECT id,name FROM song WHERE album_id = ^FormParam( albumid );

36 The Resulting Query SELECT id,name FROM song WHERE album_id = 3913

37 The Output Enter Sandman The Unforgiven Harvester of Sorrow Sad But True Of Wolf and Man Nothing Else Matters

38 The Drill Down Report Prince Metallica Hank Williams Eminem George Clinton and the P-Funk And Justice For All Master of Puppets The Black Album Load Reload Garage, Inc. Enter Sandman The Unforgiven Harvester of Sorrow Sad But True Of Wolf and Man Nothing Else Matters

39 6.3 and beyond Sub-queries (6.3) Not the same as sub-selects Up three additional queries Each sub-query allows the use of data from all of the previous queries

40 6.3 and beyond Exports (6.4+) Download query result as XML Tab CSV

41 6.3 and beyond Graphing (7.0+) Pie charts Line graphs Bar graphs 7% 8% 10% 11% 29% 35%

42 Questions?