What are SQL Reports?

Transcription

1 Using SQL Reports

2 What are SQL Reports? SQL Reports are used to: Build alternate interfaces to WebGUI Assets Display Internal WebGUI data Display data from your business applications

3 Why use SQL Reports? Creating new assets is more difficult than writing some SQL The data already exists and you just need to output it

4 When Not to use SQL Complex outputs Use Macros If you need data entry / management use an asset

5 What s involved Database Link SQL query Template

6 Database Link A place to manage database connections Uses Perl Standard DSNs

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

8 Data Source Name (DSN) DBD:<dbtype>:<dbname>:;options DBD:mysql:WebGUI;host=localhost

9 Basic SQL Query SELECT fieldname FROM tablename WHERE limiting clause 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 Together SELECT userid, username FROM users WHERE username like a% <ul> <tmpl_loop rows_loop> <li> <tmpl_var row.field.username.value> (<tmpl_var row.field.userid.value>) </li> </tmpl_loop> </ul>

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

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

14 Layout In the Palm of your Hands Tables Lists CSS Layout Whatever

15 Review Database link manages connection SQL Query retrieves the data Template displays the data

16 Example: Search Problem Have data Can t code Need to search Solution SQL Report

17 The Trick Placeholder Parameters Accepts a value from a form, integer, query results, or string Defined in Placeholder field? in the query

18 The data divname divid teamname teamid divid playername teamid playerposition

19 The Template Add a query form to your template <form method= post > <input type= text name= divname > <input type= submit value= search > </form>

20 The Output

21 The Query SELECT divname,divid FROM divisions WHERE divname =?

22 The Resulting Query SELECT divname,divid FROM divisions WHERE divname = NFC North

23 The Output

24 Drill Down Problem Lots of data Can t display it all at once Solution SQL Report

25 The Trick Multiple SQL Reports Chain them together with Placeholder Parameters Data from the first seeds the next

26 The Template Add a link to your template: <a href= /teams?divid=<tmpl_var row.field.divid.value> ><tmpl_var row.field.divname.value></a>

27 SELECT divname,divid FROM divisions The Query

28 The Output An unordered list of Divisions set up as links The link determines what the placeholder parameter uses: in this case the parameter is divid

29 The Template Add a link to your template: <a href= /players?teamid=<tmpl_var row.field.teamid.value> ><tmpl_var row.field.teamname.value></a>

30 SELECT name, id FROM team WHERE divid=? The Query

31 The Resulting Query SELECT name, id FROM team WHERE " divid= 1

32 Since we selected a divsion an unordered list of teams is now available The Output By clicking on a team we again choose the value the placeholder parameter uses: in this case teamid

33 The Query SELECT playername, playerposition FROM players WHERE teamid=?

34 The Resulting Query SELECT name, position FROM player WHERE " teamid= 4

35 The Output

36 The Drill Down Report NFC North NFC South NFC East NFC West Detroit Chicago Minnesota Green Bay Brett Favre Quarterback Ahman Green Running Back Donald Drive Wide Receiver Robert Ferguson Wide Receiver

37 Hierachical Reports Works on the same basic principle as the drill down Displays all the information in one page One query feeds the next

38 Query 1: SELECT divid, divname FROM division Query 2: Query Placeholder Parameter query1:divid SELECT teamid, teamname FROM teams WHERE divid=? Query 3: Placeholder Parameter query2:teamid SELECT playername, playerposition FROM players WHERE teamid=?

39 The Output

40 Tips Make sure you are using the correct database if it s not the WebGUI database Always use the default SQL template when first doing a query

41 Questions?