华为云用户手册

Smart Connect监控指标 表5 Smart Connect支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） kafka_wait_synchronize_data 待同步Kafka数据量 Kafka任务的待同步数据量。 单位：Count ≥ 0 Kafka实例的Smart Connect任务 1分钟 kafka_synchronize_rate Kafka每分钟同步数据量 Kafka任务每分钟同步的数据量。 单位：Count ≥ 0 Kafka实例的Smart Connect任务 1分钟 task_status 任务状态 当前任务状态。 0：任务异常 1：任务正常 Kafka实例的Smart Connect任务 1分钟 message_delay 消息时延 消息到达源端的时间与到达目标端的时间之差。 单位：ms ≥ 0 Kafka实例的Smart Connect任务 1分钟 Kafka双向数据复制的Smart Connect任务在监控中会被拆分为2个任务，分别为“Smart Connect任务名_source_0”和“Smart Connect任务名_source_1”。 如果Topic中的消息在进行下一次数据同步前，已经全部老化，此时实际是没有待同步的Kafka数据，但是Kafka数据同步监控指标使用的是包含老化数据的offset值，“待同步Kafka数据量”会显示老化的消息数。

维度 Key Value kafka_instance_id Kafka实例 kafka_broker Kafka实例节点 kafka_topics Kafka实例主题 kafka_partitions Kafka实例分区 kafka_groups-partitions Kafka实例分区的消费组 kafka_groups_topics Kafka实例队列的消费组 kafka_groups Kafka实例的消费组 connector_task Kafka实例的Smart Connect任务

消费组监控指标 表4 消费组支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） messages_consumed 分区已消费消息数 该指标用于统计当前消费组已经消费的消息个数。 单位：Count 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“分区监控”时，才包含该指标。 ≥ 0 Kafka实例的消费组 1分钟 messages_remained 分区可消费消息数 该指标用于统计消费组可消费的消息个数。 单位：Count 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“分区监控”时，才包含该指标。 ≥ 0 Kafka实例的消费组 1分钟 topic_messages_remained 队列可消费消息数 该指标用于统计消费组指定队列可以消费的消息个数。 单位：个 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“基本监控”时，才包含该指标。 0~（263-1） Kafka实例的消费组 1分钟 topic_messages_consumed 队列已消费消息数 该指标用于统计消费组指定队列当前已经消费的消息数。 单位：个 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“基本监控”时，才包含该指标。 0~（263-1） Kafka实例的消费组 1分钟 consumer_messages_remained 消息堆积数（消费组可消费消息数） 该指标用于统计消费组剩余可以消费的消息个数。 单位：个 说明： 在“消费组”页签，“主题”为“全部队列”时，才包含该指标。 0~（263-1） Kafka实例的消费组 1分钟 consumer_messages_consumed 消费组已消费消息数 该指标用于统计消费组当前已经消费的消息数。 单位：个 说明： 在“消费组”页签，“主题”为“全部队列”时，才包含该指标。 0~（263-1） Kafka实例的消费组 1分钟 messages_consumed_per_min 分区消费速率 统计消费组指定队列分区每分钟的消费数。 单位：个/分钟 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“分区监控”时，才包含该指标。 部分存量实例不支持此监控，具体以控制台为准。 0~30000000 Kafka实例的消费组 1分钟 topic_messages_consumed_per_min 队列消费速率 统计消费组指定队列每分钟的消费数。 单位：个/分钟 说明： 在“消费组”页签，“主题”为指定的Topic名称，“监控类型”为“基本监控”时，才包含该指标。 部分存量实例不支持此监控，具体以控制台为准。 0~30000000 Kafka实例的消费组 1分钟 consumer_messages_consumed_per_min 消费组消费速率 统计消费组每分钟的消费数。 单位：个/分钟 说明： 在“消费组”页签，“主题”为“全部Topic”时，才包含该指标。 部分存量实例不支持此监控，具体以控制台为准。 0~30000000 Kafka实例的消费组 1分钟

