华为云用户手册

支持的动作 获取部门ID列表 创建部门 更新部门 删除部门 获取成员ID列表 创建成员 更新成员 删除成员 获取群聊会话 创建群聊会话 修改群聊会话 推送文本消息 推送markdown消息 推送文件消息 推送图片消息 推送图文消息 推送文本卡片消息 撤回应用消息 推送文本消息到群聊 推送markdown消息到群聊 推送文件消息到群聊 推送图片消息到群聊 推送图文消息到群聊 推送文本卡片消息到群聊 机器人推送文本消息 机器人推送markdown消息 机器人推送文件消息 机器人推送图片消息 机器人推送图文消息

创建企业微信连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“企业微信”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 连接类型 选择连接类型。 机器人：若需要使用机器人推送消息功能，选择机器人； 应用：其他功能选择应用。 企业ID 仅当“连接类型”选择“应用”时需要配置。 每个企业都拥有唯一的corpid，详情见企业微信《企业内部开发服务端API文档》“基本概念介绍”章节。 应用凭证密钥 仅当“连接类型”选择“应用”时需要配置。 每一个应用都有一个独立的访问密钥，详情见企业微信《企业内部开发服务端API文档》“基本概念介绍”章节。 机器人Key 仅当“连接类型”选择“机器人”时需要配置。 机器人webhook中的请求参数key的值。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 创建项目 参数 说明 Project Name 项目名称。 Project Key 项目唯一标识。 Project模板类型 项目模板。 项目描述 描述。 表2 更新项目 参数 说明 update by Project Key 项目唯一标识。 Project Name 项目名称。 项目描述 描述。 表3 查询项目详情 参数 说明 Project Key 项目唯一标识。 表4 删除项目 参数 说明 delete by Project Key 项目唯一标识。 表5 创建issue 参数 说明 Project类型 项目类型。 Project Key 项目唯一标识。 Issue类型 issue类型。 优先级 issue优先级。 概要 issue概要。 提出者 请输入用户名称。 分配给 请输入用户名称。 描述 issue描述。 表6 修改issue 参数 说明 Project类型 项目类型。 Project Key 项目唯一标识。 名称 请输入issue名称或id。 Issue类型 issue类型。 优先级 issue优先级。 概要 issue概要。 提出者 请输入用户名称。 分配给 请输入用户名称。 描述 issue描述。 表7 修改issue状态 参数 说明 Issue名称 请输入issue名称或id。 转换目标状态 需要选择issue支持的状态。 表8 查询issue列表 参数 说明 Jql jira查询请求表达式。 偏移量 分页offset，默认为0。 最大返回数 分页limit。 表9 查询issue详情 参数 说明 Issue名称 请输入issue名称或id。 表10 查询issue可指派用户 参数 说明 Project Key 项目唯一标识，新建issue情况下必填。 Issue名称 请输入issue名称或id，Project Key未填时该字段必填。 JIRA用户名称 用于精确查询。 表11 添加评论 参数 说明 Issue名称 请输入issue名称或id。 可见性 指定可见人范围。 描述 评论内容。 表12 修改评论 参数 说明 Issue名称 请输入issue名称或id。 评论ID 评论的id。 描述 评论内容。 可见性 指定可见人范围。 表13 查询评论列表 参数 说明 Issue名称 请输入issue名称或id。 偏移量 分页offset，默认为0。 最大返回数 分页limit。

