Difference between revisions of "Prompting for Criteria in Reports"
(→Using the Same Criteria Multiple Times) |
|||
| (10 intermediate revisions by the same user not shown) | |||
| Line 9: | Line 9: | ||
2. Click the '''Edit''' button. | 2. Click the '''Edit''' button. | ||
| − | 3. Click the '''Report Builder''' tab. | + | 3. Click the '''[[Report Builder]]''' tab. |
| − | 4. | + | 4. Open the Report Builder Help Panel and click on the '''[[Report Builder Column Settings|Special SmartSimple Criteria Values]]''' tab. |
| − | [[Image: | + | [[Image:ReportBuilderHelp-SSCriteriaValues.PNG|link=]] |
| − | There are | + | There are four special functions displayed. |
:{| border="1" cellpadding="5" | :{| border="1" cellpadding="5" | ||
| Line 26: | Line 26: | ||
|+ | |+ | ||
|@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. | |@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 [[Report Variables|ReportProperty]], the object ID (opportunityid, eventid, userid, etc., depending on the [[entity]] being reported upon) will be passed to the report processor. | ||
|} | |} | ||
| Line 53: | 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=]]<br /> | ||
| + | When the report is run, the user will be prompted to select a date value:<br /> | ||
| + | [[Image:ReportsPromptingForDatePrompt.png|link=]]<br /> | ||
| + | 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:<br /> | ||
| + | [[Image:ReportsPromptingForTwoDates.png|link=]]<br /> | ||
| + | This would result in two prompts unnecessarily being displayed to the user:<br /> | ||
| + | [[Image:ReportsPromptingForTwoDatesPrompt.png|link=]]<br /> | ||
| + | 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:<br /> | ||
| + | [[Image:ReportsPromptingForTwoDatesUsingArg1.png|link=]] | ||
| + | |||
| + | {{MultipleCriteriaVariableSyntax}} | ||
==See Also== | ==See Also== | ||
* [[Passing Prompt Criteria to a Sub-Report]] | * [[Passing Prompt Criteria to a Sub-Report]] | ||
| + | * [[Criteria Template]] | ||
{{PrevNextStart}} [[Specifying Multiple Criteria in Reports]] | {{PrevNextStart}} [[Specifying Multiple Criteria in Reports]] | ||
| − | {{PrevNextMid}} [[Prompting for a Criteria using a Wildcard]] | + | {{PrevNextMid}} [[Prompting for a Criteria using a Wildcard]] {{PrevNextEnd}} |
| − | {{PrevNextEnd}} | ||
| − | [[Category:Reports]] | + | [[Category:Reports]][[Category:Criteria]] |
Latest revision as of 13:35, 8 December 2014
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 
button.
7. Click the 
button.
8. Click the 
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
- @argn.id@ returns the element ID of the input
See Also
