1. 9.0 Reports & Settings
  1. 9.1 The Reports Module
  1. Figure 258 shows the 1CRM screen with the Reports Module selected:
  1. reports.png
  1. Figure 258: The Reports Module
  1. This module is one of the most important within 1CRM – without it you must develop your understanding of the current state of your business using just the list views in each module, and the charts on the dashboard. For a smaller organization this is almost workable, but as businesses get larger and the data becomes more complex, reporting is mandatory, not a nice-to-have feature.
  1. The list view of the reports module shows a list of available reports. You may click on the name of a report to run that report, or to see the archived results of previous runs of that report. Each report listed shows its name, the principal module on which it reports, when it was last run, when it was last modified, and if it is set to run manually, interactively or automatically.
  1. A number of predefined standard reports are included with the system, and new report designs may be easily developed and saved for repeated use in future, by clicking on the Create-Button.png button.
  1. 9.1.1 Running Standard Reports
  1. To run a standard report, you need to select it from the reports list view. This shows you the report detail view (see Figure 259), from which you can then run the report by clicking on the Run-Report-Button.png button. You can also click on the Edit-Report-Button.png button, to view the report edit view, which shows the report name, the primary module from which its data is drawn, and the run method and interval - and allows you to edit the report definition. As well, you can use the show sql button.png button to display a popup box with the SQL query language to be used by that report.
  1. Note: In the Claro and Flex themes, the Edit-Report-Button.png button and the show sql button.png button are no longer buttons, but are options on a settings dropdown control settings dropdown.png .
  1. When you run the report, the results are displayed on the Report Run Details screen, as shown in Figure 260 (unless it is an Interactive type report). When you wish to exit this screen, just click on the Return-to-Report-Button.png button, to go back to the report detail view. The data from this run of the report will be archived, and added to the Archived Runs sub-panel on the detail view display. You can also exit the screen by clicking on the Delete-Run-Button.png button, in which case you will still return to the report detail view, but now without the current report data added as a new archived run.
  1. In the report run details screen, you may page forward and backwards through the detail lines of the latest run of the report. (Remember you can temporarily change the page length if you like!) The Print option on the Actions-Button.png button is used to generate a landscape-mode Acrobat PDF print-image file of the report. The results may also be exported to a CSV file for further analysis in Excel, using the Export option on the Actions-Button.png button. Depending on the specific report, items in the report may also be hyperlinked, enabling you to click on them to view the item’s detail view.
  1. Archived runs of a report may be viewed at any time by clicking on the hyper-linked run number. Each archived run carries a run date and time, a name, description and assigned user, and may be deleted if desired by clicking on the Remove-Icon.png icon.
  1. report runs.png
  1. Figure 259: The Report Detail View
  1. Note: Archived runs of a report can sometimes build up, to the point where you have dozens, or even hundreds of report runs archived. Usually the extreme cases of this happen for Scheduled Reports, where the 1CRM system itself runs the reports automatically on a regular basis. To control this accumulation, 1CRM scheduled reports let you set a value Max. Number of Runs to Keep. Your system administrator controls a scheduler task that periodically checks all scheduled reports, and removes the oldest report runs in excess of the maximum number to be kept. You can also remove them using the Delete Action on the Archived Runs sub-panel of any report.
  1. report content.png
  1. Figure 260: Report Run Details
  1. 9.1.2 Creating New Reports
  1. There are two ways to define a new report: either click on the Create-Button.png button on Reports list view and choose a module from a popup menu; or go to the list view of the module you want to report on, click on the Reports layout tab (see Figure 260 for example), and then click on the layout tab labelled ✚. Either approach gets you into the Report Editor editing a new report, based on the desired module (see Figure 261). Choose a name for the report, and enter a Description.
  1. Next, choose the Run Method and (for Scheduled Reports only) the Next Run date and time and Run Interval.
  1. If the report will only be run manually as required, then set the Run Method to Manual.
  1. Set the Run Method to Interactive if you wish the report to be run like a manual report, but with the ability to set report filter values interactively as the report is generated.
  1. If you wish the report to be run automatically at regular intervals, then set it to Scheduled, set the Next Run date to the first time you’d like it to be run, and the Run Interval to the number of Days, Weeks, Months, Quarters or Years desired between runs. Also set the Max. Number of Runs to Keep as desired.
  1. Note: Scheduled reports will not be run unless the Scheduler is setup properly by the Administrator.
  1. The Primary Module on which the report is to be based will be pre-set, but you can optionally choose one or more Related Sources, such as Contacts and Meetings as shown related to the Accounts module in Figure 261. Once you have done that, you can proceed to the other Report Editor tabs.
  1. edit report.png
  1. Figure 261: Editing a New Report - General Tab
  1. 9.1.3 Setting Report Filters
  1. Clicking on the Filters tab will reveal a screen much like that in Figure 262. Note that in this Figure we have checked Non-Zero Balance Only - so that the report only shows us Accounts that owe us money. And we have defined a Filter Group (by clicking on the Add-Filter-Group-Button.png button), and set it to group the filters together using Any Of logic, and then added the Country field to it twice using the Select-Filter-Button.png button, looking for Canada in one instance of the filter, and USA in the other.
  1. This will have the effect of only listing Accounts in Canada or the USA, that also owe us money.
  1. The Filter Group logic options are:
  1. All Of: All the conditions indented under the Group must be true
  1. Any Of: Some of the conditions indented under the Group must be true
  1. None Of: None of the conditions indented under the Group may be true
  1. Not All Of: Not all of the conditions indented under the Group may be true (so if some or none of them are true, that’s fine)
  1. Note: Use the Up-Down-Icon.png control to drag a filter left and right, to indent it under a filter group, or un-indent it from one.
  1. Note: The Hide checkmark is used only for Interactive reports. It allows you to define a filter for an Interactive report, but not to expose that filter to the user during the interactive session as they adjust filter values.
  1. report filters.png
  1. Figure 262: Editing a New Report - Filters Tab
  1. 9.1.4 Defining your Report’s Column Layout
  1. Next, click on the Column Layout tab. As in the Figure below, you should see a list of field names, with each entry also showing the field type, a width allowance for the field, and a few other values. The order of these fields from top to bottom represents what you will see on the screen, and in any PDF you generate, from left to right. Some key points on operating this tab are:
  1. Any field with the Hide checkmark set will be used in the creation of the report, but will not be shown on screen or in the PDF.
  1. To remove any field, just click on the Remove-Icon.png icon to the far right.
  1. To make any field wider on screen and on the PDF, increase the Width value (Max. 50).
  1. You can space out your columns by adding empty columns as fields, with the Add-Empty-Column-Button.png button.
  1. Add Totals to your PDF (not shown on screen) with the Select-Total-Button.png button.
  1. To reorder fields, use the Up-Down-Icon.png control to drag fields up and down.
  1. You can add new fields with the Select-Field-Button.png button. Clicking on it will present you with a long scrolling list of fields, also showing the field types.
  1. Click on the Gear-Icon.png icon to the right of any field, and select the dropdown Make Grouped option to convert this to a Grouped Field.
  1. report columns.png
  1. Figure 263: Editing a New Report - Column Layout Tab
  1. Additionally, note that:
  1. If you click on the underlined name of any field, you will be prompted to enter a new name, which will be used on the screen and for the PDF. You can also reset the name to its default.
  1. If you select a date, date/time or currency field, you will also need to select the preferred format for that field in the Format column, using a Format dropdown control.
  1. Date fields may be formatted to show just the Month, Quarter, Year, Year & Month, Fiscal Quarter, or Fiscal Year. Date & Time fields offer the additional options of Date only or Time only. Fields like this may be added to the field list more than once, in multiple data formats. So – a date could be added as the Fiscal Quarter it belongs to – so it can be used to group data by fiscal quarter – but also as the original date value so it can be displayed.
  1. A currency field may be formatted as Standard, Rounded (no decimal places), In Thousands ($425,500.07 is shown as $426K), or In Millions ($425,500.07 is shown as $0.4M).
  1. The Column Layout tab displays three types of columns (fields), with a sub-heading for each:
  1. Grouped Columns – These fields are used to group data in the report. One could group accounts by the account type, as above, or contacts by category, or invoices by the month in which they are due. Grouped columns will organise the screen report by the specified field, and will produce a PDF with sub-heading titles for each new value for the grouped field
  1. Display Columns – These fields will be visible in the on-screen report data, as well as in the PDF version of the report, and they are also included in any exported data. The exception to this is fields marked Hide.
  1. Column Totals – Totals are added by clicking on the Select-Total-Button.png button to the bottom right. Clicking on it will present you with a long scrolling list of fields, also showing the field types. Entries show the field and mathematical function desired (such as Balance: Sum – which would let you sum the balances of all accounts). Select the combination of field and mathematical function (Count, Min, Max, Sum, Avg, StdDev) you want, to generate functions on this field for all records in the report.

    These calculated values are shown at the end of any PDFs generated. Not all field types offer Totals – they are available as follows:
    1. No Totals: Text, Multi-Line Text, True or False, Dropdown, Phone Number, Email Address, Related Value, and User Name fields.
    1. Count: Name fields.
    1. Min, Max: Date, Date & Time fields.
    1. Sum, Avg, Min, Max: Currency fields.
    1. Sum, Avg, Min, Max, StdDev: Integer, Number, Real Number fields.
  1. 9.1.5 Report Sorting
  1. As you may see in the Figure below, reports may easily be sorted by selecting a field on which to sort, and then choosing Ascending or Descending sort order. If you define multiple sort fields, the first will be the primary sort field, the next the secondary, and so on.
  1. To reorder sort fields, use the Up-Down-Icon.png control to drag fields up and down.
  1. To remove a sort field, just click on the Remove-Icon.png icon to the far right.
  1. report sort order.png
  1. Figure 264: Editing a New Report - Sorting Tab
  1. 9.1.6 Defining your Report’s Chart Layout
  1. Charts may be created from any report, providing that the report has at least one reported field whose display type is set to Grouped, and add at least one total. Once these conditions are met, the Chart Layout tab allows you to select a Chart Type (Horizontal Bar Chart, Vertical Bar Chart, Pie Chart, Line Graph or Area Chart), and a Data Series (from all chartable data series available). You may also enter a Chart Title, Rollover Text and Chart Description.
  1. Once a chart has been defined, the next time the report is run, a chart will be generated as part of the report. As well, the chart will be made available in the list of chart dashlets which may be added to the dashboard.
  1. reports charts.png
  1. Figure 265: Editing a New Report - Chart Layout Tab
  1. 9.1.7 Working with Related Sources
  1. To create a report that relates data in one module (table in database terms) to data in another module, or includes data from more than one module, just create a report normally from the list view of your most important module in the report. The Primary Module of the report will be pre-set, but you can also optionally choose one or more Related Sources, such as Contacts and Meetings as shown related to the Accounts module in Figure 261.
  1. Now when you click on the Select-Field-Button.png or Select-Total-Button.png buttons, you will see a dropdown list that requires you to select the module from which to choose a field.
  1. The best way to understand these more complex reports is to study the pre-programmed reports included with the system. Look for reports with titles like Contacts by Account – any report that mentions two tables in its name.
  1. 9.1.8 Specialized Reports
  1. Several of the standard reports that are provided with 1CRM are not actually created by the normal report designer described above, but are custom coded in the report template format that is produced by the report designer. This is because the 1CRM report generator is capable of producing many reports which cannot actually be described through the use of the report designer.
  1. The limitations of the report designer are intentional, to create a user interface that is more approachable by most users. But to take full advantage of the report generator’s capabilities, coding a report manually, directly into the report template format, is a powerful option available to software developers customizing or extending an 1CRM implementation.
  1. Some of these specialized hand-coded reports included with 1CRM are:
  1. Project Profitability: This report details Project profitability month by month, with totals summed on the PDF. Filters for project status and start date let you focus on the projects desired. Principal fields are Account, Project Name, expected revenue, cost and profit, and actual revenue, cost and profit.
  1. Gross Profit by Invoice Range by User: This report details Gross Profit generated for each invoice, with totals summed on the PDF. Filters for invoice creation date and invoice number let you focus on the invoices desired. Principal fields are invoice number and name, invoice date, Account, invoice amount, gross profit and assigned user.
  1. Sales Tax Collected by Invoice Range by User: This report details the sales tax collected by invoice, with totals summed on the PDF. Filters for invoice creation date and invoice number let you focus on the invoices desired. Principal fields are invoice number and name, invoice date, Account, Tax name and amount, invoice amount and assigned user.
  1. report pdf.png
  1. Figure 266: Sample Report PDF
  1. 9.2 The Dashboards Module
  1. Figure 267 shows the 1CRM screen with the Dashboard Module selected:
  1. dashboards.png
  1. Figure 267: The Dashboards Module
  1. The Dashboards module lists the dashboards defined within your 1CRM System. Each dashboard may be viewed or edited from this list view of the various dashboards in your system. The Figure above shows the default dashboards defined in each system. New dashboards may be created using the Create Dashboard shortcut.
  1. By default, each 1CRM installation has two dashboard pages in the Today’s Activities tab group - the Home Dashboard and Action Items. In most of the other tab groups (Sales & Marketing, Order Management, Project Management and Customer Service) there are also two dashboards by default. Sales & Marketing has a Sales Home dashboard and a Sales Charts dashboard, for example. Sales Home is at the start of the tab group, and Sales Charts is at the end, and the same sort of arrangement exists for the other tab groups mentioned.
  1. Each dashboard page has basic dashboard information defined for it, as well as a layout. The dashboard info may be set by using the Dashboards module, or by clicking on the Edit button at the top of any dashboard page (see Figure above), and choosing the Edit Dashboard Info option from the four options presented. Once you do this, the following screen will be displayed:
  1. edit dashboard.png
  1. Figure 268: Setting Dashboard Information
  1. On the Figure above, you can enter a new Name for the dashboard, choose the Group Tab in which it is to appear, and the position (Start or End) within that Group Tab. The Order value is used if for example 2 or 3 dashboards are defined as going at the Start of the same Tab Group. The Published checkbox controls if the dashboard is displayed or not. And Act as a Flat Tab controls if the dashboard is to be displayed when a theme is in use that either does not offer tab groups, or has been set to simple Modules navigation, not Grouped Modules.
  1. For more information on editing dashboard content and layout, and about the variety of dashlets available within 1CRM, please see Section 4.1: The Home Dashboard.
  1. 9.3 The Activity Log Module
  1. Figure 269 shows the 1CRM screen with the Activity Log Module selected:
  1. activity log .png
  1. Figure 269: The Activity Log Module
  1. The Activity Log module provides the ability to see what users (predominantly, those in Sales) are doing within 1CRM. When Users create a new item in any of these modules - Accounts, Contacts, Leads, Cases, Tasks, Calls, Meetings, Opportunities, Projects, Bugs, Quotes, Sales Orders, Invoices and Payments - a record of that action is added in the Activity Log module.
  1. The Activity log also tracks when Opportunities are converted to Quotes, Quotes to Sales Orders, and Sales Orders to Invoices. As well, when Opportunities are Won or Lost, Meetings or Calls are re-scheduled (Moved), when Invoices are Cancelled, and when several types of items are Closed or Re-opened, the system will note that Activity.
  1. When you design Reports, or Custom List View tabs in this module, you can filter by user, or by the module affected, and really see what’s going on within the system.
  1. There is also an Activity Log dashlet provided, which allows you to access the same type of information within a dashboard layout.
  1. This module is useful as a guide to where you do and do not have any issues regarding adoption of the system. It can also be a guide to which sales people are the most and least busy!
  1. 9.4 The System Bulletins Module
  1. Figure 270 shows the 1CRM screen with the System Bulletins Module detail view displayed:
  1. bulletin.png
  1. Figure 270: The System Bulletins Detail View
  1. The System Bulletins module is used to post news messages to all system users about things such as system upgrades, planned outages, or any other news items that concern the 1CRM system. A dashlet is provided to make these messages easily visible, and you can prepare these messages using the module itself.
  1. The checkbox Display automatically on any message will cause that message to be shown as a popup to each user with whom the message is shared, after their next login.
  1. The Shared with dropdown on each message lets you choose if the message is to be shared with All Users, the members of Selected Teams, or None.
  1. 9.5 The Data Privacy Module
  1. Figure 271 shows the 1CRM screen with the Data Privacy Module list view displayed:
  1. data privacy activities.png
  1. Figure 271: The Data Privacy Activities List View
  1. This module is used to manage all 1CRM Data Privacy Activities. These include Request to View, Right to Erase, Consent to Process and Withdrawal of Consent. See more details in the 1CRM and GDPR document.
  1. Note: Most users cannot access this module. To use this module a user must be added to the special Data Privacy Manager Role by the system administrator.