创建JIRA连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Jira Software”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 连接类型 选择JIRA的连接类型。 Cloud：指在云端部署的JIRA实例，用户可以使用任何Web浏览器从任何地方访问它。 On-Premise：指本地安装的JIRA实例，需要在自己的服务器或本地PC上安装和配置JIRA。 连接地址 填写JIRA的连接地址。 当“连接类型”选择“Cloud”时，连接地址格式为https://your-domain.atlassian.net。 your-domain指组织或团队的 域名 ，需要有有效的Jira Cloud订阅才能访问该地址。如果不确定您的Jira Cloud连接地址，可以从Atlassian账户或管理员处获取。 当“连接类型”选择“On-Premise”时，填写JIRA所在服务器的IP地址或主机名，例如：http://192.168.0.1:8080或http://jira.example.com:8080。 认证类型 选择JIRA的认证类型，支持选择“Basic”和“API Token”。 用户名 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户名。 密码 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户密码。 邮箱 仅当“认证类型”选择“API Token”时需要配置。 JIRA的邮箱。 API Token 仅当“认证类型”选择“API Token”时需要配置。 用户需要在JIRA的个人设置中生成一个API Token，API Token是一种用于身份验证的令牌，它允许JIRA用户通过API访问其账户和相关数据。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 实时计算单个自定义报表 参数 说明 project_id 项目ID。 plan_id 分支/计划ID。 region_id 区域ID。 name 报表名称。 workpiece_type 工件类型（用例：case，测试套：suite）。 analysis_dim_row 分析维度。 compare_dim_column 对比维度。 creatorIds 创建人。 ownerIds 所属人。 ranks 级别。 releaseIds releaseId。 status 状态。 moduleIds 模块ID。 results 结果。 labelIds 标签。 startTime 开始时间。 endTime 结束时间。 isAssociateIssue 是否关联需求。 表2 查询某个测试计划下的需求树 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示条目数量，最大支持200条。 表3 查询某测试计划下的操作历史 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表4 获取环境参数分组列表 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表5 通过导入仓库中的文件生成接口测试套 参数 说明 project_id 项目ID。 region_id 区域ID。 testsuite_name 要生成的测试套名称。 repository_id 仓库ID。 repository_branch 仓库分支。 file_path 仓库中yaml或json文件的相对路径，仅支持Swagger 2.0版本的yaml和json文件。 表6 计划中批量添加测试用例 参数 说明 project_id 项目ID。 plan_id 计划ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id_list 计划下包含的用例个数，数组长度小于50个，只能包含一种测试类型。 表7 项目下查询测试计划列表v2 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 name 针对测试计划名称模糊查询。 current_stage 测试计划所处阶段（create,design,execute,report）。 表8 项目下创建计划 参数 说明 project_id 项目ID。 region_id 区域ID。 name 计划名称。 assigned_id 处理者ID。 service_id_list 计划下包含的用例类型，数组长度小于10。 start_date 计划开始时间，要求用UTC时间表示，如2020-03-04。 end_date 计划结束时间，要求用UTC时间表示，如2020-03-04。 表9 项目下查询测试计划列表 参数 说明 project_id 项目ID。 region_id 区域ID。 name 针对测试计划名称模糊查询使用。 current_stage 测试计划所处阶段（create,design,execute,report）。 offset 页号，取值范围1-20000。 limit 每页显示条目数量，取值范围1-200。 表10 通过用例编号获取测试用例详情 参数 说明 project_id 项目ID。 region_id 区域ID。 testcase_number 用例编号。 表11 批量更新测试用例结果 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id 测试用例ID。 execute_id 注册服务执行ID。 result_id 测试用例结果，（0-成功，1-失败，5-执行中，6-停止）。 end_time 用例结束执行的时间戳，在执行结束时该字段必填。 duration 执行用例持续时长ms，更新状态时该字段必传。 description 用于记录该次结果执行的备注信息。 表12 批量执行测试用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 plan_id 测试计划ID testcase_id 测试用例ID execute_id 注册服务执行ID。 result_id 测试用例结果（0-成功，1-失败，5-执行中，6-停止）。 start_time 用例开始执行的时间戳，在执行开始时该字段必填。 表13 更新自定义测试服务类型用例 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 注册测试类型服务接口返回的服务ID。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 status_id 测试用例状态信息（0-新建，5-设计中，6-测试中，7-完成）。 defect_id_list 缺陷ID信息。 表14 获取测试用例详情 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 表15 批量删除自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 test_case_id_list 测试用例ID。 表16 创建自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 该值由注册接口返回。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 表17 删除已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 表18 更新已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表19 新测试类型服务注册 参数 说明 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表20 用户获取自己当前已经注册的服务 参数 说明 region_id 区域ID。

创建CodeArts TestPlan连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts TestPlan”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

支持的动作 实时计算单个自定义报表 查询某个测试计划下的需求树 查询某测试计划下的操作历史 获取环境参数分组列表 通过导入仓库中的文件生成接口测试套 计划中批量添加测试用例 项目下查询测试计划列表v2 项目下创建计划 项目下查询测试计划列表 通过用例编号获取测试用例详情 批量更新测试用例结果 批量执行测试用例 更新自定义测试服务类型用例 获取测试用例详情 批量删除自定义测试服务类型用例 创建自定义测试服务类型用例 删除已注册服务 更新已注册服务 新测试类型服务注册 用户获取自己当前已经注册的服务

