back to knowledgebase

How do I create a Report in OpenCRM? Do you have an overview of the Reports module?

Updated: 10 December 2019 16:35:23 OpenCRM::Home OpenCRM::Reports

A Report is a great way of showing important information to you in graphic, detail or summary form. This data can be exported to PDF, Excel or CSV.

This article is going to walk you through:

  1. Navigating the Reports Module
  2. Creating a new Report
  3. Managing your Scheduled Reports
  4. Plus what do to if something doesn't look right

You can show report data on your home page, giving you an overview of the data you wish to see.

Examples of Reports are:

  • A list of Sales Orders created by members of the Sales team on a weekly basis.
  • A list of how many invoices are raised for each Company.
  • How many Helpdesk tickets are raised by each Customer.

This can be a one-off report or a recurring one that is set to occur when you need it – monthly, weekly - you can select and define how often the report needs to be run. You can also select which users you would like to receive these scheduled reports.

You can create reports for one or more modules (for example Contacts and Opportunities) and in addition to the module reports you are able to report on Opportunity Revenue, Opportunity Sales Stage and Audit Trails, enabling you to track and report on record changes in OpenCRM

The Reports Module

When you first navigate to the Reports module, you will see that it looks different from the other modules in the system, but the general idea is the same:

  1. Search - you have a place you can search for the records you've created
  2. Action Buttons - you have the actions you can do in this module
  3. Content - you have the this case with all your Reports in their correct Folders

Searching for Reports

To search for a Report, simply type as much of the name or description as you remember and click Search (or hit enter).

If you want to make sure that you are only searching for automated or scheduled Reports, simply click the little clock icon to the right of the keyword search bar:

This way you can easily find all the Reports that have automated schedules and easily see what the recurrence of that schedule is WITHOUT having to actual edit the Report.

Creating a new Report Folder

You are able to create as many folders as you need to organise your Reports.

To create a new Folder, simply click the "Create new Report Folder" button and type in the title and description of your folder.

Once you have created the folder, it will appear on screen...but until you save any Reports to it, it will show the following message.

To learn how to create a new Report (so you can add it to your new Folder), just keep reading.

Creating a Report

Before you get started: 

  • Ensure you are starting in the correct module – if you start in the wrong module, for example you are in Contacts module and want to create the Report relating to Personnel, you will need to start from scratch again.
  • Decide which module in OpenCRM is likely to be home to the bulk of the data. E.g. if you want to see a report showing Invoices, by company raised, the logical step would be to create an Invoice Report, since the Invoice will hold the Company name.  However if you also wanted to see, in the same Report the contact information for that company, for example, or any company specific information which is not stored on the Invoice itself, you will need to select 'Companies' as your Related Module.
  • Conversely, If you require a lot of Company data and only the name or the date of that companies' most recent Invoice then your primary module should be the 'Companies' module and the related module would be set to Invoices.
  • You also need to consider how much data you wish to feature in the report. This is where you need to filter data. A report showing ALL leads is likely be too big to be of any use, a  report showing new leads from the last seven days is probably more useful.

Let’s Create a Report to show Quotes by Company.

Go to the Reports Module and select New Report, and then select the Modules that you want in the Report, in this case Companies and Quotes and click on Continue.


 You are now on the screen where you can set the parameters for your report:

Step 1: Report Type

You will need to select the type of Report you would like to run. A Tabular report will show you a grid of all your data. A Summary report will show you this same grid and then, at the bottom, show the sums, counts, etc. of particular groups of fields. (For example, you may wish to group this example report by User, to see who is generating the most Quotes). 

In this example, we'll create a summary Report.

Step 2: Columns

We now need to select which columns we want to show on the report. Make sure you include any columns you need to filter on or sort by.

The menu on the left allows you to select the fields from the Companies and Quotes modules. In order to show Companies that actually have Quotes linked instead all Companies we now need to apply a filter to remove records where the Quote field is empty. This is done by specifying the criteria, the filters work the same way as when creating Custom Views - please refer to this FAQ.

Step 3: Grouping

This will only appear if you have selected to create a summary Report.

Here you can select how you wish to group you data. For example you may wish to see all the Quotes grouped by the Company and their assigned user. 

If you are planning to show any totals or counts, make sure you tick the "Display group totals" boxes.

Step 4: Totals

This is where you will select which number fields you would like to see totaled by the groups you selected in the previous step. For this example, let's assume we want to see the total amount for all the Quotes, as well as their average.

Step 5: Filters

This is where you will filter down your data to make sure you only see the records you most need to view.

As you can see in the screenshot below, we have set a further filter to only show Company Quotes from the last month that have not been cancelled.

We can also sort the view according to any of the fields we have entered – User, Company or Quote Stage.

You can filter using the pre-set financial periods. You can also set up your own financial periods by following the steps in this FAQ.

