华为云用户手册

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

如何使用记录查询图元 在基本中，拖拽“记录查询”图元至画布中。 选中记录查询图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面展示。系统会自动填入该值，格式为RecordSelect序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 使用快速查询模式 是否启用快速查询模式。 若勾选该参数，表示为快速模式。 仅配置查询条件即可，查询结果自动保存在对象变量中。如果对象变量不是数组，则仅保存第一条符合条件的记录。如果对象变量为数组，则保存所有返回的记录。 不勾选，表示为普通模式。 根据条件查询对象记录，需要指明要查询的对象名、查询条件，需要查询的字段列表，查询结果需要保存到设置的变量中。 默认不勾选。 单击，在“记录查询”页面进行配置。 若上一步勾选“使用快速查询模式”，则需要指定一个预先定义的对象变量或者对象变量数组，并将该对象变量或对象变量数组拖拽到“变量”输入框中，并设置条件以及选择排序方式，即可实现根据条件和排序方式将查询结果保存在对象变量中。例如，如下图所示，根据条件查询对象数据，并将查询结果保存在对象变量“Account”中。 图1 快速查询模式 表2 快速查询模式参数说明 参数 参数说明 变量 预先定义的对象变量或者对象变量数组。 查询结果自动保存在对象变量或者对象变量数组中。如果对象变量不是数组，则仅保存第一条符合条件的记录。如果对象变量为数组，则保存所有返回的记录。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 无记录时配置空值 当根据条件查询无记录时，则变量为空值。 默认为勾选。 条件 选中对象后，该条件区域“字段”列会出现该对象的字段。单击“新增行”，可设置查询数据的条件。 在“字段”中选择要进行判断的对象字段，在“比较符”中选择相应的比较符，“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 （排序）排序字段/顺序 使查询结果根据某个字段进行升序或者降序排序。 若上一步未勾选“使用快速查询模式”，则需要指定对象并在条件中设置指定对象部分字段的值，根据条件查询符合条件的对象记录，并赋值到设置的变量上。例如，如下图所示，查询“Account”对象“name”为“Lily”的记录，并将查询得到的对象id赋值到"var_record_id"变量上。 图2 普通查询模式 表3 普通查询模式参数说明 参数 参数说明 对象 查询的具体对象名。 剔重 若查询记录有重复值，是否需要删掉重复记录只保留一条记录。 默认不勾选，表示不删掉重复记录。 条件 选中对象后，该条件区域“字段”列会出现该对象的字段。单击“新增行”，可设置查询数据的条件。 在“字段”中选择要进行判断的对象字段，在“比较符”中选择相应的比较符，“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 （排序）排序字段/顺序 使查询结果根据某个字段进行升序或者降序排序。 记录行的偏移量 分页，跳过前n条记录，从第n+1条记录开始。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。 记录行的最大数目 分页，每页最多显示的记录数。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。 记录的总行数存入变量 查询出来的总记录数存入变量中。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”。 （输出）源/目标 输出结果，单击“新增行”，可进行添加。 “源”为需要查询的字段，可从下拉框中选择，“目标”可从全局上下文拖拽变量或者直接输入变量名。 无记录时配置空值 当根据条件查询无记录时，则变量为空值。 默认为勾选。

如何查多条数据 通过配置记录查询图元，输出对象的多行数据列表。 例如，应用中已创建设备对象“CNAME1__Equipment__ CS T”，且已有如下两条数据记录，通过在服务编排中配置记录查询图元，查询出该对象数据记录中所有的设备名称。实现步骤如下： 参考如何创建服务编排中操作，创建一个服务编排，名称和标签为“queryEquipment”。 图3 添加服务编排 定义服务编排的变量。 由于本任务需要查询出对象的多行数据列表，所以需要先创建对象类型的数组型变量，用于进行输出。 在服务编排编辑器页面右侧，选择。 在全局上下文页面，单击“对象变量”后的加号。 设置对象变量，保持默认“记录”类型，设置参数名称为“Equipment”（也可自定义为其他名称），对象中选择要查询的具体对象“CNAME1__Equipment__CST”，勾选“数组”表示该变量为数组型变量即集合变量，单击“保存”。 图4 创建对象 新增并配置记录查询图元。 从左侧图元列表中，拖拽“基本”下“记录查询”图元至画布中。 该图元用于根据条件查询对象记录。 图5 拖拽记录查询到画布中 选中记录查询图元，单击，配置该图元。 图6 配置记录查询图元 表4 普通类型记录查询参数说明 参数 参数说明 对象 查询的具体对象名，从下拉框中选择对象“CNAME1__Equipment__CST”。 剔重 若查询记录有重复值，是否需要删掉重复记录只保留一条记录。 默认不勾选，表示不删掉重复记录。 条件 单击“新增行”，可设置查询数据的条件。 （排序）排序字段/顺序 将查询结果，根据某个字段，进行升序或降序排序。 记录行的偏移量 分页，跳过前n条记录，从第n+1条记录开始。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。 记录行的最大数目 分页，每页最多显示的记录数。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。 记录行的总数 限定查询出来的总记录数。 从全局上下文拖拽数值变量或者直接输入“{!数值变量名}”，也可以是常量。 （输出）源/目标 输出结果，单击“新增行”，可进行添加。 “源”配置为需要查询的设备名称字段“name”，可从下拉框中选择。 “目标”从全局上下文拖拽对象变量的“name”字段，拖拽后。 “目标”取值为“Equipment[0].name”。 无记录时配置空值 当根据条件查询无记录时，则变量为空值。 默认为勾选。 将目标“Equipment[0].name”中的“0”修改为通配符“*”。 如果不改为通配符，只能查询出一条数据。 图7 将“0”修改为通配符 连接开始和记录查询图元。 在画布上，把鼠标放在起点图元上，从“+”拖动鼠标，在起点图元和记录查询图元间增加连线。 图8 连接开始和记录查询图元 单击画布的空白处，单击右侧，设置服务编排的出参，从全局上下文里的对象变量中拖入。 图9 设置服务编排的出参 单击服务编排页面上方的，保存服务编排。 测试服务编排能否正常执行。 单击服务编排编辑器上方的，执行服务编排。 不用输入测试数据，直接单击“运行”。 执行成功，界面上会返回设备对象中的全部设备名称数据，样例如下： 图10 返回样例 启用服务编排。 测试成功后，单击服务编排编辑器上方的，启用服务编排。 如果服务编排创建完成后，未启用默认是属于编辑状态，不能被页面或者其他服务调用。

