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