Difference between revisions of "Scheduled Reports"

From SmartWiki
Jump to: navigation, search
(Configuring Scheduled Reports)
(Redirected page to Scheduled Report Export)
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
==Overview==
+
#REDIRECT [[Scheduled Report Export]][[Category:Reports]]
* [[System Administrator]]s can schedule reports to be run periodically (daily, weekly, monthly).
 
* Scheduled reports can be configured to store custom field values to SmartSimple records, allowing for the periodic aggregation of data.
 
* The following types of SmartSimple records can be updated:
 
:*[[Organization]] records
 
:*[[Contact]] records
 
:*[[UTA]] records, i.e. {{l1}}, {{l2}} and {{l3}} records
 
* Typical use cases might include:
 
:* On a monthly basis, automatically storing the total number of reviews that have been performed by a given user on their contact [[profile]].
 
:* On a weekly basis, automatically updating a user's profile to indicate whether or not timesheets have been filled out in SmartSimple.
 
:* On a daily basis, automatically updating on a company's [[profile]] a summation of the total number of grants for which contacts of that organization has applied.
 
<!--22927 - new scheduled reports-->
 
 
 
==Settings for Scheduled Reports==
 
 
 
''Scheduled Reports'' are built using SmartSimple's [[Reports|integrated reporting subsystem]]. The settings for ''scheduled reports'' are available on the [[Edit Report Page: Advanced Settings Tab|Advanced tab]] of the Edit Reports page.
 
 
 
[[Image:FieldCaching.jpg|link=]]
 
 
 
* '''Frequency''' - The frequency of scheduled reports can be set as follows
 
:* ''Disabled'' - This is the default setting, and indicates that a report will not run on an automated schedule.
 
:* ''Daily'' - The report will run every morning.
 
:* ''Weekly'' - The report will run every Sunday.
 
:* ''Monthly'' - The report will run on the first of every month
 
* '''Identifier Column''' - ''Match Field'' - This setting will draw from the list of columns selected in the [[Report Builder]]. This setting indicates the matching field which allows the system to know which record to update.
 
* '''Custom Field Value Column''' - ''Source Field'' - This setting also draws from the list of columns selected in the [[Report Builder]]. This setting represents the values the system will use to update the ''Custom Field'' specified below.
 
* '''Custom Field''' - ''Destination Field'' - The custom field that will be updated when the report is run.
 
* '''Last Run''' - Indicates when the scheduled report has last automatically run.
 
 
 
==Configuring Scheduled Reports==
 
 
 
To configure a scheduled report, the settings are configured as follows.
 
 
 
Take, as an example, the following [[Report Builder]] configuration:<br />
 
[[Image:ScheduledReportsReportBuilder.png|link=]]
 
* In the above configuration, the ''Name'' field is drawn from {{l1}} and the ''Fund Amount'' and ''Remaining Funds'' fields are drawn from {{l2}}.
 
* The [[Creating_Summary_Reports#Using_Group_By|Group By]] row will sum the amounts from the ''Fund Amount'' and ''Remaining Funds'' fields and show the totals for these fields, broken out by distinct values in the ''Name'' field.
 
* The report will produce results as follows:<br />
 
:[[Image:ScheduledReportsReportResults.png|link=]]
 
 
 
* Say, for example, that you want to configure this report to update, on a daily basis, a field named ''Total Remaining Funds'' on {{l1}} based on the total of the ''Remaining Funds'' fields at {{l2}}.
 
* Take the following steps:
 
:# Edit the report
 
:# Click on the [[Edit Report Page: Advanced Settings Tab|Advanced]] tab.
 
:# Under the "Field Caching" section, set the ''Frequency'' setting to ''Daily''.<br />:[[Image:ScheduledReportsSelectFrequencyColumn.png|link=|350px]]
 
:# Select the ''Name'' column from the ''Identifier Column'' setting.<br />:[[Image:ScheduledReportsSelectIdentColumn.png|link=|350px]]<br />This is the ''Match Field'', and must be a field that contains unique values.
 
:# Select the ''Remaining Funds'' column from the ''Custom Field Value Column'' setting.<br />:[[Image:ScheduledReportsSelectCFVColumn.png|link=|350px]]<br />This is the ''Source Field'', the field from which the values will be drawn to update the ''Destination Field''.
 
:# Select the ''Total Remaining Funds'' custom field from the list of custom fields displayed in the ''Custom Field'' setting.<br />:[[Image:ScheduledReportsSelectCustomField.png|link=]]<br />This is the ''Destination Field'': The field selected in this setting will be updated with the corresponding value from the ''Source Field'' column of the report.
 
 
 
==See Also==
 
* [[Edit Report Page: Advanced Settings Tab]]
 
 
 
[[Category:Reports]]
 

Latest revision as of 11:28, 13 February 2020