如何使用跳出循环图元 在逻辑中，拖拽“跳出循环”图元至画布中。 选中跳出循环图元，单击，设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签，用于在页面展示。系统会自动填入该值，格式为Break序号，序号从“0”开始，表示同类型图元序号。 名称 该图元的标识，请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击，在“跳出循环”页面的“循环”下拉框中，选择当前服务编排中需要中断的循环。 图1 配置跳出循环图元

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

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

前提条件 开发呼吸机申请服务，首先需要创建呼吸机资源对象Respirator，作为呼吸机申请服务处理的对象。 表1 Respirator对象自定义字段 字段名 字段类型 字段含义 status 文本 呼吸机当前状态，“空闲”或“使用中”。 hospital 文本 呼吸机当前所在医院。 参考如何登录新版应用设计器中操作，登录新版应用设计器。 在左侧导航栏中，选择“数据”。 单击对象后的，进入创建对象页面。 设置对象的名称和唯一标识为“Respirator”，单击“确定”。 在创建的对象Respirator中，单击。 图2 编辑对象 在“字段”页签，单击“添加”。 设置字段显示名称和唯一标识为“status”，字段类型设置为“文本”，单击“确认”。 图3 设置字段status 参考上述操作，添加“hospital”字段。

场景描述 实现场景：根据查询到的呼吸机资源，数据判断资源是否充足，并修改相关资源信息。 实现方案：提前创建好呼吸机资源对象Respirator，使用服务编排实现上述场景功能。 通过循环图元对传入的数组对象变量RespiratorInfos（即空闲状态下的呼吸机资源数组）进行遍历，并将数组中的每个元素放置到对象变量RespiratorInfo（空闲状态下的呼吸机资源数组元素）中。 通过“赋值”图元，设置参数。 将当前遍历的对象变量元素，添加到此次申请的原始呼吸机资源数组中，并对计数进行加一操作。将当前遍历的对象变量元素的字段医院信息修改为发起呼吸机申请的医院信息，将呼吸机状态修改为“使用中”，并添加到申请后的呼吸机资源数组中。 通过“决策”图元，判断资源是否充足。 走“ResourceEnough1”分支：在空闲状态下的呼吸机资源满足申请数量时，跳出循环，返回信息“资源充足，申请呼吸机成功！”。 走“ResourceNotEnough1”分支：循环遍历全部元素后仍未满足申请数量，将走Finish连线进行资源是否充足的判断： 走“ResourceEnough2”分支：资源充足情况下，返回“资源充足，申请呼吸机成功！”。 走“ResourceNotEnough2”分支：当此次申请的呼吸机资源数组中，实际存在的资源数量比申请的数量少时，代表申请的资源不足，返回信息“资源不足，申请失败！”。 图1 总体编排流程

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

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

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

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

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

创建对象变量/结构体变量/事件变量 在服务编排设计器右侧，选择。 在全局上下文页面，单击“对象变量”后的。 设置页面参数，以创建对象变量为例进行介绍。 图9 配置对象变量 对象：变量的类型为对象变量。 全局结构体：变量的类型为全局结构体。 私有结构体：变量的类型为私有结构体。 事件：变量的类型为事件变量。 名称：新建变量的名称。 对象：请选择具体的对象。选择“对象”类型时，该参数才会显示。 全局结构体：请选择具体的全局结构体。选择“全局结构体”类型时，该参数才会显示。 私有结构体：请选择具体的私有结构体。选择“私有结构体”类型时，该参数才会显示。 事件：请选择具体的事件。选择“事件”类型时，成员变量为事件的自定义字段，不包括系统预置的标准字段。选择“事件”类型时，该参数才会显示。 默认值：变量的默认取值。 描述：该变量的描述信息。 是否为数组：是否为数组变量，即集合变量。

