Table of Contents
Advertisement
8
C r e a t i n g a n E l e m e n t C a t a l o g i n a t e m p l a t e
Importing element definitions
To import element definitions, choose Element Definitions from the File>Import submenu in
the template. Select the EDD in the Import from Document dialog box. (The EDD must be
open to appear in this dialog box.) If the EDD is invalid, an alert tells you to correct the
validation errors and then import the EDD.
If you import definitions into a template that does not yet have an Element Catalog,
FrameMaker creates a new catalog for the template. If you import definitions into a template
that already has a catalog, FrameMaker completely replaces the old catalog with your new
one.
Log files for imported element definitions
If FrameMaker encounters any problems while importing element definitions, it produces a
log file of warnings and errors. A warning is a notification of a potential problem, but it does
not necessarily mean something is wrong with the EDD. An error indicates an actual
problem in the processing; some errors can cause the processing to stop altogether.
Some warning messages describe formats that FrameMaker needs to create because they
are referenced in the EDD but not yet stored in the template. If you do not want
FrameMaker to create formats automatically when you import element definitions, you can
insert a DoNotCreateFormats element as a child element of ElementCatalog in the
EDD. (If the EDD already has a CreateFormats element, select it and change it to
DoNotCreateFormats.)
A log file can also have messages for:
•
defined elements not used in any content rules
•
elements referenced in content rules that are not defined
•
definitions that have syntax errors
This is an example of a message in a log file:
Referenced element "Part" is undefined.
All messages in the log file have a hypertext link to the EDD. You can click a message to
go to the line with the problem in the EDD.
A log file is initially locked so that you can click in it to use the hypertext links. If you want
to save the log file, you must first unlock it by pressing Esc Flk. (Press Esc Flk again to
relock the file.) For general information on FrameMaker log files, see "Log files" on page 71.
Debugging element definitions
You should test element definitions thoroughly before delivering a structured template to
end users. First correct any errors in the EDD that are identified in the log file and reimport
the definitions until FrameMaker no longer finds errors. Then import the Element Catalog
from the template into a sample document that contains representative text and check to
Developing an Element Definition Document (EDD)
104
Advertisement
Table of Contents