支持的动作 获取分支目录下的文件；获取仓库统计数据；修改被流水线引用的仓库状态；判断用户是否有仓库的管理员权限；设置仓库是公开状态还是私有状态；获取一个项目下可以设置为公开状态的仓库列表；获取公开示例模板列表；获取项目下所有仓库信息；校验指定项目下的仓库名；创建仓库；根据仓库名组名获取仓库短id，用以拼接与commitid对应提交详情页面url；根据组名和仓库名查询某仓库某分支对应的提交；查询指定仓库的webhook；为指定仓库添加hook；删除指定仓库的 hook；查询某仓库对应的分支；根据仓库id查询仓库某分支对应的提交，提供更多可选参数；添加部署密钥；删除仓库部署密钥；获取仓库上一次的提交统计信息；仓库统计；查询项目下的某个仓库；删除仓库；获取仓库所有成员记录；添加仓库成员；设置成员在仓库中的角色；删除仓库成员；查看仓库的创建状态；https账号密码校验；获取ssh key列表；添加ssh key；检验私钥是否有拉取代码的权限；删除用户公钥；查询用户的所有仓库；创建项目、仓库；创建项目并fork仓库；查询项目下的所有仓库；查询某仓库的标签列表；新建标签；查询某个仓库的详细信息；查询某个仓库的提交信息；创建提交；查询某个仓库的特定提交信息；查询某个仓库的提交差异信息；查询某个仓库的文件信息；获取代码提交行数；下载仓库；新建保护分支；获取仓库分支列表；分支关联工作项；获取仓库合并请求列表；获取仓库合并请求详情。

创建CodeArts Repo连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“华为云服务”类别下的“CodeArts Repo”。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 获取项目下流水线执行状况 参数 说明 region_id 区域ID。 project_id 项目ID。 start_date 起始日期，起始日期和结束日期间隔不超过一个月，查询包含起始日期。 end_date 结束日期，起始日期和结束日期间隔不超过一个月，查询包含结束日期。 offset 偏移量，表示从此偏移量开始查询，offset大于等于0。 limit 每次查询的条目数量。 表2 获取流水线状态 参数 说明 pipeline_id 要获取状态的流水线ID。 region_id 区域ID。 build_id 要获取状态的执行ID。 表3 获取流水线列表接口 参数 说明 region_id 区域ID。 pipeline_name 流水线名字。参数存在，则进行模糊匹配。 project_ids devCloud项目ids。该参数存在，则获取对应项目下的流水线列表，逗号分隔，id个数取值[0,10]；如果不存在，则获取调用方所属租户的流水线列表。 creator_ids 创建人id。该参数存在，逗号分隔，id个数取值[0,10]。 executor_ids 执行人id。该参数存在，逗号分隔，id个数取值[0,10]。 status 流水线运行状态。取值范围：waiting,running,verifying,handling,suspending,completed。 outcome 流水线结果，标记流水线。error、success、aborted。 sort_key 用于排序的字段。取值为：pipeline_name,create_time,start_time。 sort_dir 排序类型。asc按排序字段升序，desc按排序字段降序。 git_url codehub搜索链接：git@codehub.XXX.git；gitee搜索链接：git@gitee.com.XXX.git；github搜索链接：git@github.com.XXX.git等。 offset 偏移量。表示从此偏移量开始查询，offset大于等于0，默认取值为0。 limit 每次查询的条目数量。取值[10-50]，默认取值为10。 表4 删除流水线 参数 说明 pipeline_id 要删除的流水线ID。 region_id 区域ID。 表5 批量获取流水线状态 参数 说明 region_id 区域ID。 pipeline_ids 要获取状态的流水线ID，用逗号隔开。 表6 停止流水线 参数 说明 pipeline_id 流水线ID。 region_id 区域ID。 build_id 流水线执行ID。 表7 启动流水线 参数 说明 pipeline_id 流水线ID。 region_id 区域ID。 name 构建参数名。 value 构建参数值，最大长度为8192。 表8 检查流水线创建状态 参数 说明 task_id 实例ID。 region_id 区域ID。 表9 查询模板详情 参数 说明 template_id 模板ID。 region_id 区域ID。 template_type 模板类型。 source 接口调用方。 表10 查询模板列表 参数 说明 region_id 区域ID。 template_type 模板类型。 is_build_in 是否内置模板。 offset 偏移量，表示从此偏移量开始查询，offset大于等于0。 limit 每页显示的条目数量。 name 模板名称，匹配规则为模糊匹配。 sort 排序字段。 asc 是否正序。

创建CodeArts Pipeline连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Pipeline”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