创建普通变量或集合变量 在服务编排设计器右侧，选择。 在全局上下文页面，单击“变量”后的。 图1 创建变量 单击新增变量后的“...”，选择“设置”。 设置页面参数，单击“保存”。 图2 配置变量 表1 变量参数说明 参数 参数说明 名称 新建变量的名称。 数据类型 新建变量的数据类型，直接在下拉框中选择即可。 默认值 变量的默认取值。 描述 新建变量的描述信息。 是否为数组 是否为数组型变量即集合变量。

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

创建公式变量 公式变量主要用于变量赋值、表达式计算、参数传递等。 在服务编排设计器右侧，选择。 在全局上下文页面，单击“公式”后的。 设置页面参数，单击“保存”。 图4 配置公式变量 表3 公式变量参数说明 参数 参数说明 名称 新建公式变量的名称。 数据类型 公式变量的数据类型，直接在下拉框中选择即可。 描述 新增公式变量的描述信息。 表达式 设置新增变量的表达式。 若表达式中需要运用公式，可根据需要双击“公式”区域中系统预置的公式，该公式会显示在右侧“表达式”区域中。当表达式中需要有变量参数时，可从变量区域中直接选择变量拖入到表达式中。

修改对象数据 介绍如何通过记录更新图元，修改Respirator对象数据。 参考如何开发服务编排中操作，创建“名称”和“标签”为“UpdateRespirator”的服务编排。 定义服务编排用到的变量，并设置该服务编排的入参。 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。 新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。 图15 新建对象变量“RespiratorInfos” 单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将数组对象变量“RespiratorInfos”拖拽到“入参”中。 图16 配置开始图元 拖拽“基本”目录中的“记录更新”图元到画布中，并与“开始”图元进行如下连线。 图17 拖拽图元 配置“记录更新”图元。 单击画布中的“记录更新”图元，在“基本信息”页面中，配置图元标签及名称为“UpdateRespirator”，并勾选“使用快速更新模式”。 图18 配置“记录更新”图元基本信息 单击，在“记录更新”页面，将创建的对象变量RespiratorInfos由展开的“全局上下文”页面拖拽到“变量”输入框中。 图19 配置“记录更新”页面 单击页面上方的，保存服务编排。 保存成功后，单击，运行服务编排。 在服务编排运行页面，设置输入参数，单击“运行”。 在“输入参数”中，输入如下参数，修改Respirator对象数据，更新状态为“使用中”。其中，“CNAME”替换为环境中实际配置的命名空间，“id”取值替换为查询对象数据中查询出呼吸机的id。 { "RespiratorInfos": [ { "id": "cnE0000000m5Kvrl7kSe", "CNAME__status__CST": "使用中" }, { "id": "cnE0000000m5KvrtM7EW", "CNAME__status__CST": "使用中" } ]} 单击页面上方的，激活服务编排。

删除对象数据 介绍如何通过记录删除图元，删除Respirator对象数据。 参考如何开发服务编排，创建“名称”和“标签”为“DeleteRespirator”的服务编排。 定义服务编排用到的变量，并设置该服务编排的出参。 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。 新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。 图20 新建对象变量“RespiratorInfos” 单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将数组对象变量“RespiratorInfos”拖拽到“入参”中。 图21 配置开始图元 拖拽“基本”目录中的“记录删除”图元到画布中，并连接“开始”和“记录删除”图元。 配置“记录删除”图元。 单击画布中的“记录删除”图元，在“基本信息”页面中配置图元标签及名称为“DeleteRespirator”，并勾选“使用快速删除模式”。 单击，在“记录删除”页面将创建的对象变量RespiratorInfos由展开的“全局上下文”页面拖拽到“变量”输入框中。 图22 配置“记录删除”页面 单击页面上方的，保存服务编排。 保存成功后，单击，运行服务编排。 设置输入参数，单击“运行”，删除2条对象记录。 其中，“id”取值替换为查询对象数据中查询出的呼吸机的id。 { "RespiratorInfos": [ { "id": "cnE0000000m5Kvrl7kSe" }, { "id": "cnE0000000m5KvrtM7EW" } ]} 单击页面上方的，启用服务编排。

