华为云用户手册

异常处理 当数据源类型选择ROMA Connect时，配置完数据接入后，MQS平台收不到消息，业务设置的EventTrigger没有拉起服务编排。 问题现象：ROMA Connect消息轨迹是灰色的，可能是MQS服务地址配置错误或没有配置。 解决方法：检查iotgateway容器的“roma-server”参数是否配置。若没有配置，请配置该参数或联系运维添加正确的“roma-server”地址（端口为“9776”），确认网络正常以及MQS服务器正常，兼容客户端版本。 问题现象：ROMA Connect消息轨迹是红色的，可能是MQS的source定义错误。 解决方法：在ROMA Connect平台，查看应用ID和对应的密钥是否一致，查看该应用是否订阅了主题。配置错误时，会导致鉴权失败。 问题现象：ROMA Connect消息轨迹是绿色的， 表示MQS接收成功，并成功发送到Kafka，华为云Astro轻应用也收到了对应的消息，但是可能没成功拉起服务编排。 解决方法：查看iotgateway的“flume.log”日志，确认MQS是否接收成功。通过“kafka-console-cumer”确认消息是否转换成功，通过华为云Astro轻应用的日志跟踪功能或华为云Astro轻应用后台日志确认（日志关键字为“OnEvent”）平台是否收到事件。如果没有对应的服务编排或事件日志，可以确定服务编排未拉起，请联系华为工程师解决。

如何使用脚本图元 在基本中，拖拽“脚本”图元到右侧画布中。 选中画布中的脚本图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Script序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 单击，选择脚本、设置输入参数和输出参数。 图1 配置脚本 表2 脚本图元配置参数说明 参数 说明 脚本 调用的脚本名称，只有在启用状态下的脚本才能被服务编排调用。 输入参数/目标 脚本的输入参数名称。单击“新增行”，在下拉框中选择脚本输入参数的名称。 输入参数/源 服务编排中的变量，为目标赋值。可直接填写，也可以拖入全局上下文变量，将服务编排中的变量赋值给脚本中的输入参数。 输出参数/源 脚本的输出参数名称。单击“新增行”，在下拉框中选择脚本输出参数的名称。 输出参数/目标 服务编排中的变量，脚本中的输出参数赋值给服务编排中的变量。拖入全局上下文变量，将脚本的输出参数赋值给服务编排中的变量。

前提条件 请联系运维，开启事件流License权限。开启后，才可新建、查看并管理事件流。 已创建并启用温度监测事件“temperature”，该事件中自定义参数为文本类型“position”和数字类型“temperature”，分别表示位置和温度，具体操作步骤请参考如何自定义事件。 已创建并启用高温报警事件“fire_alarm”，该事件中自定义参数为文本类型“positionalarm”和数字类型“temperaturealarm”，分别表示高温报警位置和温度，具体操作步骤请参考如何自定义事件。

背景信息 首先，您需要理解以下概念： kafka：是由Apache开发的一个开源流处理平台，是分布式发布、订阅消息系统。kafka主要用于处理活跃的流数据，一般kafka部署为集群模式。 Topic：用来区分kafka集群中，不同类型消息的主题。例如，应用程序A订阅了Topic1，应用程序B订阅了Topic2而没有订阅Topic1，那么发送到Topic1中的数据将只能被应用程序A读到，而不会被应用程序B读到。 spark streaming：大规模流式数据处理工具，第三方工具。

