5.6.6 Using the Document Generator

Contents

Index

5.6.6 Using the Document Generator

To start the Document Generator, you have to add a new document set by selecting File New Document Set in the top menu. You have to enter a name and an optional description as well as a character set in which the entities of the new document set will be coded. You may change this character set again using File Set Character Set

To define entities in the folder hierarchy of a document set, use File Change Entities in the top menu of the document set or its subfolders. You may specify the name and the value of a new entity or change an existing one. If the name field remains empty, the entity will be removed.

Defining entities

Figure 5.6-1: Defining entities

After you have generated the templates on your local computer and have them uploaded to the document set (don’t forget to enter ‘Document Template’ (text/x-bscw-template) as MIME type), you may use action menu Eval Parameters to set the evaluation parameters of the templates. This lets you specify a template, into which the entities of the present template are to be inserted, and the name of a document which is to be generated from the present template. Internally the evaluation parameters are treated as entities with the name @template@ and @document@, respectively.

Defining eval params

Figure 5.6-2: Defining the evaluation parameters

To view all entities of the document set, of one of its folders or of a template, use File Show Entities or action menu Show Entities . If an entity appears in italics it is inherited via the folder hierarchy.

Displaying entities

Figure 5.6-3: Displaying entities

The evaluation process may be started for the whole document set, for one of its folders, a set of selected templates or single templates using File Evaluate , | evaluate | or action menu Evaluate , respectively. Documents that have already been generated in prior evaluations will be replaced.

For a backup of a document set you may save all entities with File Export Entities . This generates a file which you may save on your local computer. The file has the following syntax where ‘object path’ designates the path name of the object (folder, template) whose entities are stored within the document set.


'<object-path>' = {
  '<name_of_entity>' = '<value-of-entity>'
  ...
}
...

With action menu Import Entities you may import such entity backup files.

Contents

Index

	Help

Contents Index

5.6.6 Using the Document Generator To start the Document Generator, you have to add a new document set by selecting File New Document Set in the top menu. You have to enter a name and an optional description as well as a character set in which the entities of the new document set will be coded. You may change this character set again using File Set Character Set To define entities in the folder hierarchy of a document set, use File Change Entities in the top menu of the document set or its subfolders. You may specify the name and the value of a new entity or change an existing one. If the name field remains empty, the entity will be removed. Figure 5.6-1: Defining entities After you have generated the templates on your local computer and have them uploaded to the document set (don’t forget to enter ‘Document Template’ (`text/x-bscw-template`) as MIME type), you may use Eval Parameters to set the evaluation parameters of the templates. This lets you specify a template, into which the entities of the present template are to be inserted, and the name of a document which is to be generated from the present template. Internally the evaluation parameters are treated as entities with the name `@template@` and `@document@`, respectively. Figure 5.6-2: Defining the evaluation parameters To view all entities of the document set, of one of its folders or of a template, use File Show Entities or Show Entities . If an entity appears in italics it is inherited via the folder hierarchy. Figure 5.6-3: Displaying entities The evaluation process may be started for the whole document set, for one of its folders, a set of selected templates or single templates using File Evaluate , \| evaluate \| or Evaluate , respectively. Documents that have already been generated in prior evaluations will be replaced. For a backup of a document set you may save all entities with File Export Entities . This generates a file which you may save on your local computer. The file has the following syntax where ‘object path’ designates the path name of the object (folder, template) whose entities are stored within the document set. `'<object-path>' = { '<name_of_entity>' = '<value-of-entity>' ... } ...` With Import Entities you may import such entity backup files.

Contents Index