Skip to main content
Skip table of contents

Ad hoc reports

Use ad hoc reports to gather information from individual subject areas or to consolidate information from multiple associated subject areas, into a single report in a custom format. For example, you can create an Opportunities report to include details from the Opportunities subject area, such as description, type, and priority, and also related details from other subject areas, such as related schedule items.

As of the NexJ CRM 9.5 release, the ad hoc reporting functionality is supported in Google Chrome and Microsoft Internet Explorer.

Ad hoc reports are supported for the following subject areas:

  • Activities
  • Call Records
  • Companies
  • Contacts
  • Contact Touches (any touches that have occurred or are expected to occur for a contact)
  • Deals (product opportunities)
  • Documents
  • Leads
  • Opportunities
  • Schedule Items
  • Service Requests
  • Tasks
  • Touch Activities (any activities that are associated with a touch type)
  • Users

Ad hoc reports display data on demand, based on the settings you define while creating the report. Ad hoc reports contain fields that may not be available in the predefined reports generated from other NexJ CRM workspaces. You can view the report along with a summary and visualization within the workspace, or export the report's summary, detail (raw data), or visualization. If you are a report administrator, you can export a report's JSON definition to your local drive. You can search for specific reports using the available filter options.

Ad hoc reports are generated on the Reports workspace in NexJ CRM or in a standalone reporting application, depending on how ad hoc reporting is set up in your organization.

You can select a template provided by NexJ and customize it as needed, or you can create a report from scratch. An example of a template is the Scheduled activity breakdown report, which shows scheduled activities per user for a specific date range. You can keep your reports private or if you are granted the appropriate privileges by your administrator you can make them available to all NexJ CRM users.

Deals templates are impacted when you select a different currency in the Currency field in the Localization tab in the User Preferences dialog. For example, the Expected Amount field of the Top 10 Open Deals template will be converted into the currency set in this dialog.

To edit the Currency setting, click User settings in the NexJ CRM toolbar, select User Preferences, and select a different value in the Currency field. After you select a different currency, you must click the Update Report button

in the Report Viewer to update the Deals report with converted values. For more information about the Report Viewer, see Report Viewer. If you are using a dashboard to view a Deals report, you must click the Update Dashboard button 
in the Dashboard Viewer to view the converted currency values. For more information about the Dashboard Viewer, see Dashboard Viewer.

When you use a currency other than the default base currency, you must consider the following information for monetary values in reports:

  • Shared links of a report will show monetary values based on the Currency setting in User Preferences for each user.
  • Monetary conversions are based on the exchange rate when you run the report. To get the latest monetary conversions, you must rerun the report by clicking the Update Report button or Update Dashboard button.

Your administrator must have assigned the appropriate privileges for you to view or edit ad hoc reports. Your view of data in a report is dependent on your access level, team assignment, and organizational hierarchy. It may differ from the view that other users have.

In addition to enabling custom selection and custom ordering of the report fields, ad hoc reports provide the following controls for report data and presentation:

Filters
Use search area filters to find reports, and use field filters to filter reports data. For more information about search area filters, see Reports workspace. For more information about field filters, see Report fields.

Groupings
Group data at one or more levels for your report summary.

Calculations
Select the calculations to display in your report summary.

Visualization
Choose from a variety of chart formats to visually summarize your report data.

For more information about groupings, calculations, and report visualization, see Adding groupings and calculations to the report summary and Visualizing reports.

Once you have built your reports or other users have shared their reports with you, you can set up customized dashboards with the summary, visualization, and detail from any of your reports as components.

The ad hoc reporting functionality includes the ability to schedule reports for a specific time in the future or at regular intervals, and the ability to use an existing report definition to build another report.

Reports workspace

The Reports workspace lists all the ad hoc reports you have access to, and all the dashboards that you created. Use this workspace to view, add, edit, or delete reports and dashboards.

The Reports workspace consists of the following:

  • The My Reports, All Reports, My Dashboards, and All Dashboards tabs. The My Reports tab displays the reports that you created, while the All Reports tab displays all the reports that you can view, including those shared by other users. The My Dashboards tab displays the dashboards that you created. The All Dashboards tab displays all the dashboards that you can view, including those shared by other users.

    Report templates display as reports that can be run in All Reports. You cannot edit or delete them but you can run or clone them. Dashboard templates are also available from All Dashboards. You can clone dashboard templates to create new dashboards. Dashboard templates can only reference report templates by name, which means that dashboard templates cannot reference reports that you create on your own without using templates.

  • Use predefined filters, available in the My Reports and All Reports tabs, to view reports associated with specific subject areas. Predefined filters are search filters that are provided by default on a NexJ CRM workspace. For example, click the Opportunities filter to view all reports associated with the Opportunities subject area.

    • Use the text search field to search for items using the full item name or a part of the item name. The text search field supports the * and ? wildcard characters. The * wildcard is a placeholder for a string of text of any length, including spaces, while the ? wildcard represents a single alphanumeric character.

    • Use filter chips to add search criteria or fields in combination with an existing filter. You can filter by created date, description, and last edited date. The search area includes predefined filters, text search field, and filter chips, which enable you to locate specific items. You can use these filters to find specific items within the My Reports, All Reports, My Dashboards, and All Dashboards tabs.

    • To show or hide filter chips, add filter chips, or reset filters, click the Filter options button

      beside the text search field.

  • The data tables display a list of reports or dashboards that match your filter criteria. The Reports data table, available in the My Reports and All Reports tabs, displays reports you have access to, and the Dashboards data table, available in the My Dashboards and All Dashboards tabs, displays dashboards you have access to. You can do the following in the data tables:
    • Click the Add button
      to add a report or a dashboard.
    • Click a column header or use the Sort by button
      to sort the displayed results.
    • Click the Select Columns button 
      to choose the columns to display in the data table.
    • Hover over a report or dashboard to reveal action buttons to:
      • Edit the report or dashboard 
      • Delete the report or dashboard 
      • Perform more actions

        , such as viewing the report
        , cloning the report or dashboard definition
        , updating the report
        , exporting the report
        , and sharing the report

        You can edit or delete reports that you created. You can only view, export, or clone reports created by other users.

    • Use the Items per page drop-down to limit the number of items displayed per page.
    • Use the chevron buttons
      to navigate between pages to view additional items.

Example: Running a report provided by NexJ

The following video shows an example of how to run and update a report based on the Scheduled Activity by User template that is provided by NexJ, and use the Visualization and Summary tabs to retrieve detailed information.

Report Builder

Use the Report Builder to define or edit a report. Launch the Report Builder by clicking the Add Report button 

on the top right of the Reports data table or by clicking the Edit Report button 
for an existing report. The Report Builder displays a preview of your report summary and raw data. The preview automatically refreshes as you update the settings.

The report preview displays a subset of the report data. To view the full report data, you must save the report, open it in the view mode, and execute the report by clicking the Update Report button

.

The Report Builder consists of the following:

  • A banner with the name, description, and View and edit permissions setting for the report. The View and edit permissions setting determines whether the report is private or public.

    You will see the View and edit permissions setting if you have been granted the appropriate privileges by your administrator.

  • A report settings pane on the left-hand side with the following tabs:
    • Details
      Select the fields you want to add to your reports and refine your report data by applying filters to fields.

      You can apply a filter to a field that has not been selected for display in the report.

    • Summary
      Define your report summary by adding groupings and calculations.
    • Visualization
      Define chart values for your data. The fields and calculations in this tab can be different from the Summary tab, depending on the settings you use.
  • A report data pane on the right-hand side that shows previews for the following data:
    • When the Details tab is selected, it displays a preview of the raw report data. It refreshes in real time as you modify your report settings. Display additional columns using the chevron buttons 
      . In Contacts, Opportunities, and Deals reports, double-click a row to view the associated record on the applicable NexJ CRM workspace. Some collections provide links to associated records on the applicable NexJ CRM workspace. For more information about collections, see Viewing fields of a collection.
    • When the Summary tab is selected, it displays a preview of the summary of significant report data based on the groupings and calculations you defined.
    • When the Visualization tab is selected, you can select the required chart for your data and display a graphical preview of your data.

    You can view both the summary and the visualization in full size by clicking the Expand button

    . This no longer applies to reports but to dashboards. May reinsert it when documenting dashboards.

  • An action button to save the report
    , an action button to cancel creation of the report
    , and when editing an existing report, an additional action button to revert your changes
    .

The following reporting actions increase operational complexity, and are expected to result in longer report execution times:

  • Adding fields from associated classes
  • Grouping on fields from associated classes
  • Filtering on unindexed fields
  • Sorting on unindexed fields

Report Viewer

The Report Viewer displays existing ad hoc reports. While the Report Builder displays a preview of your report data, the Report Viewer displays the full data as of the last executed time of the report. Launch the Report Viewer by double-clicking a report or clicking the View Report button 

for a report in the Reports data table.

A report executes when the Update Report button 

for the report or the Update Dashboard button 
for a dashboard containing the report is clicked. It also executes when a report runs at its scheduled time.

For more information about dashboards, see Working with dashboards. For more information about scheduled reports, see Scheduling reports.

When viewing a report, you can sort the report summary and details, transpose rows in the report summary to columns and columns to rows, update the report to reflect the latest NexJ CRM data, export various components of the report, and schedule reports. For more information about the actions you can perform in the Report Viewer, see Viewing existing reports.

Report fields

Fields are the basic building block of ad hoc reports. Each field represents an attribute that you want to view in the report.

You can select fields in the Details tab in the Report Builder. Conduct a direct search for fields by entering the field name in the Add Fields text search field, or click the Select button 

in the Details tab to open the Add Fields dialog, where you can view all available fields and select from them. The dialog also includes a text search field similar to the one on the main Details tab. 

The following filters are available for selection in the Add Fields dialog:

  • String: Displays attributes with text-based values. For example, last name.
  • Number: Displays attributes with numeric values. For example, expected revenue from an opportunity.
  • Date: Displays attributes with date values. For example, date of birth.
  • Object: Displays attributes containing sub-attributes. For example, related opportunities.

If a sub-attribute of an object is a string, the object also shows under the String filter.

By default, all attribute types are selected in the Add Fields dialog. To view attributes of a specific type, clear the checkboxes associated with other attribute types.

The collections icon
identifies a collection which groups related fields. Some collection fields are expandable to display additional fields related to each value of the group. You can include these collection fields in your report and expand them to select the additional fields. 

If you select a collection field in the Add fields dialog (for example, the Activities field for a Contacts report), and expand the field to select related fields (for example, Activity End Time or Activity Start Time), the report displays the fields of the collection grouped by the subject area (for example, the interactions grouped by contacts). In reports, collection fields can be identified by their default fields. The default field is displayed in reports to represent the selected collection whether the default field is selected or not (for example, the default field for the Activities collection is the Description field). 

Another example of a collection is the Mobile Phone field that can be expanded to select Entity, Extension, and Number. NexJ CRM enables you to enter a description and an extension with every mobile number, in addition to the number itself.

Selected fields and default fields of selected collections display as columns in the preview data table in the report data pane. The columns refresh in real time as you add, remove, or modify fields. You can reorder the fields using drag-and-drop in the Fields section of the Details tab. If you export a report, the columns of the exported report have the fields in the order set in the Details tab. However, for the columns in the preview data table, selected fields are grouped to display non-collection fields first and then the default fields of selected collections. The fields in each group display in the order set in the Details tab.

Fields that you can group your report summary by are available for selection in the Summary tab in the report settings pane. Fields that you can add calculations to are available for selection in the Calculations section.

All collection fields that are numeric can be used for calculations, except those from associated subject areas.

After you add a field, you can apply filters to include or exclude specific records from the report. For some fields, multiple selection dialogs are available, where you can select specific values to include or exclude. For other fields, you can use operators, such as equals, contains, greater than, less than, between, unspecified, and so on, to define the filter. For more information about multiple selection dialogs, see Multiple selection dialogs. For information about operators supported in NexJ CRM, see Using operators.You can also apply additional temporary filters when viewing an existing report. These filters apply only to the current view instance. They are not saved for future views of the report. When you open a report, filter chips for the first five columns in the report display by default. If necessary, you can add additional filter fields by clicking the Filter Options button 

and selecting Add filter fields. You can hide filters by selecting Hide filters.

The maximum number of fields that you can add to a report is 200.

Viewing existing reports

To view a report, hover over the report in the Reports data table, click the More Actions button

and then click the View Report button
, or double-click the report in the Reports data table. 

The data in the Details tab of a report automatically refreshes each time you open a report. However, you may need to click the Update Report button 

to refresh the data in the Summary and Visualization tabs.

When viewing a report, you can:

  • Show or hide filters.
  • Add temporary filters for the current report view.
  • Reset any temporary filters that you added.

  • Update the report to reflect the latest changes to NexJ CRM data.
  • Sort the report summary and report details.
  • Transpose rows to columns and columns to rows in the report summary.
  • Export the report's raw data, summary, and visualization. If you are a report administrator, you can export a report's JSON definition.
  • Open details pages in NexJ CRM by clicking on links for associated objects in the Details tab that have detail data (for example, people, companies, service requests, deals (and other opportunities)). For example, when you are viewing a deals report that uses the Owner field, you can click on an owner's name in the Details tab to open the owner's detail page on the Contacts workspace.
  • Display the report definition version, subject area name, last executed time, and if applicable, the next scheduled run time of the report in the About tab.
  • Schedule reports and send reports by email to a distribution list in the About tab.
  • Click the links for collections 

    in the Details tab to see the included fields of the collection together with the default collection field. 

    Collections can be identified by their default fields in reports. The default field is displayed in reports to represent the selected collection whether the default field is selected or not (for example, the default field for the Activities collection is the Description field). 

For more information about how to perform these tasks, see Report fields, Modifying reports, Exporting reports, and Scheduling reports.

Viewing fields of a collection

In the Details tab, the collections icon

in the data table indicates that the field is a collection. Click on the icon to see the fields of the collection that you added to the report. To add more fields from a collection to a report, you must add the fields to the report in the Add Fields dialog for the report.

Some collections contain fields that have details data in NexJ CRM. These collections provide links from the Details tab to the associated record on the applicable NexJ CRM workspace. For example, the following collections provide links:

  • Service Requests
  • Coverage Children
  • Related Opportunities
  • Assign To
  • For
  • Employees

The following screenshot shows an example of the preview data table that displays when the Products collection has been selected in the Details tab. In the second data table row shown below, a contact has been assigned an opportunity with multiple products. When you click on the row, you will see a list of all of the products assigned to the contact. The rest of the rows show one product. The Products field can contain Advisory collections, which are created based on data from contacts who have been assigned the Advisory product.

Contacts can be assigned the Advisory product in the Advisory Services type of products on the Opportunities workspace or in the Opportunities tab for a contact. Mutual fund and mortgage products are also assigned on the Opportunities workspace or in the Opportunities tab for a contact. For more information about the Opportunities workspace and Opportunities tab, see Creating and managing opportunities.

Collections in the preview data table example

When the Products collection is selected, you can click a collection name link to view which contact the collection is associated with, and which products, and the default field for the collection, which is Name. The following screenshot shows the dialog that displays when you click a collection name link. In this example, the contact has one product, which displays in the Products data table.

Products example

Creating new reports

The Report Builder takes you through the steps needed to create a report. Select the attributes you want to view, add any filters to limit the report data, group the data and add calculations to the report summary, and define the visualization settings for the report.

You can either start with a report template provided by NexJ and customize it to your requirements, or create a blank report.

Report templates are only available for some NexJ CRM subject areas.

This procedure focuses on how to create a basic report by selecting attributes and adding filters. Further sections on this page provide information about configuring groupings, calculations, and report visualization.

If you are a report administrator, you can use the import report definition utility provided at <Application Root URL>/nexj/ui/report/import-definition to import a JSON file with a report definition and then edit the report definition using the Report Builder.

To create a basic report:

  1. In the My Reports or All Reports tab, click the Add Report button 
    at the top right of the Reports data table.
  2. Choose the subject area you want to generate a report for.
  3. Do one of the following:
    • To use a report template, select a template.
    • To build your report from scratch, select a blank report.
  4. If you selected a template, the report data is populated immediately. Skip the remaining steps in this procedure and edit the report parameters as needed. For more information, see Modifying reports.
  5. Enter a meaningful name for the report, and, optionally, provide a description.
  6. Optional: If you want to make your report available to all NexJ CRM users, select the Public radio button under View and edit permissions. You will see the View and edit permissions setting if you have been granted the appropriate privileges by your administrator.
  7. In the report settings pane below the Name field, in the Details tab, click the Select button for the Add fields text search field, and select the attributes you want to add.

    If you know the names of the attributes you want to add, you can directly enter the field name in the Add Fields text search field. A similar search field is available within the Add Fields dialog. For more information about searching for attributes, see Report fields.

  8. Optional: You can click on a selected field and select from the following options:
    • Add Field as Grouping - the new grouping for the field will appear in the Summary tab. For more information, see Adding groupings and calculatations to the report summary.
    • Add Field as Filter - the new filter for the field will appear in the Filters section of the Details tab and you can proceed to step #9b.
  9. Optional: In the Filters section, select the filters you want to apply:
    1. Click the Select button to open the Add filters dialog and select the required filters.

      As of NexJ CRM 9.6, the list of filters you can select from is no longer determined by your field selections. Instead, you can select any available filter. For example, you can filter a Deals report using the Stage filter without having selected the Stage field. The Stage field will not show in the Details tab for the report.

    2. In the Enter filter dialog, do one of the following:
      1. If you see a list of values you can select from, select the values you want to include.
      2. If you see fields for an operator and a text or numeric field value, select the operator and specify the values.

        Available operators vary based on the attribute type.

    3. Click Save.
    The fields to which you applied filters are highlighted in green.
  10. Optional: In the Sorting section of the Details tab, select the field that will apply the sorting to the report. Click the Select button 

    and select the required fields.

    1. To limit the results set, enter the number of item rows that you want to display in the Count field.

    2. To change the sort order of the selected field to ascending or descending, click Order.

      When a field is chosen for sorting the report, you cannot sort the columns in the data table in the Details tab in the Report Viewer.

  11. Click the Save button
    .

The report opens. In the Summary and Visualization tabs, you may see a message that the report has not been executed. Click the Update Report button 

to execute the report and to generate the summary and the visualization on the full report data. At any time, you can edit the report to change the fields and filters or to add groupings, calculations, and visualization options.

If you want to schedule the report to run at a future time, change the schedule frequency as desired. For more information, see Scheduling reports.

After you execute a report by clicking the Update Report button, the report data can be viewed for 30 days before you must rerun the report for the latest data. To save report data for a specific instance in time beyond 30 days, you must export the report within 30 days. The 30-day limit is the default design-time configuration.

When you view data for a report, click the Update Report button to see the latest data.

If you notice data is not showing anymore, the data has expired, and you must click the Update Report button to generate new report data.

Adding groupings and calculations to the report summary

The report summary, displayed in the Summary tab in the Report Builder and Report Viewer, is a pivot table representation of significant statistics in a report. Groupings define the attributes you want to group the report summary by, and calculations define the aggregated statistics displayed for the attributes.

When you select a subject area and add fields to your report, NexJ CRM dynamically generates a report summary with default calculations for all aggregatable fields in the report. At minimum, the count of all items in the subject area is displayed. You can customize these calculations and group the summary data at one or more levels to improve the usefulness of your report summary.

Available calculations vary based on data type. For example, for all deals or all clients, the only available operator is count. For expected revenue, you can select between sum, average, maximum, and minimum.

You can use groupings either as rows or columns in your pivot table. If you use them as rows, calculations are the columns, and if you use them as columns, calculations are the rows.

If you add multiple groupings, you can expand the first grouping in the report summary to view additional groupings.

At any time, you can:

  • Remove a grouping or calculation by clicking the Clear button
    on the grouping or calculation.
  • Reorder the groupings through drag-and-drop to the desired location.
  • Sort the report summary by clicking the column or row header containing the name of the calculation.

This section assumes you have the report open in the edit mode. If it is open in the view mode, the Edit Report button 

is displayed on the top right side, next to the Update Report button
.

As you update your groupings and calculations, the preview in the Summary tab refreshes to reflect your changes.

To add groupings and calculations to your report summary:

  1. In the report settings pane on the left side of the Report Builder, select the Summary tab.
  2. In the Groupings section, click the Select button 

    , and select the fields you want to group by, or you can enter the names of the fields directly in the Add Groupings text search field.

    As of NexJ CRM 9.6, the list of fields you can select from for groupings is no longer determined by your field selections. Instead, you can select any available single-value or collection-type fields as groupings. For example, you can group a Deals report using the Stage grouping without having selected the Stage field. The Stage field will not show in the Details tab for the report in the Report Viewer.

  3. Click OK to close the Add Groupings dialog.

  4. Optional: Repeat steps 1 to 4 as needed for additional groupings.
  5. Optional: For date attributes, you can select the date view you want to use for the summary. To select the date view:
    1. Click the date attribute that you added as a grouping.
    2. In the Date Grouping dialog, select from Day, Week, Month, Quarter, and Year views.
  6. In the Calculations section, click the Select button 

    to open the Add Calculation dialog. Select the required field that you want to add a calculation for. For example, Expected Amount.

    As of NexJ CRM 9.6, the list of calculations you can select from is no longer determined by your field selections. Instead, you can select any available numeric fields as calculations, except collection-type fields from associated subject areas.

  7. In the Operator field, select the aggregate operator you want to use for the calculation. Choose from the following operators:

    • Average
      Returns the average of all non-null values from the selected attribute.
    • Count
      Counts the number of instances of the selected attribute.
    • Maximum
      Returns the maximum value from all non-null values of the specified expression.
    • Minimum
      Returns the minimum value from all non-null values of the specified expression.
    • Sum
      Creates totals for selected attributes.
  8. In the Caption field, enter the name of the calculation that will display in the report.
  9. Click Confirm.

    You can add only one calculation for each attribute. If you select a field that already has a calculation, an error is displayed when you click Confirm.

  10. Optional: Repeat steps 6 to 10 as needed for additional calculations.

You have now added groupings and calculations to your report.

Visualizing reports

The Visualization tab on the Reports workspace provides a graphical, at-a-glance view of your report data. You can select from a variety of column, bar, area, pie, line, scatter, and funnel charts.

