BPEL 设计器开发人员指南

在 BPEL 设计器中导航。

本指南提供了有关 BPEL 设计器功能的信息，该设计器允许您以可视方式编写流程图，同时设计器将自动为流程图生成符合 WS-BPEL 2.0 规范的 BPEL 源代码。

BPEL 编辑器视图

在 BPEL 编辑器中，可以在“源”视图、“设计”视图、“映射器”视图和“日志”视图之间进行切换。所有视图始终保持同步。

• “设计”视图

  “设计”视图是业务流程的可视设计器。在“设计”视图中，您可以添加、编译和删除图元素。在“设计”视图中构造的图会自动生成到符合 WS-BPEL 2.0 规范的 BPEL 源代码中，并带有 BPEL Service Engine User's Guide BPEL 2.0 Language Constructs 部分中列出的异常。

  在“项目”窗口中双击 BPEL 模块项目中的 BPEL 源文件将默认打开“设计”视图。要切换到“源”视图中的相应位置，右键单击“设计”视图中的元素并选择“转到源”（Alt-O）。

• “源”视图

  “源”视图将显示业务流程图的底层代码。“源”视图基于 IDE 的 XML 源视图并为访问提供了便利，如代码展开、语法高亮和代码完成功能。

  您可以执行源代码级别编辑以及可视化设计。BPEL 项目将执行双向工程以确保“设计”视图和“源”视图彼此保持同步。每次对源文件执行手动编辑时，IDE 都会自动重新解析 BPEL 源文件并重新生成图。

  要切换到“设计”视图中的相应位置，将光标移动到“源”视图中的代码行并选择“转到设计”（Alt-D）。

• “映射器”视图

  BPEL 映射器为处理和定向 BPEL 流程数据提供了一个框架。BPEL 映射器可用于分配值或设置条件。要切换到“映射器”视图，请按 Ctrl-Shift-F9 组合键或单击编辑器工具栏上的“映射器”标签。更多信息请参考 BPEL 映射器 一节。

• “日志”视图

  “日志”视图允许您设置流程的日志或报警规则。要切换到“映射器”视图，请按 Ctrl-Shift-F9 组合键或单击编辑器工具栏上的“映射器”标签。更多信息请参考 日志和报警 一节。

克隆文档视图

克隆文档功能是一个自定义选项，它允许克隆文档视图。例如，如果想要同时查看 BPEL 流程的“源”和“设计”视图（或者“设计”和“映射器”视图），可以执行以下操作。

一个文档的多个视图始终保持同步。

要克隆文档视图：

1. 打开 BPEL 文件
2. 右键单击带有文件名的标签并选择“克隆文档”。将会创建同一个文档的另一个标签。
3. 将一个标签拖动到您选择的位置：屏幕的左侧、右侧或底部。一个橙色框将会显示您拖动的窗口将会放置的位置。

导航器摂窗口

“导航”窗口伴随 BPEL 编辑器出现。如果未显示“导航”窗口，可通过从主菜单中选择“窗口”>“导航”或使用 Ctrl+7 组合键来手动调用此窗口。

“导航”窗口提供了两个不同的 BPEL 流程视图：BPEL 逻辑视图和 XML 视图。您可以使用位于“导航”窗口上面部分中的下拉菜单在“XML 视图”和“BPEL 逻辑视图”之间进行切换。

“导航”窗口的 XML 视图

“XML 视图”与为 NetBeans 中打开的所有 XML 文档提供的“导航”视图相同。“XML 视图”伴随 BPEL“源”视图出现。双击任何导航节点时，源代码编辑器将调整当前的代码行以显示选定的元素。

“导航”窗口的逻辑视图

“导航”窗口还提供了 BPEL 流程的 BPEL 逻辑视图。在“设计”视图中选择可视元素时，“导航”的“BPEL 逻辑视图”将显示选定的相同元素。或者，在“BPEL 逻辑视图”的树中选择某个节点时，也将在图中选定对应的元素。

右键单击“BPEL 逻辑视图”中的节点可调用弹出式菜单，其中包含与特定节点有关的操作。例如，对于分配元素，这些操作是“转至源”、“切换断点”、“删除”和“属性”。“转至源”和“转至设计”操作（可用于大多数节点）具有关联的快捷键：Alt-O 用于“转至源”，Alt-D 用于“转至设计”。

通常，“导航”窗口中的节点对应于图中的元素。此外，该窗口还包含一些节点（如“变量”和“关联集”）它们与不能从图中直接访问的功能有关。要查看业务流程中使用的变量，展开“导航”窗口“BPEL逻辑视图”中的“变量”节点。对于变量，您可以在弹出式菜单中对会话执行以下操作：

• 转至源。打开 BPEL 文件的源代码并将光标置于首次提到变量的位置。
• 转至类型源。打开包含变量类型定义的源代码文件。比如说 WSDL 文件。
• 查找用法。显示 BPEL 文件中的变量用法。关联集和“合作伙伴”元素的弹出菜单中也提供了该命令。

“导入”节点是一个特别实用的节点，它列出了借助于 BPEL 文件中的导入元素引用的 XSD 和 WSDL 文件。使用“导入”节点的弹出菜单可以引用 XSD 或 WSDL 文件。只能引用位于项目文件夹中的文件。

要将源文件（.wsdl 或者 .xsd）添加为导入：

1. 在“导航”窗口的“BPEL逻辑视图”中，右键单击“导入”节点并根据要导入文件的格式选择以下选项之一：“添加 WSDL” 导入或“添加模式导入”。
2. 在“创建新导入”对话框中，选择项目结构中要作为导入添加的文件。

   ---

   注意：首先需要将存储在您的项目目录中的文件添加到项目结构。然后，可以将它们作为导入添加。已经引用的文件将显示为删除线格式。

   ---