主题监控指标 表3 主题支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） topic_bytes_in_rate 生产流量 该指标用于统计每秒生产的字节数。 单位：Byte/s、KB/s、MB/s、GB/s 说明： 在“主题”页签，当“监控类型”为“基本监控”时，才包含该指标。 0~500000000 Kafka实例队列 1分钟 topic_bytes_out_rate 消费流量 该指标用于统计每秒消费的字节数。 单位：Byte/s、KB/s、MB/s、GB/s 说明： 在“主题”页签，当“监控类型”为“基本监控”时，才包含该指标。 0~500000000 Kafka实例队列 1分钟 topic_data_size 队列数据容量 该指标用于统计队列当前的消息数据大小。 单位：Byte、KB、MB、GB、TB、PB 说明： 在“主题”页签，当“监控类型”为“基本监控”时，才包含该指标。 0~5000000000000 Kafka实例队列 1分钟 topic_messages 队列消息总数 该指标用于统计队列当前的消息总数。 单位：Count 说明： 在“主题”页签，当“监控类型”为“基本监控”时，才包含该指标。 ≥ 0 Kafka实例队列 1分钟 topic_messages_in_rate 消息生产速率 该指标用于统计每秒生产的消息数量。 单位：Count/s 说明： 在“主题”页签，当“监控类型”为“基本监控”时，才包含该指标。 0~500000 Kafka实例队列 1分钟 partition_messages 分区消息数 该指标用于统计分区中当前的消息个数。 单位：Count 说明： 在“主题”页签，当“监控类型”为“分区监控”时，才包含该指标。 ≥ 0 Kafka实例队列 1分钟 produced_messages 生产消息数 该指标用于统计目前生产的消息总数。 单位：Count 说明： 在“主题”页签，当“监控类型”为“分区监控”时，才包含该指标。 ≥ 0 Kafka实例队列 1分钟

实例监控指标 表1 实例支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） current_partitions 分区数 该指标用于统计Kafka实例中已经使用的分区数量。 单位：Count 0~100000 Kafka实例 1分钟 current_topics 主题数 该指标用于统计Kafka实例中已经创建的主题数量。 单位：Count 0~100000 Kafka实例 1分钟 group_msgs 堆积消息数 该指标用于统计Kafka实例中所有消费组中总堆积消息数。 单位：Count 0~1000000000 Kafka实例 1分钟

是否会保证将消息传送到订阅的终端节点？ SMN 向终端节点推送消息时，使用异步方式送达，不保证消息送达的时效性。如果业务要求消息准实时送达，请慎重考虑是否使用SMN服务。 如果订阅终端节点可以送达， 消息通知 服务会确保消息传送到订阅终端节点。 如果订阅终端节点无法送达，消息通知服务会将发送失败的消息保存到失败的消息队列尾部，等待下次被发送。如果发送失败次数超过6次，消息将直接丢弃，不再保存到失败的消息队列，且不会给用户发送“消息发送失败”的相关信息。 失败的消息队列中的消息处理间隔时间是不确定的，它取决于失败的消息队列的长度。 SMN向HTTP(S)订阅终端发送消息的超时时间为5s，即响应时长超过5s后，SMN会认为连接超时发送失败。 指定时间段内如果多次发送失败，则会加入到黑名单中，加入到黑名单的订阅终端SMN不再向其发送消息。 黑名单中的订阅终端会在5-10min后自动移除，移除后SMN能够正常向该订阅终端发送消息。 SMN仅在HTTP(S)订阅终端节点返回内部错误，即HTTP(S)返回码大于等于500时，才会进行重试；其他场景均不重试。

创建企业 1. 创建企业：点击“创建企业-新建企业”按钮，在弹出的新建企业弹窗中，填入企业名称和企业简称后，点击“完成”按钮，等待1-3分钟企业创建完成后，即可开始第二步“授权企业”操作。 企业创建后不支持修改企业名称和企业简称； 企业内授权用户在通过云商店统一登录页面登录时，云商店将通过用户账号和企业简称来识别登录用户信息。授权用户在登录邮箱前台时，企业简称将作为登录账号的后缀；企业简称建议填写邮箱 域名 ，作为用户登录账号的后缀。 父主题： 如何开通使用

如何给多个用户开通账号使用CodeArts Req服务？ 例如，有20个人需要使用需求管理服务，管理员可以通过“ 统一身份认证 服务 IAM ”创建20个子账号，详细操作请参见 创建IAM用户。 若项目管理员希望将这20个子账号加入至已有CodeArts项目中，则可参见添加本企业IAM用户为CodeArts项目成员进行操作。 操作完成后，子账号通过IAM用户登录CodeArts访问需求管理服务即可，详细操作请参见IAM用户登录。 父主题： 成员管理