In the visualization, each axis represents either a field that you selected or a calculation you defined. The type of data each axis represents depends on the graph type you select. For example, if you selected a column chart with deal priority on x-axis and deal count on y-axis, when you switch to a bar chart, the deal count automatically moves to x-axis and priority to y-axis.

Groupings do not automatically apply to visualizations. However, you can choose to include one of your groupings in the visualization. Data shown in the Visualization tab can be different from that shown in the Summary tab because the fields you choose to include in your graph can be different from the fields you select as groupings.

When you add a new field, grouping, or calculation to your report, it becomes available in the Visualization tab immediately. However, if you have already generated a visualization, for the graph to change, you must select the newly added field, grouping, or calculation in the relevant drop-down in the Visualization tab.

A legend displays to the right of the graph indicating the color coding used in the graph.

To visualize your data on the Reports workspace:

  1. In the Report Builder, click the Visualization tab. The Visualization tab displays the following information:
    • The Category field displays your field selections from the Details tab. You can select a different field if you choose.

      After you select a chart type, the Category field selection becomes the x-axis for column or bar charts, and determines how the information is categorized in the legend for other charts.
    • The Value field displays the default count calculation from the Summary tab. If you have added additional calculations, you can select a different calculation to use for your chart. Click the Add Value button to add additional calculations.

      After you select a chart type, the Value field selection becomes the y-axis for column or bar charts, and the total numbers for items are displayed in the legend for other charts by category.
  2. Optional: If you have added a grouping in the Summary tab, you can add the grouping to the visualization by selecting the Add Grouping checkbox, and selecting the grouping in the Grouping field.
  3. Do one of the following:
    1. If you do not already see a chart, select a chart type to display a preview of the visualization.
    2. If you see a chart and want to change the chart type, click the Select Chart Type button 

      on the top right of the chart and select a new chart type.

  4. Optional: If your chart has an x-axis and y-axis, you can change the selections in the X-Axis and Y-Axis drop-downs to display the required data. The chart refreshes to display data based on your selections.
  5. Optional: To add or remove groupings or additional calculations, do one of the following:

    1. To add a calculation, click Add X-Axis or Add Y-Axis, whichever is available.

    A chart can include either groupings or additional calculations, but not both. If you include groupings, the Add X-Axis or Add Y-Axis button is disabled. If the chart already includes more than one calculation, the Add Grouping checkbox is disabled.

  6. Optional: If your chart includes a date field, you can toggle between views of different time periods in your chart by selecting Day, Week, Month, Quarter, or Year for the date field in the Visualization tab.

    Any date view you select only applies to the current view instance. The next time you view the report, the view reverts to the default selection.

  7. Optional: To view more details on the data in a chart, click the graphical elements of the visualization. A data table is displayed with more information. 

    The collections icon 
    in a data table indicates that the field is a collection. Click the links of a collection field to see the included fields from the collection.
  8. Optional: In the Visualization tab, some fields (for example, Stage) have reorder buttons (the 

    Reorder Category button, the 
    Reorder Y-Axis button, and the 
    Reorder X-Axis button) that are displayed when you select those fields for Category, X-Axis, or Y-Axis. To reorder the values of the field in the visualization, click the button and drag-and-drop the values to set the order.
    For example, you set the Category to Stage in the Visualization tab for a funnel chart in the Deal Pipeline by stage (next 90 days) report (see the templates for Deals to find this report). To reorder the values in the funnel chart, click the 
    Reorder Category button, and drag-and-drop the stages to adjust the order of values displayed in the funnel chart.

    The 
    Reorder Category button, the 
    Reorder Y-Axis button, and the 
    Reorder X-Axis button are visible for only certain fields (for example, Stage), and the label of the button depends on the chart selected.

Scheduling reports

You can schedule your report to run once, at a future date and time, or periodically.

You can set up the report schedule in the Schedule section in the About tab in the Report Viewer. The default frequency is None, which runs the report immediately. If you want a report to run only once, but at a future time, select Once, and specify the desired date and time. If you want it to run periodically, select Daily, Weekly, or Monthly, and specify the start date and time. The report runs for the first time at the start date and time, and will continue running periodically as specified in the schedule. To automatically send a report's details to a distribution list, enter the recipients' email addresses in the Email Address Targets field.

By default, you can provide a maximum of 10 email addresses in the Email Address Targets field.

If your administrator has enabled your environment to support sending summaries and visualizations, you will also be able to send them. Click Set Schedule to save your schedule.

The raw data of a report, accessible from the Details tab for the report in the Report Viewer, updates each time you open the report. The data in the Summary and Visualization tabs, however, only updates when you click the Update Report button 

or when an update occurs automatically based on the schedule. Therefore, whenever you view a report, we recommend that you click the Update Report button to bring your report summary and visualization current with your report detail.

Each time a report runs as per schedule, you will receive a notification, which you can view in the Notification sidebar. In addition, the Last Updated timestamp is updated, in the Reports data table and in the About tab of the report. The About tab also shows the next scheduled run time for the report.

If a report fails to run at the scheduled time, an error displays in the Summary, Visualization, or Details tab of the report, depending on where the issue occurred. If you see an error, try re-running the report by clicking the Update Report button. This may resolve any failures due to temporary server issues. If it is a recurring scheduled report, the system will reattempt to run the report at the next scheduled time. If the issue persists, contact your administrator with the error code.

Report schedules are user specific. When a user runs a report, the report data is not updated for other users of the same report. Each user of a shared report must run the report individually to view any report data by clicking the Update Report button or by scheduling a run of the report.

Modifying reports

You can modify your reports by clicking the Edit Report button

for the report. You can find this button:

  • In the Reports data table, by hovering over the report.
  • When viewing a report, next to the Update Report button 
    on the top right.

