Edit the OnPoint PCR engagement letter

Content in this topic requires OnPoint PCR.

Sample standard letters are included in OnPoint PCR. You can review and edit the engagement letter draft to add your own wording and meet requirements and firm preferences in OnPoint PCR before it is sent to the client to complete, sign and return.

To edit the engagement letter:

  1. Open the engagement letter and select Edit () at the top of the document. The text toolbar appears.

  2. Once you're satisfied with the contents of the engagement letter, select the signoff icon ().

  3. Choose the applicable role for your signoff. Once the content is reviewed, you can send a copy to your client.

While editing the letter, you will also see the following functionalities:

Field

Value

Instructions

Contains information about the contents of the letter, and includes instructions for finalizing the draft.

Placeholders

Tracks your progress on placeholders and displays the number of placeholders that haven’t been replaced with specific information related to the engagement, organization or client. The top of the letter displays the number of placeholders awaiting responses.

Tip: Click the remaining placeholders to quickly navigate to the placeholders in the document.

Shortcut to create document-specific issues.
Documents with issues.
Print the document.
Review tools to allow a reviewer to see what has been changed in the document.

Turns on document edit functionality. Edit actions include:

  • Page break

  • Table of Contents

  • Text Area

  • Guidance

  • Grouping Area

More actions. More actions include:

  • Hidden items

  • Headers and footers

  • Guidance - display document guidance options

  • Print settings - set page layout and paper size

Sign off the document.

Replace text and field placeholders

The engagement letter content includes placeholders for some text and fields that you need to replace with specific information related to your engagement, organization or client.

To edit the text in a letter, select Edit (). You can begin typing in any Text Area to customize the wording. Throughout the letter, fields that are highlighted gray pull their responses from other areas of the engagement, or from the Cloud entity.

For example:

Replace text.

The Placeholders indicator located under the engagement letter document title tracks your progress on placeholders. It shows the number of placeholders that haven't been replaced by actual information. You can also select the indicator to navigate to the next empty placeholder.

Remaining placeholders.

To replace a text placeholder:

  1. Select the field placeholder.

    Tip: The blue drop-down fields in the document are field placeholders.

  2. At the Text Placeholder popup, replace the placeholder text and select Save.

    Note: Placeholders are in the form of picklists or input values. You can either make a selection from the available options or manually type a value. If you don't want to change the placeholder text, you must select the placeholder and select Save at the Text Placeholder dialog so it's removed from the count at the Placeholders indicator.

To replace a field placeholder:

  1. Select the field placeholder.

    Tip: The blue drop-down fields in the document are field placeholders.

  2. Select a value or specify a date as indicated in the placeholder field.

Change engagement glossary terms and dynamic text

Note: You can only change an existing glossary term or a dynamic text output if the override option is enabled in your product.

An engagement glossary contains terms. Terms are words and phrases that can be reused throughout the product. When a term is changed, it is changed everywhere the author defines it.

Dynamic text fields change if certain conditions are met. For example, if the client responds 'Yes' to a procedure in a checklist, then 'Agreed' shows in the dynamic text field.

Your documents may contain terms from the glossary or dynamic text fields. Depending on your product, you may be able to override glossary terms and dynamic text outputs.

To change an engagement glossary term or a dynamic text output:

  1. Select the document's text area where you want to change.

    Note: Areas highlighted in gray are either glossary terms or dynamic text fields.

  2. Select the glossary term or dynamic text to open the Data Link dialog.

    Note: If you select a glossary term, you can select information () to see the number of places that term is used.

  3. Change the Output as desired and select Save.

When the Output condition is met, the text changes in all the places it's used in the engagement. If a different condition is met after the change, the Output changes to match the configured output text for that condition.

You can insert the firm logo in any text area or in the document head or footer.

To insert the firm logo:

  1. Select the text field where you want to insert the logo.

  2. Select Insert Logo Placeholder () at the formatting toolbar.

Note: You can only upload a firm logo in the firm template. To access the firm template, you must have the Settings Admin role or similar. For more information, see Built-in roles and Assign security roles.

Add a page break

You can add a page break anywhere in the document to manually mark where a specific page ends and a new one starts. This allows you to control the page layout for printing.

To add a page break, select +Add section | Page Break. A page break is inserted with a default title Page Break. You can select the default title to change it. Note this title is not part of the document content and will not be displayed when printed.

Note: You can’t add a page break in an empty grouping area. You must add text areas or guidance sections.

  • To add text areas, select +New section | +Text Areas.

  • To add guidance sections, select +New section | +Guidance Sections.

To delete a page break, select Settings () | Delete | Yes.

Add a table of contents

You can add a table of contents to make it easier for users to easily navigate through your letter.

To add a table of contents, select +New section | +Table of Contents. A table of contents is inserted with the default title Table of Contents. You can select the default title to change it. Note that the title is not part of the document content.

To delete a table of contents, select Settings () | Delete | Yes.

Set up the print options

The Print () button converts the document to a PDF format for users to print or save. Note that guidance sections are never included in the PDF.

To set up print options:

  1. Go to the Document Map, then select More actions () | Print Settings.

  2. If you want to have different settings for a page break or a grouping area or the Table of Contents, select Settings () | Edit Print Settings.

    Specify the preferred settings for Letterhead, Page Size and Margins.

  3. Select Landscape to change the page orientation.

  4. The default is Portrait.

    Clear the Count in page numbering check box if you want page numbering to start after the Table of Contents page.