Prompting for Criteria in Reports

From SmartWiki
Jump to: navigation, search

caption Click here to watch a video on SmartSimple's integrated reporting subsystem.

You can prompt the person that runs the report for the criteria, by replacing the criteria string with three question marks - ???.

1. Make a new copy of the current report named – Prompt for Title.


2. Click the Edit button.

3. Click the Report Builder tab.

4. Open the Report Builder Help Panel and click on the Special SmartSimple Criteria Values tab.


There are four special functions displayed.

Function Purpose
??? Prompts the user for an input value. You can combine this string with any other selection operator. You can use ??? multiple times in the same report.
@userid@ Uses the current userid as the criteria. This is useful when you need to create a generic report that displays all the records for the user running the report.
@companyid@ Uses the current user's companyid as the criteria. This is useful when you need to create a generic report that displays all the records for the user running the report.
@objectid@ When using ReportProperty, the object ID (opportunityid, eventid, userid, etc., depending on the entity being reported upon) will be passed to the report processor.
  • To allow the user to enter multiple values to be matched against the same field enter REGEXP ??? in the Criteria of the report builder.
  • When prompted a list of values to be filtered on can be entered, delimited by pipes. I.E: This|That|The Other

5. Replace the current criteria with the criteria shown below:


6. Click the Buildquery.PNG button.

7. Click the SaveButton.PNG button.

8. Click the PreviewButton.PNG button.

The Criteria Prompt window is displayed.


9. Type President.

10. Click the View Report button.

Only records matching the entered criteria are displayed.

11. Close the current report.

Using the Same Criteria Multiple Times

You might want to build a report that uses the same criteria multiple times. For example, a report can prompt the user to enter a date value:

When the report is run, the user will be prompted to select a date value:
But if the report should display all grants where the date specified is the Start Date OR the Approval Date, the report would be configured as follows:
This would result in two prompts unnecessarily being displayed to the user:
The solution is to use the @arg1@ syntax. Entering =@arg1@ as the second criteria will mean that the system will re-use the user-entered criteria for two comparisons:

For reports containing multiple criteria, the variable syntax for the different criteria elements is argn where n is the order of the criteria defined in the Report Builder.

  • @argn.label@ returns the text label of the input
  • @argn@ returns the input field for the criteria
  • returns the element ID of the input

See Also

Previous.png Specifying Multiple Criteria in Reports Prompting for a Criteria using a Wildcard Next.png