Depending on your privileges, you may only be able to edit reports that you created. If you want to customize a report that you can view but not edit, clone the report and edit the clone instead. For more information, see Cloning reports.

The following table shows the changes you can save to a report, and where in the Report Builder you can make those changes.

ModificationHow to modify
Edit report nameIn the report banner, enter the new Name.
Add or edit report description

In the report banner, enter or edit the Description.

Make a report available to all NexJ CRM users

In the report banner, select the Public radio button under View and edit permissions.

The icon displayed for the report in the Reports data table changes, indicating the report is no longer private.

Add fields

In the Details tab, click the Select button

.

You can also use the Add Fields text search field to search for specific fields and add them to your report.

Remove fields

In the Details tab, click the Clear button

on the field you want to remove.

Reorder report columnsIn the Details tab, drag and drop the fields to the desired position.
Apply filters on fieldsIn the Filters section of the Details tab, click a field, and select the filter values. For some fields, you will need to select an operator and specify the values to work in conjunction with it.
Edit filters

In the Filters section of the Details tab, click a filtered field, and edit the filter selection.

Remove filters

In the Filters section of the Details tab, click the Clear button on the field you want to remove the filter from. To remove all filters, click the Clear Filters button.

Add groupings

In the Summary tab, and the Groupings section, click the Select button.

You can also use the Add Groupings text search field to search for specific fields to add as groupings.

Remove groupings

In the Summary tab, click the Clear button on the field you no longer want to group by.

Edit grouping orderIn the Summary tab, and the Groupings section, drag and drop the groupings to the desired position.
Change date groupingIn the Summary tab, and the Groupings section, click a date field to select the day, week, month, quarter, or year view.
Add or edit calculations

In the Summary tab, and the Calculations section, select the fields you want to aggregate and the operators you want to use for the calculation. To change a calculation's display name, click the calculation and enter the desired name in the Caption field.

Remove calculationsIn the Details tab, click the Clear button on the calculation you want to remove.
Sort report summary

In the Summary tab, and in the data table, click a calculation's Click to sort Asc button

to sort the report summary preview in ascending order or its Click to sort Desc button
to sort the report summary preview in descending order.

Calculations may show as either rows or columns in your report summary. Click the row or column header associated with the calculation to sort the summary.

Clear all filters

In the Filters section of the Details tab, click the Clear Filters button

.

Specify the attribute and primary calculation to be displayed in the visualization

In the Visualization tab, select the attribute in the X-Axis drop-down and the calculation in the Y-Axis drop-down.

Include additional calculations in the visualization

In the Visualization tab, click Add X-Axis or Add Y-Axis, whichever is available. In the new drop-down that displays, select the desired calculation.

Additional calculations are supported if the visualization does not include groupings.

Include groupings in the visualization

In the Visualization tab, select the Add Grouping checkbox. In the Grouping field, select the grouping you want to add to the graph.

Groupings are supported if the visualization includes only one calculation.

Change graph type

In the Visualization tab, click the Select Chart Type button 

.

After making your changes, click the Save button

. If you have made changes that impact the Summary and Visualization tabs, also click the Update Report button
in the Report Viewer. This executes the report so these tabs reflect the latest NexJ CRM data.

You can also make some changes to reports in the view mode. Changes made in view mode only apply to the current view session and are not automatically applied the next time you view the report.

The following table shows changes you can make in the Report Viewer.

Add temporary filters

Click the filter chip associated with the attribute you want to filter by, and specify the filter operator and values.

Clear temporary filters

Click the Clear button on the filter you want to clear.

Reset filter chips to the default search criteria

Click the Filter options button and select Reset filters.

ModificationHow to modify
Update the report to reflect the latest data

Click the Update Report button.

The time taken for a report to update depends on the amount of data in the report. You will receive a notification once the update is complete.

Sort report detailsIn the data table, click the column header associated with the attribute you want to sort by.
Sort report summary

In the Summary tab, and in the data table, click a calculation's Click to sort Asc button

to sort the report summary preview in ascending order or its Click to sort Desc button
to sort the report summary preview in descending order.

Transpose rows to columns and columns to rows in the report summary

In the Summary tab, and in the data table, click the Transpose button

.

Sharing reports

You can share a report's URL to enable other NexJ CRM users to easily access the report or email a report to other users.

Before sharing a report's URL, you will need to make the report public by selecting the Public radio button under View and edit permissions. Then, open the report, and click the Share Report button 

on the top right corner of the report and select Copy URL. This action copies the URL to your clipboard. You can then paste it into the required application to share it with other users.

Users you share the report with can view the report, export the report's components, and update the report to display the latest NexJ CRM data. They cannot edit the report. However, depending on their privileges, they may be able to clone the report and edit the clone by locating the report in the All Reports tab of their reports data table. For more information, see Cloning reports.

The data displayed in the report to other users may be different from the data displayed to you, depending on their access level, team assignment, and organizational hierarchy.

To email your report to other users, click the Share Report button and select Share by Email. Provide the required list of email addresses in the Send Email Results dialog, separated by semicolons, and click OK to email the report. By default, you can provide a maximum of 10 email addresses. 

Attachments and links to files for summaries, visualizations, and details are available through the email sent. The maximum file size for an attachment is 5 MB. The links to files are available on the server for 30 days before expiring.

As of NexJ CRM 9.6, PNG and CSV file attachments are replaced by PDF file attachments when you share a report by email.

Exporting reports

You can export report data to multiple formats, including PDF, HTML, CSV, XLSX, and PNG formats. If you are a report administrator, you can also export a report's definition in JSON format to share it with specific users.