创建CodeArts Req连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Req”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

支持的动作 查询迭代下工作项状态的统计数据（处理人维度） 查询项目的状态列表 更新项目的领域 查询项目的领域列表 删除项目的模块 取消领域与项目的关联关系 查询项目的模块列表 创建项目的领域 查看迭代历史记录 查询关联用例 查询当前工作项已经关联的代码提交记录 / 分支创建记录 查询当前工作项已经关联的关联Wiki 查询当前工作项已经关联的工作项 查询Scrum项目的工作项流转配置 获取项目概览 获取需求统计信息 查询项目下所有工作项的历史记录 获取bug统计信息 更新工作项 按用户查询工时（多项目） 批量删除工作项 删除工作项 获取工作项历史记录 创建工作项 查询项目的工作项 高级查询工作项 查询工作项详情 获取子工作项 按用户查询工时（单项目） 获取当前用户信息 查看迭代详情 获取指定项目的迭代列表 创建项目 更新Scrum项目迭代 删除项目迭代 批量删除项目的迭代 创建Scrum项目迭代 检查项目名称是否存在 获取指定工作项的评论列表 获取工作项完成率 获取指定项目的成员用户列表 添加项目成员 查询项目列表 查询缺陷密度 查询Scrum工作项自定义字段 细粒度权限用户创建工作项 查询人均bug 创建项目的模块 更新项目的模块 更新成员在项目中的角色 批量添加项目成员 批量删除项目成员 查询需求按时完成率 获取项目详情 更新项目 删除项目

创建CodeArts Deploy连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Deploy”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

支持的动作 修改任务规则集 任务配置高级选项 查询任务检查失败日志 任务配置屏蔽目录 查询任务的高级选项 新建检查任务 查询任务规则集的检查参数 任务配置检查参数 设置每个项目对应语言的默认规则集配置 创建自定义规则集 查询规则集列表 查看规则集的规则列表 查询任务的已选规则集列表 删除自定义规则集 获取规则列表接口 终止检查任务 查询缺陷详情的统计 修改缺陷状态 查询任务执行状态 历史扫描结果查询 查询缺陷概要 查询cmertrics缺陷概要 查询缺陷详情 查询任务列表 执行检查任务 删除检查任务

创建CodeArts Check连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Check”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

创建CodeArts Build连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Build”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 查询指定代码仓库最近一次成功的构建历史 参数 说明 project_id 项目ID。 region_id 区域ID。 repository_name 代码仓库名，不支持中文。 表2 获取构建历史详情信息接口 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 build_number 构建任务的构建编号，从1开始，每次构建递增1。 region_id 区域ID。 表3 执行构建任务 参数 说明 region_id 区域ID。 body 输入请求体内容。 表4 根据开始时间和结束时间查看构建任务的构建成功率 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 start_time 区间开始时间，格式yyyy-MM-dd。 end_time 区间结束时间，格式yyyy-MM-dd。 表5 查看任务运行状态 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 表6 查看项目下用户的构建任务列表 参数 说明 project_id 项目ID。 region_id 区域ID。 page_index 分页页码， 表示从此页开始查询， page_index大于等于0。 page_size 每页显示的条目数量，page_size小于等于100。 表7 KeyStore文件下载 参数 说明 region_id 区域ID。 file_name 下载的文件名称。 domain_id 租户ID。32位数字、小写字母组合。 表8 根据开始时间和结束时间查看构建任务的构建历史列表 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 offset 分页页码， 表示从此页开始查询， offset大于等于0。 limit 每页显示的条目数量，limit小于等于100。 start_time 区间开始时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。 end_time 区间结束时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。 表9 查看构建任务的构建历史列表 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 offset 分页页码， 表示从此页开始查询， offset大于等于0。 limit 每页显示的条目数量，limit小于等于100。 interval 距今天的时间区间（单位：天），interval小于等于30。

创建CodeArts Artifact连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Artifact”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

支持的操作 通用 表格识别 通用文字识别 网络图片识别 智能分类识别 手写 文字识别 身份证识别 行驶证识别 驾驶证识别 护照识别 银行卡识别 营业执照识别 道路运输证识别 车牌识别 名片识别 VIN码识别 增值税发票识别 发票验真 机动车销售发票识别 出租车发票识别 火车票识别 定额发票识别 车辆通行费发票识别 飞机行程单识别 电子面单识别 保险单识别 财务报表识别 道路运输从业资格证识别 自定义模板OCR