如何使用决策图元 在逻辑中，拖拽“决策”图元至画布中。 选中决策图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Decision序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 根据实际需求，输入图元的描述信息。 取值范围：1~255个字符。 单击，在“决策”页面进行配置。 图1 配置决策图元 表2 决策图元配置参数说明 参数 说明 可编辑的结果 所有的判断条件。 可通过单击“新增”，新增判断条件分支，界面右侧区域配置分支条件。 默认：默认输出，当其他所有条件均不满足情况下，进入该分支。 可视 当选择“可视”时，可配置分支的判断条件。单击“新增”，可新增判断条件，条件显示为“资源”、“比较符”、“值”。 资源：从全局上下文拖拽变量或者直接输入“{!变量名}”。 比较符：从下拉框中选择。 值：从全局上下文拖拽变量或者直接输入“{!变量名}”，也可以是常量。 公式 可采用公式设置该分支条件。 公式中的变量，可从全局上下文拖拽变量或者直接输入变量。 选择连接条件 当选择“可视”并设置多条判断条件时，需要设置选择连接条件“或”或者“且”。 或：表示满足多条判断条件的其中一条，便可进入该分支。 且：表示必须同时满足多条判断条件，才可进入该分支。

如何使用脚本图元 在基本中，拖拽“脚本”图元到右侧画布中。 选中画布中的脚本图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 脚本图元的名称，用于在页面显示。系统会自动填入该值，格式为Script序号，序号从“0”开始，表示同类型图元序号。 名称 图元的标识，请确保在当前服务编排中唯一。 描述 图元的描述信息。 单击，选择脚本、设置输入参数和输出参数。 图1 配置脚本 表2 脚本图元配置参数说明 参数 参数说明 脚本 调用的脚本名称，只有在启用状态下的脚本才能被服务编排调用。 输入参数/目标 脚本的输入参数名称。 单击“新增行”，在下拉框中选择脚本输入参数的名称。 输入参数/源 服务编排中的变量，为目标赋值。 可直接填写，也可以拖入全局上下文变量，将服务编排中的变量赋值给脚本中的输入参数。 输出参数/源 脚本的输出参数名称。 单击“新增行”，在下拉框中选择脚本输出参数的名称。 输出参数/目标 服务编排中的变量，脚本中的输出参数赋值给服务编排中的变量。 拖入全局上下文变量，将脚本的输出参数赋值给服务编排中的变量。

前提条件 已在原生服务中配置好API，具体操作请参考配置API。 已接入服务实例，具体操作请参考注册Native Service。 进入需要调用原生服务的应用设计器，单击“Internal dependencies”或“External dependencies”旁的“+”，选择“Native服务”，在“添加Native服务”页面添加要调用的原生服务。添加后，在该应用的服务编排中，才可以调用Native服务。 “Internal dependencies”为内部依赖文件夹，导入的BO服务或Native服务，在打包上层应用时也会随应用打包发布出去。 “External dependencies”为外部依赖文件夹，导入的BO服务或Native服务，在打包上层应用时不会打包出去。 图1 应用中添加原生服务

如何使用Native服务图元 在Native服务中，拖拽所需的Native服务图元至画布中。 选中Native服务图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为原生服务名+序号。序号从“0”开始，表示同类型图元序号。 名称 图元的标识，请确保在当前服务编排中唯一。 描述 图元的描述信息。 单击，在“Native服务”页面进行配置。 图2 配置Native服务图元 表2 Native服务图元配置参数说明 参数 参数说明 操作方法 原生服务中已自定义好的API接口。 入参/目标 当选择具体操作方法（API）后，API的输入参数将会显示在入参的目标列。 入参/源 服务编排中的变量，需要和目标的参数类型保持一致。该源会将服务编排中的变量，赋值给调用API的输入参数。 出参/源 当选择具体操作方法（API）后，API的输入参数将会显示在出参的源列。 出参/目标 服务编排中的变量，需要和输出参数的类型保持一致。将API中的输出参数赋值给服务编排中的变量，供服务编排中使用。

常见问题 是否拥有执行触发器设定的操作权限，取决于触发器的创建人还是触发人？ 回答：是否有执行触发器设定的操作权限，取决于触发者本人是否有相关权限，和触发器创建人无关。例如，某个触发器关联了对象“D__ CS T”，触发类型是“插入或更新记录时”，触发时执行事件C，即对象“D__CST”数据有新增或更新时，会触发该触发器，从而执行事件C。用户A是触发器的创建人，没有对象“D__CST”的操作权限和事件C的执行权限，用户B有“D__CST”的操作权限和事件C的执行权限，当用户B更新“D__CST”对象数据时，会触发该触发器，执行事件C。

