NEW GENERATION SOFTWARE LTD Vladimira Varićaka 3, 10010 Zagreb, Croatia https://templater.info Templater user manual v6.1 September 9, 2021 New Generation Software Ltd Rikard Pavelić New generation software Ltd, Vladimira Varićaka 3, Zagreb, Croatia – Registration number: 080542197 – Bank: Raiffeisenbank Austria d.d. Zagreb – Director: Rikard Pavelić – Company number: 2004852 1 NEW GENERATION SOFTWARE LTD Vladimira Varićaka 3, 10010 Zagreb, Croatia https://templater.info Content About ....................................................................................................................................................... 4 New Generation Software Ltd. ............................................................................................................ 4 Templater ............................................................................................................................................ 4 Supported documents ............................................................................................................................. 5 Office Open XML ................................................................................................................................. 5 Text based formats .............................................................................................................................. 5 Supported languages ............................................................................................................................... 6 Microsoft .NET ..................................................................................................................................... 6 Oracle Java ........................................................................................................................................... 6 Google Android ................................................................................................................................... 6 Others .................................................................................................................................................. 7 Getting started ........................................................................................................................................ 8 Tags ...................................................................................................................................................... 8 Minimal API ......................................................................................................................................... 9 Setting up a project ........................................................................................................................... 11 Thread safety ..................................................................................................................................... 12 Built-in processors and analysis ........................................................................................................ 12 Application Programming Interface ...................................................................................................... 14 Low-level API ..................................................................................................................................... 14 High level API ..................................................................................................................................... 20 Configuration ..................................................................................................................................... 25 Templater Editor for Microsoft Office ................................................................................................... 44 Installation and licensing ................................................................................................................... 44 Schema .............................................................................................................................................. 46 Tag analysis ........................................................................................................................................ 49 Tag navigation ................................................................................................................................... 50 Tag listing ........................................................................................................................................... 51 Running Templater ............................................................................................................................ 52 Debugging Templater ........................................................................................................................ 55 Word features ....................................................................................................................................... 57 Mail merge ........................................................................................................................................ 57 New generation software Ltd, Vladimira Varićaka 3, Zagreb, Croatia – Registration number: 080542197 – Bank: Raiffeisenbank Austria d.d. Zagreb – Director: Rikard Pavelić – Company number: 2004852 2 NEW GENERATION SOFTWARE LTD Vladimira Varićaka 3, 10010 Zagreb, Croatia https://templater.info Resizable regions ............................................................................................................................... 58 Word specific features ...................................................................................................................... 74 Known issues ..................................................................................................................................... 85 Excel features ........................................................................................................................................ 87 Complex non-streaming documents ................................................................................................. 87 Resizable behavior ............................................................................................................................. 88 Excel specific features ..................................................................................................................... 107 Known issues ................................................................................................................................... 124 PowerPoint features ............................................................................................................................ 125 Ready-to-use presentations ............................................................................................................ 125 Resizable behavior ........................................................................................................................... 125 PowerPoint specific features ........................................................................................................... 134 Known issues ................................................................................................................................... 139 CSV/text features ................................................................................................................................ 140 Simple documents ........................................................................................................................... 140 Streaming documents ..................................................................................................................... 141 Best practices ...................................................................................................................................... 143 Complex documents ........................................................................................................................ 143 Performance/memory optimizations .............................................................................................. 150 Tag management ............................................................................................................................. 156 User defined plugins ........................................................................................................................ 158 F.A.Q. ................................................................................................................................................... 159 New generation software Ltd, Vladimira Varićaka 3, Zagreb, Croatia – Registration number: 080542197 – Bank: Raiffeisenbank Austria d.d. Zagreb – Director: Rikard Pavelić – Company number: 2004852 3 NEW GENERATION SOFTWARE LTD Vladimira Varićaka 3, 10010 Zagreb, Croatia https://templater.info About New Generation Software Ltd. N.G.S. is a software company founded in 2005 by Rikard Pavelić in Croatia. It focuses on making software development easier and more productive. Since its early days Templater-like solutions were used for reporting/document generation. Once we realized such an approach would be useful to others, N.G.S. released Templater v1.0 in 2011. N.G.S. primary focus is on providing consulting around its software products. Templater Templater focuses on binding data with documents. This allows for separation of data and layout leading to customization of templates by business users/end clients. Unlike other reporting libraries which