When you're in the standard filter section you will have some additional options when you select "custom" you will be able to select "Selected Dates", "Next", "Last", "More Than" and "Less That" you will then get the choice of unit of time so 1, 2, 3 etc then you will have option between Days, Weeks, Months and Years. So for example you can select to list in a Report all Companies created in the last 3 days:

Step 6: Scheduling

You will now see series of options, that will allow you to specify the frequency of the schedule and who should receive the report, sent by email. You have a time field which allows you to specify the time that you wish the report to be created.  

Important: Be sure to set either a Number of Recurrences or an End By Date before you hit Save.

Within this container is a user multi-select pop up and contact selector, similar to that found on Emails. Click on either of the icons to select who you wish to send the report to.

Once a Contact has been added to this box when the report is ran on a schedule it will send the generated PDF to the specified contacts.

For more information on our tips on the best ways to manage your scheduled reports, please scroll down to the bottom of this article for some tips.

Step 7: Graphing

Important: You can only set a graph on a summary Report. 

The X (horizontal) axis will by the fields you set as the Groups. the Y (vertical) axis will either be the columns you totaled or (if you prefer) you can use a count of the records by setting 'Number of Records' under 'Graph Values.

Step 8: Home Page

If you would like the graph, Report grid, summary, or a combination of those results on your or any other users' home page, you will need to set this here.

Step 9: Security

Last step! 🙂 And it's a big one.

If you do not make any changes to this section, your Report will be assigned to the person who created and the security will be set using the Default Organisation Access you have set up.

Should you wish to restrict access to this (or any other) Report, you can do so by

1. Selecting the User to whom the report is assigned, this will by default be the User creating the report, when creating the report you have the ability to reassign.

2. From the next drop-down menu you can select the report security level:

3. You can use the final two menus items to select and restrict access to the report at both Group and User level.

Step 10: Results

By clicking "Save and Run" you will be able to set the name of your Report and choose a folder for it.

We do suggest giving it a sensible name and description so you (or anyone else) can find it later.

You now have the finished report, which can be exported to PDF, Excel or CSV file.

Managing your Scheduled Reports

We've got some tips and best practice guidelines for managing your scheduled reports.

Setting the Default PDF and Email Template for scheduled Reports

In the same way that many automated emails can be modified you can amend the Default Email template that is used when OpenCRM generates a Scheduled Report.

To make changes to this template follow these 2 steps;

Step 1: Create or Edit the desired Email Template

  • Settings (Top Right - this will only appear if you are a System  Administrator - if you cannot see the Settings option please contact your Administrator for assistance)
  • Communication Templates > Email Templates
  • Browse to the Template you wish to use OR create the new Template
  • Generally vanilla systems will have a Template setup which is stored within the Default Templates folder - called 'Scheduled Reports'
  • Once created / amended find the ID Number of this template
  • This can be done when viewing the email template and looking at the number that is shown in the URL address bar at the end after 'templateid=xxx

  • This ID Number should be entered during phase two of this process

Step 2: Tell OpenCRM which Email Template to use

  • Settings (Top Right - this will only appear if you are a System Administrator - if you cannot see the Settings option please contact your Administrator for assistance)
  • Configuration > Additional Settings
  • Scroll down to the section headed - Email Settings
  • Locate the Default Scheduled Report Template option - the box to the right shows the ID Number of the template to be used

  • Insert or change this value to correspond to the Email Template you wish to use - see above
  • Select SAVE

When creating a template, be aware that the subject will be replaced by the name of the report that is being sent plus the date is is sent on.

Best Practice for saving your scheduled Reports

The report you create may be one that you wish to run manually as well as having it delivered by email. Our suggestion is that you create a normal report and save this into an appropriate folder group - so an Invoice report that shows figures for a set period would be created and saved into the Invoice Reports group.

Once you are happy with the report you should create a new Report Folder - label it very obviously for automated reports, something like "Automated Reports" or "Scheduled Reports", then duplicate the report you created earlier and set up the schedule options, the period that you would like to receive the report and which people (users and contacts) you wish to receive a copy. Then save this duplicate into the automated reports folder you created earlier.

By having a duplicate saved under your automated reports folder will keep the normal report separate so that if you run this mid month and need to change the parameters of the report you will not accidentally change the data that is sent automatically, you will then always have a consistent report delivered at your pre-defined scheduled time and also a version that you can run manually and tinker with without fear of messing up the automated version.


If you are finding a blank column on your report, you need to check the parameters of your search. If for example you select a view to show all Quotes created for Companies, you need to filter the results so as not to show blank records. Please refer to this FAQ for details on how to filter view search results.

Rate This Article
  • 1 star
  • 2 star
  • 3 star
  • 4 star
  • 5 star
Feedback and Comments
captcha code  

You may also be interested in: