Reporting and Printing

When it’s time to share your project with colleagues or the outside world, in addition to exporting to a variety of formats, OmniPlan offers a robust and customizable set of printing features — and with OmniPlan Pro, an all-new interface for creating beautiful custom reports.

Printing in OmniPlan

OmniPlan offers a highly flexible set of options for printing your document straight from the standard print dialog of Mac OS X.

Choose File ▸ Print (Command-P), and choose Show Details from the pop-up menu in the print dialog to see OmniPlan’s print options.

OmniPlan print-time options for content display.
  1. You can print the Task View, the Resource View, or the Network View — whichever one is open in the main window. In Task and Resource views you can choose whether to print the outline, the Gantt chart or resource diagram, or both; since Network View has no outline, you’re taken right to the headers and footers section instead.

  2. The dimensions are calculated based on the size of the project and the scale set in the percentile field here. When you change the width or height, the other one changes accordingly. Note that this overrides the Scale setting in the Page Setup dialog. When printing in Network View, a Scale percentage setting is available in the headers and footers section.

  3. You can choose whether to include notes when printing from the outline, either as displayed or all expanded. Task and resource groups can be printed as displayed in the project, or all expanded or collapsed.

  4. You can use the Cropping settings to chop off any part of the project you don’t need. An overview of your project is here. To define the area to print, resize the cropping box by dragging its left or right edge, or move the box by draging its center. If you enter dates in the From and To fields, the cropping box updates to match.

  5. The preview shows what your project will look like on paper. Use the buttons to step through the pages and get an idea of the scale and layout.

  6. When you have your print options set up just the way you like, you can use the Presets menu to Save Current Settings as Preset. You can choose whether the preset applies to the currently selected printer or all printers, and view and edit your new preset — along with others — from Show Presets in the Presets menu.

  7. As with other applications that use the Mac OS X printing system, you can “print” to a PDF file instead of to real paper.

Saving a new printing preset from OmniPlan 3’s print dialog.

Note
When printing from Network View, the scale of the diagram in the view itself determines the initial scale at which it will be printed via the print dialog. You can edit this with the Scale control in the print dialog, or by changing the scale in Network View (Use (-) and (+) or the zoom controls in the bottom right corner of Network View to zoome out and in).

In addition to the print dialog options described above, OmniPlan supports the standard Mac OS X Page Setup dialog; choose Page Setup from the File menu to access it. You can set the paper size, print orientation, and document scale here; this information is saved with the document.

Customizing Headers and Footers

Headers and footers can be customized extensively for printing by choosing Headers & Footers from the dropdown menu in the Print dialog’s detail view.

Header and footer customization options.
  1. Use this menu to choose where custom headers and footers will appear in your printed document. Options include the Master Page (applied to every page printed, unless overridden by another page style), the First Page, Odd Pages, and Even Pages.

  2. This Scale setting appears when printing from Network View, and controls the scale (as a percentile) at which the document is printed relative to its original size.

    Scales for printing from Task and Resource Views are defined in the Dimensions section of the print dialog’s Content details.

  3. As you update your custom headers and footers, changes are reflected in the print preview to give you an idea of how your document will look on paper.

  4. The header and footer sections each have three fields that can be customized: left, right, and center-justified. You can enter custom text here, or:

  5. Use the Insert menu to add information automatically derived from your document to a header or footer field. These automatically generated attributes include:

Note
If you print the project while a filter is on, only the visible tasks are included in the printed copy.

Using the Report Window (Pro)

With OmniPlan 3 Pro, we’ve prepared some great new reporting templates for your project that you can use to print or export your data with a more polished and easily readable look.

To preview your project with any of the available templates, use the Reports button in the toolbar or choose File ▸Report... (Option-Command-R) to access the new HTML reports interface. You can print or export your report with the chosen template directly from the interface.