创建文字识别连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“华为云服务”类别下的“文字识别”。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

调试步骤 登录新版ROMA Connect控制台。 在左侧导航栏选择“组合应用”，在组合应用页面单击需要调试的组合应用。 单击右上角的“编辑”进入组合应用设计页面。 单击页面上方“调试”按钮，进入调试模式。 图1 设计页面 选择调试环境。选择“区域”、“项目”和“实例”，作为在线调试使用的环境。 图2 配置调试环境 配置触发器节点。根据触发器节点类型，配置对应的触发参数，如Open API节点您可能需要配置API请求参数和请求Body等。 图3 配置Open API节点参数 单击“保存”，开启工作流调试。 执行调试操作，对工作流进行调试。 图4 调试工作流 添加断点：单击工作流中的节点，即可添加断点，工作流在调试过程中可能会停在当前断点。再次单击该节点，可移除断点。 触发器节点、并行处理节点和分支判断节点等不可添加断点。 调试运行：单击“调试运行”，工作流开始执行调试。如果工作流中存在断点，工作流会停留在该断点，并展示进入当前断点的数据，包括“属性”和“载荷”数据；如果工作流中不存在断点，工作流会自动运行至结束，或者在运行出错的节点停止，并展示错误信息。 单步运行：当工作流处于调试状态，停留在某一节点时，单击“单步运行”，工作流可自动运行至下一个节点。 运行到下一断点：当工作流处于调试状态，停留在某一节点时，单击“运行到下一断点”，工作流可自动运行至下一个断点。如果后续不存在断点，工作流会自动运行至结束，或者在运行出错的节点停止，并展示错误信息。 运行到结束：当工作流处于调试状态，停留在某一节点时，单击“运行到结束”，工作流会自动运行至结束，或者在运行出错的节点停止，并展示错误信息。 停止运行：当工作流处于调试状态，单击“停止运行”，工作流会终止本次调试过程。 调试完成后，单击页面右上方“退出调试”，退出调试模式，返回组合应用设计页面。

前置条件和约束 使用工作流在线调试功能，您需要具备ROMA Connect实例作为调试运行环境。您可购买独立的ROMA Connect实例，也可以使用共享体验版实例。 工作流在线调试功能可能会对运行在所选实例上的其它工作流产生影响，推荐您使用独立的实例进行调试。 使用工作流在线调试功能，调试环境如果选择共享体验版实例，您可同时调试的最大工作流数量为1条；如果选择购买独立的ROMA Connect实例，可同时调试的最大工作流数量为5条。 使用工作流在线调试功能，工作流的触发器节点不会真实运行，如Open API节点不会发布为API，您需要手动配置触发器节点进行触发。 使用工作流在线调试功能，在单个节点的最大停留时间为60s，超时后会自动向后运行。

目的端-数据格式为 CS V样例 是否跳过标题：CSV文件的表头，数值 true/false：输出数据是/否含有表头。 分隔符：文件中每列数据通过单元格进行分隔，单元格可以为“制表符”、“空格”、“逗号”、“分号”。 场景1：目的端数据源选择数据格式“CSV”，是否跳过标题：true，字段分隔符：逗号 。 导入文件时，当是否跳过标题选择“true”，默认解析csv第一行为字段名。 源端MySQL数据库表 demo.statistics 中的数据： id city uuid1 suzhou uuid2 shanghai 数据映射输出数据为： ManufacturerId, ProductName uuid1, suzhou uuid2, shanghai 场景2：目的端数据源选择数据格式“CSV”，是否跳过标题：false，字段分隔符：逗号。 导入文件时，当是否跳过标题选择“false”，不使用导入文件的头字段，系统默认设置字段filedN。 源端MySQL数据库表 demo.statistics 中的数据： id city uuid1 suzhou uuid2 shanghai 数据映射输出数据为： uuid1, suzhou uuid2, shanghai

