CIB merge technical documentation (EN)

9. Special funcionality: Mixing document properties

(from CIB merge Version 3.9.174)

In an RTF the document properties (Doc-Properties) can be set via the editor (e.g. MS-Word). Examples are author, title, department, project etc. Furthermore, there are also the so-called User-Properties. The CIB merge treats Doc-Properties and User-Properties the same way.

The command INCLUDETEXT in the raw RTF can be used to create a document hierarchy. Each of these RTFs can have its own document properties. The CIB merge merges this document hierarchy into a single output RTF.

The document properties of the output RTF are determined by the following rules:

Until CIB merge version 3.12.2:

  • When merging, the last RTF overwrites the specifications of the previous one, i.e. it "wins" the lowest RTF in the hierarchy.
  • Already occupied properties are not deleted by empty ones.

Example:

Starting from the call hierarchy

ROOT.rtf -> TEMPLATE1.rtf -> TEMPLATE2.rtf

with the following document properties of the individual documents:

ROOT.rtf:                     Title-R / Author-R / Project-R
TEMPLATE1.rtf: Title-1 / Project-1 / Storage-1
TEMPLATE2.rtf: Title-2 / Storage-2 / Department-2

the merged result document gets the following document properties:

Title-2 / Author-R / Project-1 / Storage-2 / Department-2

 

From CIB merge version 3.12.3:

  • When merging, the document properties are "collected" in the merge order. Thus the root always has priority.
  • Already used properties are not overwritten, only new properties are added.

Example:

Starting from the call hierarchy

ROOT.rtf -> TEMPLATE1.rtf -> TEMPLATE2.rtf

with the following document properties of the individual documents:

ROOT.rtf:                     Title-R / Author-R / Project-R
TEMPLATE1.rtf: Title-1 / Project-1 / Storage-1
TEMPLATE2.rtf: Title-2 / Storage-2 / Department-2

the merged result document gets the following document properties:

Title-R / Author-R / Project-R / Storage-1 / Department-2