A task form's PDF settings define the content, language, appearance and filename of its task report. The settings for automatically generating and sending the report are in the same place. These settings also apply to the form-specific task report used on Android and iOS.

Open the form's PDF settings

Open Task forms from the browser navigation. On the Task forms tab, select the form's name or the pencil icon on its row, then open the PDF settings tab in the editing window. To change the settings, you need permission to edit that task form. Read-only permission does not allow you to change them.

The Options section of the tab contains the language, content, layout and sending options, as well as Additional text. Below it, you can separately expand Report logo, Custom PDF filename, PDF report headers, Device card fields in the report and Styling options.

The form-specific task report and the browser PDF export of task details are separate functions. The shared heading and logo for task exports in the service settings do not change this report. See the instructions for configuring shared PDF export settings for the service.

Select the information needed in the report

A content option includes existing information; it does not add missing entries to the task.

  • Include work log entries shows the task's work log entries by user. Duration is calculated as the difference between the entry's start and end times and displayed in hours and whole minutes. Any fraction of a minute is omitted: for example, 1 h 2 min 59 s appears as 1 h 02 min. An entry that has not ended shows a dash for its duration. This is not a machine hour meter reading.
  • Include comments includes the task's comments with their authors and timestamps. A field-specific comment entered in a form field appears alongside that field regardless of this option.
  • Include used products shows the name, code, quantity and unit of a product recorded on the task. This option does not add product prices to the report.
  • Include billing information shows the internal reference, external reference and order number when these have been recorded. It does not create an invoice.
  • Include task images in report includes images attached to the form's sections. This option does not mean that all files belonging to the task or Spot are included in the PDF.
  • Include machine hours shows the machine hour reading saved on the task when machine hour tracking is enabled for the Spot. This is a meter reading, not the sum of the task's work log entries.
  • Include customer data shows the completed name, customer number and address details of the first customer linked to the task. For a contract task, the contract number is also included if one exists.
  • Include signatures includes signatures saved on the task. The option itself does not collect signatures.

Show asset folder shows the Spot's folder and its hierarchy. Show completion time shows when the task was completed, and Show completion remarks shows the completion remarks saved when the task was completed. Completion remarks, task comments and field-specific comments are separate information.

The initial settings for a new PDF configuration include images, the folder, completion time and completion remarks. Work log entries, task comments, used products and billing information are not included. Always check the saved selections for the form you are editing.

Add the Spot's device card data

Open Device card fields in the report and select Add new attribute. From the list in the row that appears, select the Spot data field to print. Add any other fields you need and drag the rows into the desired order. The trash icon on a row removes the field from the report selection; it does not delete the data field or its value from the Spot.

The values of the selected fields are retrieved from the Spot when the report is generated. They are not historical copies from the time the task was performed. Only selected fields that exist on the Spot are printed. Show filled fields only omits empty values from this part of the report. It does not hide empty inspection fields in the task form.

Adjust the layout, language, headers and footers

In the Options section, Display sections in a single column changes the form's sections from two columns to one. Display label and value in line places the field's label and value side by side instead of on separate lines. Long content may still wrap.

Compressed layout reduces the separate page breaks between images, additional text, additional data and signatures. It also changes the placement of additional data. The number of pages depends on the content, so this option does not guarantee a single-page report. Without this option, the form has more separate content pages.

Language determines the language of the report's translated standard text. It does not translate headings, answers, comments or header and footer text that you have entered yourself. System default uses the language in use when the report is generated, unless a shared default language has been set.

Default for every PDF report next to the language selection makes the selected language the shared default for reports from other task forms as well. The shared default language overrides the form's own language selection. Saving a new shared default language clears the previous corresponding default selection. The shared language default and shared styling default are separate options.

Open Report logo and select Add PDF report logo. The allowed formats are PNG, JPG/JPEG, BMP and GIF, and the file must be smaller than 25 MB. The logo appears on the left at the top of the report. Uploading and saving a new logo replaces the previous one.

