两个git库之间迁移_IBM BPM迁移到盘古BPM步骤

      如果您认为可以从IBM导出BPMN，并希望能够在盘古BPM Modeler中打开它，那么您可能会感到惊讶。正如已经发现的那样，IBM BPMN导出不包含诸如盘古BPM Modeler之类的工具用来绘制图的图信息。在本教程中，我们将引导您通过两种方法，利用我们咨询团队开发的实用程序来帮助您创建一个完整的图，不仅可以在盘古BPM Modeler中打开，而且可以在任何BPMN兼容设计工具中打开并查看。

     盘古BPM Consulting团队创建了一套免费的工具，用于迁移流程。可以在此处找到用于迁移IBM流程流的工具。您会注意到，目前有两种可用于IBM的工具。一个是BPMN转换器，另一个是Teamworks文件(也称为.twx)转换器。我们将首先阅读BPMN转换器教程，然后逐步介绍.twx转换器。

BPMN转换器教程

      您可以在此处找到BPMN转换器。您会注意到这是一个Maven项目，几乎可以在任何集成开发环境中打开它。Eclipse和Intellij是最受欢迎的两种IDE。但是首先，您需要克隆或下载迁移工具存储库–您可以在此处进行。

在本教程中，我们将使用Eclipse作为我们的IDE。

• 克隆或下载Git存储库后，将IBM BPMN导出转换器工具存储库的内容复制到新的工作空间中。例如，如果您的Git存储库位于C：gitRepos，那么您将在文件图表中找到来自导出的BPMN的IBM BPMN转换器。

• 将整个文件夹复制到您选择的工作空间中。

• 接下来，启动Eclipse并选择您刚刚将内容复制到的工作区。Eclipse启动后，导航至“文件”>“导入”>“常规”>“来自文件夹或归档的项目”。

• 点击下一步。在出现的对话框中，单击目录，然后导航到刚复制到工作区中的文件夹。您的屏幕应该看起来像这样(见下文)

• 点击完成。

      该项目将被导入到您的工作区中。您可能想要更新所提供的代码和您的环境之间的所有Java编译器差异，但是它应该可以正常工作。

接下来，我们将创建一个Run配置，以允许您在Eclipse中运行转换器：

• 右键单击根项目文件夹，然后选择运行方式>运行配置…。

• 在出现的对话框中，双击Java应用程序以创建新配置。项目名称已在对话框中填写。您可以根据需要为该配置重新命名。

• 接下来，您需要选择一个主类。单击“搜索”按钮，您应该只会看到一个可用的类-BPMNDiagramGenerator。选择它，然后单击确定。

• 您的屏幕应如下所示：

      现在，您需要提供两个参数，第一个是从IBM BPMN导出的，第二个是转换后的文件的名称。为了以防万一，请在用引号引起来的“参数”选项卡的“程序参数”部分中输入路径和文件名。提供了一个示例BPMN文件，以帮助您入门。要使用此样本，请为输入和输出文件输入以下内容：

“ ./src/main/resources/SampleBPMNfromIBM.bpmn”
“ ./src/main/resources/Converted.bpmn”

您的屏幕应如下所示：

     点击运行。应该会打开一个控制台窗口，您应该在控制台中看到以下内容：

       从BPMN转换而来的BPMN图生成的图./src/main/resources/SampleBPMNfromIBM.bpmn，可以在./src/main/resources/Converted.bpmn中找到

      使用盘古BPM Modeler，打开Converted.bpmn文件，您会注意到其中的“ swimlane”(现在是盘古BPM BPMN中的“池”)并不像您期望的那样合适。

该算法只需设置高度和宽度的任意值，您就需要相应地调整车道的大小。您会注意到的其他事情是，转换后的图看起来与原始图完全不同。这是预期的，因为在导出的BPMN中没有任何内容可以指示任何坐标。下一节将解决该问题。最后，您会发现序列流不是典型的直线，而是简单的点对点线，随着对象的移动，点对点线将变为更熟悉的直线。