操作步骤 参考登录经典应用设计器中操作，登录经典版应用设计器。 将鼠标放在应用的某个文件夹上（如Logic），单击“+”，选择“事件流”。 开启事件流License权限后，才会有新建事件流的入口。 单击“新建”，进入“事件流”页面。 在“事件流”页面右侧，单击“设置”，进行数据配置。 图2 设置页面 窗口长度：事件流处理的数据采集时间间隔，单位为分钟。建议时间间隔不要配置过小，否则系统频繁的建表和执行SQL语句，会影响系统性能。例如：配置为“1”表示spark streaming每隔1分钟去kafka获取事件数据。 在“事件流”页面右侧，单击“图元”，拖拽“输入源”中Kafka图元至左侧画布区域，并配置基本信息，单击“保存”。 输入源中Kafka图标表示数据来自Kafka。 图3 数据来源Kafka基本信息页面 标签：新建数据源Kafka的标签名，用于在界面展示。 名称：新建数据源Kafka的名称，系统自动生成。 事件：需要订阅的事件。例如，配置为温度监测事件“temperature”。 从外部接收：是否从外部Kafka接收事件。 关闭该开关，从与AstroZero相连的Kafka接收事件。 打开该开关，从外部Kafka接收事件。本示例中关闭该开关，使用与AstroZero相连的Kafka。 Kafka集群地址：数据源Kafka的集群地址。多个节点服务器地址可用“,”间隔，格式为“Kafka节点1的ip:节点1端口号,Kafka节点2的ip:节点2端口号,...”。 获取Kafka的IP和端口号方法：登录每台Kafka节点服务器，查看“${KAFKA_HOME}/config”目录下，“server.properties”中“listeners”的取值。 订阅主题：获取的事件数据来源，即来自于kafka集群的哪个Topic。 从“图元”中，拖拽“投影”图元至左侧画布区域数据源Kafka下方，并在弹出的“添加投影器”页面配置基本信息，单击“保存”。 图4 “添加投影器”页面 标签：新建投影的标签名，用于在界面展示。 名称：新建投影的名称，系统自动生成。 输入字段：订阅事件的所有事件参数。选择所需的参数，单击，选中的参数会出现在“输出字段”中。 输出字段：从订阅事件的事件参数进行筛选后，用到的事件参数。 从“图元”中，拖拽“过滤”图元至左侧画布区域投影下方，并在弹出的“添加过滤器”页面配置基本信息和过滤条件，单击“保存”。 图5 设置过滤条件 标签：新建过滤的标签名，用于在界面展示。 名称：新建过滤的名称，系统自动生成。 条件设置：设置过滤条件。例如，图中的配置表示提取温度大于60度的事件。 字段：上一步筛选后的事件参数。 比较符：操作符，直接在下拉框中选择。 值：字段值。 （可选）从“图元”页面中，拖拽“分组”图元至左侧画布区域过滤器下方，并在弹出的“添加分组器”页面配置基本信息和分组条件，单击“保存”。 图6 “添加分组器”页面配置 标签：新建分组的标签名，用于在界面展示。 名称：新建分组的名称，系统自动生成。 分组设置：设置分组条件。例如，图中配置表示按照相同位置的大于60度的温度取温度平均值。 在“图元”页面右侧，拖拽输出源中的Kafka图元至左侧画布区域最下方，设置spark streaming输出事件和输出事件数据的接收方，单击“保存”。 可以拖拽多个Sink中的Kafka图元，设置多个事件接收方。 图7 数据接收方配置 标签：数据接收方Kafka的标签名，用于在界面展示。 名称：数据接收方Kafka的名称，系统自动生成。 事件：spark streaming输出的事件。本示例此处配置为高温报警事件“fire_alarm”。温度监测事件“temperature”中的“position”，对应高温报警事件“fire_alarm”中的“positionalarm”。温度监测事件的“temperature”，对应高温报警事件“fire_alarm”中的“temperaturealarm”。 发送到外部：是否发送到外部Kafka。若关闭该开关，表示发送到与AstroZero相连的Kafka。若打开该开关，表示发送到外部Kafka，需要配置“Kafka集群地址”和“订阅主题”。本示例中关闭该开关，使用与华为云Astro轻应用相连的Kafka。 Kafka集群地址：接收事件的Kafka集群地址，例如10.136.14.56:9092。 多个节点服务器地址可用“,”间隔，格式为“Kafka节点1的ip:节点1端口号,Kafka节点2的ip:节点2端口号,...”。 获取Kafka的IP和端口号方法：登录每台Kafka节点服务器，查看“${KAFKA_HOME}/config”目录下，“server.properties”中“listeners”的取值。 接收事件的kafka集群，不需要一定配置为和AstroZero相连。 订阅主题：接收事件数据的kafka Topic，例如__BINGO_PROD_SYS_TOPIC。 事件属性/属性、值：配置输出事件与接收事件中，已定义参数的对应关系。 单击页面右上方保存按钮，设置“事件流”基本参数。 图8 该“事件流”基本参数页面 标签：新建事件流的标签名，用于在界面展示。 名称：新建事件流的名称，系统自动生成。 描述：新建事件流的描述信息。 单击页面上方的，启用事件流。

结果验证 创建一个服务编排“fire_alarm”，创建后启用该服务编排，实现当kafka中出现高温报警事件时，AstroZero需要接收该事件，再向第三方系统发送该告警邮件。 鼠标放在应用下的Logic文件夹上，单击“+”，选择“服务编排”。 选择“创建一个新的服务编排”，设置标签和名称为“fire_alarm”，单击“添加”。 在服务编排设计页面左侧，拖拽“逻辑”下的“等待”图元至画布中。 单击，在“可编辑的事件”中，单击“新增”，新增“event0”分支。 配置该分支事件为高温报警事件，当系统中出现该事件时，会执行该分支。 图9 配置等待图元 拖拽“基本”下的“发送邮件”图元至画布中。 单击，设置发送邮件参数。 配置高温报警邮件的主题和内容，地址填入第三方系统的邮件接收地址。 图10 配置发送邮件图元 直接编辑：手动设置邮件信息。 基于模板：基于同一账号或基线中已有的邮件模板，设置邮件主题和内容，方便用户增加效率。 模板：选择“基于模板”时，需要选择邮件模板。 主题：设置邮件标题。 选中“直接编辑”时，需要配置邮件标题。 选中“基于模板”时，该参数配置区域置灰。 内容：设置邮件内容。 选中“直接编辑”时，需要配置邮件内容。 选中“基于模板”时，该参数配置区域置灰。 自定义变量：选中“基于模板”时，需要配置模板中的参数。在“值”中，直接输入参数取值或者从全局上下文拖拽变量。 地址：接收人的邮箱地址。 字符串：直接输入分号分隔的字符串或从全局上下文拖拽变量。 集合：从全局上下文拖拽集合变量。 抄送：抄送人员的邮箱地址，直接输入分号分隔的字符串或者从全局上下文拖拽变量。 密送：密送发送人员的邮箱地址，直接输入分号分隔的字符串或者从全局上下文拖拽变量。 按照下图连接所有图元，等待图元和发送邮件图元之间选择“event0”分支。 图11 连接所有图元 单击页面上方的，保存服务编排。 保存成功后，单击，启用服务编排。 创建一个服务编排“send_fire_event”，将温度监测事件“temperature”中位置参数“position”赋值为仓储公司某区域，温度“temperature”赋值为70度，启用该Flow，用于模拟事件发送。 鼠标放在应用下的Logic文件夹上，单击“+”，选择“服务编排”。 选择“创建一个新的服务编排”，设置标签和名称为“send_fire_event”，单击“添加”。 在服务编排编辑器页面左侧，拖拽“基本”下的“发送事件”图元至画布中。 单击，设置发送事件参数。 图12 配置发送事件图元 事件：选择待发送的事件。 分区字段：从事件中选择一个自定义参数用作Kafka的分区字段，则根据该字段值进行路由，相同的值将路由到同一个Kafka分区。如果不指定，则默认随机路由到不同Kafka分区，从而提升并发处理性能。 发送到外部：系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。若不勾选“发送到外部”，表示将事件数据发到默认的Topic上。若勾选“发送到外部”，则表示将事件数据发送到与AstroZero相连Kafka的其他Topic上。 延迟到事务结束（提交或回滚）后才发送：是否延迟到该服务编排事务结束后，才发送事件。 主题：勾选“发送到外部”时，才显示该参数，表示非系统配置的默认Topic。 目标/源：配置事件数据。 本示例中，“目标”请从下拉框中选择事件的自定义参数“temperature”和“position”，在“源”中给目标赋值。 按照下图连接所有图元。 图13 连接图元 单击页面上方的，保存服务编排。 保存成功后，单击，启用服务编排。 在“事件流”列表页面，单击该事件流程所在行的，运行该事件流程。 单击服务编排“send_fire_event”编辑器上方的，执行服务编排。 不用输入任何输入参数，直接单击“运行”。 参考上一步，执行服务编排“fire_alarm”。 不用输入任何输入参数，单击“运行”。 打开第三方系统邮箱，成功收到高温警报邮件，验证成功。

如何使用循环图元 例如，当前有数组变量“TestList1”，“TestList2”，要求把“TestList1”中的元素逐个加到数组“TestList2”的后面。 创建数组变量“TestList1”、“TestList2”和普通变量“test_var”。 在服务编排编辑器页面右侧，选择。 在全局上下文页面，单击“变量”后的加号。 图1 创建变量 单击新增变量后的“...”，选择“设置”。 设置数组变量“TestList1”，数据类型为文本。 图2 数组变量“TestList1” 参考上述步骤设置数组变量“TestList2”和普通变量“test_var”，普通变量不用勾选“是否为数组”。 图3 数组变量“TestList2” 图4 普通变量“test_var” 在逻辑中，拖拽“循环”图元到画布中。 选中循环图元，单击，设置基本信息。 图5 设置基本信息 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Loop序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 单击，在“循环”页面进行配置。 图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" ] } }

如何使用等待图元 在逻辑中，拖拽“等待”图元至画布中。 选中等待图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Wait序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 单击，在“等待”页面进行配置。 图1 Wait配置及Pass分支条件配置 图2 Unpass分支条件配置 图3 Timeout分支条件配置 表2 条件分支配置参数说明 参数 说明 可编辑的事件 所有的判断条件。 可通过单击“新增”，来增加判断条件分支。 默认：默认输出，当其他所有条件均不满足情况下，进入该分支。 例如，新增如下三个判断条件： Pass：应聘者被录用。应聘通过时，Boolean类型参数“result”赋值为全局常量“{!$GlobalConstant.True}”，表示结果为真，即应聘通过。 Unpass：应聘者没有被录用。应聘失败时，Boolean类型参数“result”赋值为全局常量“{!$GlobalConstant.False}”，表示结果为假，即应聘拒绝。 Timeout：超时事件。基于该服务编排执行时间，超时30分钟未返回是否录用。 事件/时间 当订阅的是自定义事件时，需要选择“事件”。 当订阅的是系统预置的标准事件“Absolute Time Alert”，即定时器发送的系统事件时，需要选择“时间”。 本示例中，需要配置如下： Pass：请选择“事件”。 Unpass：请选择“事件”。 Timeout：请选择“时间”。 事件 请选择需要订阅的事件，当订阅的是自定义事件时，该参数才会显示。 事件条件 该分支的条件。单击“新增行”，可进行添加。当订阅的是自定义事件时，该参数才会显示。 分支条件中的字段，为创建该事件时设置的自定义参数，值可从右侧全局上下文中选择拖入。 定义需要满足的其他条件 勾选“定义需要满足的其他条件”后，可根据事件变量外的其他变量设置追加条件。 可视 勾选“定义需要满足的其他条件”后，该参数才会显示。当选择“可视”时，可配置追加条件的判断条件。单击“新增”，可新增判断条件。条件显示为“资源”、“比较符”、“值”。 默认选择“可视”。 公式 勾选“定义需要满足的其他条件”后，该参数才会显示。可采用公式设置追加条件。 选择连接条件 当选择“可视”并设置多条判断条件时，需要设置选择连接条件“或”或者“且”。 或：表示满足多条判断条件的其中一条，便可进入该分支。 且：表示必须同时满足多条判断条件，才可进入该分支。 输出 如果需要在服务编排中，使用事件的参数，将其参数赋值到事件变量中方便服务编排引用。 当订阅的是自定义事件时，该参数才会显示。 默认不需要。 基准时间 当订阅的是系统预置的定时器发送事件时，该参数才会显示。 可从全局上下文拖拽日期/时间类型变量，也可设置为某个具体时间，或者设置为本服务编排执行时间。 例如，在本节中设置为本服务编排执行时间，即{!$Flow.CurrentDateTime}。 偏移时间 偏移时间，例如“30”。当订阅的是系统预置的定时器发送事件时，该参数才会显示。

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

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

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

如何使用发送事件图元 在基本中，拖拽“发送事件”图元至画布中。 选中发送事件图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为Event序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 单击，在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 说明 事件 选择待发送的事件，直接在下拉框中选择。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段，则根据该字段值进行路由，相同的值将路由到同一个Kafka分区；如果不指定，则默认随机路由到不同Kafka分区，从而提升并发处理性能。 须知： 建议选择有区分度的关键字段，该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与华为云Astro轻应用相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 如果不勾选“发送到外部”，表示将事件数据发到默认的Topic上。 如果勾选“发送到外部”，表示将事件数据发送到与华为云Astro轻应用相连Kafka的其他Topic上，此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束（提交或回滚）后才发送 是否延迟到该服务编排事务结束后，才发送事件。 默认不勾选，表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时，该参数才会显示，表示非系统配置的默认Topic。 需要从与华为云Astro轻应用相连Kafka处，获取其他主题Topic。 目标/源 配置事件数据，为该事件自定义参数赋值，将“源”取值赋值到“目标”中。单击“新增行”，可添加并进行赋值。 目标：从下拉框中，选择事件的自定义参数。 源：从全局上下文拖拽变量或直接输入“{!变量名}”，给目标赋值。