Open PDF report headers. Header text center and Header text right add text to the header. Footer text left, Footer text center and Footer text right add text at the bottom. Each field allows up to three lines and a total of 255 characters.

Additional text in the Options section adds shared supplementary text to the report. The maximum length is 4096 characters, and stored formatting also uses part of this allowance. The text's position in the report depends on the other content and the compressed layout; do not assume it will always appear on the second-to-last page.

Enable styling

Open Styling options. Adjust Font, Font size and Font color in the Headers and footers, Info pane, Sections and Additional task data groups. For sections and additional data, you can also select a Background color. The font choices are Noto Sans, Serif and Courier. The font size range is 10–15 px for sections and 10–18 px for the other groups.

Select Styling options enabled for this task form to apply the form's own style. Without it, the report uses the standard style unless a shared default style has been defined.

Default for every PDF report in this area also applies the style to reports from other task forms. The shared default style overrides the forms' own styles, even if their own styling is enabled. The shared default style is also used without selecting its form-specific enable option. Saving a new default style clears the previous default style selection. This does not copy the logo, header and footer text, content selections or filename to other forms.

The form's content and the report's appearance are separate things: styling does not replace missing inspection fields. Section icons are selected in the form's content settings. If you hide icons, pay particular attention to the readability of selection field results. See configuring form sections and fields.

Define the PDF filename

Open Custom PDF filename. Drag the parts you want into the four drop slots in the order in which they should appear in the name. You can use the completion time, the Spot's name, the task's title and an Additional text part. For the last of these, enter your own text, up to 64 characters. The cross in a slot removes that part from the filename selection.

The completion time is shown in Finnish time in the format day.month.year_hour.minute. The parts are joined together, spaces become underscores and prohibited special characters are removed. Periods, hyphens and underscores are allowed. The filename stem is truncated to 128 characters before the .pdf extension. For example, the additional text Huolto and the Spot name Pumppu 1 produce the filename Huolto_Pumppu_1.pdf. Without a custom name, the filename is task_pdf_report.pdf.

Check report generation and recipients

Create the PDF report every time in the Options section determines the automatic report selection. Clearing it does not guarantee that a PDF will not be generated: on mobile, report generation also starts when a task with a form is completed. The actual PDF is generated from a completed task; a task under inspection does not yet meet this condition.

Default to addresses defines the report's default recipients. If the field contains addresses, saving enables Create the PDF report every time even if you cleared it. Clearing the addresses does not automatically disable this setting: check both selections separately. Sending associated with report generation combines the default recipients with the recipients entered for that particular execution.

Mail the report to the current user primarily adds the email address of the user who started work on the task as a recipient. If that address cannot be found, the email address of the user who marked the task as completed is used. The option therefore does not refer to the user editing the settings. Sending requires the report to be generated successfully and a recipient address to be available.

The separate report email function on Android and iOS sends an already generated report to the specified addresses. It does not update the content of an existing PDF with the new appearance settings.

Save and check the result

  1. Select Save at the bottom of the editing window and make sure no error is reported when saving.
  2. Open the form again and check the PDF settings selections, recipients and shared defaults.
  3. Perform a suitable test task using this form and make sure the task is completed. If the execution workflow offers an option to generate a report, select it.
  4. Open the resulting task report and check its content, language, filename, long headings, section boundaries and the readability of the headers and footers. Also check that any email is received.

The Preview report button in the Styling options area is available only after the form has been saved for the first time. Its preprocessing saves only styling changes, so it does not replace the Save button for saving other PDF settings or the form's content. Verify the result in an actual task report: task data and images may take up more space than the sample content.

Saving the PDF settings does not change the task's answers, recorded history or an existing saved PDF attachment. A file that has already been downloaded also remains unchanged. Check the new settings using a test task completed after the settings have been saved; downloading or sending an old report again does not update it.

If information is missing, first check that it has been recorded in the correct place and that the corresponding content option is enabled. Also check the shared default language and default style if the form's own selection does not seem to have an effect. Opening a report is described in inspecting a task and viewing its task report.