源端-数据格式为JSON样例 以下面的组合应用为例，该组合应用的主要功能是调用Open API获取OBS指定桶的对象列表，并将结果中的桶名称和对象名称通过数据映射，映射到MySql指定表中的相关字段，然后使用MySql添加记录的操作将桶名和对象名存储到MySql中。 其中， 对象存储服务 OBS产生的结果是数据映射的源端数据源，MySql是目的端数据源。 可以通过使用Open API调用OBS连接器执行获取桶内对象列表的操作结果获得源端数据源的导入文件，或者根据OBS连接器执行获取桶内对象列表的操作结果手动添加字段信息。 当源端数据源的类型为“JSON”时，在使用数据映射时选择数据格式“JSON”，将源端数据源的输出作为源端数据源页签中“导入文件”的输入，根据文件的编码格式选择导入文件编码，可选项有GB2312、UTF-8和ASCII。此时源端数据源页签中会根据导入的文件内容自动生成相应的字段。 目的端数据格式选择“MySQL”，在选择表名后，目的端数据源页签会自动生成数据库表中的字段。 以下面的组合应用为例，该组合应用的主要功能是调用Open API获取OBS指定桶的对象列表，并将结果中的桶名称和对象名称通过数据映射，映射到MySql指定表中的相关字段，然后使用MySql添加记录的操作将桶名和对象名存储到MySql中。其中，对象存储服务 OBS产生的结果是数据映射的源端数据源，MySql是目的端数据源。可以通过使用Open API调用OBS连接器执行获取桶内对象列表的操作结果获得源端数据源的导入文件。也可以根据OBS连接器执行获取桶内对象列表的操作结果手动添加字段信息。 源端导入的文件内容： { "responseHeaders": { "bucket-location": "cn", "connection": "keep-alive" }, "objectSummaries": [ { "bucketName": "test0223", "objectKey": "test0424.txt", "owner": { "displayName": null, "id": "uuid" }, "metadata": { "responseHeaders": {}, "originalHeaders": {} }, "objectContent": null } ] } 数据映射输出结果为：

配置参数 参数 说明 源端数据源 设置源端数据源，数据库类型的数据源在选择完表之后会自动显示字段信息，其他格式的数据源需要通过导入文件或者手动增加的形式来添加字段。导入的文件目前主要支持json，xml和csv格式导入。 目的端数据源 设置目的端数据源，数据库类型的数据源在选择完表之后会自动显示字段信息，其他格式的数据源需要通过导入文件或者手动增加的形式来添加字段。导入的文件目前主要支持json，xml和csv格式导入。 使用技巧： 映射方式：鼠标左键单击源端数据源需要映射的数据字段，再单击目标端数据源对应的字段，即可建立关联。 输出引用方式：后续节点可通过payload方式引用数据映射处理器的输出数据，例如，${075007|payload.ID}。 ${075007|payload.ID}，即${节点id|payload.xxx}的形式，如果后续节点想要引用“数据映射”处理器的输出数据，可通过该形式来引用。 注：节点id可通过单击“数据映射”处理器获取到。

配置参数 参数 说明 类型 指定循环类型。 指定循环次数 指定循环条件 指定循环数组 循环次数 当“类型”为“指定循环次数”时，可配置循环次数，默认值为3，最大循环次数为100，超出后运行报错。 执行条件 当“类型”为“指定循环条件”时，可配置执行条件，满足执行条件时，最大循环次数为100，超出后运行报错。 遍历数组 当“类型”为“指定循环数组”时，可配置遍历数组，遍历数组的数据可以从上一节点获取，请参考引用变量。 数组最大长度为100，超出后运行报错。

创建WordPress发布连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“WordPress发布”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 地址 填写WordPress地址，如http://myblog.com。 用户名 填写WordPress用户名 密码 填写WordPress密码。 描述 填写连接器的描述信息，用于识别不同的连接器。

创建 消息通知 连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“消息通知服务”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 鉴权方式 选择连接器的鉴权方式。 云服务委托，即委托其他云服务管理资源。 依赖的授权项： smn:topic:list smn:template:create smn:template:list smn:topic:publish AK/SK Access Key 仅当“鉴权方式”选择“AK/SK”时需要配置。 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 仅当“鉴权方式”选择“AK/SK”时需要配置。 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 发布模板消息 参数 说明 区域 消息通知服务所在的区域。 项目 消息通知服务所在的项目。 主题 在消息通知服务创建的主题，指消息发布或客户端订阅通知的特定事件类型。 消息标题 给邮箱订阅者发送邮件时作为邮件主题。 模板 在消息通知服务创建的消息模板，指消息的固定格式，发布消息时可以使用已创建的消息模板向订阅者发送消息，可以在模板参数中填写模板中的参数。 表2 发布文本消息 参数 说明 区域 消息通知服务所在的区域。 项目 消息通知服务所在的项目。 主题 在消息通知服务创建的主题，指消息发布或客户端订阅通知的特定事件类型。 消息标题 给邮箱订阅者发送邮件时作为邮件主题。 消息内容 发送给订阅者的消息正文。