这是在Blueworks Live中创建并导出为BPMN的流程的示例：

这是在生成缺失图并相应调整池之后，盘古BPM Modeler中的过程：

      在下一节中，您将逐步介绍另一种使用另一种IBM BPM导出格式的工具，该格式将保留原始图的保真度。

     转换IBM BPM .twx文件导出

       如果需要图表保真度，并且可以以.twx(aka Teamworks)格式导出流程，则可以使用.twx迁移工具。.twx文件是IBM BPM的项目交换格式，其压缩xml文件中包含图信息。描述流程的xml文件类似于BPMN，但最肯定不是BPMN。我们将使用的项目确实包含一个示例xml文件，但我们将逐步指导您如何从自己的twx文件中提取所需的文件。

       如果您已经克隆/下载了git存储库，则只需重复前面详细介绍的步骤，即可在Eclipse工作区中复制并打开项目。您甚至可以使用在本教程前面创建的工作空间。只要确保将.twx工具复制到一个单独的目录中即可。

       接下来，我们将为项目中包含的示例创建一个运行配置。再次右键单击项目根文件夹，然后选择“运行方式”>“运行配置...”。
      在对话框中提供的选项中，双击Java应用程序。如果您以前使用的是同一工作区，请确保已选择“从TWX导出创建BPMN”作为项目。
     搜索主类，尽管这次您可能会看到多种选择。确保选择BPMNGenFromTWX作为主要类。
     接下来，我们需要像以前一样为该类提供两个参数，一个用于输入，一个用于输出。

“ ./src/main/resources/TWXOriginal.xml”“ ./src/main/resources/TWXConverted.bpmn”

      点击运行。应该会打开一个控制台窗口，您应该在控制台中看到以下内容：

     BPMN图生成的
    图./src/main/resources/TWXOriginal.xml是从IBM .twx导出转换而来的，可以       在./src/main/resources/TWXConverted.bpmn中找到

       resources文件夹包含IBM中原始流程的PNG文件(PictureOfProcess.PNG)，它看起来像这样：

使用Modeler，打开TWXConverted.bpmn，它看起来应该像这样：

      如您所见，通过使用.twx导出方法，您可以保持原始图的保真度，因为.twx导出包含相关的图信息，尽管不是遵循BPMN的形式。由于IBM和盘古BPM中的默认形状缩放比例，会有一些细微的差异。

      您在IBM BPM中的流程

      接下来，我们将讨论如何从.twx文件中提取流程xml，并将这些提取物用作工具的输入。.twx文件只是一个zip文件，最简单的解压缩方法是将扩展名从.twx更改为.zip，然后使用您喜欢的zip实用程序将内容提取到文件夹中。

      提取内容后，导航至根文件夹，然后继续导航至/ objects文件夹。正如您将看到的，它包含许多xml文件，这些文件将包括流程以及教练流程。通常，进程是最大的文件，名称以“ 25 ”开头。后跟一串字母数字字符。在您喜欢的文本编辑器中打开这些候选文件。在文件的开头，您会看到类似以下内容：

       搜索您想要转换的过程，并使用易于记忆的名称来复制文件，并将其用作该工具中另一个运行的输入。您可能还需要更改输出文件的名称。转换愉快！

创建一个jar文件

如果您只想创建任一实用程序的jar文件，则可以选择以下选项：

• 一种方法是右键单击pom.xml文件，然后选择“运行方式”>“ Maven安装”。

• 另一个方法是右键单击根文件夹，然后选择“在本地终端中显示”，然后发出以下Maven命令：mvn clean package install。

         无论哪种情况(或使用您自己的首选方法)，都应在/ target文件夹中获得一个jar文件。将该jar复制到任何位置，然后在终端中发出以下命令：

java -jar yourGeneratedJarFile。jar“您的输入文件”“您的输出文件”

而已！请随时在我们的论坛中提供反馈，并在此Git存储库中查看其他可用的转换器。