Single Report Schedule: General
The General Tab decides the most basic properties of the schedule itself. How the schedule is organized, the report (s) it runs, and its purpose are determined here. Once the require fields are filled, click next to proceed to the next section.
Create In: Select the folder where you wish the schedule to be stored. These are MARS specific folders.
Schedule Name: Name the schedule
Database Path: Browse and select the database where the report is located.
Report Location: Browse through the report server browser to select the desired report. Authenticate to the reports server if necessary.
DB Password: Enter the password to the selected database if necessary.
WorkGroup Security: If your Access database uses Workgroup Security, then check this option and enter the required credentials.
Security File Path: Browse and select the security file (.mdw) which is used by Access to control security for this database. If you don't know what this is, or where it is stored, your System or Database administrator will be able to point you to the right file.
Important If you are using Workgroup Security:
You must join the workgroup that defines the user accounts used to access the database.
Your user account must have Open/Run and Open Exclusive permissions for the database object.
Your user account must have Administrator permissions for all the tables, queries, macros, tables and any other objects in the database, or it must be the owner of all tables in the database.
Your user account must have Administrator permissions for all objects in the database.
Report or Query: Select Report or Query to tell MARS which you wish to schedule.
Connect: Click to connect to the database.
Report Name: Select the report or query you wish to schedule from the dropdown list (only available after successful connection to the database)
Open Arguments: If there are some special arguments you would like MARS to run when it opens the MS Access database you should enter them here.
Continue To Single Report Schedule - Schedule
Single Report Schedule: Schedule
In this section, you will decide when the report will execute. There are a variety of options:
Daily: Run a report every day or at a frequency of days.
Repeat every X Days- EX. Run the schedule every 3 days.
Weekly: Run a report on a weekly time frame.
Repeat every X weeks- EX. Run the schedule every 2 Weeks.
On- Select the specific days of the week the schedule will run. If only once a week, select only the day of the week it will run. EX. Run every Monday, Wednesday, and Friday.
Weekdays: Run the schedule Monday through Friday.
Working Day: Run the schedule starting on a specific day of the month. Indicate which day of the month the schedule will run. E.G. run the schedule on the 4th working day of the month.
Monthly: Run the schedule on a monthly time frame.
Use the following options- Checking this box will enable you to select frequency options such as the “last Thursday of the month.” Also you can include or exclude specific months from the schedule.
Annually: run the schedule every year at a specified time.
Custom Calendar: Select the custom Calendar you wish to use. You can create a new custom calendar from the menu as well. Please see Custom Calendars for a tutorial.
Other: Other scheduling options.
Run Schedule every X Minutes, hours, days, weeks, months, years
None: No scheduling is required for this item.
Next, you will specify the time that the schedule will run as well as repetition options.
Schedule time: Specify the exact time you want your schedule to run. *Tip: keeping in mind how long it takes for your report, time your schedules accordingly!
Exception Calendar: choose a calendar that will instruct the schedule to NOT run on those specified days. Please see Custom Calendars for a tutorial.
Next to run on: displays the next run date of your schedule.
Repeat ever X hours or minutes: run your reports on a reoccurring basis during a specific time frame. EX Repeat every .25 hours until 5PM.
Enable this schedule: to enable the schedule leave the box checked. To create this schedule disabled, deselect this box.
Once you have finished creating the timing for your schedule, click finish to proceed to the next stage.
Continue To Single Report Schedule - Report
Report Schedule: Destinations
In this section, you will decide where your schedule will be delivered. In a Package Schedule, all reports enclosed in the package will be delivered to the same destination(s).
The list in the center will display the list of destinations you have added to the schedule. You can organize the various destinations’ order by clicking on the green up and down arrows.
By clicking Edit, you can edit any destinations you have created.
The delete button will remove that destination from your schedule.
Import allows you to add default destinations. Please see Options section for more details on default destinations.
To add destinations click on the “Add” button. Alternatively, click the small down arrow to immediately select a destination.
If you clicked the small arrow, skip this paragraph and proceed to the next. If not, a new window will appear. In the “Type” Field, select your destination from the drop down list.
These are the destinations currently supported by MARS:
Disk- Send a report to folder on the machine or any UNC path.
Email- Email a report via MAPI, SMTP, GroupWise, or MARSMail.
Fax- Send a report via Fax Machine. (Requires a V92 Fax Modem)
FTP- Send a report via FTP or SFTP
ODBC- Output reports to a database
Printer- Send your report to a connected or networked printer.
SharePoint- Upload the report to a SharePoint directory.
SMS- Send the report as a text message.
*Please see Destinations for details.
Select the Destination that you wish to use. A window will appear that will allow you to set up the destination. Also an Inserts window will appear separately.
In this scenario, we wish to email the report to the recipient. Select email as the destination.
Setting up an Email Destination:
Enter the email address of the recipient. If there is more than one, simply place a semi colon followed by the next recipient’s email.
Add a subject to the email, and attach any additional file you desire.
In the body, you can write a customized message to your recipients. Using inserts you can add dates and user constants.
By default the report comes attached. For details on the email destination please see destinations.
Setting the Report Format:
Each destination has a format tab in its mini wizard. To select a format for your report, go to the format tab.
From the dropdown list you can select a format for your report. MARS has a wide variety of formats to choose from. For details on all formats available in MARS please see the Formats section.
In this Scenario, Jamie needs the report in PDF format. Select Adobe “Acrobat Format (*.pdf)” from the dropdown list.
If are finished with your destination’s settings, click OK to return to the wizard.
Click OK and you will be returned to the destinations screen where your destination (email in this case) will be listed. You can continue to add destinations by clicking on the add button and repeating the steps above.
Once you have created all of your destinations, click next.
Continue To Single Report Schedule - Exception Handling
Single Report Schedule: Report
In this section, you will determine the parameters for your report (if any). If your report has no parameters, you may skip this section by clicking next.
There are 3 requirements in order for MARS to detect your MS Access Report parameters and their parameter values:
1) The parameter must be in use in the report
2) The parameter must be visible
3) The parameter must be set to be prompted at runtime
If these three requirements are achieved, you should see the parameters in your report listed in this screen.
Select from the dropdown list the upper and lower value for the parameter.
Include Value upper/lower: Include the selected parameter value in the range.
No lower/upper bound: include all values above the upper value, include all values below the lower value.
*Tip: to enable a report parameter to run for a date constant (Current Date, Yesterday etc.), select MARS Constants from the inserts window, then drag and drop your
desired constant to the parameter field.
Preview: view the report output given the selected parameters.
Advanced: Shows you the report's record selection formula and allows you to edit it:
To modify the record selection formula, simply type your modification into the formula space. Once this formula is changed, MARS will always use this formula for this schedule. It will ignore the original report's formula.
The changes are stored in MARS. The report in your database is not changed, so it can be reused for other schedules or for its previous general use.
Continue To Single Report Schedule - Report Options
Single Schedule Report: Report Options
In this section you will authenticate to the database the report runs against, set snapshots, and other options.
Login required for linked tables (optional): If the database requires logon credentials, check this option and enter the required username and password. If credentials are not required, uncheck the option and continue as normal (default). All values are optional. You only need to enter a value if your database, security, networking or infrastructure require it. Logins for individual tables can be set as well.
Report Metadata and Keyword (Optional): This information is used to help you organize your schedules and to help future users of MARS understand what each schedule does and why its there. The information is also used to set up and update SmartFolders.
Resume failed/errored schedules with cached data: If the schedule fails, resume the schedule from where it left off. You can then select how long should the cached data should be kept.
Save Snapshots: Save a Picture of the report as it is produced. Choose the amount of time will be stored in the system before deletion. View Snapshots for more info.
Continue To Single Report Schedule - Destinations
Use a Copy: An Access databases will become unstable if multiple users are connected at the same time as an automation tool is interacting with it. To prevent this we recommend that MARS works exclusively on a copy of the database when it needs to run a report or query. Check this option to enable MARS to use a copy of the source database.
When the option is selected a copy of the database will be taken and stored in the same folder as the source database. You can change the location of the copy to a location with more disk space. If your database is stored on a network, you will benefit from better performance if the copy is stored locally on the MARS PC.
When MARS has finished running your report it will delete the database copy. It will be able to do this once MS Access has released the file (the ldb disappears). This can take a while, sometimes up to a few hours, so be patient.
If you prefer not to use a copy of your database (e.g. because it is too big) then you should not check this option. However you must ensure that no other users or processes are logged into the database at the schedule time. In addition, we recommend that you backup up your database before the schedule time so that you can revert to your original in case of corruption.
Front-End/Back-End: This is a special type of database which has been split using the facility in MS Access and is Identified by MS Access as FE/BE. For more information about splitting your database please see your MS Access user manual. Select this option if you are using a split database.
Note: When splitting your database MS Access stores the path to the BE in the FE. During the slitting process ensure you select a UNC path to the BE otherwise it will only be visible to MARS if MARS is installed on the PC where the splitting was done.
If your backend database is an ODBC database, select this option, the Database DSN, and your user credentials.
If your backend database is an Access file, select this option, then browse to the desired backend database file.
Single Report Schedule: Exception Handling
In this section, you will set error handling for your report, as well as options for blank reports.
Treat as “error” if not completed in X minutes: if a report takes longer than the specified amount of time to run, this option will treat the schedule as an error and follow the appropriate action. The “Auto-calculate” option instructs MARS automatically determine how long a schedule should take to run the report. If it takes longer than the calculated amount of time, then it is an error.
*Note: if manually determining the error timing, please double check the runtime of the report in order to get the correct time estimate.
On error, retry executing schedule every X minutes up to Y times: If an error has occurred with the schedule, you can set the interval and number of times you wish the schedule to attempt a retry. By default MARS will make 3 attempts.
MARS and Blank Reports:
MARS has the ability determine if a report is blank. Meaning that if a report genuinely has no data behind it, then MARS can do a number of things with the report and the schedule.
Check if a report is blank: With this option you can check if a report is blank.
Ignore the report: if the report is blank, do not send the report. The report will not be delivered to the destination.
Method Tab: Select the Method that will determine whether a report is blank.
Native: MARS will check to see if the report returns any data. If not, the report is considered blank.
SQL Query: Select this option to use a user made query that will determine if the report is blank. If the query returns no results, the report is blank.
File Size Check: If the file fails to be a certain file size then the report will be considered blank.
Actions Tab: Select an action from the task list. This task will be executed in the event that a schedule is blank.
*Tip: You can send a notification if a report is considered blank instead of sending the report. Simply select “check if a report is blank” then select “Ignore the report.” In the actions tab, select “Send Email” from the list. Compose your email and save.
Continue To Single Report Schedule - Custom Tasks
Single Report Schedule: Custom Tasks
In the section you have the option of setting up custom tasks. Custom tasks are business process automation tools that can be auto triggered before or after a report runs. For more details on Custom Tasks, please seeAutomation Schedules for a full description of each task.
If you have no desire to add a Custom Task, you can click the finish button to complete the schedule.
Single Report Schedule Context Menu
Right-Click on a schedule to see the following actions.
Copy: Use this to copy an existing schedule. You can then paste it into another folder or the same folder. Simply open the folder you wish to paste to, right-click in the "white" space and select "Paste". Follow the on-screen instructions to complete the process.
Paste: Paste a previously copied schedule
Rename: Rename a schedule
Enabled: Schedules are Enabled when there is a check beside this option. To stop a schedule from running, or to "pause" it for a while, select this option to remove the check. Disabled schedules will not run till they are enabled again.
Refresh: When a schedule is first created, MARS caches (saves) a copy of the report. All executions of the scheduled are performed using this copy. If you make changes to your master report, you must select this option in order to pull the changes into MARS.
Preview Report: Click this option to preview your report.
Execute Schedule: This will execute the schedule immediately. Note that the next run date and time is not moved on as a result of a manual execution. They only move on if the schedule is run automatically by one of the schedulers.
Delete Schedule: Selecting this option will delete the schedule.
Properties: Selecting this option will bring up the "Properties" module containing configuration information for that schedule. For more information on Properties, click here.
Test Schedule: Use this option to test the schedule and export it to selected "test" destinations.
Convert to Package: Select this option to convert a Single Report Schedule to a Packaged Reports Schedule. Please note that you can select multiple single schedules to convert into a single Packaged Report Schedule. You are given the option to select which single schedule will be used as a template for the Packaged Report Schedule. Please note that the single schedules are deleted once the Packaged Report Schedule is created. For more information on Packaged Reports Schedules, click here.
Ad-Hoc Email to Recipients: Select this option to send an ad-hoc email to all recipients of this schedule. You can use this to alert recipients to a planned system outage, or any other useful information. For more information on this feature, click here.
Create Shortcut: Use this option to create a shortcut you can save in any location on your PC. Execute the shortcut to execute the schedule in MARS.
Adhoc View: This enables you to execute the report without using any of the parameter values and other settings in the schedule.
Single Report Schedule - Properties
To access your schedule properties, right click on a schedule and select properties.
Similar to the schedule wizard, you adjust settings to your schedule such as timing, error handling, or custom tasks.
For more information on each of the menu items, select the relevant link below:
History: Review the schedules history. Successes, failures, and other data is located here.