Standard layout options for PDF/Word/HTML documents

Contents

About

PDF, Microsoft Word, and HTML documents are the most commonly used document types. Set up formatting guidelines to control the document's page size, page breaks, font color, the arrangement of images, etc.

Info: The topic Creating and Managing Documents describes how to customize document names.

Formatting Options

These options control the appearance of the document. Shown in the image below are the main parts of the documents that can be controlled.

Layout of a PDF Form

Global Settings

These settings apply to the entire document.

Paper

  • Paper Size: Choose the rendered page size -- "Letter", "Legal", or "A4".

  • Paper Orientation: Choose between Portrait or Landscape.

Page Breaks

Choose when the document will break to a new page. This is helpful for organizing the document for its viewers, although settings other than "Auto" will increase the length of the document.

"Page Breaks" selector in the PDF editor

Auto

If chosen, the document will break to a new page automatically, whenever there is no longer room to print the next lines of data. Choose this option for the most efficient use of space.

Before all form pages or sections

If chosen, a new dropdown will appear below.

Drop-down to select page break style

Break to a new page: Choose whether the document will break to a new page before showing the next form page, or if should break to a new page before each new form section.

Before specific form pages or sections

This option allows you to customize when the document breaks to a new page. This is useful if certain information from your form is required to all show on the same page, like a summary.

PDF editor - Inserting page breaks before specific pages or sections

  • Break to a new page: Choose whether the document will break to a new page before showing specific form pages, or form sections.

  • Page or Section Unique IDs: Enter a comma-separated list of page Unique IDs (or section Unique IDs, if you chose to break before custom form sections). Find more information on Unique IDs.

Document Layout

These settings control which of the following areas of the document are visible, as well as the data they contain and their appearance.

  • Document Header

  • Document Title

  • Submission Metadata

  • Document Footer

Document Header

"Document Header" section in the PDF editor

Options

  • Show Document Header: Controls if the document has a header or not. If turned off, none of the below settings are available.

  • Show header on first page: Controls if header text appears on the first page. If cleared, the header text appears only on the second page and subsequent pages, if there are any.

  • Left Header Text: Use any combination of DREL and static text to specify a single line of text to be shown on the left of the header. Leave this empty if you do not want any text to show here.

  • Right Header Text: Use any combination of DREL and static text to specify a single line of text to be shown on the right of the header. Leave this empty if you do not want any text to show here.

Document Title

The document title typically contains the logo, and formatted information like the form name, a work order number, or the contact information for your business.

The Document Title shows in the document below the header (if enabled), and above Submission Metadata (if enabled). The Document Title will only appear on the first page of the document.

"Document Title" settings in the PDF editor

Options

Example:

Title and header content of a PDF form

Submission Metadata

This section includes information about the form submission.

"Submission Metadata" in the PDF editor

Options

  • Show Submission Metadata: Controls if the document has a metadata section or not. If turned off, none of the below settings are available.

  • Background Color: Choose a background color for this block. The only available text color is black, so ensure to choose a color light enough that your text will show on it.

  • Excluded/Included Metadata: These are the metadata options available to show in this block. Use the arrow buttons to move wanted options into the "Included" area.

    • Reference Number: The form submission's unique identifier in the TrueContext system. The first half shows the submission date, the second half shows the submission ID.

    • Submission ID: The second half of the reference number (see above) -- this is the "unique" part.

    • Submission Name: The Data Record Name of the form submission.

    • Form Name: The name of the form the submission was made for.

    • Form Version: The version of the above form that the submission was made against.

    • FormSpace Name: The name of the FormSpace the form is in.

    • Submitter Name: The Name and Username of the user who submitted the form.

    • Location: The Geolocation from where the user was when they submitted the form.

    • Address: The address extracted from the location (see above).

    • Submission Date: The date and time of submission, based on the Document Time Zone Source you select on the Document Basics tab.

    • Local Submission Date: The date and time of submission based on the time zone of the submitter’s device.

    • Server Receive Date: The date and time the server received the submission.

    • Device: The type of mobile device the form was submitted from.

    • Device Version: The software/OS version on the mobile device the form was submitted from.

    • Mobile App Version: The TrueContext Mobile App version used to submit the form.

