Skip to content
D
Documentation

Principals Report

reference
8 min readUpdated

Use the Principals Report to prepare a report for selected accounts, choose its reporting period and content, generate it, and download it as a PDF.

Principals Report overview

The Principals Report is a Dashboard report tab for reviewing account-related sales information in one report. Select one or more accounts, choose the period and report sections, and prepare charts or detail lists for those accounts.

The report settings group the available output into report sections and list variants. Report sections include narrative content, charts, an overall analysis, and lists. List variants are the inquiry, offer, order, delivered, lost, and cancelled job lists.

If you need to…Go to
Understand the Dashboard area that contains the reportDashboard overview
Prepare the account selection and report nameBefore you start
Recognize the controls on the report pageOpen the report and identify its controls
Choose a period and report contentSet the reporting period and report options
Add narrative contentAdd introduction and outline content
Generate and review the reportGenerate and read the report
Narrow a detail listFilter an available detail list
Diagnose a stopped generation attemptWhen report generation fails
Download the report or continue to broader report navigationContinue from the report

Before you start

The report is prepared from selected accounts and a report name, rather than from a business record that you save. Have the account records you want to include available for selection.

Have or knowWhy it matters
One or more account recordsAccounts is required and accepts multiple selections.
A report nameReport is required.
Access to the qualifying Dashboard tab and subscription conditionThe report page appears only when the Dashboard tab and subscription condition allow it.

Open it from the Dashboard reporting flow. The Principals Report appears when the Dashboard is on the qualifying report tab and the subscription condition allows it.

Open the report and identify its controls

The Principals Report page is the report setup surface. Its main controls identify the accounts, report name, period, settings, narrative content, generation action, and PDF action.

Prerequisites

  • Have access to the Dashboard report tab.
  • Have the accounts and report name ready.

Steps

  1. Open the Principals Report from the Dashboard reporting flow.

  2. Locate Accounts for the account selection.

  3. Locate Report for the report name.

  4. Locate Time Frame for the reporting period.

  5. Select one of the report actions in this table.

    ActionPurpose
    SettingsConfigure report sections, charts, and lists.
    Introduction & OutlinePrepare the narrative sections.
    Generate ReportStart report generation.
    Download as PDFDownload the report as a PDF when it is ready.
The Principals Report controls for accounts, report name, time frame, settings, narrative content, generation, and PDF output

Result: The Principals Report setup controls are on screen, including Accounts, Report, Time Frame, Settings, Introduction & Outline, Generate Report, and Download as PDF.

Set the reporting period and report options

The reporting period limits the dates used by the report. The settings determine which report sections, charts, and lists are included before generation.

Prerequisites

  • Open the Principals Report.
  • Select the accounts and enter the report name.

Steps

  1. In Time Frame, follow the applicable row.

    If you need to report on…Select or enter
    The current yearThis Year
    A named calendar yearDefinite Year, then a year from 1990 through the current year
    The previous twelve-month periodlast 12 months
    A custom date rangeFrom / To, then the first date in From and the last date in To; check that From is not later than To
  2. Select OK in the time-frame popup.

  3. Select Settings.

  4. Select the report content options from the table.

    If you need to include…Select
    All available report settingsAll
    Running-job contentRunning jobs
    Running firm-offer statusStatus of running firm offers
    Running-order statusStatus of running orders
    Lost-job reasonsReasons for lost jobs
    Booking trendsBookings over time
    Detail listsShow Lists
    Account-based filteringClient
    Product-based filteringProduct Type
  5. When a chart is enabled, choose its chart type from Bar or Pie.

  6. When Bookings over time is enabled, choose Monthly where that period is required.

  7. Select OK in the settings popup.

The chart choices appear only when the related chart is enabled. Running jobs is a settings option that is disabled in Settings. Valid changes to saved settings can require the report to be generated again.

The Principals Report page with its report setup controls and available actions

Note: The choices in Accounts depend on the accounts available to you.

Result: The report has a selected time frame and saved report options for its sections, charts, lists, account filter, and product filter.