创建对象数据 由于服务编排中内置的记录创建图元无法批量创建，需要循环调用记录创建图元，进行批量创建。 参考如何开发服务编排中操作，创建“名称”和“标签”为“CreateRespirator”的服务编排。 参照表1，定义服务编排用到的变量，并设置该服务编排的入参。 表1 变量说明 变量名 变量类型 变量说明 RespiratorInfo Respirator对象 系统中空闲状态下的呼吸机资源数组元素。 RespiratorInfos Respirator对象数组 系统中空闲状态下的呼吸机资源数组。 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。 图1 添加对象变量 设置对象变量名称为“RespiratorInfo” ，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），单击“保存”。 图2 新建对象变量RespiratorInfo 服务编排中只允许引用当前应用工程下的资源（例如对象、脚本），上图中的对象需要和服务编排在同一应用中。 按照上述操作，新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。 图3 配置数组类型对象变量 单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将数组对象变量“RespiratorInfos”拖拽到“入参”中。 图4 配置开始图元 拖拽快捷目录中的“循环”图元以及“基本”目录中的“记录创建”图元到画布中，并与“开始”图元进行如下连线。 图5 拖拽图元 配置“循环”图元。 单击画布中的“循环”图元，在“基本信息”页面中配置图元标签和名称为“LoopRespiratorInfos”。 图6 配置“循环”图元基本信息 单击，进入“循环”配置页面，展开“全局上下文”页面，拖拽对象变量RespiratorInfos到“数组”输入框中，拖拽对象变量RespiratorInfo到“元素”输入框中。 图7 配置“循环”页面 如上图配置，能够将数组对象变量RespiratorInfos进行遍历，并将数组中的每个元素放置到对象变量RespiratorInfo中，进行下一步操作。 配置“记录创建”图元。 单击画布中的“记录创建”图元，在“基本信息”页面中配置图元标签及名称为“CreateRespirator”，并勾选“使用快速创建模式”。 图8 配置“记录创建”图元基本信息 单击，在“记录创建”页面，展开“全局上下文”页面，将对象变量RespiratorInfo拖拽到“变量”输入框中。 图9 配置“记录创建”页面 单击页面上方的，保存服务编排。 保存后，单击，运行服务编排。 在服务编排运行页面，设置输入参数，单击“运行”，创建3条对象记录。 其中，“CNAME”替换为环境中实际配置的命名空间。 { "RespiratorInfos": [ { "name": "呼吸机1", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机2", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机3", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" } ]} 单击页面上方的，启用该服务编排。

查询对象数据 介绍如何通过记录查询图元，查询Respirator对象数据中“状态”为“空闲”的对象记录。 参考如何开发服务编排中操作，创建“名称”和“标签”为“SelectRespirator”的服务编排。 定义服务编排用到的变量，并设置该服务编排的出参。 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。 新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。 图10 创建数组类型对象变量“RespiratorInfos” 单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将数组对象变量“RespiratorInfos”拖拽到“出参”中。 图11 配置开始图元 拖拽“基本”目录中的“记录查询”图元到画布中，并与“开始”图元进行如下连线。 图12 拖拽图元 配置“记录查询”图元。 单击画布中的“记录查询”图元，在“基本信息”页面中，配置图元标签及名称为“SelectRespirator”，并勾选“使用快速查询模式”。 图13 配置“记录查询”图元基本信息 如下图所示，单击，在“记录查询”页面中，将创建的对象变量RespiratorInfos由展开的“全局上下文”页面拖拽到“变量”输入框中。在“条件”中单击“新增行”，新增条件语句，“排序”为可选配置。 图14 配置“记录查询”页面 条件中的“值”，需要使用英文双引号。 单击页面上方的，保存服务编排。 保存成功后，单击，运行服务编排。 由于该服务编排没有配置入参，直接单击“运行”，即可查询对象数据。 查看是否返回所有状态为空闲的对象记录。 { "interviewId": "002N0000XXXXXXx5Cy", "outputs": { "RespiratorInfos": [ { "createdBy": "10gd000XXXXXX7Pea", "createdBy.name": "XXX", "createdDate": "2021-08-10 14:25:18", "currencyIsoCode": "USD", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲", "id": "cnE0000000m5Kvrl7kSe", "lastModifiedBy": "10gd000XXXXXXq7Pea", "lastModifiedBy.name": "XXX", "lastModifiedDate": "2021-08-10 14:25:18", "name": "呼吸机1", "owner": "10gd0000XXXXXXq7Pea", "owner.name": "gonCNAMEhen" }, { "createdBy": "10gd000000bZHUAq7Pea", "createdBy.name": "XXX", "createdDate": "2021-08-10 14:25:18", "currencyIsoCode": "USD", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲", "id": "cnE0000000m5KvrtM7EW", "lastModifiedBy": "10gd0000XXXXXXea", "lastModifiedBy.name": "XXX", "lastModifiedDate": "2021-08-10 14:25:18", "name": "呼吸机2", "owner": "10gd000000bZHUAq7Pea", "owner.name": "XXX" }, { "createdBy": "10gd000XXXXXX7Pea", "createdBy.name": "XXX", "createdDate": "2021-08-10 14:25:18", "currencyIsoCode": "USD", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲", "id": "cnE0000000m5KvrykUhk", "lastModifiedBy": "10gd0000XXXXXXPea", "lastModifiedBy.name": "XXX", "lastModifiedDate": "2021-08-10 14:25:18", "name": "呼吸机3", "owner": "10gd000000bZHUAq7Pea", "owner.name": "XXX" } ] }} 单击页面上方的，启用服务编排。

场景描述 实现场景：由于呼吸机资源缺乏，为了有效利用剩余的呼吸机，需要提供呼吸机申请服务进行资源调度。申请人调用服务接口提供医院信息和申请呼吸机资源数量，服务根据系统中处于空闲状态下的呼吸机资源判断资源是否充足，在资源充足的情况下返回被申请的呼吸机信息并修改系统中相应呼吸机的医院信息和状态。 实现方案：使用服务编排实现上述功能，实现逻辑如下： 通过调用查询对象数据中创建的服务编排，获取系统中空闲状态下的呼吸机信息。 通过调用使用服务编排开发业务的基本逻辑中创建的服务编排，进行资源是否充足的判断，返回被申请的呼吸机信息。 通过决策图元判断上一步骤返回的申请呼吸机信息，做出下一步操作。 走“ResourceEnough”分支：在资源满足的情况下，调用修改对象数据中创建的服务编排，修改系统中被申请的呼吸机的医院信息和状态。 走“ResourceNotEnough”分支：在资源不足的情况下，返回错误信息。 图1 呼吸机申请服务总体流程

如何开发呼吸机申请服务 参考如何开发服务编排中操作，创建“名称”和“标签”为“RespiratorApply”的服务编排。 参照表1，定义服务编排用到的变量，并设置该服务编排的入参和出参。 表1 变量说明 变量名 变量类型 变量说明 num 数字 申请的呼吸机数量。 hospital 文本 申请呼吸机的医院。 msg 文本 申请结果。 RespiratorInfos Respirator对象数组 系统中空闲状态下的呼吸机资源数组（后用于存放信息修改后的资源数组）。 RespiratorRecs Respirator对象数组 此次申请的原始呼吸机资源数组。 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“变量”后的。 图2 创建变量 单击新增变量后的“...”，选择“设置”。 图3 设置变量 配置数字类型的变量“num”，单击“保存”。 图4 配置变量 表2 普通变量参数说明 参数 参数说明 名称 新增变量的名称，直接输入“num”。 数据类型 变量的数据类型，根据业务需求直接在下拉框中选择。 本示例设置为“数字”。 默认值 变量的默认取值。 本示例不用配置。 描述 新增变量的描述说明，建议填写该变量的作用。 是否为数组 是否为数组型变量即集合变量。 本示例不勾选。 参考上述操作，创建文本类型的变量“hospital”、“msg”。 图5 成功创建变量 在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。 图6 创建对象变量 参考上述操作，新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。 图7 配置数组类型对象变量 参考上述操作，创建数组类型的对象变量“RespiratorRecs”，注意要选中“是否为数组”。 单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将变量num、变量hospital拖拽到“入参”中，将变量msg、对象变量RespiratorRecs拖拽到“出参”中。 图8 配置开始图元 编排该服务主要使用了三种图元，分别是“子服务编排”“赋值”、“决策”图元，按照下图将相关图元拖拽到画布中对应位置。 图9 拖拽图元 在画布上，把鼠标放在起点图元上，从“+”拖动鼠标，在起点图元和“子服务编排”图元Flow0间增加连线。 配置“子服务编排”图元Flow0。 单击画布中的“子服务编排”图元Flow0，在“基本信息”页面中配置图元标签为“查询呼吸机资源”，名称为“SelectRespirator”。 图10 配置“子服务编排”图元基本信息 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择查询对象数据创建的服务编排“SelectRespirator”。配置输出参数，从“全局上下文”页面拖拽变量到“目标”中。 图11 配置子服务编排图元Flow0 如上图配置，将调用查询对象数据中开发的查询对象记录服务编排，并将查询结果存放到对象变量RespiratorInfos中。 从“子服务编排”图元“SelectRespirator”，连向“子服务编排”图元Flow1。 配置“子服务编排”图元Flow1。 单击画布中的“子服务编排”图元Flow1，在“基本信息”页面中配置图元标签为“处理呼吸机资源”，名称为“ProcessRespiratorResouce”。 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择使用服务编排开发业务的基本逻辑创建的服务编排“ProcessRespiratorResource”，配置入参和出参。 图12 配置子服务编排图元Flow1 如上图配置，将调用使用服务编排开发业务的基本逻辑中开发的资源处理服务编排，并将查询对象记录服务编排中返回的空闲状态下呼吸机资源以及申请医院、资源数量作为入参传入，返回申请结果、被申请的呼吸机资源以及修改信息后的呼吸机资源数组存入相应对象变量。 从“子服务编排”图元“ProcessRespiratorResouce”连向“决策”图元Decision0。 配置“决策”图元Decision0。 单击画布中的“决策”图元Decision0，在“基本信息”页面中配置图元标签为“判断资源是否充足”，名称为“judgeResource”。 在“决策”页面中，单击“默认”结果，将名称设置为“ResourceEnough”，单击“新增”，新增一个名为“ResourceNotEnough”的结果，并按照下图进行配置。 图13 配置默认结果 图14 新增“ResourceNotEnough” “ResourceNotEnough”结果表示当返回的资源数组为空时，代表资源不足，走向赋值图元设置错误信息。默认的“ResourceEnough”结果代表资源充足，将进行系统中数据的修改。 从“决策”图元“judgeResource”连向“子服务编排”图元Flow2，连线类型为“ResourceEnough”，从“决策”图元Decision0连向“赋值”图元Assignment0，连线类型为“ResourceNotEnough”。 配置“子服务编排”图元Flow2。 单击画布中的“子服务编排”图元Flow2，在“基本信息”页面中配置图元标签为“修改呼吸机资源状态”，名称为“UpdateRespiratorResource”。 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择修改对象数据中创建的服务编排“UpdateRespirator”，并配置输入参数。 图15 配置子服务编排图元Flow2 如上图配置，将调用修改对象数据中开发的修改对象记录服务编排，根据传入的对象变量RespiratorInfos对系统中的对象数据进行修改。 配置“赋值”图元Assignment0。 单击画布中的“赋值”图元Assignment0，在“基本信息”页面中配置图元标签为“设置错误信息”，名称为“setError1”。 如下图所示，单击，在“赋值”页面进行配置赋值语句，在资源不足的情况下设置相应的错误信息。 图16 配置赋值图元Assignment0 单击页面上方的，保存服务编排。 保存成功后，单击，运行服务编排。 进行测试。 当资源不足时，测试服务是否报错并返回相应错误信息。 设置输入参数，单击“运行”，人民第66医院需要申请5台呼吸机。 { "hospital": "人民第66医院", "num": 5} 检查输出页签的结果，是否符合预期。 返回如下信息，表示资源不足，申请失败。 图17 输出结果 当资源充足时，返回信息“资源充足，呼吸机申请成功！”，以及申请的呼吸机资源信息，并修改系统中对象数据。 打开创建对象数据中创建的服务编排“CreateRespirator”，单击页面上方的，运行服务编排。 设置输入参数，单击“运行”，创建5台某医院空闲的呼吸机。 其中，“CNAME”为命名空间名称，请替换为环境中实际配置的命名空间。 { "RespiratorInfos": [ { "name": "呼吸机1", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机2", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机3", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机4", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" }, { "name": "呼吸机5", "CNAME__hospital__CST": "第1人民医院", "CNAME__status__CST": "空闲" } ]} 打开本节开发的服务编排“RespiratorApply”，单击页面上方的，运行服务编排。 设置输入参数，单击“运行”，人民第66医院需要申请5台呼吸机。 { "hospital": "人民第66医院", "num": 5} 检查输出页签的结果，是否符合预期。 资源充足时，如下图所示返回信息“资源充足，呼吸机申请成功！”，以及申请的呼吸机资源信息。 图18 输出界面 单击页面上方的，启用服务编排。

前台页面常用调测方法 在高级页面的开发中，常借助浏览器内置的 开发者工具 对样式或功能问题进行定位和分析。下面以Chrome浏览器为例，简单介绍浏览器开发者工具中常用的调测方法。在Chrome浏览器中，按下“F12”或者“Ctrl + Shift + I”，开启开发者工具。 DOM和 CSS 样式调试 在Elements面板，可以自由的操作DOM和CSS，来迭代布局和设计页面。在开发者工具打开的状态下，使用左上角的箭头按钮，可点选页面元素，查看该元素DOM和CSS等。也可以在Elements页签下，修改页面上的元素的DOM标签或CSS样式（修改立即生效），实时查看修改后效果。 图1 Elements页签查看调试DOM和CSS样式 打印日志信息 在Console页签下，可使用控制台打印日志信息。在Sources页签下，调试JavaScript时常用方法是将多个console.log()语句插入代码，重新加载页面后，可以在Console页签中，查看到打印的消息。Sources页签主要包括三个部分，左侧为页面请求文件列表，中间为选择文件的文件内容，右侧为JavaScript调试窗格。 想要在JavaScript中打印日志，需要找到相应文件，查找相关代码，然后插入console.log()。 图2 Sources页签布局 调用低代码平台API 在Console页签下，可使用控制台调用低代码平台提供的API，以获取相关信息进行调试。 图3 调用低代码平台API 断点调试 在Sources页签下，可以设置断点来调试JavaScript。使用断点，DevTools会在暂停时及时显示所有变量值。Chrome开发者工具，提供了代码行断点、条件代码行断点、DOM断点和事件侦听断点等多种断点，请根据调测的实际需求选择合适的断点。断点的类型和使用场景，如表1所示。 表1 Chrome断点类型及使用场景 断点类型 使用场景 代码行 在确切的代码区域中。 条件代码行 在确切的代码区域中，且仅当其他一些条件成立时。 DOM 在更改或移除特定DOM节点或其子级的代码中。 XHR 当XHR网址包含字符串模式时。 事件 在触发点击等事件后运行的代码中。 侦听器 在引发已捕获或未捕获异常的代码行中。 异常函数 任何时候调用特定函数时。 代码行断点调试是最为常见的断点调试方法， 设置代码行断点的方法是找到请求文件，在Sources左侧请求文件列表按照目录查找，也可以借助“Ctrl+F”搜索关键词找到相关文件。在Sources中间文件内容区域，找到要设置断点的代码行，单击行号，出现蓝色图标，这意味着这行代码上有一个代码行断点。如图4所示，在global_BubbleChartWidget.js文件的49行代码处，设置了一个代码行断点。 刷新此网页，脚本运行始终会在执行此行代码之前暂停，可单击右侧调试窗格的按钮进行单步调试，或者单击调试窗格的按钮继续执行脚本。 图4 代码行断点示例 多终端测试 在进行页面自适应测试时，可采用Chrome开发者工具提供的模拟移动设备的功能。借助此功能，可无实物快速对网页进行多个终端测试。 单击，可启动模拟移动设备界面，设备工具栏在打开时默认处于自适应视口模式，可以将视口大小调整为所需的任何尺寸，另外还可以选择多种终端型号。 图5 模拟移动设备

操作步骤 参考如何登录新版应用设计器中操作，登录新版应用设计器。 在左侧导航栏中，选择“界面”。 在对应的高级页面中，单击，选择“设置”。 图1 进入设置页面 在“水印”页签，参考如何设置页面水印设置参数，单击“保存”。 图2 水印设置 图3 设置后效果 表1 参数说明 参数 参数说明 启用水印 是否给该页面启用水印。 重复渲染 当需要设置满页面水印时，开启该项。 水印内容 设置水印文本内容。 当前用户 当需要设置水印内容为当前用户名时，可开启该项。 开启后，“水印内容”中的文本不生效。 水印长度 水印矩形框的长度。 水印宽度 水印矩形框的宽度。 水平起始位置 当关闭“重复渲染”时，才可设置，表示单个水印在页面的水平起始位置。 垂直起始位置 当关闭“重复渲染”时，才可设置，表示单个水印在页面的垂直起始位置。 字体颜色 水印字体的颜色。 字体大小 水印字体的大小。 旋转角度 水印的旋转角度，取值范围-180~180，即逆时针或者顺时针旋转180度。 透明度 水印的透明度设置。

操作步骤 确认高级页面属性开关“合并并压缩资源”已关闭。 参考如何登录新版应用设计器中操作，登录新版应用设计器。 在左侧导航栏中，选择“界面”。 在设置中，单击“页面设置”，进入页面设置。 图1 进入页面设置 获取锁后，在“属性”页签，去勾选“合并并压缩资源”。 若勾选“合并并压缩资源”，会对所有高级页面涉及的css和js文件进行合并及压缩，使用单页面性能检查功能时，不要勾选该选项。 图2 关闭“合并并压缩资源”属性 设置完成后，单击，并单击，释放锁。 打开要进行性能检查的高级页面，在浏览器开发者工具中，勾选“Disable cache”属性。 在Chrome浏览器中，按下“F12”或者“Ctrl + Shift + I”，开启开发者工具。 在“Network”页签，勾选“Disable cache”属性（即禁用缓存）。 在进行页面性能检查时，如果不勾选该选项，性能检查会读取缓存中的数据，导致性能检查结果不准确。 图3 勾选“Disable cache”属性 在已发布的高级页面上方，单击“性能分析”，进入页面性能分析报告页面。 开发者工具请保持打开状态，关闭后“Disable cache”属性会自动不勾选。同时请确保高级页面已发布，若未发布，单击高级页面上方的，发布页面。 图4 查看性能分析报告 在页面性能报告中，单击各指标后的“展开”，可查看性能指标详情。 图5 查看性能指标详情

操作步骤 参考如何登录新版应用设计器中操作，登录新版应用设计器。 在左侧导航栏中，选择“界面”。 在高级页面中，单击对应的页面，进入高级页面开发界面。 在页面右上角，单击，定义全局状态。 定义全局状态使用JavaScript编程语言，不支持TypeScript。全局状态结构固定以MStore命名，每个页面仅包含一个全局状态实例，方便在组件调试的过程中，轻易的获取整个当前页面状态的快照。全局状态的结构定义由以下三部分组成： state：定义页面所有组件的初始状态数据，即页面中所有组件共享状态的初始数据源。 mutations：状态变更的唯一方法是提交mutation。mutation以声明的方式，将state变化映射到视图，每次state的变更都需要定义一个mutation。mutation使用对象风格的提交方式，整个对象都作为载荷（payload）传给mutation函数，mutation都是同步事务。 actions：通过actions执行状态数据变更，用于衔接state和mutation。Action可以包含任意异步操作，通常用于绑定状态和组件，可以调用服务。 在页面的组件js文件中，使用预置的“this.$mstore.dispatch（）”方法，修改状态数据。 系统还预置了onStateChanged(state) 方法，用于监听属性整个全局状态的变更。

使用说明 页面组件之间，可以通过配置事件和动作进行信息交互。当页面组件较多，且需要进行信息交互时，频繁的给每个组件去定义事件或动作就比较繁琐了。此时，可以通过定义全局状态，来实现页面级所有组件中数据信息的更新。 低代码平台高级页面支持设置全局状态，通过页面级内存方式共享数据，即采用集中式存储管理页面所有组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。简单的理解就是全局状态，可理解为页面中所有组件的共享状态，不管组件在页面的哪个位置或层级，任何组件都能获取状态或触发状态改变的动作。全局状态相当于全局变量，属性是私有的，需要在组件的js文件中，使用预置的“this.$mstore.dispatch”方法，来修改状态数据。 思考：什么情况下，应该使用全局状态？ 解惑：当页面组件构成比较简单，组件间不需要频繁的进行信息交互时，不需要设置全局状态。反之，则建议使用全局状态，通过设置并使用全局状态，可以帮助我们管理页面所有组件的共享状态。

响应式组件开发基本原则 组件的响应式设计，是高级页面适配多终端的重要前提。为确保自定义组件能够自适应不同分辨率设备，在组件开发中用户需要遵从响应式设计的基本原则。 根据内容设计。 不专注于特定屏幕宽度，而是专注于内容设计，当屏幕越小或浏览器窗口越窄时，内容所占的垂直高度越来越多，内容就要向下方自然延伸。建议从小屏幕开始，逐步设置断点（例如设备宽度320px、768px、1024px），针对不同设备进行设计，形成流动布局。 针对复杂情况，可以使用CSS3的@media查询。针对不同的终端类型和不同屏幕分辨率的设备，定义不同样式，选择应用不同的CSS规则。只有当该设定媒体查询与正在使用的设备匹配时，其对应的CSS规则才起作用。 CSS语法如下： @media mediatype and|not|only (media feature) { CSS-Code;} 其中，参数说明如表1所示。 表1 @media语法参数说明 参数 值 说明 mediatype all 用于所有设备。 screen 用于电脑屏幕、平板电脑、智能手机等。 print 用于打印机和打印预览。 media feature aspect-ratio 定义输出设备中，页面可见区域宽度与高度的比率。 max-width 定义输出设备中，页面最大可见区域的宽度。 max-height 定义输出设备中，页面最大可见区域的高度。 min-width 定义输出设备中，页面最小可见区域的宽度。 min-height 定义输出设备中，页面最小可见区域的高度。 设置示例：对页面宽度不同的设备，设定不同背景颜色。 /*媒体查询*//*页面宽度大于1200px 时，背景颜色为蓝色，主要用于大屏设备*/@media screen and (min-width: 1200px) { body { background-color:blue; }}/*页面宽度在992px和1200px之间，背景颜色为红色，用于中等屏幕PC端*/@media screen and (min-width: 992px){ body { background-color:red; }} 避免固定尺寸。 使用像px这样的绝对单位，来指定元素的宽高、边框和字体大小等，固定宽度容易破坏响应式布局。为了布局更加灵活，推荐使用百分比、em或rem等相对单位，这样可以保证浏览器字体大小调整和缩放时，能正常显示。常用相对单位，如表2所示。 表2 常用相对单位 单位 说明 em 在font-size中，使用相对于父元素的字体大小，在其他属性中使用相对于自身的字体大小，如width。 rem 相对根元素的字体大小。 ch 相对于数字“0”的宽度。 ex 相对于字符“x”的高度。 lh 相对于元素line-height计算值。 最大和最小值。 对于大屏页面和移动端，内容扩充占满整个屏幕宽度并不总是适用的。展示同样的内容，手机端可能更适宜充满屏幕宽度，而大屏则需要在宽度上留出一定边界，使得布局上更加美观。所以，设定最大值或最小值，可以帮助您设计更为合理的布局。例如，组件宽度设定100%，最大宽度设定1024px，那么内容扩充的最大宽度即为1024px，当屏幕宽度超出1024时，内容在宽度上不会再继续扩展。 嵌套对象。 对于关系紧密的多个元素，采用相对位置会使得元素难以控制。此时，可以考虑放置于同一容器中集中管理。在容器内部，可以考虑采用绝对单位固定其关系，这对于不需要扩展的按钮等元素来说非常有效。 图片的自适应。 自适应组件设计还需要满足图片的自适应，可以使用max-width，对图片宽度进行限制，确保图片宽度不会超过浏览器窗口或容器可视部分的宽度。 移动优先。 通常来说，移动端屏幕较小、视图简单，而大屏空间大、呈现更为复杂和多样。那么，从移动端小屏幕设计入手过渡到大屏幕设计，在开发中逐步增加CSS的复杂度，通过补充设计的方式逐步丰富布局。这样，通过移动优先，可以更轻松地开发响应式布局。

属性 在属性中，设置仪表盘组件的位置、边框、背景等。 图2 属性 基础 组件标题：设置组件的标题。 组件名称：设置组件的名称。 位置 距离左端：组件到页面左侧的距离，单位为px。 距离顶端：组件到页面顶部的距离，单位为px。 宽度：组件的宽度，单位为px。 高度：组件的高度，单位为px。 堆叠顺序：设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”，数字越大，显示越靠前。当需要让组件置底时，可设置堆叠顺序为“0”。 自适应高度：组件的高度是否随宽度改变。 边框：设置组件的边框样式，如全边框或角边框。 背景 样式：设置背景的样式，如普通、居中、拉伸等。 图片链接：背景图片URL。 颜色：设置背景的颜色。