KB User's Guide - Documents Tab - Template Creation via a New Document Set to "Template" Type

The Document Template feature in KB Admin Tools makes it easier for KB authors to replicate frequently used document formats and styles.

What is a Template?

A template allows users to make one, or multiple documents having a uniform appearance. A well pre-formatted template can prescribe very specific content, structure, formatting, prompt for minimal requirements, etc. They provide reproducable consistency and continuity of style and are time-saving in that users personalize a standard, ready-made document.

Create a Template

Creating a document template is the same as creating a regular document except that the Type field is set to Template.

  1. In the KB Admin Tools, click on the Documents tab.
  2. Click on the New Doc link on the left navigation menu.
  3. Fill in standard, reusable text. Format the content as desired the following input fields:
    • Title
    • Keywords
    • Search priority
    • Page header
    • Page footer
    • Summary
    • Body
    • InternalNote
    • MyGroupNote
    • MyGroupNote Position
    • SeeAlso
    • Up, Previous, Next
    • Type
    • Topics
    • Audiences
    • WriteAccess
    • ReadAccess
    • SiteAccess
    • CampusAccess
    • Relevance
    • Status
    • Activation (including future activation)
    • Expiration
    • Owner
    • FeedbackTo
    • MiscOptions: Blog, No reminder, No keyword suggestion, No comment, HTML only mode
    • JavaScript/CSS
    • (Note: While you may be able to save template data in the Up, Previous and Next fields, that data is not intended to transfer over to a New Document.

  4. Set the Type field flag to "Template."
  5. Click the Submit button to save the document as a template.
  6. We recommend that you leave the Status set to In Progress, even if the template is in its final form. If it is set to Active and discoverable by users on the Live Site, it may be confusing.
  7. If you think you will need to access the template on the Live Site(s):

    • Once or twice: - set the Search Priority to Exclude from Search and save as Active. To access this document in the Live Site, you must know the exact document ID number of your template.

    • With some regularity: - Set the Search Priority to the appropriate setting; Low, Normal, High or Top. Next, create a User Access group and set the document ReadAccess to that specific User Access Group. This way, the person(s) in that group can discover the Template on the Live Site by means of keyword search.
  8. There is no limit to the number of templates one group can have.
  9. Like a regular document, a template can be copied via the Save As... button and shared across multiple KB groups.

Apply Template to a New Document

When you click on the New Doc link in the Documents tab, you will be led to a screen called Creating a New Document.

If you have not created a Template yet, you will see "No templates defined or available" in the Template dropdown menu.

KBgrouphasnotemplates.png

However, if you have created a template(s), you can access it by clicking on the down arrow next to the Template field dropdown menu. Choose the appropriate template.

While the screen still says Creating a New Document, the fields that were pre-formatted with data in the template you selected will automatically populate the fields of the New Document.

From here, we recommend that you click on the Save Change button or the Submit button to assign this New Document its own, unique Document ID number. Once the New Document is saved, using either method, the screen will now read, Editing Document XXXXXX. (e.g. the New Document will prominently display the Document ID number).

Continue to edit the document as per your KB Site's workflow.

  • Note: When a document is created from a template using this method, the Activation time and date stamp will reflect the current time and date and not the time and date that the template was created. The Expiration date will reflect the date your KB Site Admin has set in the Default doc expiration period, which is usually set to 4 years.

See Also:




Keywords:knowledgebase knowledge base creating KB draft "New Doc from" stencil pattern overlay framework boilerplate   Doc ID:14044
Owner:Teresa A.Group:KB User's Guide
Created:2010-05-24 19:00 CDTUpdated:2016-08-29 16:33 CDT
Sites:KB Demo, KB Demo - Child Demo, KB User's Guide
Feedback:  0   0