如何使用子服务编排图元 在基本中，拖拽“子服务编排”图元到右侧画布中。 选中画布中的子服务编排图元，单击，配置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 子服务编排图元的名称，用于在页面显示。系统会自动填入该值，格式为Flow序号，序号从“0”开始，表示同类型图元序号。 名称 图元的标识，请确保在当前服务编排中唯一。 描述 图元的描述信息。 单击，选择服务编排实例、输入参数和输出参数。 图1 配置子服务编排 表2 子服务编排图元配置参数说明 参数 参数说明 服务编排实例 选择服务编排的名称。 只有在启用状态下的服务编排，才能作为子服务编排被其他服务编排调用。 输入参数/目标 子服务编排的输入参数名称。 单击“新增行”，在下拉框中选择子服务编排输入参数的名称。 输入参数/源 服务编排中的变量，为目标赋值。 可直接填写，也可以拖入全局上下文变量，将服务编排中的变量赋值给子服务编排中的输入参数。 输出参数/源 子服务编排的输出参数名称。 单击“新增行”，在下拉框中选择子服务编排输出参数的名称。 输出参数/目标 服务编排中的变量，子服务编排中的输出参数赋值给服务编排中的变量。 在全局上下文变量中，将子服务编排的输出参数赋值给服务编排中的变量。

如何使用记录删除图元 在基本中，拖拽“记录删除”图元至画布中。 选中记录删除图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为RecordDelete序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 使用快速删除模式 是否启用快速删除模式。 如果勾选该参数，表示为快速模式。 根据对象变量中的记录ID，删除对应的记录。当配置的对象变量为数组时，则从数据库中删除对象变量数组中的包含的所有记录（按照记录ID进行删除）。 不勾选，表示为普通模式。 按照条件删除指定对象中的记录，需要配置待删除记录对应的对象名，删除条件。 默认不勾选。 单击，在“记录删除”页面进行配置。 如果上一步勾选“使用快速删除模式”，则需要指定一个预先定义的对象变量或者对象变量数组，并将该对象变量或对象变量数组拖拽到“变量”输入框中，使用该对象变量或对象变量数组的记录ID删除对应的对象记录。如图1，使用“accountDelete”对象变量的记录ID删除对象记录。 图1 快速删除模式 表2 快速删除模式参数说明 参数 说明 对象 预先定义的对象变量，使用该对象变量或对象变量数组中的记录ID删除对象记录。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前流程出现错误时回滚 当前服务编排出现错误时，回滚到上一个流程。 默认为勾选。如果无特殊要求，请不要更改设置。 如果上一步未勾选“使用快速删除模式”，则需要指定对象并在条件中设置指定对象部分字段的值，根据条件删除符合条件的对象记录。如图2所示，删除“Account”对象“name”为“Lily”的记录。 图2 普通删除模式 表3 普通删除模式参数说明 参数 说明 对象 指定具体的对象，直接在下拉框中选择。 当前流程出现错误时回滚 当前服务编排出现错误时，回滚到上一个流程。 默认为勾选。如果无特殊要求，请不要更改设置。 条件 选中对象后，该条件区域“字段”列会出现该对象的字段。单击“新增行”，可设置删除数据的条件。 在“字段”中选择要进行判断的对象字段，在“比较符”中选择相应的比较符，“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。

操作场景 在AstroZero中新添加的业务用户，若没有配置指定的权限，默认使用系统预置的Portal User Profile权限。若默认Portal User Profile权限不能满足需求，即业务用户需要额外的权限时，可参照本章节对业务用户进行权限配置。 在AstroZero中，修改业务用户权限有如下两种方式： 方式一：修改系统预置的权限Portal User Profile 权限配置Portal User Profile是全局的，修改Portal User Profile权限会影响系统所有的应用。 方式二：新建权限配置 在预置的Portal User Profile权限基础上，自定义业务用户的权限配置和拓展。在AstroZero的权限配置功能中，基于某个权限配置新建的Profile，将会继承原Profile的全部权限。

基于预留扩展点进行定制 此处以“createOrder”接口为例进行介绍，基线“createOrder”接口中预留了一个扩展点。 这个扩展点是一个空的子服务编排“AfterSaveOrder”，将这个子服务编排另存一个定制版本“AfterSaveOrder_0419”，实现新的业务逻辑。子服务编排另存为定制版本的操作方法，请参见另存版本后进行定制。 在此方式下，定制内容在基线接口预留节点中，该接口还是属于基线接口，可以随版本升级使用。 图2 定制示例

