Specification of Docly™ DOCX Template Framework

Docly™ developed framework to use Microsoft Office Word (2010 or above) files as templates to merging data and output DOCX and/or PDF files. (C) 2014 - 2023 Docly™ | www.docly.net

About

The Docly™ DOCX Template Framework makes it easy to output DOCX (and PDF files - combined with Kingsoft Writer API) from Microsoft Office Word files as templates. Making it easy for users familiar with Microsoft Word to setup their design and look of the output for their solutions.

Merging data fields

Specify fields to merge with your data.

> Insert text with "MergeField"

Use the insert field option in word. Then select "MergeField", enter data field name and click OK. Merged fields are shown with brackets in the document.

Example

> Insert images with "MergeField"

Insert a placeholder image. Right click the image, open alternative text and enter link(FIELDNAME). Fieldname beeing the actual name of the field with the image data. See example below.

link(YourImageFieldName)

Example

Where the field value should be the filename of the image.

Downloaded image, specify the url (http or https):

link("http://www.yourserver.com/image1.jpg")

To merge a value and download the url:

link(join("http://www.yourserver.com/",YourMergeFieldName))

> Insert links

Use {{ and }} as tokens (not the # token) in the link like this:

Merging tables and lists

Merge arrays of data into your document.

> Merge data into table

Specify loop(listname) in the property window of the table. Right click the table and click "Table properties".

Examples

> Merge a list of items (not table)

Still use a bounding table with no header and only one 100% width column. See the next guide on how to remove the padding in the table.

> Remove table padding

Right click inside the table. Select the "Cell" tab and the Options button. Remove "Same for whole table" checkbox and enter 0 cm in all sides. See image below.

Example

Installation on server

> Libre Office components

Install latest Libre Office from:
https://www.libreoffice.org/

See also

More information about the available functions to call within a DOCX template is described at:
http://tech.docly.net/Hash-Templates