Applications Administration Guide > Proposals >

Creating Template Documents in Microsoft Word


The first step is to create documents in Microsoft Word. These documents consist of one style document and multiple component documents, as shown in Figure 18.

Figure 18.  Word Documents That Can Make Up a Proposal Template
Click for full size image

The components shown in Figure 18 are only examples. You could have other components, such as a table of contents or a set of collateral, and you could omit the quotes or product descriptions, for example. However, a template must have a style document and one or more component documents.

NOTE:  See Release Notes for information about which versions of Microsoft Word are supported.

To create the template documents, you perform the following tasks:

Planning the Template

Before you create the documents in Word, you must determine how the proposal should look and what type of information it should contain.

Begin by looking at previous successful proposals to see what sections they included. For example, did they all have a cover letter, an executive summary, and a quote? Also, look at the documents your company currently has on hand, and the customer questions these pieces answer. Then decide how to organize your information. What topics could be standard across all proposals? What topics are specific to certain proposals? What is the best order for the pieces in the proposal you are creating? Finally, decide what fields to insert to customize their proposals (for example, contact name, account name, and industry). You will use this information to create bookmarks in your Word documents.

As part of your planning, you should look at the sample templates that come with Siebel Proposals, which are described in Sample Data: Field Mappings and Templates.

NOTE:  Proposals use fields from only one business object. If you want to include additional fields, you must use Siebel Tools to add the business components that include these fields to the business object that is the basis of the proposal.

Creating a Styles Document

After you plan your templates, you work on the styles document for this template. This Word document will define the layout of your proposal and may include such things as headers, footers, your logo, and special margins.

The layout options you specify will automatically be applied to all the components used in the proposal.

NOTE:  Do not type any content into this document. The content will come from the individual component documents that you will create later.

To set up styles for your template

  1. Create a new document in Microsoft Word.
  2. Set up margins, headers, footers, fonts, and other layout options for your template.
  3. When you are finished creating styles, save the file:
    • Choose a name that uses only alphanumeric characters.
    • Use the .doc extension for Microsoft Word.
  4. Close the file.

Creating Components

The next step in developing your template is to create components, which are the text pieces that make up the body of your proposal.

A component is a Microsoft Word document that includes standard text and personalized data. For example, a cover letter component includes your standard cover-letter text and personalized data such as the name and address of the contact to whom the letter is addressed.

To create a component, you type the standard text and then create bookmarks, or Microsoft Word placeholders for custom data. When a sales representative generates a proposal, these bookmarks will be replaced with data from the Siebel application.

To create a component with bookmarks in Microsoft Word

NOTE:  This procedure may vary slightly, depending on your version of Microsoft Word.

  1. Create a new blank document in Microsoft Word.
  2. Type the standard text that belongs in this component.
  3. Place the cursor where you want to create a bookmark, and choose Insert > Field.
    Click for full size image
  4. Click Links and References in the Categories list, and then click Ref in the Field Names list.

    REF appears in the Description box.

  5. In the Comments box, enter the name of your bookmark after REF.

    For example, you might type Company for company name, so that the Comments box contains:

    REF Company

    The bookmark name cannot begin with a number.

    NOTE:  If the text inserted into a bookmark contains double quotes ("), the inserted text will automatically be preceded by a backslash (\). If you do not want the backslash to appear in the inserted text, change the double quotes to single quotes in the Siebel software.

  6. Note the name of the bookmark, because you will need it when you map the bookmark to a Siebel field names.
  7. Click the Preserve Formatting During Updates check box if you want to maintain the format of the merged text.
  8. Click OK to insert the field.

    In your document, the following message appears:

    Error! Reference source not found.

    This message is Word's normal bookmarking convention. The error text will be replaced by appropriate data at the time of draft generation.

  9. Repeat Step 3 through Step 8 to add bookmarks for every field you want to insert in the text.

    NOTE:  If the same field is being inserted in several places, you can copy its bookmark and paste it into other parts of the document.

  10. Save the component document as a .doc file.

 Applications Administration Guide
 Published: 09 September 2004