Variable replacement<\/a> is quite a popular way to get started generating Word documents.<\/p>\n I guess that’s because developers expect this sort of approach to be available, and its easy<\/em>: all you have to do is add your variables to the document, then bang, you replace them.<\/p>\n But its not all a bed of roses, there’s some thorns in there too:<\/p>\n Content control data binding is a great solution to these problems.<\/p>\n Your data (provided in XML format) is bound to content controls using XPath, and with the OpenDoPE conventions, this approach offers:<\/p>\n Some users create very complex\u00a0contracts and reports this way.<\/p>\n Automated Migration<\/strong><\/p>\n The good news is that docx4j contains code to automatically migrate\u00a0a document\u00a0which has\u00a0variables on its surface, to one which contains OpenDoPE content controls.<\/p>\n The code is in FromVariableReplacement.java<\/a><\/p>\n Have a look at the main method<\/a> to see how to use it.<\/p>\n There have been some fixes recently, so you should use docx4j-nightly-20180428.jar<\/a> (or 3.3.8 when released) or later.<\/p>\n OK, let’s assume you now have a docx file with content controls in it.\u00a0 You may want to further develop your template.\u00a0 For this you need an OpenDoPE Authoring tool.<\/p>\n OpenDoPE Authoring<\/strong><\/p>\n The\u00a0friendliest\u00a0OpenDoPE authoring tool is the “No-XML” Word AddIn<\/a>.<\/p>\n With this it is very easy to add conditions, but\u00a0the limitation is that it assumes a fixed XML format.\u00a0 \u00a0If you want to use your own XML format (or to bind escaped XHTML I suspect), you’ll need to use one of the older add ins.<\/p>\n Here we’ll walk through adding a condition with “No XML” add in.<\/p>\n For this example, we’ll use the Commonwealth of Australia’s model Confidentiality Agreement,\u00a0available at\u00a0http:\/\/www.business.gov.au\/IPToolkit<\/p>\n Here’s what the first few\u00a0blanks look like, represented as content controls with the “No XML” AddIn’s ribbon showing in Word:<\/p>\n I had pressed the “Show tags” button to be able to see the content controls in orange above.<\/p>\n Further down, there’s an optional Indemnity clause.<\/p>\n Since its optional, let’s wrap that in a conditional content control.\u00a0 First, we need a question “Do you want the Indemnity”.\u00a0 It works this way because this AddIn is aimed primarily at the interactive<\/strong><\/em> use case, that is, a user can answer questions in their web browser to generate an instance document.<\/p>\n But the resulting template can be used just as easily for the more common non-interactive \/ entirely programmatic case.<\/p>\n So click the “Insert Q\/A” button.\u00a0 I did this with my cursor somewhere in the middle of the Indemnity clause.<\/p>\n Fill in the form (for Multiple Choice choose yes):<\/p>\n click next, then on the next page, choose type boolean (true\/false), then ok.<\/p>\n You’ll see a content control inserted where your cursor was.\u00a0 We don’t really want that, so its a bit annoying (you can\/should delete it).\u00a0\u00a0You’ll see why we did this\u00a0just below.<\/p>\n Now select the clause heading and body, and click “Wrap with Condition”.\u00a0 You’ll see something like:<\/p>\n In the condition builder, define the following condition:<\/p>\n then click OK. (Now you can see why we needed to set up that question first)<\/p>\n Our resulting conditional clause appears as follows:<\/p>\n That’s all you need to do.\u00a0 We can now try generating an instance document from this template.<\/p>\n Document generation runtime<\/strong><\/p>\n To generate a document, use docx4j code to populate an Answers object, then call Docx4J.bind. For example:<\/p>\n where addAnswer is just:<\/p>\n How do you know what key to use?\u00a0 Look in the answers part in the docx and use the corresponding ID (yes, you should be able to see this in the AddIn, but the reason you can’t is that for the interactive use-case, you never need to know), or you can just invoke Docx4J.bind with debug level logging enabled for org.docx4j.model.datastorage, and it will print out the relevant part.<\/p>\n\n
\n
![\"NoXMLAddIn1\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/NoXMLAddIn1.png\")
<\/a><\/p>\n![\"qa_mcq\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/qa_mcq.png\")
<\/a><\/p>\n![\"condition1\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/condition1.png\")
<\/a><\/p>\n![\"indemnity_condition\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/indemnity_condition.png\")
<\/a><\/p>\n![\"indemnity_result\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/indemnity_result.png\")
<\/a><\/p>\n\r\nWordprocessingMLPackage wordMLPackage = WordprocessingMLPackage\r\n.load(new java.io.File(inputfilepath));\r\n\r\nanswers = new Answers();\r\n\r\naddAnswer("Sponsor_name_ACNABN_oW", "CSIRO of Some St, Sydney")\r\naddAnswer("want__Indemnity_clause_K8", "true"); \/\/ or false\r\n\/\/ etc\r\n\r\nDocx4J.bind(wordMLPackage, answers, Docx4J.FLAG_BIND_INSERT_XML & Docx4J.FLAG_BIND_BIND_XML);\r\nDocx4J.save(wordMLPackage, new File(outputfilepath), Docx4J.FLAG_NONE);\r\n<\/pre>\n\r\nprivate void addAnswer(String key, String value) {\r\nAnswer a = new Answer();\r\na.setId(key);\r\na.setValue(value);\r\nanswers.getAnswerOrRepeat().add(a);\r\n}\r\n<\/pre>\n
![\"answersPart\"](\"https:\/\/www.docx4java.org\/blog\/wp-content\/uploads\/2018\/04\/answersPart.png\")
<\/a><\/p>\n