Document Footer

"Footer" section of the PDF editor

  • Show Document Footer: Controls if the document has a footer or not. If turned off, none of the below settings are available.

  • Show footer on first page: Controls if footer text appears on the first page. If cleared, the footer text appears only on the second page and subsequent pages, if there are any.

  • Footer Text: Use any combination of DREL and static text to specify a single line of text to be shown on the left of the footer. Leave this empty if you do not want any text to show here.

  • Page Number: If the footer is enabled, a document page count will appear on the right of the footer.

Appearance

This section controls the visual appearance of core parts of a form (pages, sections, and questions) in the document. This is a good opportunity to change colors to match your company's custom branding.

Control the appearance of:

  • Page Headings

  • Section Headings

  • Repeat Entry Headings

  • Content (answers and questions)

  • Table Layouts for Repeatable Sections

headings.png

Table Layout for Repeatable Sections:

Page Headings

This controls how the name of the form's pages will be shown in the document.

Page Headings appearance in the PDF editor

  • Solid Backing/Underline: Controls if the page heading will have a solid colored background behind it, or if it will have a colored underline instead.
  • All Caps: Will show the page name in all caps.
  • Bold: Will show the page name in a bold font.
  • Backing Color/Underline Color: Choose either the solid background color behind the page name, or the underline color.
  • Font Color: Only available if you have a solid backing. We recommend black, white, or gray. Ensure there will be enough contrast with the backing color, so that the text will be easily readable.

Section Headings

This controls how the name of the form's sections will be shown in the document.

Section Headings appearance in the PDF editor

  • Solid Backing/Underline: Controls if the section heading will have a solid colored background behind it, or if it will have a colored underline instead.

  • All Caps: Will show the section name in all caps.

  • Bold: Will show the section name in a bold font.

  • Backing Color/Underline Color: Choose either the solid background color behind the section name, or the underline color.

  • Font Color: Only available if you have a solid backing. We recommend black, white, or gray. Ensure there will be enough contrast with the backing color, so that the text will be easily readable.

Repeat Entry Headings

This controls how the title for each entry into a repeatable sectionClosed A Repeatable Section is a subform that contains a set of related questions. The data captured is “repeating”, because the field user can complete the same subform more than once, which creates multiple entries. will be displayed.

Repeat Entry Headings appearance in the PDF editor

  • Solid Backing/Underline: Controls if the heading will have a solid colored background behind it, or if it will have a colored underline instead.

  • All Caps: Will show the heading in all caps.

  • Bold: Will show the heading in a bold font.

  • Backing Color/Underline Color: Choose either the solid background color behind the heading, or the underline color.

  • Font Color: Only available if you have a solid backing. We recommend black, white, or gray. Ensure there will be enough contrast with the backing color, so that the text will be easily readable.

Content Layout

This controls how the questions and answers in your form will be displayed in the document.

Content Layout appearance in the PDF editor

  • Question Column Width/Answer Column Width: Controls how much of the page width will be given to the question text vs. the answer text.

  • Text Formatting: Make all question text bold, all answer text bold, or none of the text bold.

  • Section Overrides: This allows you to specify different answer/column widths for different sections of your form. For example, you may have one section with very long questions, and very short text. For this section, specify the above settings, then list the Unique IDs of each section you would like these settings to apply to.

  • Boxed/Non-Boxed Layout: Controls if there is a line/box around the questions and answers or not. Generally, if your section headings do not have a solid backing, a non-boxed layout looks better.

Table Layouts

This section allows you to lay out specific repeatable sections in your form as a table.

  1. Select Add a Table Layout.

  2. Enter the Unique ID for the Repeatable Section you want to lay out as a table.

  3. Add columns to display. Enter whatever you'd like as the Header, and enter a single Unique ID per column. This is the question whose answers will be shown in the column.

    Creating a table layout in the PDF Editor

  4. Apply additional formatting as desired.
    Additional table layout settings in the PDF editor

If your table layout is not working on your produced documents, double check that your Unique IDs are correct for both the section and the questions. See the picture below as a reference.

A Repeatable Section's Unique IDs can be found in the righthand column of the table.

Answer Format