另存版本后进行定制 此处以基于服务编排“testFlow”的基线“1.0.1”版本另存一个“1.0.2”的定制版本为例，进行说明。 单击已创建好的服务编排“testFlow”，进入该服务编排设计页面。 单击页面上方的，禁用该服务编排。 单击页面上方的，进入另存为页面。 “类型”选择“新版本”，设置服务编排标签，单击“保存”。 保存后，系统默认进入“1.0.2”的新版本服务编排设计页面。 图1 另存为新版本 标签：服务编排的标签，用于在页面显示。 名称：服务编排的名称，和基线版本的服务编排名称保持一致。 类型：另存为的类型。 新版本：另存为新版本，适用于新建的服务编排，基础服务编排仍可使用。 新服务编排：是将原服务编排重新另存并命名，新保存后为另一服务编排，与选择“新版本”场景不同，适用于新建的服务编排，基础服务编排仍可使用。 服务编排类型：服务编排的类型，在创建基础服务编排时配置的类型，不可更改。 Autolaunched Flow：自启动服务编排，在接口调用后会立即执行服务编排模型定义的逻辑。 Event Trigger：事件触发的服务编排，在事件触发时才会开始执行服务编排模型定义的逻辑。 展示标签：服务编排实例的展示标签，系统自动填充为“标签值{!$Flow.CurrentDateTime}”。 描述：服务编排的描述信息。 在“1.0.2”版本服务编排设计页面，按需进行定制。 单击页面上方的，保存服务编排。 保存成功后，单击，运行服务编排，检查服务编排运行结果是否符合预期。 单击页面上方的，启用新版本服务编排。 在此方式下，当基线版本升级时，系统默认启用和使用服务编排的定制版本。升级造成的基线服务编排原有图元变化，定制服务编排可继承。升级造成的基线服务编排新增图元，定制服务编排无法继承。

使用场景 AstroZero提供了“客户端模式”和“授权码模式”两种授权模式进行OAuth鉴权。 客户端模式 通过该模式获取的access-token，用于在调用API接口时进行鉴权，使用时需在请求消息头上设置“access-token”。 授权码模式 通过该模式获取的access-token，只能用于在获取用户信息时进行鉴权，使用时需在请求消息头上设置“Authorization: Bearer ***”。

自定义OAuth2授权码模式接入鉴权 前面介绍了第三方系统在调用AstroZero业务接口前，如何配置接入鉴权。鉴权通过后，才能实现调用AstroZero业务接口。在AstroZero中开发的应用，也可以自定义OAuth2授权码模式接入鉴权。当应用配置鉴权后，只有通过鉴权的第三方系统才可以访问应用。 参考2~4获取鉴权ID“client_id”和鉴权密钥“client_secret”。 在应用开发页面，通过自定义接口，给第三方接入调用，用于第三方系统获取授权码code。 应用调用脚本API，判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时匹配。 如果匹配，则由AstroZero应用自定义接口，实现登录跳转和授权跳转。在授权完成后，再调用脚本API获取授权码code，并将需要展示给第三方的授权用户信息通过该API传给AstroZero，AstroZero会返回一个code。最后，应用重定向到“redirect_url”，并携带code。 判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时匹配的API样例如下： // Here's your code. import * as oauth from 'oauth' let handle = oauth.getAuthorizeHandle() let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c", } let pass = handle.checkURL(clientDatas) console.log(pass) //true if (pass){ //判断是否登录，做登录跳转 //判断是否授权，做授权跳转 } 获取授权码code的脚本API样例如下： // Here's your code. import * as oauth from 'oauth' let handle = oauth.getAuthorizeHandle() //前面步骤已经走完 let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c", } let userInfo = { "name": "jack", "phone": "1256287222", "email": "example.com" } let code = handle.getAuthCode(clientDatas, userInfo) console.log(code) //WEUcqXbeQDKUHxcn8til3Q 第三方系统接收到该请求，并解析出code后，在后端访问接口获取access_token，步骤和6一致。 第三方系统在获取到access_token后，使用该凭证访问平台“https://域名/u-route/baas/oauth/v1.0/third/userinfo”接口（该接口和8中的接口不同），来获取授权用户的信息。 响应示例如下： { "resCode": "0", "resMsg": "成功", "result": { "email": "example.com", "name": "jack", "phone": "1256287222" } }