结果验证 通过服务编排订阅“EmployResultNotify”事件后，招聘经理需要给出招聘结果，即给“Result”赋值后，人事部经理才会收到招聘者是否被录用的邮件通知。即需要设置发送事件，订阅者才可以接收事件。 本章节通过单独创建一个服务编排，来给应聘者Lily的应聘结果“Result”赋值，模拟事件发送。 参考创建服务编排中操作，创建一个服务编排。 图8 新建服务编排SendEvent 在服务编排设计页面左侧，选择“基本”，拖拽“发送事件”图元至画布中。 Send Event为系统提供的，发送事件接口。 图9 拖拽发送事件图元至画布中 配置发送事件图元。 以应聘者Lily被成功录用为例，在“全局上下文”中，单击“变量”后的加号，新增变量，设置发送事件参数。 单击，进入全局上下文页面，新建一个变量variable0。 图10 新增一个变量 选中发送事件图元，单击，设置基本信息。 图11 设置发送事件基本信息 单击，设置发送事件。 图12 发送事件配置页面 表3 发送事件参数说明 参数 说明 事件 选择待发送的事件，本示例选择创建华为云Astro轻应用自定义事件中创建的事件。 分区字段 从事件中，选择一个自定义参数，用作Kafka的分区字段。设置后，会根据该字段值进行路由，相同的值将路由到同一个Kafka分区。如果不指定，则默认随机路由到不同Kafka分区，从而提升并发处理性能。 发送到外部 系统内部有配置与华为云Astro轻应用相连Kafka的固定Topic（__BINGO_SYS_TOPIC）。 不勾选，表示将事件数据发到默认的Topic上。 勾选，表示将事件数据发送到与华为云Astro轻应用相连Kafka的其他Topic上。 默认为不勾选。 延迟到事务结束（提交或回滚）后才发送 是否延迟到该服务编排事务结束后，才发送事件。 默认为不勾选。 目标/源 该事件自定义的参数取值，请单击“新增行”，进行添加并赋值。 连接开始和发送邮件图元。 图13 连接图元 在服务编排设计页面上方，单击，保存服务编排。 保存成功后，单击，运行服务编排。 设置输入参数，单击“运行”，运行后，才能发送该事件。 邮件接收者，收到邮件，验证成功。 图14 发送事件

通过服务编排订阅事件 参考创建服务编排中操作，新建一个服务编排。 图1 添加服务编排 表1 新建服务编排参数说明 参数 说明 标签 新建服务编排的标签名，用于在页面展示。 取值范围：1~64个字符。 示例：EmployResultNotifySubscription。 名称 名称为服务编排在系统中的唯一标识，创建后不可修改。要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 示例：EmployResultNotifySubscription。 类型 请在下拉列表中，选择新建服务编排的类型。取值如下： Autolaunched Flow：自启动服务编排，即在接口调用后，会立即执行服务编排中定义的逻辑。 Event Trigger：事件触发的服务编排，在事件触发时，才会开始执行服务编排中定义的逻辑。 示例：Event Trigger。 事件 选择在服务编排中订阅的事件，即创建华为云Astro轻应用自定义事件中创建的事件，请确保事件已启用。 描述 请根据需要，在文本框中输入该服务编排的描述信息。 取值范围：1~255个字符。 在服务编排设计页面左侧，选择“逻辑”，拖拽“决策”图元至画布中。 该图元类似“if”语句的判断，用于在服务编排流程中创建判断条件，根据判断结果连线其他图元，决定后续执行何种操作。本示例需要设置应聘者被成功录用、应聘者没被录用和其他三个判断分支。 图2 拖拽决策图元至画布中 选中决策图元，单击，设置分支条件参数。 图3 pass分支条件配置 图4 unpass分支条件配置 可编辑的结果，即所有的判断条件。系统已预置默认条件，即当其他所有条件均不满足情况下，进入该分支。 本示例，需要新增如下两个判断条件： Pass：应聘者被录用。应聘通过时，事件中自定义的布尔类型参数“Result”赋值为全局常量“{!$GlobalConstant.True}”，表示结果为真，即应聘通过。 Unpass：应聘者没有被录用。应聘失败时，事件中自定义的布尔类型参数“Result”赋值为全局常量“{!$GlobalConstant.False}”，表示结果为假，即应聘失败。 在服务编排设计页面左侧，选择“基本”，拖拽“发送邮件”图元至画布中。 发送邮件是发送邮件的接口。本示例中，需要根据录用结果，发送不同的邮件给人事部。 录用成功，需要邮件通知人事部办理入职。 录用不成功，需要邮件通知人事部告知应聘者应聘失败。 事件超时（默认分支），需要邮件通知招聘经理，看其是否给出招聘结果。 如下图所示，以应聘者被成功录用为例，设置发送邮件参数。 选中发送邮件图元，单击，设置基本信息。 图5 设置邮件发送基本信息 单击，设置邮件发送参数。 图6 配置邮件发送参数 表2 邮件发送参数说明 参数 说明 邮件配置 可选择“直接编辑”手动设置邮件信息或“基于模板”选择邮件模板。 示例：直接编辑。 主题 请根据需要，在输入框中输入邮件的标题。 示例：Interview Result。 内容 设置邮件的内容，需要使用事件变量“命名空间_EmployResultNotify__e”，请直接从变量中拖入。 地址 接收人的邮箱地址。 文本：表示直接输入。 集合：表示可以拖入一个集合变量。 示例：文本，即直接输入邮件接收人的地址。 参考5中操作，设置应聘者录用失败和超时邮件发送。 如图7所示，连接所有元素。 图7 连接并设置起始元素 在服务编排设计页面上方，单击，保存服务编排。 保存成功后，单击，启用服务编排。 启用后，当有“EmployResultNotify”事件触发时，即会执行服务编排中定义的逻辑。

