Skip to content
D
Documentation

Templates

reference
8 min readUpdated

Templates at a glance

A template is the company document or email content used in inquiry, offer, order, procurement, inspection, and invoice work. Administrators use Templates to maintain those documents, the list of available variables, and the email wording associated with a document type.

The list identifies each entry by its Template type, Uploaded file name, and Uploaded on date. Use the row's available action to download a sample, download the company version, upload a company document, download the variable list, or edit the matching email content.

If you need to…Go to
Identify the document or email content to maintainFind a template
Choose the task for a template rowChoose the right template action
Download a sample, company file, or variable listDownload a template or the variable list
Upload a company documentUpload a company template
Edit email contentEdit a document template
Upload the variable listUpload the list of variables
Understand an error or unavailable actionWhen a template action fails
Return to the configuration areaConfiguration dashboard
The Templates list with its three identifying columns and task controls

Before you start

Have the approved file or saved email wording ready before changing a template, because the action changes the content available to those document workflows.

Prerequisites

  • Have a subscription that includes Word Templates. When it does not, the list is replaced by the subscription surface.
  • Have administrator access that permits the action. Upload list of variables is available to permitted developer accounts when the subscription includes Word Templates.
  • For a company document, have one .doc or .docx file ready. The upload surface accepts one file.
  • For the variable list, have one PDF ready.
  • For email editing, have the wording ready for the rich-text E-mail template content area. The editor also provides available variables through #.

Find a template

The Templates list is the starting point for matching a business document to the content you need to maintain. Read the row's Template value first, then use Uploaded file name and Uploaded on to distinguish the file currently associated with that type.

Prerequisites

  • Know whether you are maintaining inquiry, offer, order, procurement, or invoice content.

Steps

  1. Open Templates from the configuration area.

  2. In the Templates list, read the Template column to find the required document or email type.

  3. Read Uploaded file name to identify the associated company file.

  4. Read Uploaded on to compare the upload date when more than one entry needs review.

    The Templates grid with Template, Uploaded file name, and Uploaded on

Result: The required row is identified by its template type, file name, and upload date.

Use this row's available action to continue with the required template task.

Understand the Templates screen

The Templates screen combines a page-level variable-list action with a list of template rows. Each row can expose email editing and document actions according to its type and data. The available popups are the company-template upload surface, the variable-list upload surface, and the HTML Template Editor.

When Word Templates is not included in the subscription, the subscription-upgrade surface replaces the list. The page-level Upload list of variables action is shown only to permitted developer accounts.

Important: Use the approved company document or email wording. Template content is used by the document workflows that follow.

File actions open a popup, while email-template actions open the HTML Template Editor. The company-document and variable-list popups use Upload; the editor uses Save and Cancel.

The HTML Template Editor opened from an inquiry email-template row

The editor surface includes the selected type, HTML Template Editor, and the instruction Type # to insert a variable. Its toolbar provides these controls.

To edit email content, select Offer E-mail Template, Order E-mail Template, PO E-mail Template, Invoice E-mail Template, Inquiry E-mail Template, or RFQ E-mail Template in the matching row.

Editing purposeControls
History and text emphasisOK, Undo, Redo, Bold, Italic, Underline
Alignment and listsAlign Left, Align Center, Align Right, Ordered List, Bullet List
Text and colour formatHeader, Font Color, Background Color
TablesInsert Table, Delete Table, Insert Row Above, Insert Row Below, Delete Row, Insert Column Left, Insert Column Right, Delete Column
The HTML Template Editor toolbar controls

Choose the right template action

Choose an action from the row that matches the document type and whether a company file exists.

Your purposeSelectRow condition
Edit inquiry email contentInquiry E-mail TemplateThe row is an inquiry template
Edit offer email contentOffer E-mail TemplateThe row is a technical or commercial offer template
Edit order email contentOrder E-mail TemplateThe row is an order-confirmation template
Edit purchase-inquiry email contentRFQ E-mail TemplateThe row is a purchase-inquiry template
Edit purchase-order email contentPO E-mail TemplateThe row is a purchase-order template
Edit invoice email contentInvoice E-mail TemplateThe row is a commission or sales-invoice template
Download the sample documentSample templateThe row is not an inquiry template
Download the company documentCompany templateThe row is not an inquiry template and is not a basic template
Provide or replace the company documentUpload company templateThe row is not an inquiry template
Download the variable listList of variablesThe row is not an inquiry template

