Proposal Template

Proposal Template Master - User Guide

1. Introduction ๐Ÿ“

The Proposal Template Master enables organizations to draft, format, and maintain standardized proposal terms, introductory briefs, and quotation boilerplate notes. When sales representatives engage with leads, they can select a predefined proposal template on any activity record and dispatch an official, formatted email directly to the prospective client with a single click.

โ„น๏ธ

In the overall CRM flow:

  1. Defines standard commercial and technical content mapped to specific Document Types (e.g., Product Catalog Brief, Commercial Quotation Terms, Service Agreement Proposal).
  2. Empowers the Email action button within Lead Activity Details to automatically populate email bodies.
  3. Guarantees consistent brand messaging and legal wording across the entire sales team.

2. Getting Started ๐Ÿš€

Accessing the Module

Navigate to CRM > Masters > Proposal Template (/stdinsmstindex/P).

The Index Page

The index interface presents:

  • Doc Type: The business document category associated with the template.
  • Notes: A clean, plain-text preview of the template content with HTML tags automatically stripped for easy readability.
  • Create New: Top-level button launching the rich-text creation editor (/stdinsmstcreate/P).

3. Features โœจ

  • ๐Ÿ–‹๏ธ Embedded Rich-Text Editor: Features an integrated Quill WYSIWYG editor supporting bold text, bulleted lists, numbered lists, headings, alignments, and hyperlink insertions.
  • ๐Ÿ“ง Direct Lead Email Integration: Once authored, templates become immediately selectable inside Lead Activities, allowing sales reps to email prospects without opening an external mail client.
  • ๐Ÿ›ก๏ธ Hyperlink Security Validator: An automated link inspection engine verifies that every inserted hyperlink adheres to strict secure protocol standards.
  • ๐Ÿ“„ Dual Length Validation: Enforces safety checks on both readable plain text and raw HTML formatting strings to prevent database truncation and mail server rejection.

4. Complete Flow ๐Ÿ”„

Select Document Type

  • From the Proposal Template Index, click Create New.
  • Select the applicable Document Type from the dropdown menu (e.g., Standard Proposal, Technical Specs Brief, Annual Maintenance Terms).

Author Content in Rich-Text Editor

  • Compose your proposal copy directly within the editor workspace.
  • Format key terms, warranties, delivery lead times, and payment milestones.
  • If inserting hyperlinks (e.g., links to product brochures or corporate portfolios), ensure each URL begins with https://.

Save and Validate

  • Click Save. The system validates that no duplicate template exists for this document type, checks character limits, and verifies link security.

Deploy in Follow-up Activities

  • Sales executives can now open any Lead Activity, choose the Proposal Template Type, and click Email to send the proposal directly to the prospect.

5. Validations and Error Handling โš ๏ธ

The Proposal Template module enforces strict content and security validations:

Validation ScenarioWhat is checked?Error Message / System Behavior
One Template per Document TypePrevents multiple conflicting templates from being created for the same Document Type.“Note already exists for this document type.”
Mandatory Content RequirementPrevents saving an empty or blank template.“Notes needs to be filled.”
Plain-Text Character CeilingStrips HTML formatting tags and measures actual readable characters (maximum 2,000 characters).“Notes can be up to 2000 characters only.”
Total HTML Payload CeilingChecks total content length including underlying HTML tags and styling (maximum 4,000 characters).“Notes can be up to 4000 characters only.”
Strict Link Security CheckInspects every <a href="..."> anchor tag. Links must strictly begin with https://, mailto:, or tel:. Insecure plain http:// or non-standard protocols are rejected.“Invalid link in notes. Please include https:// or a valid prefix.”
โš ๏ธ

โš ๏ธ Crucial Dependency for Lead Emailing

If a sales rep attempts to click Email on a Lead Activity that specifies a proposal document type, the system checks this master. If no content has been configured for that document type, email dispatch is halted with:

“Please create records in Proposal Template for [Document Type Name]”


6. Tools / Smart Features ๐Ÿ”ง

  • ๐Ÿงผ Automatic Attribute Normalization: The editor sanitizes double and single quotes to prevent rendering glitches across diverse email clients (Outlook, Gmail, Apple Mail).
  • ๐Ÿ‘๏ธ Live Visual Preview: Review how the rendered rich text will appear to prospects directly beneath the editing canvas before committing changes.

7. Configuration Requirements โš™๏ธ

  • Permissions: Access to configure proposal templates is protected by CrmProposalDetails and CrmProposalCreate security roles.

8. Best Practices ๐Ÿ’ก

  • Always Use Secure HTTPS: When linking to hosted documents, always verify the URL starts with https:// to comply with the link validator.
  • Keep Boilerplates Focused: Templates are designed for introductory summaries and standard terms. For voluminous multi-page catalogs, host the PDF securely and insert a secure download link within the template.