Flowable 6.6.0 Eclipse设计器 - 5.扩展Flowable设计器 - 5.1定制调色板概述

Flowable 6.6.0 用户指南相关文档下载

• BPMN用户指南 第一部分 - 中文PDF精编版
• BPMN用户指南 第二部分 - 中文PDF精编版
• BPMN用户指南 第三部分 - 中文PDF精编版
• 应用程序指南 - 中文PDF精编版
• 应用程序指南 - 中英对照PDF精编版
• 应用程序指南 - Eclipse设计器中文PDF精编版
• 表单用户指南 - 中文PDF精编版
• 事件注册表用户指南 - 中文PDF精编版

有关Flowable文档的其他资料，参见：

《Flowable文档大全》

---

《Flowable 6.6.0 Eclipse设计器》

1 安装（Installation）

2 Flowable 设计器编辑器特性（Flowable Designer editor features）

3 Flowable设计器BPMN 特性（Flowable Designer BPMN features）

4 Flowable设计器部署特性（Flowable Designer deployment features）

5 扩展Flowable设计器（Extending Flowable Designer）

• 5.1 定制调色板（Customizing the palette）

  • 5.1.1 扩展设置（Eclipse/Maven）Extension setup (Eclipse/Maven)

  • 5.1.2 在Flowable设计器中应用扩展（Applying your extension to Flowable Designer）

  • 5.1.3 向调色板增加形状（Adding shapes to the palette）

  • 5.1.4 配置自定义服务任务的运行时执行（Configuring runtime execution of Custom Service Tasks）

  • 5.1.5 属性类型（Property types）

  • 5.1.6 禁用调色板的缺省形状（Disabling default shapes in the palette）

• 5.2 图验证及自定义输出格式（Validating diagrams and exporting to custom output formats）

---

5 扩展Flowable设计器（Extending Flowable Designer）

You can extend the default functionality offered by Flowable Designer. This section documents which extensions are available, how they can be used and provides some usage examples. Extending Flowable Designer is useful in cases where the default functionality doesn’t suit your needs, you require additional capabilities or have domain-specific requirements when modeling business processes. Extension of Flowable Designer falls into two distinct categories: extending the palette and extending output formats. Each of these extension types requires a specific approach and different technical expertise.

您可以扩展Flowable Designer提供的默认功能。本节说明可用哪些扩展，如何使用，并提供一些使用示例。在默认功能不适合您的需要、您需要其他功能或在建模业务流程时具有特定于领域的需求时， Flowable设计器扩展非常有用。Flowable设计器的扩展分为两个不同的类别：扩展调色板和扩展输出格式。每种扩展类型都需要特定的方法和不同的技术专长。

Note
Extending Flowable Designer requires technical knowledge and, more specifically, knowledge of programming in Java. Depending on the type of extension you want to create, you might also need to be familiar with Maven, Eclipse, OSGi, Eclipse extensions and SWT.

注意
扩展Flowable Designer需要技术知识，更具体地说，需要Java编程知识。根据您想要创建扩展类型，您可能还需要熟悉Maven、Eclipse、OSGi、Eclipse扩展和SWT。

5.1 定制调色板（Customizing the palette）

You can customize the palette that is offered to users when modeling processes. The palette is the collection of shapes that can be dragged onto the canvas in a process diagram and is displayed to the right-hand side of the canvas. As you can see in the default palette, the default shapes are grouped together (these are called “drawers”) for Events, Gateways and so on. There are two options built-in to Flowable Designer to customize the drawers and shapes in the palette:

您可以在建模流程时提供给用户自定义的调色板。调色板是可以在流程图中拖到画布上并显示在画布右侧的形状的集合。正如您在默认调色板中看到的，默认形状被组合在一起（这些形状称为“抽屉”），用于事件、网关等。Flowable Designer内置两个选项，用于自定义调色板中的抽屉和形状：

• Adding your own shapes / nodes to existing or new drawers
• Disabling any or all of the default BPMN 2.0 shapes offered by Flowable Designer, with the exception of the connection and selection tools
• 将您自己的形状/节点添加到现有或新的抽屉中
• 禁用一个或所有的Flowable Designer提供的默认BPMN 2.0形状，连接和选择工具（connection and selection tool）除外
  In order to customize the palette, you create a JAR file that is needs to be added to every installation of Flowable Designer (more on how to do that later). Such a JAR file is called an extension. By writing classes that are included in your extension, Flowable Designer understands which customizations you wish to make. In order for this to work, your classes should implement certain interfaces. There is an integration library available with those interfaces and base classes to extend, which you should add to your project’s classpath.

为了定制调色板，您需要创建一个JAR文件，该文件需要添加到每个Flowable设计器的安装中（稍后将详细介绍如何进行此操作）。这样的JAR文件称为扩展（extension）。通过编写您的扩展中包含的类，Flowable设计器了解您希望进行哪些自定义。为了使其工作，您的类应该实现某些接口。有一个集成库可用于扩展这些接口和基类，您应该将其添加到项目的classpath中。

You can find the code examples listed below in source control with Flowable Designer. Take a look in the examples/money-tasks directory in the flowable-designer repository of Flowable’s source code.

您可以在使用Flowable设计器的源代码管理中找到下面列出的代码示例。在Flowable’s 源代码（source code）的flowable-designer存储库中查看examples/money-tasks目录。

Note
You can setup your project in whichever tool you prefer and build the JAR with the build tool of your choice. For the instructions below, a setup is assumed with Eclipse Mars or Neon, using Maven (3.x) as build tool, but any setup should enable you to create the same results.

注意
您可以在您喜欢的任何工具中设置项目，并使用您选择的构建（build）工具构建JAR。对于下面的说明，假设使用Eclipse Mars或Neon进行设置，使用Maven（3.x）作为构建工具，但是任何设置都应该保证您能创建相同的结果。