The page-level click here to download the list of variables. action downloads the variable list when the subscription is included. The row-level List of variables action is available for non-inquiry rows.

After choosing an action, follow the matching procedure below.

Maintain and use a template

Use the action that matches the row. A download requests a file, an upload opens a file popup, and an email action opens the editor for the selected type.

Prerequisites

  • Locate the row using Find a template.
  • Confirm that the required action appears for that row.

Steps

  1. Choose the matching option in the If you need to… table below.

    If you need to…SelectContinue with
    Download a fileSample template, Company template, or List of variablesDownload a template or the variable list
    Upload a company documentUpload company templateUpload a company template
    Edit email contentThe row's email actionEdit a document template

Result: The selected download request, upload popup, or HTML Template Editor is open.

Download a template or the variable list

Download a sample, the current company document, or the variable list from the Templates screen.

Prerequisites

  • Have the relevant non-inquiry row in view, or have the page-level variable-list instruction in view.

Steps

  1. Select the action that matches what you need to download.

    If you need to download…Select
    The sample documentSample template
    The company document from a non-basic rowCompany template
    The variable list from a non-inquiry rowList of variables
    The page-level variable listclick here to download the list of variables.
    The page-level variable-list download instruction

Result: The selected sample, company document, or variable-list download request is made.

Upload a company template

Provide or replace the company document for a non-inquiry template.

Prerequisites

  • Have one approved .doc or .docx file ready.
  • Have a non-inquiry template row selected.

Steps

  1. Select Upload company template for the row.
  2. In the Upload company template popup, select Browse.
  3. Choose the company document file.
  4. Select Upload.

Result: The company-template upload request is submitted from the Upload company template popup.

Edit a document template

Change the email content associated with a document type.

Prerequisites

  • Have an email-template row with its email action available.
  • Have the approved wording ready.

Steps

  1. Select the row's email action, such as Inquiry E-mail Template, Offer E-mail Template, Order E-mail Template, RFQ E-mail Template, PO E-mail Template, or Invoice E-mail Template.

  2. In HTML Template Editor, edit the E-mail template content rich-text area.

  3. Type # in the editor to insert an available variable.

  4. Select the action that matches how you want to finish.

    If you want to…Select
    Keep the changesSave
    Close without savingCancel

Result: The selected email-template editor action is completed or cancelled from HTML Template Editor.

Upload the list of variables

Upload the company variable reference when it is provided as a PDF and the page-level action is available.

Prerequisites

  • Have one PDF containing the list of variables.
  • Have an included Word Templates subscription.
  • Use an account permitted to access Upload list of variables.

Steps

  1. Select Upload list of variables.

  2. In the Upload list of variables popup, select Browse.

  3. Choose the variable-list PDF.

  4. Select the action that matches how you want to finish.

    If you want to…Select
    Submit the fileUpload
    Close without submittingCancel

Result: The variable-list upload popup is open for completion or cancellation, and its file action is Upload.

When a template action fails

When Word Templates is excluded from the subscription, the Templates list is unavailable. The same result applies when a row does not meet the action's type condition, while processing can also return an error.

What you seeWhat it meansWhat to do
The subscription-upgrade surface replaces the listWord Templates is not included in the subscriptionReturn to the Configuration dashboard or use a subscription that includes Word Templates
Upload list of variables is unavailableThe action is restricted to permitted developer accounts and subscriptions that include Word TemplatesUse an account permitted for the action and confirm the subscription includes Word Templates
A row has no company-template actionThe row is an inquiry template or the action condition is not metUse the email action for an inquiry row, or choose a non-inquiry row for company-document work
An error occurred while processing your request appearsThe selected operation returned the shared processing errorCheck the selected row and file, then retry the same supported action

If a download, upload, variable-list action, or editor save fails, the page displays An error occurred while processing your request.

When the action is complete, continue with the document workflow below.

Continue with the document workflow

After maintaining a template, continue in the workflow that uses the same Template type.

Template contentContinue with
InquiryInquiries
OfferOffers
OrderOrders
RFQPurchase job RFQs
POPurchase job orders
InvoiceCreate invoice

Select the workflow that matches the maintained template rather than a different document category.

Was this page helpful?

Need help using the product?