You must run a report before you can export the report. Exporting the report does not refresh the data in the report. The exported report uses the data from the last time you clicked the Update Report button 

or when the report ran as a scheduled report.

To export a report, you can either:

  • Hover over the required report in the reports data table, click the More Actions button
    , select Export Report, and select one of the following export menu options:
    • Full Report (PDF)
      A full report includes the data from the Details, Summary, and Visualization tabs.
    • Full Report (HTML)
    • Detail (CSV)
    • Summary (XLSX)
    • Visualization (PNG)
    • Definition (JSON) - This option can only be used by report administrators.
  • Open the required report in view mode (see Viewing existing reports) and complete the following procedure:
    1. Perform one of the following procedures:
      • Select the Details, Summary, or Visualization tabs and perform an export:
        • To export the raw data, select the Details tab and click Export To CSV.

          As of NexJ CRM 9.6, you can include multiple collections as part of your CSV export. For example, you can include attributes from both the Assign To and For collections for an activity-based report. 

        • To export the report summary, select the Summary tab and click Export to Excel.
        • To export the report visualization, select the Visualization tab and click Export to PNG.
      • Click the Export Report button 
        and select one of the following export menu options:
        • Full Report (PDF)
        • Full Report (HTML)
        • Detail (CSV)
        • Summary (XLSX)
        • Visualization (PNG)
        • Definition (JSON) - This option can only be used by report administrators.

          For Detail (CSV), when a report has a collection and is exported to a CSV file, the fields of the report are repeated in columns for each related collection value listed unless your system administrator has configured your reports to not repeat the fields.
    2. Specify the location for the exported file.

The file is saved to the specified location. The default file name is in the following format: <reportName>_<typeOfExport> (for example, <reportName>_summary.xlsx ). The column order in the CSV and XLS files is the same as when viewing the report.

As of NexJ CRM 9.6, your system administrator can configure CSV exports so that duplicate data related to the parent record in the Details tab is not shown in the spreadsheet. For example, the following spreadsheet shows duplicated data in the Full Name, Position, and Status columns.

Unflattened collections data in a spreadsheet example

The following spreadsheet shows the same spreadsheet columns when the attributes related to the parent record (Full Name, Position, Status) are configured to not show duplicated data.

Flattened collections data in a spreadsheet example

The default maximum limit for an exported CSV file is 10,000 rows. Your system administrator may configure the maximum number of rows for CSV exports.

Cloning reports

You can clone a report as a base to build another report. You can use this feature, for example, to build the same report with two different summary or visualization representations.

To clone a report:

  1. Hover over the report in the reports data table or open the report to view.
  2. Under the More options button
    , select Clone Definition.

The new report opens. It will have the same name as the original report but preceded by "CLONE -". If you want the report to reflect the latest data, click the Update Report button

.

If a report has multiple clones with similar names, you can use the Created timestamp in the reports data table to identify the most recent clone.

Dashboard Viewer

The Dashboard Viewer displays existing dashboards. While the Dashboard Builder displays a preview of your dashboard, the Dashboard Viewer displays the full data as of the last executed time of the reports on the dashboard. Launch the Dashboard Viewer by clicking a dashboard.

For more information about the actions you can perform in the Dashboard Viewer, see Working with dashboards.

Working with dashboards

Dashboards enable you to view data from multiple reports simultaneously, on a single canvas. By organizing components from related reports into a single dashboard, you can get a high-level summary that provides quick and helpful insights into the data contained in the reports. The components could be summary, visualization, or detailed data from any of the reports that you have access to. You can control the size of a dashboard as well as its individual components. Using drag-and-drop, you can reposition the components to suit your needs.

NexJ also provides dashboard templates in the All Dashboards tab, for example, the Deal Management Dashboard.

To create a dashboard:

  1. In the My Dashboards tab or All Dashboards tab, click the Add Dashboard button 
    at the top right of the dashboards data table.
  2. Enter a meaningful name for the dashboard, and, optionally, provide a description.
  3. By default, dashboards are private. If you are a report administrator, you can clear Private Dashboard to make the dashboard template public. When building their own dashboards, users can clone the public dashboard template in the dashboards data table in the All Dashboards tab.

    A private dashboard cannot be shared with other users.

  4. Optional: To edit the row height and the number of columns in the dashboard, click the Settings button

    .

    The row height effectively represents the height of individual components in a dashboard, and the number of columns determines the number of components displayed in each row. Adjust the row height and the number of columns as necessary for an optimal view.

  5. Click the Add Dashboard Item button to add the first component of the dashboard. Adding a component involves:

    1. Optionally, adding a caption title for the component.
    2. Optionally, adding a description for the component.
    3. Selecting the report.
    4. Choosing between the report detail, summary, or chart.
    5. Optionally, setting the number of rows and columns the component should occupy on the dashboard. The default selection is 1 column and 1 row. The maximum number of columns is the limit you set for the dashboard (see step 3).

  6. Repeat the previous step as needed for additional components.

    If a dashboard component displays a message that the report has not been executed yet, click the Update Dashboard button 

    after saving your changes . This executes all the reports in the dashboards so they reflect the latest data. For dashboards that contain report summaries or visualizations, we recommend executing the reports periodically to ensure latest data. If a component displays no data even after executing the report, check the report settings and confirm there is matching data.

  7. Optional: Use drag-and-drop to resize or reorder the dashboard components as desired. As you resize a component through drag-and-drop, the values in the Rows and Columns fields in the component settings (accessible by clicking the Settings button) update to reflect the new size.

The dashboard is created. You can access it at any time by double-clicking it in the Dashboards data table. If the components of a dashboard are from a single subject area, you can filter your dashboard data by clicking the Filter Options button 

and selecting Add filter fields.

To edit or delete a dashboard, click the Edit button 

