Difference between revisions of "Creating templates"

Revision as of 18:09, 19 December 2011

As you can see in the User Guide you can create new documents based on Templates. But OpenKM offers another feature based in this idea. First of all you need to know the template syntax, which is used by the FreeMarker Template Engine. This engine can be used from making simply variable substitution to loops and other control structure. In this example we use only the basic ones, but you can learn more at FreeMarker Manual.

OpenKM can handle 3 types of template documents:

• PDF
• OpenOffice
• Text (This includes other text-based like HTML, for example)

To Generate Fillable Content

In order to generate the final document from the template, we need to make an association with Property_Groups and register them in Property_Groups_administration. The final document also will be assigned the corresponding property group with the user input values, so you can use them for a future search. The three sample template types we will use this Property Groups definition:

PropertyGroups.cnd

<okm = 'http://www.openkm.org/1.0'>
<okg = 'http://www.openkm.org/group/1.0'>
<okp = 'http://www.openkm.org/group/property/1.0'>

[okg:tpl] mixin
- okp:tpl.name (string) = '' autocreated
- okp:tpl.bird_date (string) = '' autocreated
- okp:tpl.language (string) = '' autocreated

PropertyGroups.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 1.0//EN"
                                 "http://www.openkm.com/dtd/property-groups-1.1.dtd">
<property-groups>
  <property-group label="Sample Template" name="okg:tpl">
    <input label="Name" name="okp:tpl.name"/>
    <input label="Bird Date" name="okp:tpl.bird_date" type="date" />
    <select label="Language" name="okp:tpl.language" type="simple">
      <option label="Java" value="java"/>
      <option label="Python" value="python"/>
      <option label="PHP" value="php" />
    </select>
  </property-group>
</property-groups>

Remember you need to add these in: Property_Groups and register them in Property_Groups_administration!