Changes between Version 3 and Version 4 of TracReports

Timestamp:

Nov 7, 2017, 8:42:35 PM (8 years ago)

Author:

trac

Comment:

--

TracReports

@@ -30 +30 @@
 
 == Changing Report Numbering ==
-There may be instances where you need to change the ID of the report, perhaps to organize the reports better. At present this requires changes to the trac database. The ''report'' table has the following schema ''(since 0.10)'':
+There may be instances where you need to change the ID of the report, perhaps to organize the reports better. At present this requires changes to the trac database. The ''report'' table has the following schema:
  * id integer PRIMARY KEY
  * author text
@@ -47 +47 @@
 Clicking on one of the report results will take you to that ticket. You can navigate through the results by clicking the ''Next Ticket'' or ''Previous Ticket'' links just below the main menu bar, or click the ''Back to Report'' link to return to the report page.
 
-You can safely edit any of the tickets and continue to navigate through the results using the ''!Next/Previous/Back to Report'' links after saving your results, but when you return to the report, there will be no hint about what has changed, as would happen if you were navigating a list of tickets obtained from a query (see TracQuery#NavigatingTickets). ''(since 0.11)''
+You can safely edit any of the tickets and continue to navigate through the results using the ''!Next/Previous/Back to Report'' links after saving your results, but when you return to the report, there will be no hint about what has changed, as would happen if you were navigating a list of tickets obtained from a query (see TracQuery#NavigatingTickets).
 
 == Alternative Download Formats ==
@@ -109 +109 @@
 }}}
 
+Dynamic variables can also be used in the report title and description (since 1.1.1).
 
 == Advanced Reports: Dynamic Variables ==
@@ -136 +137 @@
 }}}
 
-Dynamic variables can also be used in the report title and description (since 1.1.1).
 
 === !Special/Constant Variables ===
@@ -164 +164 @@
  * '''id''' — same as '''ticket''' above when '''realm''' is not set
  * '''realm''' — together with '''id''', can be used to create links to other resources than tickets (e.g. a realm of ''wiki'' and an ''id'' to a page name will create a link to that wiki page)
+   - for some kind of resources, it may be necessary to specify their ''parent'' resources (e.g. for ''changeset'', which ''repos'') and this can be achieved using the '''parent_realm''' and '''parent_id''' columns
  * '''created, modified, date, time''' — Format cell as a date and/or time.
  * '''description''' — Ticket description field, parsed through the wiki engine.
@@ -245 +246 @@
 === Reporting on custom fields ===
 
-If you have added custom fields to your tickets (a feature since v0.8, see TracTicketsCustomFields), you can write a SQL query to cover them. You'll need to make a join on the ticket_custom table, but this isn't especially easy.
+If you have added custom fields to your tickets (see TracTicketsCustomFields), you can write a SQL query to cover them. You'll need to make a join on the ticket_custom table, but this isn't especially easy.
 
 If you have tickets in the database ''before'' you declare the extra fields in trac.ini, there will be no associated data in the ticket_custom table. To get around this, use SQL's "LEFT OUTER JOIN" clauses. See [trac:TracIniReportCustomFieldSample TracIniReportCustomFieldSample] for some examples.