Add introduction and outline content

The Introduction & Outline popup holds the narrative sections that accompany the report's figures and lists.

Prerequisites

  • Open the Principals Report.
  • Set the reporting period and report options.

Steps

  1. Select Introduction & Outline.
  2. Enter the report introduction under Introduction :.
  3. Enter the sales discussion under Sales Analysis :.
  4. Enter the lost-opportunity discussion under Lost Opportunities and Competition :.
  5. Enter the complaints and difficulties under Client Complaints and Difficulties :.
  6. Enter the improvement proposals under Suggestions for Business Improvement :.
  7. Enter the booking expectations under Booking Forecast :.
  8. Enter the closing text under Conclusion :.
  9. Confirm the entries in the report introduction and outline popup.

Result: The report introduction and outline content is prepared for the report.

Generate and read the report

The generated report brings together the enabled charts, summaries, section navigation, and available detail lists. The report sections are conditional: a section appears when its report setting and report data allow it.

Prerequisites

  • Select the accounts and enter Report.
  • Set Time Frame and Settings.
  • Complete Introduction & Outline when narrative content is required.

Steps

  1. Select Generate Report.
  2. Use the report navigation entries to move to Running Jobs, Status of running firm offers, Status of running orders, Sales Overview, Reasons for lost jobs, Status of submitted offers, Bookings over time, Deliveries over time, or Overall Analysis.
  3. In the job summaries, read Jobs (Count) and Jobs (Value).
  4. In the submitted-offer summary, read Hit Rate (count) and Hit Rate (value) when submitted-offer data is available.
  5. In Overall Analysis, use the time view and client view to compare submitted offers and received orders by count and value.
  6. Select a report section to read its charts and summaries.

Result: The report view contains the enabled report sections and their available charts, summaries, and analysis views. Generate Report is disabled while the report is ready or while generation is in progress. The chart and setup controls are shown before a report is generated.

Filter an available detail list

Detail lists show job information grouped by the report list selected in settings. Each available list provides a filter row and a filter at the column heading.

Prerequisites

  • Generate a report with Show Lists selected.
  • Open a list that is available in the generated report.

Steps

  1. Select the detail list that matches the work you need to review.

    If you need to review…Select
    Current inquiriesCurrent inquiries
    Current offersCurrent offers
    Current ordersCurrent orders
    Completed deliveriesDelivered jobs
    Lost workLost jobs
    Cancelled workCancelled jobs
  2. Enter a value in the filter row to narrow the list.

  3. Use the filter at the column heading for a column-specific filter.

  4. Read the columns available in the selected list, such as Job no., Client, Offer price, Order price, Backlog, Expected delivery date, Lost reason, and Cancellation reason.

Result: The selected detail list is narrowed by its filters, and its visible headers identify the job information available in that list.

When report generation fails

Report generation checks the required inputs before it processes the report. A missing account selection has a report-specific validation message; a processing failure uses a general error message.

What appearsWhat to do
RequiredComplete the required field marked on the report setup form.
Please choose one or more principalsSelect one or more records in Accounts, then generate the report again.
An error occurred while processing your requestReview the report inputs and submit the report again.

The report-specific account-selection check applies when no principal or client is selected. The general processing message identifies a processing failure rather than a particular field.

Continue from the report

After the report settings are valid, the report provides a PDF action for continuing from the report view. The PDF action follows the report's generated state and calls the download path.

Prerequisites

  • Have valid report settings.
  • Have generated report content available for download.

Steps

IfConsequence
The generated report is availableThe PDF is available for download.
Valid saved settings require another generationThe PDF is unavailable until the report is generated again.
  1. If valid saved settings require another generation, select Generate Report.
  2. After the generated report is available, select Download as PDF.
  3. Open the broader Reports area when you need the application's other report navigation.

Result: The report's PDF download action is available from the generated-report state, and the broader Reports area remains available for other report navigation.

Was this page helpful?

Need help using the product?

Principals Report — PAMS Fresh Generation