AdHoc Grids
AdHoc Grids allow for the creation of data Grids based on a User-Defined SQL query; any AdHoc Grid can be used to generate reports. Knowledge of the SQL language is Required.
For information on how to access a User-Defined Field in an AdHoc Query, please see our article on UDFs.
Creating an AdHoc Grid
When writing your own AdHoc Grid can be a difficult process for an inexperienced User. PCR-360 provides useful tools in both the AdHoc Grid's Query Builder and the Data Dictionary.
Navigate to Admin > Reports > AdHoc Grids.
Click the
button.
Enter the desired SQL Statement
Click the
button to run the Query, to confirm the desired output is provided.
Click the
button, on the Saved Queries tab to save the query for use later.
Click the
button to open the Add New Grid form, which will also move the previously run Query so it is not needed to be re-entered.
Provide a Name, Description, as well as any desired Role Permissions and any other customizations to the look of the new Grid.
Click the Save button to save the Grid.
The following functions are not allowed for use: INSERT, UPDATE, DELETE, DROP, ALTER, CREATE, TRUNCATE, EMPTY, and SELECT INTO.
When writing AdHoc grids do not use spaces and other characters in the SQL column Aliases. Using characters other than UPPER-CASE and UNDERSCORE characters, the AdHoc Grid will break and cause any filters to not work.
Import/Export AdHoc Grids
PCR-360 contains functionality to Import/Export AdHoc Grids from one environment to another. This is particularly useful for building a new AdHoc Grid on a Test Environment and then not needing to rebuild it from scratch on a Production Environment.
A User can click the button the AdHoc Grids Grid, to upload a JSON File containing an AdHoc Grid definition.
A User can click on an AdHoc Grid displayed on the AdHoc Grids Grid and then click the button to save a JSON File containing an AdHoc Grid definition to their local machine.
AdHoc Parameters
AdHoc Grids have a “Parameters” tab on the Manage Grid Form. From this Tab, a User can Parameters that can be used on the AdHoc Grid.
These Parameter Details are similar to the Types of UDF Fields a User can add to Forms.
The new Parameters can be used within the BIND and/or REPLACE fields on the “Query” tab. Using the parameters in the query allows for quick adjustment of the data within the Results.
On the AdHoc Grid, Users can /
to show the values to adjust what is being used on the Grid, or to hide them for convenience.
On CustomerCenter, users are shown any AdHoc Grid Parameters by default, and they can not be hidden like they can within the backend application.
AdHoc Grid Library
For the convenience of our customers, this Library contains pre-built AdHoc Grids that anyone may copy and add to their PCR-360 application. If you require an AdHoc query not provided by this Library, please contact your Account Manager to request Professional Services; your Account Manager will provide you with a quote to create an AdHoc tailored to your needs.
Using the Library
To load the provided queries into your Organization's instance of PCR-360, simply enter the desired query as your SQL Statement when creating an AdHoc
RECID vs. ROW ID
Library of AdHoc Queries
Cable Locations Report Query
Service Desk Cabling Query
Inventory Reorder Details Report
Duplicate MAC Address Locator Query