创建私有结构体 服务编排中如果涉及复杂的结构体参数，可以先创建全局或私有结构体，并用作参数类型。创建全局结构体和私有结构体后，再参考创建对象变量/结构体变量/事件变量中操作，创建全局结构体变量和私有结构体变量，作为服务编排的参数类型。 在服务编排设计器右侧，选择，在私有结构体页面单击“新增”。 该“私有结构体”页面有两个“新增”按钮，单击上面的“新增”按钮，是通过设置页面参数新建私有结构体。单击下面的“新增”按钮，是通过输入JSON Schema类型的数据源码定义私有结构体。 图12 添加私有结构体类型 （如果上一步单击“私有结构体”页面上方的“新增”按钮，请执行该步骤）设置页面参数。 在“基本信息”中，输入结构体名字、描述信息。 在“结构体成员”中，设置自定义成员变量，包括设置成员变量的名称、数据类型、是否必填、是否是集合和描述信息等。单击“新增”，可增加成员变量，支持设置全局结构体或私有结构体成员变量。当私有结构体的成员变量包含结构体类型时，您需要提前定义成员结构体。例如，下图中成员变量“hobby”为私有结构体类型，需要提前创建“create”私有结构体。 图13 配置私有结构体 （如果上一步单击“私有结构体”页面下方的“新增”按钮，请执行该步骤）在“创建JSON Schema”页面中，定义结构体名称，在“JSON源码”中输入数据源码，单击，系统会进行校验，转换成服务编排中的结构体类型，单击“保存”。 图14 创建JSON Schema 数据源码示例如下： { "name": "xiaoming", "age": 18, "father": { "name": "daliu", "gender":"male" }, "brother": { "name": "xiaolei", "gender":"male" } } 创建成功后，页面显示如下。 图15 创建成功 该方式创建的结构体中，包含成员结构体时，成员结构体具体定义不会在界面显示，且其他结构体不可引用。 JSON结构体支持嵌套，例如上述创建的“family”结构体，在“JSON Schema结构体”区域再次单击“新增”，新增“company”结构体，里面“ceo”嵌套引用“family”结构体，如下图所示，在定义结构体输入值时，您可以输入“$”符号，选择当前服务编排中的其它结构体进行嵌套引用。 图16 引用其他结构体

创建服务编排 参考登录华为云Astro轻应用应用设计器中操作，登录应用设计器。 在左侧导航栏中，选择“逻辑”。 （可选）单击编排后的，为服务编排添加目录。 服务编排默认存放在根目录下，在创建服务编排前，您可以先创建服务编排存放的目录，也可以在服务编排创建后将其拖拽到指定目录。 将鼠标放在已创建的服务编排目录上，单击，进入“添加服务编排”页面。 如果未创建服务编排目录，请直接单击编排后的，进入添加服务编排页面。 设置参数，单击“添加”。 图1 创建服务编排 表1 添加服务编排参数说明 参数 说明 标签 新建服务编排的标签名，用于在界面展示，创建后可修改。 取值范围：1~64个字符。 名称 服务编排在系统中的唯一标识，创建后不支持修改。系统会自动在名称前添加“{命名空间}__”，当其他功能调用服务编排时，调用的是服务编排的名称，而不是标签。 命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 名称必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。 类型 在下拉框中，选择服务编排的类型。 Autolaunched Flow：自启动Flow，在接口调用后会立即执行服务编排模型定义的逻辑。 Event Trigger：事件触发的服务编排，在事件触发时才会开始执行服务编排模型定义的逻辑。当选择该类型时，您需要配置具体的事件以及条件规则。 默认值：Autolaunched Flow。 描述 请根据实际需求，输入服务编排的描述信息，建议设置为服务编排的功能介绍。 取值范围：1~255个字符。 创建变量。 在服务编排设计器中，单击，进入全局上下文页面。 单击“变量”后的，创建表2中的变量。 图2 创建变量 表2 变量说明 变量名 类型 变量说明 userName 文本 传入的用户名 message 文本 欢迎信息 在全局上下文中，除了创建基本类型的变量，还可以创建常量、创建公式变量、创建私有结构体和创建对象变量/结构体变量/事件变量。 单击，配置服务编排的输入输出参数。 图3 配置输入输出参数 将“逻辑”中的“赋值”图元，拖拽到画布中。 赋值图元可以实现对全局上下文中变量等参数进行赋值，其他图元的详细介绍，请参见为华为云Astro轻应用服务编排设置图元。 图4 拖拽赋值图元到画布 配置图元。 选择赋值图元，单击。 在“赋值”页面中，单击“新增行”，参照下图将创建的变量拖拽到相应的位置。 将“"Hello,"”赋值给message变量，并将userName变量拼接到message变量中，赋值语句将从上往下依次执行。 图5 配置赋值图元 连接图元指定逻辑关系，即从开始图元连向赋值图元，表示服务编排开始执行后，执行赋值图元的赋值语句。 图6 连接图元 单击页面上方的，保存服务编排。 单击，进入服务编排调试页面。 在输入参数中，输入如下内容，并单击“运行”。 { "userName": "Flow" } 运行结果如下，输出“Hello,Flow”。 图7 运行结果 单击页面上方的，启用服务编排。 服务编排启用后，才可以在脚本、工作流等操作中引用。 调试已创建的服务编排。 在应用设计器左侧导航栏中，选择“集成”。 单击开放接口后的“+”，新建一个helloFlow开放接口，单击“保存”。 图8 新建开放接口helloFlow 接口创建后，在开放接口中，将鼠标放在已创建的接口上，单击，选择“查看”。 在预览页面，单击接口后的。 单击“测试一下”，输入示例模型，单击“执行”。 图9 测试接口 执行成功后，可查看到API的测试结果。 [ "resCode": "0", "resMsg": "成功", "result": [{ "message": "Hello, Flow" }] ]

