{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"}},"macroMetadata":{"macroId":{"value":"d445d8efb41ef666b72315a7337a3144"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9392a78b-5904-4c66-b98a-87b2068d0246"}},{"type":"rule"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This page is about \"classic\" templates. You can find more information ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://primedocsen.wikipage.io/c/61407388/template+types"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Each template or template type provides its part to complete the final document. For example, the style template provides all the font formatting. The different template types can thus be combined in any way and exchanged or updated at any time. This avoids redundancies in template construction. The documents are always regenerated at runtime.","type":"text"}]},{"type":"panel","attrs":{"panelIconId":"atlassian-warning","panelIcon":":warning:","panelColor":"#FFFAE6","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"CAUTION","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If your templates and/or snippets are constantly changed, it cannot be guaranteed that documents generated and saved in the past will still work when you update them again. The reason for this is that the document was saved in different circumstances. It now points to the new version of the template when it is reopened and updated.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This graph shows the ","type":"text"},{"text":"maximum","type":"text","marks":[{"type":"strong"}]},{"text":" inheritance level – each level is optional.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1217,"id":"d960639e-5419-4c7d-93d8-f9e4bd22292f","collection":"contentId-61407402","type":"file","height":760}}]},{"type":"paragraph","content":[{"text":"The document pipeline contains a template specific list of functions that are realized as plug-ins and are loaded when primedocs is started. Which document functions are used in which order in a template is defined by the template editor in the administration view of the client. Document functions contain self-contained procedures that are applied to the document, interfaces, etc.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"We use the terms \"higher\" and \"lower\", according to the graph above:","type":"text"},{"type":"hardBreak"},{"text":"Higher means that the document function has been defined on a style, for example.","type":"text"},{"type":"hardBreak"},{"text":"Lower means that the document function has been defined closer to the actual document.","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Document function inheritance","type":"text"}]},{"type":"paragraph","content":[{"text":"All document functions configured on the templates at the various levels in the template inheritance system are combined in a chain. Each document function is added only once. If a document function is added to a function template, for example, it will be executed at the end of the execution order.","type":"text"}]},{"type":"paragraph","content":[{"text":"However, there are exceptions: Due to the system, some document functions are automatically moved to the end of the chain. This applies, for example, to the document functions \"","type":"text"},{"text":"Scripts","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61408115"}}]},{"text":"\" or \"","type":"text"},{"text":"Library for advanced binding","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61408202"}}]},{"text":"\" (Extended bindings).","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Active and deactivated document functions","type":"text"}]},{"type":"paragraph","content":[{"text":"If you define the document function \"","type":"text"},{"text":"document parameter","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407823"}}]},{"text":"\" on style level, all templates based on the style inheriting this function have this function automatically attached as well. If you now deactivate the document parameter in the content template, it will be deactivated for the document generation as a whole.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overwrite configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If you define a document function on ","type":"text"},{"text":"different","type":"text","marks":[{"type":"strong"}]},{"text":" levels, the following rule applies for most document functions: The configuration that was configured ","type":"text"},{"text":"closer","type":"text","marks":[{"type":"strong"}]},{"text":" to the final document is selected in the Document Engine.","type":"text"}]},{"type":"paragraph","content":[{"text":"Exception to this rule is e.g., the document function \"Scripts\": Here the different dataNodes from each level are put together, so that in the end all scripts from all levels can be run through.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Transformation","type":"text"}]},{"type":"paragraph","content":[{"text":"Besides overwriting or activating/deactivating a higher document function, there is also the possibility to specifically overwrite configuration entries from a higher level (e.g. Style). This kind of configuration allows to make very precise changes to an existing configuration. However, this requires familiarization with the ","type":"text"},{"text":"\"XDT\" transformations","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.microsoft.com/en-us/previous-versions/aspnet/dd465326(v=vs.110)"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A transformation is only started if the following XML namespace is applied:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"xmlns:xdt=\"http://schemas.microsoft.com/XML-Document-Transform\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Without this XML namespace the normal merge mechanism is used, which mostly replaces the whole configuration with the higher one.","type":"text"}]},{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Layout template with document function \"Formatting\":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Headings\n \n Title\n \n \n Subtitle\n \n \n \n Various\n \n Emphasis\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Now other headings are to be used in a certain Word template. Without transformation, the whole content would have to be copied between the ","type":"text"},{"text":"DocumentFunction","type":"text","marks":[{"type":"code"}]},{"text":" tags and then modified. With transformation only a section of the configuration can be defined. Thereby the sections are added as follows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Whole groups are transformed: ","type":"text"},{"text":"xdt:Transform=\"Replace\" xdt:Locator=\"Match(name)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only a single line is transformed: ","type":"text"},{"text":"xdt:Transform=\"Replace\" xdt:Locator=\"Match(type)\"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Note the XML namespace: xmlns:xdt=\"http://schemas.microsoft.com/XML-Document-Transform\"","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Here are a few examples:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n Headings\n \n Title\n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"It is also possible to chain several transformations one after the other, for example, in order for a function template to transform the existing configuration again:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"A complete documentation about all XDT actions can be found in ","type":"text"},{"text":"MSDN","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.microsoft.com/en-us/previous-versions/aspnet/dd465326(v=vs.110)"}}]},{"text":".","type":"text"}]}],"version":1}

Browser not supported