Camunda平台支持模板引擎，兼容JSR-223的脚本引擎。因此，模板用于任何可以使用脚本的地方。

在Camunda平台的社区版本中，以下模板引擎是开箱即用的：

• FreeMarker

以下模板引擎是作为插件添加：

• Apache Velocity

脚本引擎包装器的实现可以在camunda-template-engines资源库中找到。

此外，以下模板引擎可以在企业版中使用：

• XSLT

安装一个模板引擎

为嵌入式流程引擎安装模板引擎

模板引擎和脚本引擎是用相同方式安装的。这意味着模板引擎必须被添加到流程引擎的classpath中。

使用嵌入式流程引擎时，模板引擎库必须添加到应用程序部署中。在mavenwar项目中使用流程引擎时，模板引擎依赖必须作为依赖项添加到mavenpom.xml文件中。

<dependencies>

  <!-- freemarker -->
  <dependency>
    <groupId>org.camunda.template-engines</groupId>
    <artifactId>camunda-template-engines-freemarker</artifactId>
  </dependency>

  <!-- apache velocity -->
  <dependency>
    <groupId>org.camunda.template-engines</groupId>
    <artifactId>camunda-template-engines-velocity</artifactId>
  </dependency>

</dependencies>

为分布式流程引擎安装一个模板引擎

当使用一个分布式流程引擎时，模板需要添加到分布式流程引擎的classpath中。classpath的位置取决于应用服务器。在Apache Tomcat中，库必须被添加到共享的lib/文件夹中。

使用模板引擎

如果模板引擎库在classpath中，你可以在BPMN流程中任何可以使用脚本的地方使用模板，例如作为一个脚本任务或输入输出映射。 FreeMarker模板引擎是Camunda平台发布的一部分。

在模板内部，BPMN元素范围的所有流程变量都是可用的。模板也可以从外部资源加载，如脚本源部分所述。

下面的例子显示了一个FreeMarker模板，它的结果被保存在流程变量text中：

<scriptTask id="templateScript" scriptFormat="freemarker" camunda:resultVariable="text">
  <script>
    Dear ${customer},

    thank you for working with Camunda Platform ${version}.

    Greetings,
    Camunda Developers
  </script>
</scriptTask>

在输入输出映射中，使用外部模板来生成 “camunda:connector” 的有效载荷是非常有用的。

<bpmn2:serviceTask id="soapTask" name="Send SOAP request">
  <bpmn2:extensionElements>
    <camunda:connector>
      <camunda:connectorId>soap-http-connector</camunda:connectorId>
      <camunda:inputOutput>

        <camunda:inputParameter name="soapEnvelope">
          <camunda:script scriptFormat="freemarker" resource="soapEnvelope.ftl" />
        </camunda:inputParameter>

        <!-- ... remaining connector config omitted -->

      </camunda:inputOutput>
    </camunda:connector>
  </bpmn2:extensionElements>
</bpmn2:serviceTask>

使用模板引擎 XSLT

安装 XSLT 模板引擎

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.

在嵌入式流程引擎中使用XSLT模板引擎

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

<dependencies>

  <!-- XSLT -->
  <dependency>
    <groupId>org.camunda.bpm.extension.xslt</groupId>
    <artifactId>camunda-bpm-xslt</artifactId>
  </dependency>

</dependencies>

使用 XSLT 模板

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

<bpmn2:scriptTask id="ScriptTask_1" name="convert input"
                  scriptFormat="xslt"
                  camunda:resource="org/camunda/bpm/example/xsltexample/example.xsl"
                  camunda:resultVariable="xmlOutput">

  <bpmn2:extensionElements>
    <camunda:inputOutput>
      <camunda:inputParameter name="camunda_source">${customers}</camunda:inputParameter>
    </camunda:inputOutput>
  </bpmn2:extensionElements>

</bpmn2:scriptTask>

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

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

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

A full example of the XSLT Template Engine in Camunda Platform can be found in the examples repository..