如何使用发送邮件图元 在基本中，拖拽“发送邮件”图元至画布中。 选中发送邮件图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为Email序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“发送邮件”页面进行配置。 图1 配置直接编辑邮件 图2 配置基于模板邮件 表2 发送邮件图元配置参数说明 参数 参数说明 直接编辑 手动设置邮件信息。 基于模板 基于同一租户或基线里已有的邮件模板，设置邮件主题和内容。 模板 当选中“基于模板”时，需要选择邮件模板。 主题 邮件标题。 当选中“直接编辑”时，需要配置邮件标题。 当选中“基于模板”时，该参数配置区域置灰。 内容 邮件内容。 当选中“直接编辑”时，需要配置邮件内容。 当选中“基于模板”时，该参数配置区域置灰。 自定义变量 当选中“基于模板”时，需要配置模板中的参数，在“值”中进行赋值。 地址 接收人的邮箱地址。 字符串：直接输入邮箱地址，多个地址请用分号分隔，或者从全局上下文拖拽变量代表一个接收人的邮箱地址。 集合：表示可以从全局上下文拖拽集合变量，集合变量即数组型变量，表示多个接收人的邮箱地址。在定义变量时勾选“是否为数组”，则该变量被定义为集合变量。 抄送 抄送人员的邮箱地址，直接输入分号分隔的字符串或者从全局上下文拖拽变量。 密送 秘密发送人员的邮箱地址，直接输入分号分隔的字符串或者从全局上下文拖拽变量。

应用集成开发概述 集成开发包括连接器、数据接入和开放接口三部分。其中，数据接入（DataAccess）和连接器（Connector），是将外部数据或功能模块集成到AstroZero中使用，而开放接口是将AstroZero中开发的脚本、服务编排等包装成自定义REST接口，供第三方系统使用。 图1 集成开发 表1 集成开发 特性 特性说明 连接器 连接器是AstroZero提供的，调用第三方服务的集成工具。AstroZero封装了不同类型的连接器，用于对接相应的第三方服务，如OBS、Redis、 云搜索 和ROMA等。通过连接器，开发者无需关注具体代码实现，只需要配置集成服务的地址和鉴权信息，即可在服务编排或脚本中快速集成第三方系统。 使用连接器调用第三方接口 在使用AstroZero时，通常会调用第三方系统接口，进行数据交互。AstroZero提供了Rest服务连接器、Soap服务连接器和自定义连接器三种方式来调用第三方接口。使用这三种连接器，可方便快捷的调用第三方接口，实现对第三方系统数据的增加、删除、修改和查找。 使用Rest服务调用Rest协议接口：当系统需要调用第三方提供的Rest协议接口时，可以通过配置Rest服务来实现。Rest服务是第三方系统提供的，是一组模块化的Rest接口，通过配置第三方提供的Rest服务的URL进行调用。 使用SOAP服务调用SOAP协议接口：当系统需要调用第三方提供的SOAP协议接口时，可以通过配置SOAP服务来实现。SOAP服务是第三方系统提供的，是一组模块化的SOAP接口，通过配置第三方提供的SOAP服务的URL进行调用。 须知： 调用第三方接口前，需要第三方系统提供符合Rest和SOAP协议规范的API。 使用自定义连接器调用第三方接口：通过使用自定义连接器，可快速对接一个外部服务的接口并在AstroZero中使用。 使用连接器对接云服务 AstroZero封装了不同类型的连接器对接相应的第三方服务，如OBS、Redis、云搜索和ROMA等。通过连接器，开发者无需关注具体代码实现，只需要配置一下服务地址和鉴权信息，即可在服务编排或事件中快速集成第三方系统。 数据接入 数据接入是指通过对接多种输入源进行消息类数据的接入，如将ROMA侧的MQS，转换成Kafka消息队列中的事件，供平台业务逻辑接口使用。 开放接口 开放接口是指将用户在应用中开发的脚本、服务编排等包装成自定义的REST接口，供第三方系统进行调用。 父主题： 使用AstroZero进行应用集成开发

