Camunda BPM supports template engines which are implemented as script engines compatible withJSR-223. As a result, templates can be used everywhere where scripts can be used.

In community distributions of Camunda BPM, the following template engine is provided out of thebox:

Additionally, the following template engine is supported as enterprise extension:

  • XSLT

    Install a Template Engine

Install a Template Engine for an Embedded Process Engine

A template engine must be installed in the same way as a script engine. This means that the templateengine must be added to the process engine classpath.

When using an embedded process engine, the template engine libraries must be added to theapplication deployment. When using the process engine in a maven war project, the template enginedependencies must be added as dependencies to the maven pom.xml file:

Please import the Camunda BOM to ensure correct versions for every Camunda project.

  1. <dependencies>
  3.   <!-- freemarker -->
  4.   <dependency>
  5.     <groupId>org.camunda.template-engines</groupId>
  6.     <artifactId>camunda-template-engines-freemarker</artifactId>
  7.   </dependency>
  9.   <!-- apache velocity -->
  10.   <dependency>
  11.     <groupId>org.camunda.template-engines</groupId>
  12.     <artifactId>camunda-template-engines-velocity</artifactId>
  13.   </dependency>
  15. </dependencies>

Install a Template Engine for a Shared Process Engine

When using a shared process engine, the template engine must be added to the shared process engineclasspath. The procedure for this depends on the application server. In Apache Tomcat, thelibraries have to be added to the shared lib/ folder.

FreeMarker is pre-installed in the Camunda pre-packaged distribution.

Use a Template Engine

If the template engine library is in the classpath, you can use templates everywhere in the BPMNprocess where you can use scripts, for example as a script task or inputOutput mapping.The FreeMarker template engine is part of the Camunda BPM distribution.

Inside the template, all process variables of the BPMN element scope are available. Thetemplate can also be loaded from an external resource as described in the script sourcesection.

The following example shows a FreeMarker template, of which the result is saved in the process variabletext.

  1. <scriptTask id="templateScript" scriptFormat="freemarker" camunda:resultVariable="text">
  2.   <script>
  3.     Dear ${customer},
  5.     thank you for working with Camunda BPM ${version}.
  7.     Greetings,
  8.     Camunda Developers
  9.   </script>
  10. </scriptTask>

In an inputOutput mapping it can be very useful to use an external template to generate thepayload of a camunda:connector.

  1. <bpmn2:serviceTask id="soapTask" name="Send SOAP request">
  2.   <bpmn2:extensionElements>
  3.     <camunda:connector>
  4.       <camunda:connectorId>soap-http-connector</camunda:connectorId>
  5.       <camunda:inputOutput>
  7.         <camunda:inputParameter name="soapEnvelope">
  8.           <camunda:script scriptFormat="freemarker" resource="soapEnvelope.ftl" />
  9.         </camunda:inputParameter>
  11.         <!-- ... remaining connector config omitted -->
  13.       </camunda:inputOutput>
  14.     </camunda:connector>
  15.   </bpmn2:extensionElements>
  16. </bpmn2:serviceTask>

Use XSLT as Template Engine

Enterprise Feature

Please note that this feature is only included in the enterprise edition of the Camunda BPM platform, it is not available in the community edition.

Check the Camunda enterprise homepage for more information or get your free trial version.

Install the XSLT Template Engine

The XSLT Template Engine can be downloaded from the Enterprise Edition Download page.

Instructions on how to install the template engine can be found inside the downloaded distribution.

Use XSLT Template Engine with an embedded process engine

When using an embedded process engine, the XSLT template engine library must be added to theapplication deployment. When using the process engine in a maven war project, the template enginedependency must be added as dependencies to the maven pom.xml file:

Please import the Camunda BOM to ensure correct versions for every Camunda project.

  1. <dependencies>
  3.   <!-- XSLT -->
  4.   <dependency>
  5.     <groupId>org.camunda.bpm.extension.xslt</groupId>
  6.     <artifactId>camunda-bpm-xslt</artifactId>
  7.   </dependency>
  9. </dependencies>

Use XSLT Templates

The following is an example of a BPMN ScriptTask used to execute an XSLT Template:

  1. <bpmn2:scriptTask id="ScriptTask_1" name="convert input"
  2.                   scriptFormat="xslt"
  3.                   camunda:resource="org/camunda/bpm/example/xsltexample/example.xsl"
  4.                   camunda:resultVariable="xmlOutput">
  6.   <bpmn2:extensionElements>
  7.     <camunda:inputOutput>
  8.       <camunda:inputParameter name="camunda_source">${customers}</camunda:inputParameter>
  9.     </camunda:inputOutput>
  10.   </bpmn2:extensionElements>
  12. </bpmn2:scriptTask>

As shown in the example above, the XSL source file can be referenced using the camunda:resourceattribute. It may be loaded from the classpath or the deployment (database) in the same way asdescribed for script tasks.

The result of the transformation can be mapped to a variable using the camunda:resultVariableattribute.

Finally, the input of the transformation must be mapped using the special variable camunda_sourceusing a <camunda:inputParameter … /> mapping.

A full example of the XSLT Template Engine in Camunda BPM can be found in theexamples repository..

原文: https://docs.camunda.org/manual/7.9/user-guide/process-engine/templating/