3. 查看只读的“名称空间”和“类型”字段中的值，然后单击“确定”。

   刚才添加的源文件将出现在“导航”窗口的“导入”节点下面。

在 WSDL 文件中添加属性：

从“导航”窗口，您可以将属性和属性别名添加到 BPEL 文档中应用的 WSDL 文件。

1. 在“导航”窗口的“BPEL 逻辑视图”中，右键单击“导入”节点下面的 WSDL 文件，然后从弹出式菜单中选择“添加属性”。
2. 在“创建新的关联属性”对话框中，指定属性名称。
3. 选择属性类型，然后单击“确定”。

在 WSDL 文件中添加属性别名：

1. 在“导航”窗口的“BPEL 逻辑视图”中，右键单击“导入”节点下面的 WSDL 文件，然后从弹出式菜单中选择“添加属性别名”。
2. 在“创建新属性别名”对话框中，单击“属性”字段旁边的“浏览”以指定属性。
3. 在“属性选择器”对话框中，选择要创建别名的属性，然后单击“确定”。将使用该属性的类型来填充“创建新属性别名”对话框中的“属性类型”字段。
4. 在“将属性映射到”树中，展开 WSDL 文件节点，然后选择消息或消息部件。
5. 要添加查询，请在“查询”文本字段中输入查询字符串。

   如果选中了“与树同步”复选框，则每次修改“映射属性到树”中的选项时都会更新“查询”字段。

6. 单击“确定”。

有关使用 WSDL 编辑器定义属性和属性别名的详细信息，请参见 WSDL 编辑器开发人员指南。

属性摂窗口

“属性”窗口包含当前选择的流程元素的属性信息。也可以使用 IDE 的“属性”窗口配置所有 BPEL 元素属性。“属性”窗口的内容应活动流程元素的不同而不同。每个元素只能使用两个“属性”窗口持久字段：

• Name。显示元素名称。
• Documentation。包含与元素相关的注释。更多信息请参阅“文档”一节。

要打开“属性”窗口，请选择“窗口”>“属性”或按 Ctrl-Shift-7 组合键。

滚动

从“项目”窗口 打开 BPEL 文件时，默认情况下将会在“设计”视图的编辑模式下打开图。在该模式下，可以编辑图并对其进行滚动。只要在“编辑器”工具栏上选择了导航模式，编辑模式就会启用。

在编辑模式中，可以使用以下方法滚动图：

• 调整鼠标滑轮。
• 使用垂直和水平滑动栏。
• 按 Tab 键在元素之间移动

放大和缩小

放大和缩小图。 缩入特性允许您减小或放大图的尺寸，以获得合适的视角。可以使用“编辑器”工具栏上的“缩放值”下拉列表修改缩放值。要查看适合窗口大小的图，请单击“适当地调整图大小”按钮。要查看适合窗口宽度的图，请单击“适当地调整宽度大小”按钮。

注意，最小缩放比率为 33%，并且一些较大的图可能无法完全适合窗口。

要更改缩放比例，请执行以下操作之一：

• 单击工具栏上的“放大”或者“缩小”按钮。
• 在工具栏上单击“适合图”按钮，对图进行缩放以适合窗口。
• 在工具栏上单击“适合宽度”按钮，对图的宽度进行缩放以适合窗口。
• 在工具栏打开导航模式，然后使用鼠标滚轮进行缩放。

打印 BPEL 图和源文件

您可以打印 BPEL 源文件和 BPEL 图，并自定义打印设置以适应需要，包括边框、页眉、脚注、颜色、行号和缩放比例。

要预览和打印 BPEL 图或源文件：

1. 在“设计”视图中打开 BPEL 文件。
2. 从主菜单中选择“文件”，然后执行以下操作之一：
   • 打印预览。预览打印布局或配置打印设置。
   • 打印为 HTML。以 HTML 文件格式打印 .bpel 文件。

自定义打印选项：

1. 在 IDE 中，选择要打印的对象：
2. 在“打印预览”窗口，单击“打印选项”。此时将打开“打印选项”对话框。
3. 将打印设置更改以适应需要：
   • 打印边框。在打印页面中添加一个边框。单击“颜色”图标可以更改边框颜色。
   • 打印页眉和页脚。指定页眉和脚注的文本、缩进、颜色和字体。要隐藏页眉或脚注，可以分别清除“打印页眉”或“打印脚注”复选框。要指定页眉或脚注模式文本，单击相应的缩进字段（左、中和右）并选择下面的按钮。例如，要在左下角添加打印时间，可以选择“打印页脚”复选框，单击“Left”字段，并单击“打印时间”图标。单击“选择脚注颜色”和“选择脚注字体”图标可以修改页眉和脚注的颜色和字体。
   • 行号。指定是否打印源文件的行号。
   • 封装行。 封装行以适应页面。
   • 按照编辑器中的设置打印。打印页面将与编辑器中显示的一样。
   • 文本字体和颜色。指定打印文本的颜色和字体，比如说源文件。
   • 背景颜色。指定背景颜色。
   • 行间距。指定行间距值。
   • 缩放。 指定在页面中打印的文本或图的缩放比例。可以选择适合宽度或高度，也可以选择具体的缩放比例。
5. 单击“确定”。

要自定义页面设置：

1. 在 IDE 中，选择要打印的对象：
2. 选择“文件”>“打印预览”。
3. 在“打印预览”窗口，单击“页面设置”。此时将打开“页面设置”对话框。
4. 还可以选择“文件”>“页面设置”调出“页面设置”对话框。
5. 在“页面设置”页面指定以下参数：
   • 纸张大小
   • 纸张来源
   • 纸方向
   • 页边大小
6. 单击“打印”按钮并指定打印机。
7. 单击“确定”。

返回顶部