循环图元参数配置 例如，当前有数组变量“TestList1”，“TestList2”，要求把“TestList1”中的元素逐个加到数组“TestList2”的后面。 创建数组变量“TestList1”、“TestList2”和普通变量“test_var”。 在服务编排编辑器页面右侧，选择。 在全局上下文页面，单击“变量”后的加号。 图1 单击变量后的加号 单击新增变量后的“...”，选择“设置”。 设置数组变量“TestList1”，数据类型为文本。 图2 数组变量“TestList1” 参考上述步骤设置数组变量“TestList2”和普通变量“test_var”，普通变量不用勾选“是否为数组”。 图3 数组变量“TestList2” 图4 普通变量“test_var” 在逻辑中，拖拽“循环”图元到画布中。 选中循环图元，单击，设置基本信息。 图5 设置循环图元基本信息 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为Loop序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“循环”页面进行配置。 图6 配置循环图元 表2 循环图元配置参数说明 参数 参数说明 数组 进行循环的具体数组，可从全局上下文中拖拽或输入集合变量。 本示例从全局上下文拖拽数组变量“TestList1”，表示对数组“TestList1”进行循环。 元素 将每次循环取出来的元素，赋值给该变量，可从全局上下文中拖拽或者输入变量。 本示例请从全局上下文拖拽普通变量“test_var”，表示将每次循环取出来的元素赋值给变量“test_var”。 排序 循环取出的顺序，可选择升序或者降序从数组中依次取出。 进行赋值操作，将“test_var”的值加到数组“TestList2”后面。 在逻辑中，拖拽“赋值”图元到循环图元后。 图7 拖拽赋值图元 单击，设置“标签”和“名称”为“AddToList2”。 如下图所示，设置页面参数，从全局上下文拖拽数组变量“TestList2”到变量中，从全局上下文拖拽普通变量“test_var”到值中。将“test_var”的值加到数组“TestList2”后面。 图8 添加Assignment定义 将循环和赋值连线，在连线类型选择“下一个取值”。 图9 添加连线 清空“test_var”并闭环。 在逻辑中，拖拽“赋值”图元至画布中。 单击，设置“标签”和“名称”为“testvar_Tonull”。 单击，设置页面参数。 从全局上下文拖拽普通变量“test_var”到变量中，从全局上下文拖拽全局常量“$GlobalConstant.Null”到值中。清空“test_var”。 图10 清空test_var页面 在服务编排编辑器页面右侧，选择，按照下图从全局上下文页面中拖拽参数到相应的入参和出参区域，设置服务编排的入参和出参。 图11 设置服务编排的入参和出参 按照下图连线，单击页面上方的，保存服务编排。 图12 连接服务编排 单击，在“输入参数”中输入参数后，运行服务编排。 在“输入参数”中，输入如下参数： { "TestList1": [ "1", "2", "3" ] } 检查输出页签的结果是否符合预期。 { "interviewId": "002N000000YfbbgBStmq", "outputs": { "TestList2": [ "1", "2", "3" ] } }

如何使用开天 集成工作台 连接器图元 开天集成工作台是面向应用开发者和API开发者，提供基于元数据的可扩展的集成框架，打造开放、共生、智能、协同的技术标准体系，从而降低应用间的集成工作量，并沉淀多种集成资产，如连接器、领域信息模型资产等的平台。更多相关介绍，请参考开天集成工作台产品文档。 连接器图元中有一种特殊的图元，用于对接开天集成工作台，调用开天集成工作台上已有的API。在服务编排中，如何使用开天集成工作台连接器，请参见在服务编排中，如何使用开天集成工作台连接器图元。

创建报表 参考登录AstroZero新版应用设计器中操作，登录新版应用设计器。 在左侧导航栏中，选择“界面”。 （可选）单击报表后的，为报表添加目录。 报表默认存放在根目录下，在创建报表前，您可以先创建报表存放的目录，也可以在报表创建后将其拖拽到指定目录。 将鼠标放在已创建的报表目录上，单击，进入添加报表页面。 如果未创建报表目录，请直接单击报表后的，进入添加报表页面。 设置报表主对象、标签等，单击“新建”。 图1 添加报表基本信息 表1 创建报表参数说明 参数 说明 主对象 选择前提条件中创建的主对象，该对象定义了报表的汇总主体。例如，如果报表想展示图书的作者，数据来源于“Author__CST”，即“Author__CST”作为主对象。 标签 报表的标签名，用于在页面展示。 取值范围：1~64个字符。 名称 报表的名称，名称是报表在系统中的唯一标识。 命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 说明： 名称前模糊掉的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 文件夹 在下拉框中选择文件夹，对报表进行分类管理。 PublicReports：公共报表。 PrivateReports：私有数据报表。 WanrData：告警数据报表。 默认值：PublicReports。 描述 根据实际需求，在输入框中输入报表的描述信息。 对象连接关系 定义报表中，要展现对象的连接关系。例如图2，将两个对象数据的交集，作为报表展示的数据范围，也可以只选用一个主对象。 每个'A' 对象的记录至少关联一条'B'的记录：为内连接，表示取连接双方的交集。 'A' 对象的记录可以关联或不关联'B'的记录：为左连接，表示取左方的全集以及双方的交集数据。 图2 选取对象交集作为报表展示范围 编辑报表要展示的信息。 选择报表要展示的字段，即在报表编辑页面左侧“可选字段”中，拖拽所需的字段到右侧“报表预览”页面。 图3 选择字段 单击某个字段后的，选择“按该字段分组”，设置分组字段。 图4 按该字段分组 设置报表数据过滤条件。 通过设置过滤条件，可以挑选出希望获得的数据。如下图所示，展示了创作时间在2019-02-01至2019-03-28之间的图书情况。 编辑状态的报表，仅显示前20条数据。 图5 设置报表数据过滤条件 单击报表编辑页面上方的，保存报表。 保存成功后，单击，显示运行态报表页面。 图6 运行态报表页面

