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.

  1. Navigate to Admin > Reports > AdHoc Grids.

  2. Click the image-20240819-152050.png  button.

  3. Enter the desired SQL Statement 


  4. Click the image-20240819-152527.png button to run the Query, to confirm the desired output is provided.

  5. Click the image-20240819-152506.png button, on the Saved Queries tab to save the query for use later.

  6. Click the image-20250401-143739.png 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.

  7. Provide a Name, Description, as well as any desired Role Permissions and any other customizations to the look of the new Grid.

  8. Click the Save button to save the Grid.

image-20250401-144856.png

 

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 image-20250401-144000.png 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 image-20250401-144032.png 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 image-20250401-145518.png Parameters that can be used on the AdHoc Grid.

image-20250401-145445.png

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 image-20250401-145801.png / image-20250401-145849.png 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





Related Pages

Related content