创建常量 编排服务流程或交互时，不会改变的值或参数，通常定义为常量，例如服务标识、访问地址和错误码等。 在服务编排设计器右侧，选择。 在全局上下文页面，单击“常量”后的。 单击新增常量后的“...”，选择“设置”。 设置页面参数，单击“保存”。 图10 配置常量 表3 常量参数说明 参数 说明 名称 新建常量的名称，名称是变量在流程中引用的唯一标识。修改变量名不会改变图元中的引用，但是会导致流程不可用。 数据类型 常量的数据类型，直接在下拉框中选择即可，默认为“文本”类型。 值 新建常量的取值，字符串常量输入需要用双引号括起来，例如“"abc"”。 描述 根据实际需求，输入变量的描述信息。 外部使用 如果勾选该选项，表示该变量为外部使用变量，编译时不校验其是否被使用。 默认为不勾选。

创建对象变量/结构体变量/事件变量 对象变量用于在服务编排中引用或操作特定的对象实例，用于较简单的业务流程中。结构体变量允许将多个不同类型的数据项进行组合，通常用于较复杂的业务流程中。事件变量用于表示系统或业务流程中发生的事件，事件可以是系统内部产生的，也可以是外部触发的。 在服务编排设计器右侧，选择。 在全局上下文页面，单击“对象变量”后的。 设置页面参数，以创建对象变量为例进行介绍。 图17 配置对象变量 表5 对象变量参数说明 参数 说明 名称 输入新建对象变量的名称，名称是变量在流程中引用的唯一标识。修改变量名不会改变图元中的引用，但是会导致流程不可用。 对象 请直接在下拉框中，选择具体的对象。选择“对象”类型时，该参数才会显示。 全局结构体 请直接在下拉框中，选择具体的全局结构体。选择“全局结构体”类型时，该参数才会显示。 私有结构体 请直接在下拉框中，选择具体的私有结构体。选择“私有结构体”类型时，该参数才会显示。 事件 请直接在下拉框中，选择具体的事件。选择“事件”类型时，成员变量为事件的自定义字段，不包括系统预置的标准字段。选择“事件”类型时，该参数才会显示。 默认值 请直接输入变量的默认值或从下拉框中选择。 描述 请根据实际需求，输入变量的描述信息。 取值范围：1~255个字符。 是否为数组 是否为数组变量，即集合变量。 默认为不勾选。 外部使用 勾选该选项，表示该变量为外部使用变量，编译时不校验其是否被使用。 默认为不勾选。

创建公式变量 在服务编排中，公式变量主要用于变量赋值、表达式计算、参数传递等。 在服务编排设计器右侧，选择。 在全局上下文页面，单击“公式”后的。 设置页面参数，单击“保存”。 图11 配置公式变量 表4 公式变量参数说明 参数 说明 名称 输入新建公式变量的名称。 数据类型 公式变量的数据类型，直接在下拉框中选择即可，默认为“文本”类型。 描述 根据实际需求，输入公式变量的描述信息。 外部使用 勾选该选项，表示该变量为外部使用变量，编译时不校验其是否被使用。 默认为不勾选。 表达式 设置新增变量的表达式。如果表达式中需要运用公式，可根据需要双击“公式”区域中系统预置的公式，该公式会显示在右侧“表达式”区域中。当表达式中需要有变量参数时，可从变量区域中直接选择变量拖入到表达式中。

如何使用记录创建图元 在基本中，拖拽“记录创建”图元至画布中。 选中记录创建图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为RecordCreate序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 请根据实际需求，在输入框中输入图元的描述信息。 取值范围：1~255个字符。 使用快速创建模式 是否启用快速创建模式。 如果勾选该参数，表示为快速模式。该模式可以创建一条或者多条记录，仅需要配置对象的对象变量（与对象关联的变量）或对象变量数组。该图元负责将对象变量或对象变量数组的值写入数据库。当对象变量为数组时，则实现创建多条记录。创建成功后，返回的记录ID自动保存在对象变量中。创建记录的各个字段的值为对象变量中的值，因此一般需要在创建记录之前先给对象变量进行赋值。 不勾选，表示为普通模式。该模式下每次执行到该图元仅创建一条记录，需要配置要创建记录的对象名，对象中字段的值，返回的记录ID保存到变量名中。 默认为不勾选。 单击，在“记录创建”页面进行配置。 如果上一步勾选“使用快速创建模式”，则需要指定一个预先定义的对象变量或者对象变量数组，并将该对象变量或对象变量数组拖拽到“变量”输入框中，使用该对象变量或对象变量数组的值创建新记录。如下图所示，使用“accountCreate”对象变量的值创建新记录。 图1 快速创建模式 表2 快速创建模式参数说明 参数 说明 变量 预先定义的对象变量或对象变量数组，使用该对象变量或者对象变量数组的值创建新记录。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前流程出现错误时回滚 勾选表示在服务编排中，当后续图元失败的情况下，就可以回滚到上一个流程。 不勾选，在服务编排中，当出现后边图元失败的情况下，对象记录操作的图元就不回滚。 默认为勾选。无特殊要求，请不要更改设置。 如果上一步未勾选“使用快速创建模式”，则需要指定对象并为对象的字段赋值来创建记录。如图2所示，为“Account”对象新增“name”为“Lily”的数据记录，在变量“var_record_id”中保存新建的记录ID。 图2 普通创建模式 表3 普通创建模式参数说明 参数 说明 对象 请在下拉框中，选择具体的对象。这里只能使用当前项目中的，依赖BO中公开的以及全局的对象。 当前流程出现错误时回滚 当前服务编排出现错误时，回滚到上一个流程。 默认为勾选。无特殊要求，请不要更改设置。 赋值 选中对象后，该赋值区域“目标”列会出现该对象的字段。如果需要给多个字段赋值，则单击“新增行”，定义其他字段的值。 在“目标”中选择需要赋值的对象字段，“源”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 变量 将创建的记录ID分配到该变量中，以便在服务编排中引用。 从全局上下文拖拽或直接输入文本类型变量。

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