如何使用跳出循环图元 在逻辑中，拖拽“跳出循环”图元至画布中。 选中跳出循环图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Break序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 单击，在“跳出循环”页面的“循环”下拉框中，选择当前服务编排中需要中断的循环。 图1 配置跳出循环图元

什么是流程配置 了解流程配置前，请先熟悉一下BPM的概念。BPM是Astro轻应用提供的图形化流程编排引擎，着重于构建带有用户交互行为的业务流程，例如审批流、工单派发流程、故障单处理流程等。 在开发环境开发好带有BPM资源的应用后，并将应用打包发布到运行环境。在运行环境中该BPM资源是受保护的，不能定制修改，但某些业务场景，用户希望能够在运行环境中基于已有的BPM流程进行复用、定制修改。在该背景下，Astro轻应用提供了流程配置功能。 流程配置是对BPM流程进行一定的封装，其中定义了流程的基本要素，使用户能够在运行环境的业务配置中心中对流程进行复用及定制。 下面以创建一个故障单处理流程为例，介绍如何在开发环境中创建流程配置，并打包发布到运行环境，以及如何在运行环境中进行复用和定制。 图1 创建流程配置流程图 父主题： 如何创建流程配置

操作场景 创建一个定时任务“OfferingOffline”，用于实现从2021-11-25开始，每天零点自动将过期商品下架。其中，将过期商品下架的功能由“OfferingOffline”脚本实现。在创建定时任务之前，需要先开发实现定时任务功能的Script脚本，Script脚本的开发可参考脚本。 除了在环境配置中创建定时任务，您还可以在应用开发时创建定时任务，详情请参见定时任务。两者的区别是在应用开发设计器中创建的定时任务，可在打包发布应用时，将定时任务一起打包发布出去。在环境配置中创建的定时任务，无法随应用发布出去。除此之外，在应用开发时创建的定时任务仅对当前应用有效，而在环境配置中创建的定时任务可在多个应用中使用。

如何使用BO图元 在BO中，拖拽所需的BO图元至画布中。 选中BO图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为BO名序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“BO”页面进行配置。 图2 配置BO图元 表2 BO图元配置参数说明 参数 参数说明 服务版本 BO中自定义API的版本号。 API类型 API类型。 操作方法 BO中已自定义好的API接口，该API接口类型必须是“服务编排”，才可在服务编排中调用。 入参/目标 当选择具体操作方法（API）后，API的输入参数将会显示在入参的目标列。 入参/源 服务编排中的变量，需要和目标的参数类型保持一致。该源会将服务编排中的变量，赋值给调用API的输入参数。 出参/源 当选择具体操作方法（API）后，API的输入参数将会显示在出参的源列。 出参/目标 服务编排中的变量，需要和输出参数的类型保持一致。API中的输出参数赋值给服务编排中的变量，供服务编排使用。

前提条件 已在BO中自定义封装好API，具体操作请参考如何开放API接口。 进入需要调用BO服务的应用设计器，单击“Internal dependencies”或“External dependencies”旁的“+”，选择“BO服务”，添加要调用的BO服务。添加后，在该应用的服务编排中，才可以调用BO服务。 “Internal dependencies”为内部依赖文件夹，导入的BO服务或Native服务，在打包上层应用时也会随应用打包发布出去。 “External dependencies”为外部依赖文件夹，导入的BO服务或Native服务，在打包上层应用时不会打包出去。 图1 应用中添加BO服务