Report Scheduler

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
User Manuals > Report Scheduler

Introduction

Available in Version 8 of CommitCRM is the new Report Scheduler add-on module which you can use to prepare your Reports in advance and have them sent to you at the defined intervals. This module will save you a lot of time and effort as you no longer have to spend your valuable time manually configuring reports every time you need one and overall will improve the efficiency of your business by ensuring you have all the Reports you depend on, ready for you to use and always to hand at the appropriate time.

Setting up the Report Scheduler Module

The Report Scheduler module is a standalone module that runs as part of the CommitCRM Server Windows Service on your server, and so the CommitCRM Server service must be installed. Only then you can start the service in order to use the Report Scheduler.

If you already use the Email Connector or Alerts Server then you can skip this section as the CommitCRM Server service is already installed and there is nothing more you need to do besides scheduling your Reports.

Install Service

  1. Log in to to your Server with a Windows Administrator account.

  2. Open a command prompt window: Right-click the command prompt icon and and choose 'Run As Administrator'.

  3. Type the following command:

    <Installation_DIR>\CommitCRM\Server\CommitServer.exe -install

  4. Note: The <Installation_Dir> must refer to a LOCAL server path (e.g. c:\ or D:\Software, etc.) and NOT to a shared network name/path.

  5. Wait for a success message to appear, indicating the service was installed successfully.

  6. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.

  7. Verify that a Windows service called CommitServer is now displayed in the services list.

  8. If the service is not there, make sure again that you are running the command prompt Window using 'Run as Administrator' and try again.

Running CommitCRM Server Service

  1. Once the CommitCRM Server Service is installed, setup the CommitCRM Report Scheduler as explained in Activating the Report Scheduler.

  2. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.

  3. Locate the CommitCRM Server service and start the service (right-click > Start).

  4. Make sure that it is set to start automatically with a 'Delayed Start' (Startup type > Automatic Delayed Start) each time the server is restarted.

Activating the Report Scheduler

  1. Log into the Server with a Windows Administrator user. Note that the setup program must run from the same server as the one where the CommitCRM installation sits and from where you plan to run the Email Connector.

  2. Run <Installation_DIR>\CommitCRM\Server\ServerConfig.exe.

  3. Note: there are two executable files under the server folder, make sure you are running the configuration program (ServerConfig.exe).

  4. In the window that opens, click the Report Scheduler tab.

In this tab, you should define the Report Scheduler Settings as follows:

  • System State – The state can be one of the following: On or Off.

  • On (default) - You should use the On setting when you wish to activate the Report Scheduler mechanism. The system state is ON by default.

  • Off - This mode should be used when you do not want the system to prepare or send Scheduled Reports at all. This also means when you reactivate the CommitCRM Report Scheduler, no Reports will be waiting to be sent.

  • Sender Name - Here you define the Email Sender Name that will be used when sending the Reports. You can define an Alias to be used which will reflect the source of this email (such as "CommitCRM Report"). The Email address is taken from the Public Email Address tab.


Important Notes:

  1. Reports will start to be sent only after each user defines their own Scheduled Report settings, see below.

  1. Changes to settings may take some time to take effect in the CommitCRM Server. In order for it to take effect immediately, you should restart the CommitCRM Server Service.

  2. If you have not done so previously, you will also need to set your Public Email Address and setup your Outgoing Mail Server - both are done through the relevant tabs in the ServerConfig.


Uninstall Service

Should you ever need to uninstall the CommitCRM Server service, follow these steps:

  1. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.

  2. Stop the CommitCRM Server service.

  3. Open a command prompt window: Right-click the command prompt icon and and choose 'Run As Administrator'.

  4. Type the following command: 
<Installation_DIR>\Server\CommitServer.exe -uninstall


Scheduling a Report

To schedule a Report and have it mailed to you automatically, do the following:

  1. Go to the Reports window and select the Report you want to schedule from the list.

  2. Click the Schedule button in the menu bar or go to Reports > Schedule This Report.

  3. In the Scheduling Settings popup which then opens, select the Main filtering criteria, for example “Open Tickets” or “Completed Tickets with no Charges”.

  4. Select additional filtering option, if relevant for the specific type of Report, such as the Account Manager.

  5. Select the Date - depending on the type of Report, this field name can vary and besides just Date it could be called Creation Date, Open Date Time, Purchase Date or something similar. For the Date you can select date ranges for the Report such as Today, Yesterday, Last 7 days or many more. So if you want to get a Report sent showing all new Accounts created yesterday you can easily do that now.

  6. Now click Next to go to the recurring settings for the Scheduled Report - in other words here you specify how often and at what exact time of day you want the Report generated and sent to you. You can for example have the Report for yesterday sent to you daily at 9 am. The recurring settings Options menu changes dynamically depending on whether you choose Daily, Weekly or some other Type.

  7. Click Next again and now select the email address/es to send to and specify the name of the Report which will appear in the email subject. An email address must have been previously defined for the Account before you can schedule a Report.

  8. Click Finish and it is done.

Managing Scheduled Reports

You can manage your existing Scheduled Reports and edit or delete any of them as required.

  1. Click the Scheduled Reports button on the menu bar or go to Reports > Scheduled Reports.

  2. Select the Report you want to manage from the drop down list displayed.

  3. On the Scheduling Settings popup which appears you can select either:
    • Edit Settings to edit the scheduling for that Report, which returns you to the Scheduling Settings window described above in Scheduling a Report.
    • Delete to remove it completely.

Troubleshooting

I setup a Scheduled Report but nothing arrived.

Solution: You should check the following options:

  1. When creating a new Scheduled Report (or editing one) it can take up to 15 minutes before it is updated in the service that runs the server, unless the CommitCRM Server service is restarted to apply the updates immediately.

  2. Reports are not sent immediately but only on the defined schedule so perhaps the time for sending did not yet arrive.

  3. Make sure that the Report Scheduler System State is set to ON in the ServerConfig.

  4. Make sure the Email address (as defined in the Employee Account on the General or Address tab) which you selected for sending Reports to is valid.

  5. Make sure the CommitCRM Server service is running on your machine.


* This new feature comes as an optional standalone add-on module.
Retrieved from "https://www.rangermsp.com/w/index.php?title=Report_Scheduler&oldid=6937"