The Report window in OmniPlan Pro.
  1. Use the dropdown menu to choose the template you’d like to use to print or export your project.

  2. Swipe or scroll horizontally to browse the available report types in the current template. You’ll see the report types duplicated in the body of the report as well — this is to provide navigation internal to the report when it’s exported as HTML.

    Available report types include:

    • Project Overview — An overall project status report, highlighting project variance, completion percentage, and cost.
    • Task Report — A report on the status of project tasks, as shown in the outline of Task View.
    • Resource Report — A report on the status of project resources, as shown in the outline of Resource View.
    • Earned Value Analysis — A report on the earned value of tasks in your project, as shown in the outline of Task View.
    • Gantt Chart — An image-based snapshot of the current status of the Task View’s Gantt chart.
    • Resource Timeline — An image-based snapshot of the current status of the Resource View’s timeline.
    • Monte Carlo Simulation — A report including simulation results estimating the best, worst, and expected cases for cost and completion time of the milestones in your project.
  3. Use the Reload Report button to generate an up-to-date version of the report based on any new changes made to your project.

  4. Use the Export button to generate a PDF or HTML exported copy of your full project report (including all of the report types available). Details on the contents of an HTML Full Report can be found below.

  5. Use the Print button to print the currently selected report type using the standard Mac OS X print dialog options. The option to save the print output as a PDF file is also available here.

  6. This is the HTML preview of your report, representing how it will appear when exported.

When you choose the HTML Full Report option from the Export dialog of the Report window, you’ll have the option to pick a location in Finder to save the report.

The product of exporting a report to the Finder as HTML.

Upon saving, a folder is created that contains a full report of the project in HTML format. Depending on the template used for export, the following items may be included (the built-in SeriousBusiness template includes all of these):

Note
While both Apple Calendar events and Reminders checklists are exported using the same file format (.ics), OS X is smart about figuring out which one goes where, and will prompt you with the correct location to add your scheduled items when you double-click the file.

Once you’ve exported your full report, you can open and print individual pages in Safari, send Calendar events and Reminders to your team, or edit the CSS and HTML for a pixel-perfect representation of your project status.

Customizing Reporting Templates (Pro)

With some knowledge of HTML and CSS, you can make your own HTML templates for printing and exporting. Get started with your custom template in a few quick steps:

  1. First, go to the HTML pane of OmniPlan Preferences.

  2. To create a new template, select an existing template and choose Edit a Copy from the gear menu below the list.

  3. Enter a name for the template and save it in a convenient location.

  4. The new template opens in Finder; it is a folder of HTML and CSS files that you can customize to your liking.

Creating a custom HTML template from an existing one.

Note
Due to security changes in OS X, HTML templates created in versions prior to OmniPlan 2.3 are automatically relocated and not available for direct editing. To change the contents of a migrated template, select it and choose Edit a Copy from the gear menu.

When you have the template set up the way you want, you can manage it from the HTML Preferences pane and choose it in the Report Window as a template for printing and exporting.

A custom HTML template available for management via HTML Preferences.

Custom Template Tokens

HTML reporting templates use a special syntax for inserting data from your project. Open one of the HTML files in the text editor of your choice, and you’ll find standard XHTML interspersed with OmniPlan tokens that look like this:

{@Token Name@}

These tokens are placeholders for data about the project as a whole. When the template is used to export an OmniPlan file, each token is replaced by the data corresponding to the token name.

A reference for the various available tokens follows:

Project Tokens

Stylesheet Token

If exporting a full HTML report, a link to the stylesheet as an external file. This lets all of the exported HTML files link to the same stylesheet.

<link rel="stylesheet" href="include/style.css"type="text/css" />

If exporting just one HTML page (a task list or resource list), an embedded copy of the stylesheet. This keeps everything in one HTML file.

<style type="text/css"> [...] </style>

Loop Tokens

These work like open/close HTML or XML tags. When the export happens, OmniPlan cycles through everything between the opening and closing tokens, inserting data about each task or resource. The Assignments loop has to happen inside the Resources loop, as it lists tasks that are assigned to a particular resource. Make sure that you include the closing token, and that your task-specific or resource-specific tokens are between the appropriate loop tokens.

Tip
A handy option for a svelte template is to remove the {@Assignments@}{@/Assignments@} section from the Resources loop. {@Resources@} gives you each resource, while {@Assignments@} gives you each assignment for the current resource; if you omit the {@Assignments@} that leaves just the resource summary info. This is demonstrated in the index page of the built-in Printer Friendly template.

Tokens for Tasks

These tokens can be used inside the Tasks loop or the Assignments loop of a resource.

Tokens for Resources

These tokens can be used inside the Resources loop.

Path Tokens

These provide the path to a particular page in the HTML export. You can use these to create links between pages; for example:

<a href="file:{@TaskReportPath@}">

Earned Value Analysis Tokens

These tokens correspond to the columns employed in the outline of Task View by the Earned Value Analysis feature.

Monte Carlo Simulation Tokens

These tokens correspond to values used in computing Monte Carlo simulations to estimate milestone completion. They don’t run simulations themselves; rather, they use the most recently computed results for your project.