如何使用BO图元 在BO中，拖拽所需的BO图元至画布中。 选中BO图元，单击，设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签，用于在服务编排设计页面展示。系统会自动填入该值，格式为BO名序号，序号从“0”开始，表示同类型图元序号。 名称 设置图元的名称，名称为图元在服务编排中的标识，请确保在当前服务编排中唯一。命名要求如下： 长度范围为1~80个字符。 必须以英文字母开头，由英文字母，数字或单下划线组成，且不能以下划线结尾。 描述 根据实际需求，输入图元的描述信息。 取值范围：1~255个字符。 单击，在“BO”页面进行配置。 图1 配置BO图元 表2 BO图元配置参数说明 参数 说明 服务版本 BO中自定义API的版本号。 API类型 根据实际需求，选择REST或SDK。 操作方法 BO中已自定义好的API接口，该API接口类型必须是“服务编排”，才可在服务编排中调用。 入参/目标 当选择具体操作方法（API）后，API的输入参数将会显示在入参的目标列。 入参/源 服务编排中的变量，需要和目标的参数类型保持一致。该源会将服务编排中的变量，赋值给调用API的输入参数。 出参/源 当选择具体操作方法（API）后，API的输入参数将会显示在出参的源列。 出参/目标 服务编排中的变量，需要和输出参数的类型保持一致。API中的输出参数赋值给服务编排中的变量，供服务编排使用。

如何使用发送事件图元 在基本中，拖拽“发送事件”图元至画布中。 选中发送事件图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面显示。系统会自动填入该值，格式为Event序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 参数说明 事件 选择待发送的事件。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段，则根据该字段值进行路由，相同的值将路由到同一个Kafka分区；如果不指定，则默认随机路由到不同Kafka分区，从而提升并发处理性能。 须知： 建议选择有区分度的关键字段，该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 若不勾选“发送到外部”，表示将事件数据发到默认的Topic上。 若勾选“发送到外部”，表示将事件数据发送到与AstroZero相连Kafka的其他Topic上，此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束（提交或回滚）后才发送 是否延迟到该服务编排事务结束后，才发送事件。 默认不勾选，表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时，该参数才会显示，表示非系统配置的默认Topic。 需要从与AstroZero相连Kafka处，获取其他主题Topic。 目标/源 配置事件数据，为该事件自定义参数赋值，将“源”取值赋值到“目标”中。单击“新增行”，可添加并进行赋值。 目标：从下拉框中，选择事件的自定义参数。 源：从全局上下文拖拽变量或直接输入“{!变量名}”，给目标赋值。

卡片 卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基础元素（卡片标题、图表、卡片背景、卡片边框）和图表元素构成。 图3 基本漏斗图卡片 卡片装饰：卡片装饰设置，可根据自身的业务需求选择不同的卡片样式。单击“清除样式”，可清除已设置的装饰样式。 背景 背景色：设置组件卡片的背景颜色。 边框：组件卡片的边框设置，支持无边框、全边框和角边框三种样式。设置为全边框和角边框时，支持设置组件外圈边框的线型、圆角等。 样式：选择图片时，图片显示的样式，支持普通、居中、拉伸和平铺四种样式。 选择图片：使用本地的图片作为组件背景，支持新增目录和子目录，便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片，且每张图片不能超过50MB。 特效：组件是否高亮显示，支持默认展示和跳转到页面时展示。 边距：组件中图表距离整个组件四边（上、下、左、右，如图2）的距离，默认为0，即铺满整个组件。

图形 图形是指组件中，实现 数据可视化 的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图5 基本漏斗图图形 颜色：设置图表中，图形的颜色。 统一配置 数据块高度(%)：设置漏斗图的高度比。 标签字体：设置数据块中标签的字体、颜色、大小。 数据系列 系列名称：原始数据中默认的系列名称，可通过设置“显示名称”，进行修改。 显示名称：自定义图表中系列的显示名称。 数据块颜色：数据块的颜色。 标签字体：设置标签的字体、文字大小、文字颜色等。

图例 图例是指在多维度可视化图形表达中，用以区分不同维度可视化图形的提示标识。 图6 基本漏斗图图例 显示图例：是否展示图例。图例文字内容来源于数据模型下“label”的值。 图例标记：设置图例小图标形状。 图例宽高：设置图例的宽度和高度。 图例间隔：设置图例之间的间隔。 字体：设置图例的字体、颜色和大小等。 图例位置(左)：图例的位置。 对齐方式：设置图例的对齐方式，如左对齐、居中或右对齐。 上间距：图例到漏斗图组件顶部距离占组件高度。 图例类型：存在很多图例，导致图表中无法全部显示，此时可设置图例类型，即通过滚动翻页还是普通换行来查看图例。 翻页按钮：翻页按钮的颜色。 翻页按钮不激活：翻页按钮不激活时的颜色。 自定义图例显示：是否开启自定义图例显示设置。开启后，可调整图例名称显示字符长度。默认关闭，即显示图例所有字符。