or the Delete button 
for the dashboard in the Dashboards data table. To delete a dashboard component, open the dashboard in the edit mode, and click the Remove button for the component. For a larger view of a component, click the Expand button
.

Example: Creating a dashboard

The following video shows an example of how to create a dashboard with three dashboard components, and how to resize a component by changing the Rows field's value and using drag-and-drop.

Cloning dashboards

You can clone a dashboard as a base to build another dashboard.

To clone a dashboard, hover over the dashboard in the dashboards data table and click the Clone Definition button 

. The new dashboard opens. It will have the same name as the original dashboard but preceded by "CLONE -".

If a dashboard has multiple clones with similar names, you can use the Created timestamp in the dashboards data table to identify the most recent clone.

Sharing dashboards

You can share a dashboard's URL to enable other users to easily access the dashboard.

Before sharing a dashboard's URL, you will need to make the dashboard public by clearing the Private Dashboard checkbox. Then, open the dashboard and click the Copy URL button

. This action copies the URL to your clipboard. You can then paste it into the required application to share it with other users.

Users you share the dashboard with can view the dashboard, export the dashboard's components, and update the dashboard to display the latest NexJ CRM data. They cannot edit the dashboard. However, depending on their privileges, they may be able to clone the dashboard and edit the clone by locating the dashboard in the All Dashboards tab of their dashboards data table. For more information, see Cloning dashboards.

The data displayed in the dashboard to other users may be different from the data displayed to you, depending on their access level, team assignment, and organizational hierarchy.

Exporting dashboards

To share dashboards outside of NexJ CRM or print them, you can export dashboards in PDF or HTML file formats.

The dashboards export functionality requires additional configuration before it can be used. For more information, see "Setting up the ad hoc reports export and dashboards export" in the technical documentation.

To export a dashboard, select the required dashboard in the All Dashboards or My Dashboards tabs to open the Dashboard Viewer, click the Update Dashboard button 

to include the latest data in the dashboard, click the More Actions button
, and select one of the following menu options:

  • Export Dashboard To PDF
  • Export Dashboard To HTML

When you export a dashboard that includes a Detail type report, only the first 10 records are exported from the details list for the report.

After the export is prepared, you can choose to open the PDF or .zip file or save the file locally.

The HTML files are provided as a .zip file. You can open the HTML files in your browser. You can also use Microsoft Excel to view the individual HTML files provided in the contents folder.

Example: Tracking activities through ad hoc reports

Lucas, a branch manager, needs to regularly track the progress of activities assigned to his branch staff. His team's activity backlog has increased in size over the past two quarters. He wants to get the backlog under control while also ensuring the team's current activities are not affected. To prioritize work assignments and to monitor his team's performance on an ongoing basis, Lucas creates the following reports:

Overdue Tasks

Lucas uses a report shared by another manager as the base for his team's overdue tasks report. After cloning the report and renaming it, Lucas customizes the report, ensuring the following:

  • The Description, Priority, Due Date, Status, and Assign to fields are selected.
  • Filters are applied on the Due Date and Status fields so that completed and canceled activities are excluded, and only activities due today or before are included.
  • The Status field is added as a grouping.
  • The Column Stacked chart type is selected for the visualization, with the x-axis set to Assign To and with the Status grouping added.

The following video shows how Lucas clones the report, edits it to rename it, adds the missing Priority field, changes the operator for the Due Date filter, excludes completed and canceled activities, adds the grouping, modifies the visualization, and saves it before running it.

Upcoming Activities

To track the activities starting in the next 30 days, Lucas uses the Scheduled activity breakdown report template, which already includes most of the fields he needs in the report. He renames the report and makes the report public. He removes the End Time field and adds the Start Time field. He selects the Add Field as Filter menu option for the Start Time field. He sets the Start Time filter to in the next 30 days and sets the Status filter to exclude canceled activities (completed activities are already excluded in the template). He removes the End Time filter. He adds the Start Time field as a grouping. He selects the Summary tab in the report data pane to show the live feedback when he modifies the Start Time grouping. He sets the Start Time grouping to be done by week. He moves this grouping to the top of the list, so that the summary is broken down by the start time first and can be expanded to view other groupings. He wants the visualization to show activities broken down per user per activity, so he verifies that Assign To is selected for the x-axis and adds the Type grouping to the visualization. He retains the Stacked Column chart type, which was preset in the template, and saves the report before running it. He selects the Visualization tab to view the chart, selects the Summary tab in the Report Viewer, and expands some of the items to show resultant groupings.

The following videos shows how Lucas creates the upcoming activities report.

Priority Breakdown

Lucas needs to ensure that high-priority activities are completed as scheduled. An at-a-glance view of upcoming activites by priority level would help him keep track of such activities. He clones the Upcoming Activities report that he set up earlier, adding the Priority field. He changes the x-axis to Priority and selects Pie Donut as the chart mode.

Completed Activities

An important performance metric for Lucas' team are completed activities, so he wants to keep track of the total activities completed by each of his team members in the last 90 days. For this, he could use a Completed activities breakdown report template, but since he only needed a simple report with the overall numbers per agent, he decides to create an activity report with just three fields - Assign To, Activity End Time, and Status. He selects the Add Field as Filter menu option for both the Status and Activity End Time fields and sets the filters so that only activities that were "completed" and in the previous 90 days are included. He configures the visualization as a Bar chart with no groupings added and saves the report.

The following video shows how Lucas creates the completed activities report.

After creating the reports, he proceeds to clone and edit the Activity Management Dashboard, selecting the relevant components from his reports, and reordering and resizing the components as needed. The following image shows an example of a completed dashboard. For more information about cloning a dashboard, see Cloning dashboards.

Activity Management Dashboard example


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.