建设者简介
在本教程中,您将学习如何使用脚本和构建器在工作流中配置自动化任务。构造器执行多个步骤来创建和配置对象build ()
方法并返回完全构造的对象。您将创建一个新的资产,向资产添加属性并修改资产状态。
先决条件
- Eclipse IDE。
- Flowable Eclipse设计器插件。
- 以具有Sysadmin全亚愽视频局角色或至少具有工作流管理全局权限的全局角色的用户访问Collibra环境。
- 访问Collibra控制台进亚愽视频行故障排除。
有关更多安装细节和熟悉Eclipse IDE接口,请参见从工作流程开始.
创建一个脚本任务
打开Eclipse IDE和
- 创建一个新的可流动项目和图表。
- 添加存储池并配置其属性。
- 添加开始事件、脚本任务和结束事件,并将它们连接起来。
有关如何创建可流动项目和图表的更多信息,请参见从工作流开始和你好世界!教程。
添加Groovy支持
如果您更喜欢使用自己的编辑器来编写Groovy脚本,则可以跳过此步骤。
Apache Groovy编程语言允许Java和Collibra库之间的简单互操作性。亚愽视频
要在Eclipse中添加对Groovy语法高亮显示和自动补全的支持:
- 在菜单栏上,单击帮助→安装新软件….
- 在可用的软件窗口中,单击添加.
- 在添加库亮点:
- 输入一个的名字例如,Groovy-Eclipse.
- 为您的Eclipse版本输入相应的链接Groovy-Eclipse页面在位置字段。我们正在使用https://dist.springsource.org/release/GRECLIPSE/e4.9在这个例子中。
- 点击添加关闭添加库窗口。
- 在可用的软件窗口,选择主要包复选框。
- 确保在安装期间联系所有更新站点以查找所需的软件选中复选框,单击下一个.
- 查看安装详细信息后,单击下一个.
- 检查、接受许可协议,然后单击完成.
- 如果系统提示安全警告,请单击无论如何安装.
- 点击现在重启完成安装。
有关更多安装说明,请参见Groovy-Eclipse文档.
添加对Collibra Java亚愽视频 API v2的支持
如果您更喜欢使用自己的编辑器来编写Groovy脚本,可以跳过这一步,或者将其调整为适合自己的编辑器。
- 下载Collibra Ja亚愽视频va API库版本2:
- 去亚愽视频Collibra社区下载页面.
- 选择您的Collibra亚愽视频数据智能云版本。
- 下载dgc-core——<版本> -apiv2.jar文件。
- 在Eclipse中,在项目中创建一个新文件夹:
- 在可流动的探险家选项卡,右键单击项目名称。
- 选择新→文件夹.
- 在新文件夹窗口中,输入文件夹名称,然后单击完成.我们正在使用自由在这个例子中。
- 将下载的JAR文件移动到新文件夹中。
如果看不到刚才添加的文件,请刷新文件夹。
- 在可流动的探险家选项卡,右键单击项目名称并选择属性→Java构建路径→库.
- 在库的标签。Java构建路径部分中,点击添加jar….
- 在JAR的选择窗口中,选择Java API库version 2 JAR文件,单击好吧.
- 在属性窗口中,单击申请及关闭.
创建一个Groovy脚本文件
如果您更喜欢使用自己的编辑器来编写Groovy脚本,那么可以跳过这一步,在编辑器中创建一个新的Groovy脚本文件。
- 在可流动的探险家选项卡,右键单击项目名称并选择新→其他.
- 在新窗口,展开Groovy文件夹,选择Groovy类型并点击下一个.
- 在新型Groovy类型窗口,更改种类来脚本.
- 输入新文件的名称并单击完成.我们正在使用newAsset在这个例子中。
的newAsset.groovy文件被添加到项目中,并显示在共享区域中。
访问Collibra API亚愽视频文档
- 在Collibr亚愽视频a数据智能云环境中,单击信息图标在右上角。
- 点击API文档.
- 在API文档页面,单击核心API.
与Collibra Java AP亚愽视频I构建器一起工作
项下列出了所有支持的资产相关操作AssetApiCollibra Java API亚愽视频文档中的接口。
在工作流脚本任务的上下文中,<资源> Api接口(如AssetApi、CommunityTypeApi、FileApi等)已经实例化并可通过<资源> Api变量(如assetApi、communityTypeApi、fileApi等)。
该API利用通用唯一标识符(uuid)在Collibra数据智能云中查找资源。亚博 在线亚愽视频方法中提到的检索资源的UUID有几种方法查找资源id章节。获取UUID最简单的方法是从资源的URL:
https:// < yourdgcinstance > / <资源类型> / 00000000-0000-0000-0001-000100000001
在Co亚愽视频llibra Java API v2中,UUID是通过string2Uuid ()
辅助方法。
在引用任何类之前,必须首先引用它们的包。方法解析类引用进口
声明。有几种方法可以向脚本文件添加导入。最简单的方法是使用自动完成功能Ctrl / command +空格当输入类并选择一个可用选项时:
Eclipse自动完成类的名称,并在文件的开头添加必要的导入声明。
创建一个新资产
要创建新资产,请使用addAsset ()
方法,该方法需要AddAssetRequest
参数。的AddAssetRequest类有一个构建器()
可用的方法。
- 类:AssetApi
- 主要方法:AddAsset()
- 参数和构建方法:AddAssetRequest.builder()
- 主要方法:AddAsset()
构建器参数 | 强制性的 | 类型 | 描述 |
---|---|---|---|
名称() | 是的 | 字符串 | 设置资产的名称。 |
类型id () | 是的 | UUID | 设置资产类型。使用string2Uuid()帮助方法。 |
domainId () | 是的 | UUID | 将资产放置在域内。使用string2Uuid()帮助方法。 |
build () | 是的 | 构建对象。 | |
displayName () | 没有 | 字符串 | 设置资产的显示名称。默认情况下,显示名称与名称相同。 |
id () | 没有 | UUID | 设置资产的id。使用string2Uuid()帮助方法。 |
状态() | 没有 | UUID | 设置资产的状态。使用string2Uuid()帮助方法。 |
import com.亚愽视频collibra.dgc.core.api.dto.instance.asset.AddAssetRequest .builder() .name("DGC") .typeId(string2Uuid("00000000-0000-0000-0000- 00000000-0000- 0000000011003 ") .domainId(string2Uuid("00000000-0000-0000-0000-000000006013") .build());
该命令适用于打包的文件新业务术语域和首字母缩写资产类型。
为资产添加属性
要向资产添加属性,请使用setAssetAttributes ()
方法,该方法需要SetAssetAttributesRequest
参数。的SetAssetAttributesRequest类有一个构建器()
可用的方法。
- 类:AssetApi
- 主要方法:setAssetAttributes()
- 参数和构建方法:SetAssetAttributesRequest.builder()
- 主要方法:setAssetAttributes()
构建器参数 | 强制性的 | 类型 | 描述 |
---|---|---|---|
assetId () | 是的 | UUID | 标识资产。使用string2Uuid()帮助方法。 |
类型id () | 是的 | UUID | 设置属性类型。使用string2Uuid()帮助方法。 |
值() | 是的 | 列表 | 设置属性的一个或多个值。 |
build () | 是的 | 构建对象。 |
import com.亚愽视频 collibra.dc.core .api.dto.instance.asset. setassetattributesrequest assetApi.setAssetAttributes(SetAssetAttributesRequest.builder() .assetId(string2Uuid("1b2f8eb4-4f13-4cd2-a238-9a7d9666a93a")) .typeId(string2Uuid("00000000-0000-0000-0000-000000000202") .values(["数据治理中心"]).build());
该命令将资产的定义设置为数据治理中心.除非将资产UUID替换为有效的UUID,否则该命令将不起作用。
修改资产
要修改资产,请使用changeAsset ()
方法,该方法需要changeAssetRequest
参数。的changeAssetRequest类有一个构建器()
可用的方法。
- 类:AssetApi
- 主要方法:changeAsset()
- 参数和构建方法:ChangeAssetRequest.builder()
- 主要方法:changeAsset()
构建器参数 | 强制性的 | 类型 | 描述 |
---|---|---|---|
id () | 是的 | UUID | 标识资产。使用string2Uuid()帮助方法。 |
displayName () | 至少选择一个 | 字符串 | 更改资产的显示名称。 |
domainId () | 至少选择一个 | UUID | 将资产移动到域。使用string2Uuid()帮助方法。 |
名称() | 至少选择一个 | 字符串 | 更改资产的名称。 |
statusId () | 至少选择一个 | UUID | 更改资产的状态。使用string2Uuid()帮助方法。 |
类型id () | 至少选择一个 | UUID | 更改资产类型。使用string2Uuid()帮助方法。 |
build () | 是的 | 构建对象。 |
import com.亚愽视频collibra.dgc.core.api.dto.instance.asset.ChangeAssetRequest . changeasset (ChangeAssetRequest.builder() .id(string2Uuid("1b2f8eb4-4f13-4cd2-a238-9a7d9666a93a")) .statusId(string2Uuid("00000000-0000-0000-0000-000000005009")) .build());
该命令将资产的状态更改为批准.除非将资产UUID替换为有效的UUID,否则该命令将不起作用。
多个操作
这个例子创建了一个新的缩略词GDPR在包装中新业务术语域,添加描述并将状态更改为批准.
import com.亚愽视频collibra.dgc.core.api.dto.instance.asset.ChangeAssetRequest import com.collibra.dgc.core.api.dto.instance. Asset setassetattributesrequest import com.collibra.dgc.core.api.dto.instance. Asset资产GDPR = assetApi.addAsset(AddAssetRequest.builder() .name("GDPR") .typeId(string2Uuid("00000000-0000-0000-0000-000000011003") .domainId(string2Uuid(" 00000000-0000-0000-0000-00000000-6013 ") .build());assetApi.setAssetAttributes(SetAssetAttributesRequest.builder() .assetId(GDPR.getId()) .values(["通用数据保护条例"]).typeId(string2Uuid("0000000 -0000-0000-0000-000000000202") .build());assetApi.changeAsset(ChangeAssetRequest.builder() .id(GDPR.getId()) .statusId(string2Uuid("0000000 -0000-0000-0000-000000005009")) .build());
在工作流中使用脚本
您可以使用本教程中的任何示例,也可以创建自己的脚本,并将其添加到已创建的工作流中:
- 复制代码。
- 在工作流图上,选择脚本任务。
- 在属性视图中,选择主要配置部分。
- 从脚本语言下拉菜单,选择groovy.
- 将代码粘贴到脚本提起。
- 保存图表并将BPMN文件上传到Collibra Data Intelligence Clo亚愽视频ud。
- 中的工作流配置和启用设置鞘翅类的部分。亚愽视频
- 启动工作流。
如果没有错误,则在Collibra中创建或修改资产。亚愽视频的Business Glossary应用程序中可以找到它们所有业务资产视图。
故障排除
如果出现错误,则工作流不会启动,并显示错误消息。
日志包含有关错误的更多信息:
- 打开Col亚愽视频libra控制台。
亚愽视频Collibra控制台以基础设施页面。 - 单击您在其中部署工作流的环境的名称,以显示其详细信息。
- 选择数据治理中心.
- 选择日志→dgc.log
查找与Java或Groovy相关的错误。
下一个步骤
您已经创建了一个工作流,其中添加了一个新的首字母缩略词并设置了其属性,并在Collibra Data Intelligence Cloud中看到了结果。亚愽视频
下一个教程将在您构建复杂的工作流时测试您对用户和脚本任务、委托和独占网关的知识。