Dynamic Converter Administration Guide
3-1
Ch a p t e r
3.T
EMPLATE
R
ULES
This section covers the following topics:
ʍ About Template Rules (page 3-1)
ʍ Template Selection Rules Page (page 3-2)
ʍ Managing Your Template Rules (page 3-7)
ʍ Assigning Metadata Criteria to a Rule (page 3-8)
ʍ Choosing a Template for a Rule (page 3-9)
A
BOUT
T
EMPLATE
R
ULES
A rule is a set of instructions that drive the conversion process in Dynamic Converter. 
These instructions identify source documents in the content server and then determine 
whether or not these documents should be converted based on their metadata (content ID, 
type, author, etc.) and file type. The rule then requests that the document be converted 
using the template  associated with the rule (for more on templates, see chapter 4). You can 
have more than one rule in Dynamic Converter. If this is the case, the first rule to match 
the source document’s metadata is used for dynamic conversion. Depending on the system 
configuration, other matching rules may also be applied (see Forced Conversions on 
page 1-6).
The Template Selection Rules page (see below) allows you to add, remove, and reorganize 
rules; specify the criteria (metadata) to base a rule on; and assign a template (or templates) 
to the rule.
Copy pdf bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
export pdf bookmarks to text file; pdf bookmark editor
Copy pdf bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
excel hyperlink to pdf bookmark; pdf bookmark
3-2
Dynamic Converter Administration Guide
Template Rules
A number of features have come together to form the Template Selection Rules page. You 
can add multiple rules and then change the order for which those rules will apply to source 
documents. You can select a number of metadata fields to base a rule on (and add even 
more fields using the configuration page). Lastly, you can assign a template (or templates) 
to the rule and then edit those templates using the Edit Template button.
T
EMPLATE
S
ELECTION
R
ULES
P
AGE
Use the Template Selection Rules page to add, remove, and re-order rules. To access 
this page, click Template Selection Rules on the Dynamic Converter Admin Page 
(page 1-13).
Figure 3-1 Template Selection Rules page
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
document file. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. Also a preview
create bookmark pdf; convert word pdf bookmarks
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Demo Code in VB.NET. The following VB.NET codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
how to create bookmarks in pdf file; copy pdf bookmarks
Dynamic Converter Administration Guide
3-3
Template Rules
Rules are processed from the top down. When a user requests a source document in 
Content Server, the rule that appears first in this list is processed. If the rule does not apply 
(for example, the source document might contain metadata not specified in the rule), then 
the next rule is processed. This process continues until it reaches the last rule in your list.
Once a rule has been added, you can use the criteria section to define or target your rule 
toward the source documents stored in the content server. You might, for example, choose 
“Type” as a category and “Report” as the name so that your rule applies to all documents 
with the type “Report.”
Lastly, you will choose a template for your rule. In a second template field, you can 
specify a layout template that complements a GUI template by establishing a consistent 
page layout (borders, navigation, scripting, etc.) for your converted documents.
Page Features
The following options are available:
Tech Tip: Rules that were created in a Dynamic Converter version prior to 6.1 appear as a 
numbered rule in this version of Dynamic Converter. You can continue using that rule or 
delete it and re-create the rule in Dynamic Converter 10gR3 (you cannot rename a rule).
Option
Definitions
Template Selection Rules
Move Up
Click this button to move a rule up the list, giving it precedence 
over the rules below it. Template selection rules are processed from 
the top-down.
Move Down
Click this button to move a rule down the list, giving it less 
importance than the rules above it. Template selection rules are 
processed from the top-down.
Delete Rule
Click this button to remove a rule from the list. When you remove a 
rule, you are removing the customized settings for that rule 
(metadata criteria and template).
Add New Rule
Click this button to add a new rule to the Template Selection Rules 
list. Once you add a rule, you can move it up or down in the list, 
changing the order that it is processed by Dynamic Converter.
C# PDF File Compress Library: Compress reduce PDF size in C#.net
NET framework. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. C# class demo
adding bookmarks in pdf; adding bookmarks to pdf
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
export bookmarks from pdf to excel; adding bookmarks to a pdf
3-4
Dynamic Converter Administration Guide
Template Rules
Criteria For Selected Rule
Field
These are the metadata fields that you can base a template selection 
rule on (all fields are case-sensitive). The number of criteria that 
you can specify for each rule is controlled by a setting on the 
Dynamic Converter Configuration page (see page 2-1).
The following metadata fields are available:
ʍ Content ID—The unique identifier of a content item. 
The content ID can be assigned by a user or automatically 
generated by Content Server. Your template, as a result, is 
assigned to only one content item.
ʍ Title—The descriptive name assigned to a content item by the 
user. Your template, as a result, is assigned to only one content 
item.
ʍ Author—The person who created or revised the content item. 
Your template is assigned to all content items created by this 
author.
ʍ Type—The category of content items (a category is created in 
the Configuration Manager in Content Server). Your template 
is assigned to all content items matching this category.
ʍ Security Group—The set of files with the same access 
privileges, generally 'public' and 'secure.' Your template is 
assigned to all content items matching this security group.
ʍ Template Type—Facilitates searches for templates in the 
content server.
ʍ Format—The file format for a content item (this is determined 
by the application used to create the file). A file format is the 
same as a MIME type, and it can be specified using the same 
comma delimited values (application/rtf, application/msword, 
etc.). Please note that the Conversion Formats field on the 
Dynamic Converter Configuration page (see page 2-1) serves a 
different purpose, and that is to control which file formats will 
actually be converted by Dynamic Converter.
Option
Definitions
How to C#: Basic SDK Concept of XDoc.PDF for .NET
create, load, combine, and split PDF file(s), and add, create, insert, delete, re-order, copy, paste, cut This class describes bookmarks in a PDF document.
how to create bookmark in pdf with; how to add bookmark in pdf
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
by C#.NET PDF to HTML converter toolkit SDK, preserves all the original anchors, links, bookmarks and font style that are included in target PDF document file.
create pdf bookmarks online; adding bookmarks to pdf document
Dynamic Converter Administration Guide
3-5
Template Rules
Field (continued)
ʍ User Agent—The viewing device that requests and downloads 
content from a web server. Typically, this is a web browser that 
runs on a computer, such as Microsoft Internet Explorer, 
Mozilla Firefox , or Opera. You can target a particular web 
browser by entering its value in this text box (such as *msie 7* 
for Internet Explorer 7, *firefox 2* for Mozilla Firefox 2, 
*webtv 1* for WebTV viewers, and so on). This setting is 
particularly useful for targeting your content to mobile devices.
Note: If you have added custom metadata to the content 
server, those values will appear in this list too.
Value
This is the specific metadata value for your criteria. Source 
documents are converted with the associated template if their 
metadata value matches the value listed here.
You can select the desired metadata from the dropdown menu to 
the right of the Value field. You can also use wildcards in the Value 
field (for example *report*). An * (asterisk) wildcard represents 
any number of characters, and a ? (question mark) represents a 
single character. For example, the value report* includes 
report2001, reporting, and reports. The value report? includes 
reports and report8, but it does not include report10.
Template and Layout For Selected Rule
Template
This is the name (content ID) of the template that you want to 
apply to source documents matching the above criteria.
Available 
Templates
This is a list of all the available templates currently stored in the 
content server.
Template Types
This is a list of the different types of templates: GUI Template, 
Layout Template, and Script Template. When you choose a 
template type, a list of available templates of that type will display 
in the Available Templates field.
See Chapter 4 (ConversionTemplates) for more information about 
templates.
Option
Definitions
VB.NET PDF: Basic SDK Concept of XDoc.PDF
create, load, combine, and split PDF file(s), and add, create, insert, delete, re-order, copy, paste, cut This class describes bookmarks in a PDF document.
acrobat split pdf bookmark; pdf bookmarks
VB.NET PDF Page Replace Library: replace PDF pages in C#.net, ASP.
edit, C#.NET PDF pages extract, copy, paste, C# page with another PDF page from another PDF file text, images, interactive elements, such as links and bookmarks.
bookmark pdf reader; pdf create bookmarks
3-6
Dynamic Converter Administration Guide
Template Rules
Edit Template
This button is activated once you enter a recognized GUI template 
in the Template text box. Click this button to open the Template 
Editor. (The Template Editor contains a suite of editing options, all 
in a graphical user interface, for your GUI templates.) The first 
time you click this button, you are prompted to download the 
Template Editor. See Template Editor (page 5-2) for more 
information.
Layout
This is the name of the layout template. A layout template is 
commonly used along with a GUI template to control the 
placement of items on a web page, in particular, the areas outside 
of the converted content (borders, navigation, company logo, 
custom script, etc.).
Available Layouts This is a list of all the available layout templates currently stored in 
Content Server.
Other Settings
File Extension
Set the file extension of converted pages that use this rule.
Forced 
Conversion
Indicates that this rule is to be used for forced conversion (see page 
1-6). This rule will always be applied to content items as long as 
the content items match the rule criteria. The conversion results can 
be retrieved using the incDynamicConversionByRule Idoc Script 
function or the GET_DYNAMIC_CONVERSION service with the 
conversionRule parameter specified. 
Exclude From 
User Request
Indicates that the rule should not be used when a user clicks on the 
HTML rendition link or menu item. Rules designed for fragments 
(see page 1-6) and used by the 
incDynamicConversionByRule
Idoc 
Script function should be excluded from Dynamic Converter’s rule 
evaluation during a user request.
Update
Click this button to apply any changes that you have made to the 
Template Selection Rules page.
Quick Help
Click this button to display context-sensitive help information 
about this page.
Option
Definitions
Dynamic Converter Administration Guide
3-7
Template Rules
M
ANAGING
Y
OUR
T
EMPLATE
R
ULES
The top section of the Template Selection Rules Page (page 3-2) enables you to manage 
the template rules that are used to convert your source documents. You can do the 
following:
ʍ Adding a Rule (page 3-7)
ʍ Deleting a Rule (page 3-7)
ʍ Reordering the Rules (page 3-8)
Adding a Rule
To add a new template rule, complete these steps:
1. Open the Dynamic Converter Admin Page (page 1-13).
2. Click Template Selection Rules.
The Template Selection Rules Page (page 3-2) is displayed.
3. Type a name for your rule in the New rule name text box (under the Template 
Selection Rules heading).
4. Click Add New Rule.
When your rule is highlighted, you will notice that the criteria and template fields for 
the rule are blank. You can start entering the desired metadata criteria and template for 
this rule right away.
5. Click Update at the bottom of the Template Selection Rules page.
Deleting a Rule
To delete a template rule from the Template Selection Rules list, complete these steps:
1. Open the Dynamic Converter Admin Page (page 1-13).
2. Click Template Selection Rules.
The Template Selection Rules Page (page 3-2) is displayed.
3. Highlight the rule to be deleted and click Delete Rule.
4. Click Update at the bottom of the Template Selection Rules page.
3-8
Dynamic Converter Administration Guide
Template Rules
Reordering the Rules
To change the order in which your template rules are processed, complete these steps:
1. Open the Dynamic Converter Admin Page (page 1-13).
2. Click Template Selection Rules.
The Template Selection Rules Page (page 3-2) is displayed.
3. Do either of the following:
ʍ To move a rule up the list, where it is prioritized over other rules, highlight the 
rule and click Move Up. Then click Update.
ʍ To move a rule down the list, where it will receive a lower priority, highlight the 
rule and click Move Down. Then click Update.
A
SSIGNING
M
ETADATA
C
RITERIA
TO
A
R
ULE
When assigning conversion templates to content items, you need to make sure that the 
metadata specified here matches the metadata assigned to your source documents. You can 
verify this by opening the content information page for your source documents in the 
content server.
To assign metadata to a template selection rule, complete these steps:
1. Open the Dynamic Converter Admin Page (page 1-13).
2. Click Template Selection Rules.
The Template Selection Rules Page (page 3-2) is displayed.
3. Choose a metadata field from the first Field drop-down list (under the “Criteria for 
selected rule” heading). You may choose Type, Author, Title, Content ID, Title, or 
anumber of other fields.
4. In the Value text box, enter the metadata that you would like your rule to target.
5. If desired, choose a second and third metadata field for your rule.
Important: Deleting a rule will remove all of the settings (metadata criteria and template) 
for that rule. You cannot undo this operation.
Note: You can select the metadata value from the dropdown menu to the right of the Value 
text box. You can also use wildcards to specify a metadata value.
Dynamic Converter Administration Guide
3-9
Template Rules
6. Click Update on the bottom of the Template Selection Rules page to update your rule.
C
HOOSING
A
T
EMPLATE
FOR
A
R
ULE
Your template selection rule is not complete until you choose a template for the rule. 
The template will ultimately drive the appearance of your converted documents.
To assign a template to a rule, complete these steps:
1. Open the Dynamic Converter Admin Page (page 1-13).
2. Click Template Selection Rules.
The Template Selection Rules Page (page 3-2) is displayed.
3. Enter the content ID for the template in the Template text box (under the “Template 
and layout for selected rule” heading).
4. If you chose a GUI template in the previous step, you may want to complement it with 
a layout template. If so, enter the content ID for the layout template in the Layout text 
box (again, you may select the layout template from the Available Layouts dropdown 
menu).
5. Click Update to add the template to your rule.
Once you have created a template selection rule, assigned the appropriate metadata 
criteria to it, and selected a template (or templates) for the rule, you should verify 
your configuration settings on the Dynamic Converter Configuration Page (page 2-1). 
In particular, make sure that you have added the necessary file types to the Conversion 
Formats list.
Note: There will always be an “AND” relationship between the metadata fields, which 
means that only those content items that meet all criteria are converted by this rule.
Tech Tip:  The maximum number of criteria that you can specify for each rule is 
controlled by a setting on the Dynamic Converter Configuration Page (page 2-1).
Note: You can select a type of template (GUI, Layout, or Script) from the Template Types 
dropdown menu, and then you can select your desired template from the Available 
Templates dropdown menu.
Note: See Chapter 4 (ConversionTemplates) for more information about templates.
Documents you may be interested
Documents you may be interested