This section controls how the document displays different question types.

The Answer Format tab of a new PDF document template options.

Button Group

You can use these options to customize how answers to Button Group questions display in the document.

  • Use display colors for answers: (Default) Button Group answers display in the same color as they do in the Mobile App. This helps you find an answer if your team uses Button Group colors to represent something specific, such as Pass/Fail inspection statuses.

  • Show value: The document shows the server value of the submitted answers. This may be different from the display text, depending on how you configure the answer options in the Form Builder.

  • Show display text: (Default) The document shows the display text of the submitted answers. This is the same text the technicians see in the Mobile App. This may be different from the server value, depending on how you configure the answer options in the Form Builder.

Use these options to change how Dropdown, Radio Button, and Multiselect answers display in the document.

  • Show value: The document shows the server value of the submitted answers. This may be different from the display text, depending on how you configure the answer options in the Form Builder.

  • Show display text: (Default) The document shows the display text of the submitted answers. This is the same text that the technicians see in the Mobile App. This may be different from the server value, depending on how you configure the answer options in the Form Builder.

Attachments

  • Show photos, sketches and signatures in the document: If ON, these will be shown as images embedded in the document.

  • Show attachment filenames in the document: Print the filenames of attachments in the document, below the images. This is helpful if the attachments are also included as separate files when sent through a data destination, so they can be easily identified.

  • Image/Signature Max Width: Defining this limits the size of an image.

  • Image Compression: Adding compression reduces the size of the document. 0.9 compression is low compression, and 0.1 is highest compression.

    Most documents should use 0.9 compression, which applies a small amount of compression and doesn't noticeably alter image quality. If you are encountering problems in generating documents, try increasing compression by lowering the number. If you are emailing or sending the images as separate attachments, the attachment will still be full-size; this setting only compresses images within the document.

  • Show barcode images: Will render any scanned barcode as an image, instead of just listing the barcode value.

  • Include attachment hyperlinks to the Web Portal: Any attachments can be selected to be viewed in the TrueContext Web PortalClosed The TrueContext Web Portal is a web application used to manage security settings, forms, FormSpaces, other users, Data Sources, and Data Destinations.. This will only work if the person viewing them has a TrueContext account with permissions to view the form submission.

Exceptions

Exceptions are used to categorize problems identified during the course of a field technician's work as the user completes a form.

  • Show answer exceptions in the document: If set to ON, answer exceptions will be shown in the document.

  • Show exception background color in the document: Enabling this will allow your selected exception colors to show in the document, adding color-coding in the same way it does for field technicians' work.

  • Show exception custom messages in the document: Enabling this shows any error messages you have configured and embeds them in the document if exceptions have been triggered.

Additional Comments

Form designers can use Additional Comments to ask for more details about an answer. If the answer meets specific criteria, the form prompts the field user for additional information. You can choose to hide Additional Comments in your documents. This is useful when you use Additional Comments for internal-only information and you want to exclude them from customer-facing reports.

Do you want your document to include Additional Comments?

  • If yes, keep the Show additional comments in the document toggle switched on.

  • If no, switch off the Show additional comments in the document toggle.

Info:The topic Additional Comments on Questions describes in more detail how additional comments work.

Date/Time Formats

This controls how answers that include dates and/or times will be shown in the document.

Style Format: Choose Short, Medium, Long or Full depending on how much detail should be shown.

Short: Date: 11/27/13 Time: 6:50 PM
Medium: Date: Nov 27, 2013 Time: 6:50:40 PM
Long: Date: November 27, 2013 Time: 6:50:40 PM PST
Full: Date: Wednesday, November 27, 2013 Time: 6:50:40 PM PST

Custom Format: Create custom date or time formatting using the following syntax.

Date Formatting: yyyy (Year) MM (Month) dd (Day)
Time Formatting: hh (hour[12 hour syntax]) a (AM/PM Marker) HH (Hour[24 hour syntax] mm (Minute) ss (Second)
Timezone: z (up to 4 z's) (Time Zone) Z (up to 3 Z's) (Time Zone as Offset/City)

Elements of this syntax can be combined. For example, "hh:mm a z" could output the time as "6:50 PM PST."