购买实例 进入购买华为云Astro大屏应用实例页面。 选择购买的实例版本和购买时长，单击“立即购买”。 购买实例时，支持同时购买页面扩容包，也可以在实例购买后，对页面进行扩容。页面扩容包计费规则，请参见计费项。 图1 购买实例（基础版） 图2 购买实例（专业版） 图3 购买实例（企业版） 选择支付方式，单击“去在线支付”，完成订单支付。 图4 确认付款 订单支付成功后，单击“返回Astro轻应用控制台”。 在华为云Astro大屏应用控制台中，可以查看华为云Astro大屏应用的安装状态。当“实例状态”变为“运行中”时，说明实例已安装好，可以正常使用。 图5 华为云Astro大屏应用控制台

图例 图例是指在多维度可视化图形表达中，用以区分不同维度可视化图形的提示标识。 图7 轮播饼图图例 统一配置 图例：是否显示图例，如工程管理、环境管理。图例文字内容来源于数据模型下“s”的取值。 水平对齐方式：设置图例的水平对齐方式，支持左对齐、居中、右对齐和按照百分比设置。 垂直对齐方式：设置图例的垂直对齐方式，支持顶部对齐、居中、底部对齐和按照百分比设置。 排列方向：设置图例的排列方向，支持水平和垂直两种方式。 类型：存在很多图例，导致图表中无法全部显示，此时可设置图例类型，即通过滚动翻页还是普通换行来查看图例。设置为“滚动翻页”时，支持设置翻页箭头的宽高、图标默认颜色、图标选中颜色和页码字体。 图例总宽高：设置图例项的宽度和高度，单位为“%”。 图例项宽度：设置图例的宽度，支持自动和自定义。 图例间隔：设置图例项之间的间隔。 图例标记 图例标记：设置图例前图标的形状。 标记宽高：设置图例前图标的宽度和高度。 图例系列名 字体：设置图例的字体、颜色和大小。 图例字符：设置图例显示的字符数，支持全显和省略。设置为“省略”时，支持设置图例显示的文字数量。 数据值：图例中是否显示数值。设置为“显示”时，可设置如下参数。 字体：设置图例中数值的字体、大小和颜色等。 数值左间距：设置系列名和数据之间的间距。 前缀：数值前是否显示前缀。 前缀内容：设置前缀的显示内容。 前缀字体：设置前缀的字体、大小和颜色等。 前缀右间距：设置前缀和数值之间的间距。 后缀：数值后是否显示后缀。 后缀内容：设置后缀的显示内容。 后缀字体：设置后缀的字体、大小和颜色等。 后缀左间距：设置后缀和数值之间的间距。 百分比：是否显示百分比。设置为“显示”时，支持设置如下参数。 数字字体：设置百分比中数值的字体、大小和颜色等。 百分号字体：设置百分比中百分号的字体、大小和颜色等。 百分号左间距：设置数值和百分比之间的间距。

图形 图形是指组件中，实现数据可视化的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图6 轮播饼图图形 颜色：设置图表中，图形的颜色。 统一配置 数据系列：是否显示该系列数据。如果不选中，会隐藏该组件中对应的系列数据。 南丁格尔图：是否使用南丁格尔图。 内半径：设置饼图内半径的值，单位%。 外半径：设置饼图外半径的值，单位%。 圆心横坐标：设置饼图圆心横坐标的值，单位%。 圆心纵坐标：设置饼图圆心纵坐标的值，单位%。 排布顺序：扇区可按顺时针或逆时针排布。 起始角度：扇区起始角度。 最小角度：扇区最小角度。 鼠标悬停：鼠标放在扇区时，该扇区是否放大显示。 所有标签设置：图表的各个数据系列上，是否显示标签。 所有标签悬浮设置：鼠标悬浮在对应数据系列上时，标签是否显示。 标签位置：标签显示位置，如内部、外部或中间。 标签视觉引导线是否展现：标签前是否显示视觉引导线。 引导线长度：设置视觉引导线的长度。 标签内容：设置标签显示的内容，如系列名、数据值和百分比。 标签文字：设置标签的字体、大小和颜色等。 描边：轮播饼图间系列和整体范围的描边样式。 设置背景：设置为“是”时，可自定义饼图的背景颜色。 数据系列 系列名称：原始数据中默认的系列名称，可通过设置“显示名称”，进行修改。 显示名称：图表中实际显示的系列名称。 下标：数据系列所在的位置。 初始选中：数据项初始是否被选中。 颜色样式：数据系列的颜色样式，支持以下几种。 单色：可设置正常颜色和高亮下颜色。 渐变色：可设置渐变样式、渐变方向、起始颜色和结束颜色。 纹理：通过上传纹理图片，自定义数据系列的颜色样式。 普通标签：未选中数据系列时，标签的样式。 系列名是否展示：标签中系列名是否显示，如工程管理。 数据值是否展示：标签中数据值是否显示，如工程管理对应的数据值“635”。 百分比是否展示：标签中百分比是否显示，如工程管理对应的百分比“67.2”%。 普通标签字体：设置标签内容的字体、颜色和大小等。 高亮标签：选中数据系列时，标签的样式。 系列名是否展示：标签中系列名是否显示，如工程管理。 数据值是否展示：标签中数据值是否显示，如工程管理对应的数据值635。 百分比是否展示：标签中百分比是否显示，如工程管理对应的百分比67.2%。 高亮标签字体：设置标签内容的字体、颜色和大小等。

指标 指标是指可视化组件中，对除可视化图形之外的具体补充，即主要以文字和数字的表现形式，为可视化组件提供具体数值的参考。 图9 轮播饼图指标 显示指标：是否显示组件的指标。设置为显示时，可自定义指标的内容和样式等。 标题内容：自定义指标的显示内容。 标题字体：设置指标标题的字体、大小和颜色等。 自动求和：指标是否自动求和。 数值内容：“自动求和”设置为“否”时，需要输入数据指标数值。 数值字体：设置数值的字体、大小和颜色等。