Chapter 2. Release Notes

2.1. What's new in 0.9?

2.1.1. Breaking change: JNDI Data Source configuration

JNDI data source configuration is now exclusively configured within pullreports.properties. Although this change allows more flexible, per-report data source configuration, it means these breaking changes:

  • The <catalog> jndiDataSource attribute is no longer supported.

  • This release contains a new pullreports-catalog-1.1.0.xsd schema file with the jndiDataSource attribute removed.

  • The pullreports.properties default.jndiDataSource property is renamed to jndiDataSource.

See Per-<catalog> and per-<report> property configuration for more information.

2.1.2. Ad hoc creator usability improvements

The ad hoc report creator Available Tables component received several usability improvements in the 0.9 release.

2.1.2.1. Column names now visible in table closed state

The first several <column> display names are now visible on the table component when the table is in its closed state. This helps users quickly review the columns without having to open the table.

2.1.2.2. Multiple tables open at once

More than one table component can now be opened a time. This helps users review many tables at once.

Additionally, the Available Tables component title bar contains buttons to open and close all tables with just one click.

2.1.2.3. Swatches indicate tables within export

Each table included within the export results is represented by a swatch button on the Available Tables component title bar. Clicking the swatch toggles the table's open/closed state and focuses the table within the Available Tables component. The new swatches provide a quick visual of which tables are in the current export and an easy way to navigate to an included table.

2.1.2.4. Non-exportable icon in table information tab

<column>s set to export='false' are now denoted with a special icon within the table's Info tab in addition to the text Not included in export results. Only for filtering.

2.1.3. Ability to decorate Export Report REST API output with Servlet includes

Decorate the HTML output of the html and map Export Report REST API formats via Servlet includes. This feature permits easy customization of the outputs with HTML, JavaScript, and CSS and provides an alternative decoration technology to SiteMesh.

2.1.4. Improved filter output for html, htmltable, and map output formats.

This release improves the readability of filters applied to the Export Report REST API results in the html, htmltable, and map formats. The filter format now following this pattern:

Table: <em>[table.displayName]</em>, Column: <em>[column.displayName]</em> <samp>[operator]</samp> [value(s)]

2.1.5. Row offset, limit, and total count added to html, htmltable, and map output formats.

The html and htmltable Export Report REST API formats now display the offset, limit, and total row count values within the table <caption>.

Additionally, the map format now displays the distinct feature count and raw data row offset, limit, and count values above the map.

2.1.6. Logging improvements

Logging may now be isolated to a specific <catalog>s or <report>s.

2.1.7. Per-<catalog> and per-<report> property configuration

Most properties within pullreports.properties may now be configured per-<catalog> or per-<report> by (.) appending the <catalog> id and, optionally, <report> id to the property name. Properties values specified at a lower scope (e.g. <report>) override the same property specified at a higher scope (e.g. <catalog> or global).

Properties whose values may now be customized per-<catalog> and per-<report> are:

  • jndiDataSource

  • export.report.maxResults

  • export.report.postgresql.queryCostMaximum

2.1.8. Documentation improvements

The GET Label Value List REST endpoints are now documented.

2.1.9. REST-API dependency upgrades

The following Java dependencies are upgraded.

  • org.codehaus.groovy:groovy-all to 2.4.8

  • org.slf4j:slf4j-api to 1.7.22

2.1.10. Creator dependency upgrades

The following ad hoc report creator JavaScript dependencies are upgraded.

  • Angular Bootstrap upgraded to 2.5

2.2. What's new in 0.8?

In addition to closing over 17 defects and minor enhancements, release 0.8 contains these functional enhancements.

2.2.1. Support for Grails 3

Pull Reports™ now supports Grails 3 deployment. See the installation guide for more information.

2.2.2. Full Screen Mode

The ad hoc report creator now has full screen mode to better utilize all available screen space. This is especially useful when working with large <table> graphs in the Available Tables component.

2.2.3. Searchable filter value lists

The ad hoc report creator now supports type-ahead search when choosing filter values for <column>s of paramType java.lang.String. This features makes finding values in a long <label_value_list>s much easier.

2.2.4. Leaflet Mapper customization

The Export Report REST API map format now supports customization of the Leaflet Mapper. Add Leaflet layers and controls via the mapConfig global JavaScript variable.

2.2.5. HttpServletRequest available within <url_template>s

The <url_template> element within Pull Reports™ XML Catalog files now supports a reference to the HttpServletRequest associated with the Export Report REST API request. This permits the use of HTTP header and parameter values when creating drill through URLs.

2.2.6. Configurable query cost limits for PostgreSQL

The new export.report.postgresql.queryCostMaximum configuration property sets a query cost maximum on each PostgreSQL database query formulated by the Export Report REST API. The property allows an administrator to prevent resource utilization overruns caused by relational cross join products or other excessive export requests.

2.2.7. Creator dependency upgrades

The following ad hoc report creator JavaScript dependencies are upgraded.

  • Angular Bootstrap upgraded to 2.1

  • RequireJS upgraded to 2.3