Difference between revisions of "Prompting for Criteria in Reports"

From SmartWiki
Jump to: navigation, search
(→‎See Also)
Line 55: Line 55:
  
 
11. '''Close''' the current report.
 
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.
 +
 +
[[Image:ReportsPromptingForDate.png|link=]]
 +
[[Image:ReportsPromptingForDatePrompt.png|link=]]
 +
[[Image:ReportsPromptingForTwoDates.png|link=]]
 +
[[Image:ReportsPromptingForTwoDatesPrompt.png|link=]]
 +
[[Image:ReportsPromptingForTwoDatesUsingArg1.png|link=]]
 +
 +
{{MultipleCriteriaVariableSyntax}}
 +
  
 
==See Also==
 
==See Also==

Revision as of 14:32, 8 December 2014

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.

Reps37.png

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.

ReportBuilderHelp-SSCriteriaValues.PNG

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:

Reps39.png

6. Click the Buildquery.PNG button.

7. Click the SaveButton.PNG button.

8. Click the PreviewButton.PNG button.

The Criteria Prompt window is displayed.

Reps40.png

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.

ReportsPromptingForDate.png ReportsPromptingForDatePrompt.png ReportsPromptingForTwoDates.png ReportsPromptingForTwoDatesPrompt.png ReportsPromptingForTwoDatesUsingArg1.png

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
  • @argn.id@ 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
Retrieved from ‘https://wiki.smartsimple.com/index.php?title=Prompting_for_Criteria_in_Reports&oldid=23731’