华为云用户手册

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

基本属性 基本属性通过数据绑定后，在运行时以数据绑定的值为准。 标签：下拉框的显示标签名称，只有下拉框放在表单form中才生效。 占位符：下拉框未选择时，展示给用户的提示信息。 选项：下拉框单击后，可选择的选项内容。如果“属性值绑定”中，设置了“选项”与模型字段绑定。预览页面时，优先以“属性值绑定”为准，显示选项内容。 输入的数据必须为json格式，如： [{"value": "1","display": "男"},{"value": "0","display": "女"}] 选项列表：单击，选择系统中配置的选项列表。选项和选项列表，只能配置其中一种。 如果“属性值绑定”中，设置了“选项”与模型字段绑定。预览页面时，优先以“属性值绑定”为准，显示选项内容。 选项值是否唯一：选项值是唯一标识，开启后提升渲染性能。 是否多选：配置下拉框是否提供多选的能力。 可清空：是否在选择下拉框，显示一个删除图标，来删除选择框的内容。 弹层独立：选项值区域展示不全，部分内容隐藏时，开启后，可显示完整选项值。 可过滤：下拉框是否提供过滤能力。 远程搜索：是否根据输入的关键字，调用自定义的接口查询数据，和事件“on-remote-search”配合使用。 是否初始加载：拉框是否初始加载。 AUI风格：启用后，下拉框的下拉图标风格会所有不同。 最大宽度：组件的最大宽度。

数据绑定 通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：值绑定类似vue中的v-model语法，组件上创建双向数据绑定。值绑定会根据组件类型，自动选取正确的方法来更新元素。同时，负责监视各类引起绑定数据变化的事件以更新数据。 在“数据绑定”中，单击“值（value）绑定”中的，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 图2 定义模型 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。 表1 模型来源说明 分类 模型说明 模型参数的定义 模型方法的定义 API调用方法 自定义 开发者自行定义的模型。 由开发者自定义，可以添加子节点。 开发者自定义方法。 $model.ref("modelName").actionName(); 对象 由Object对象表映射生成，关于对象模型的详细介绍，请参见对象。 系统自动获取Object所有的字段，开发者可以从中选择部分字段作为参数。 系统自动生成查询、保存、删除和统计四个方法。 $model.ref("modelName").query(param); $model.ref("modelName").save(); $model.ref("modelName").delete(); $model.ref("modelName").count(); 服务 服务模型由后台服务映射生成，当前支持与服务编排或脚本映射。关于服务模型的详细介绍，请参见服务编排和脚本。 参数根据后台服务的入参、出参，映射生成为inputParam和outputParam节点。 系统自动生成run方法 ，用于执行模型关联的服务编排或脚本。 $model.ref("modelName").run(); 事件 事件模型由后台事件的字段映射生成，并且支持websocket刷新模型数据。 参数根据后台事件的字段映射生成。 直接使用 直接使用 除了在模型中定义的方法，低代码平台还提供了如下标准API，适用于所有的模型。 获取模型数据：$model.ref("modelName").getData(); 设置模型数据：$model.ref("modelName").setData(); 设置模型字段值：$model.ref("modelName").setValue(key,value); 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。 属性值绑定：将容器组件的某个属性，如隐藏、样式、弹性布局等与具体的模型字段相绑定，绑定后组件的属性随模型字段的值变化而变化，类似Vue的v-bind。 在“数据绑定”中，单击“属性值绑定”后的“+”。 在“属性”下拉框中，选择容器的某个属性。 在模型字段中，单击，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。详细介绍，请参见表1。 图3 定义模型 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。

创建对象视图 参考登录AstroZero新版应用设计器中操作，登录应用设计器。 根据实际需求，创建所需的对象。 例如，创建对象DepartmentInfo和EmployeeInfo。其中，对象DepartmentInfo存储了部门信息，包括部门ID、部门经理姓名。对象EmployeeInfo存储了员工信息，包括员工姓名、部门ID。 对象DepartmentInfo已创建完成，如图1。 图1 部门信息 对象EmployeeInfo已创建完成，如图2。 图2 员工信息 返回应用设计器，在左侧导航栏中，选择“数据”。 单击视图后的，进入新建视图对象页面。 在添加视图对象页面，直接单击“新建”。 图3 直接单击新建 设置视图对象的基本信息，单击“下一步”。 图4 设置基本信息 表1 新建对象视图参数说明 参数 说明 标签 新建视图对象的标签，用于在页面显示。 取值范围：1~64个字符。 名称 视图对象在系统中的唯一标识，创建后不支持修改。输入标签后单击该参数的输入框，系统会自动生成视图对象的名称。同时会自动增加“__VIEW__ CS T”后缀和命名空间前缀，作为对象的唯一标识。命名要求如下： 长度不能超过60个字符，包括命名空间和后缀的长度。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，没有连续的下划线，且不能以单下划线结尾。 描述 根据实际需求，在输入框中输入视图对象的描述信息。 设置对象联结，单击“下一步”。 在A中选择主对象，单击“点击以关联另一个对象”后，在B中选择另一个对象，设置关联关系，单击加号设置“关联条件”。 如图5，表示当部门ID相同时，取两个对象表数据中的交集。对象联结最多支持三个Object连接，两个Object之间的连接条件由各自的字段及操作符所组成，连接条件可以有多条。 图5 配置关联关系 每个“A”对象的记录至少关联一条“B”的记录：表示结果取满足对象之间设定条件的“且”合集。 “A”对象的记录可以关联或不关联“B”的记录：表示结果取满足对象之间设定条件的“或”合集。 关联条件：表示对象之间的关联条件。 在映射信息页面，单击“字段映射”中的“添加”，选择所需的字段（选择的字段将作为视图对象展示的字段），设置标签。 支持增加记录筛选条件，只有满足该条件，才会展示在视图中。本示例不涉及。 图6 映射信息配置 单击“下一步”， 预览视图对象对应的SQL语句。 核对信息无误后，单击“保存”，进入视图对象的详情页面。 “自定义字段”页签中，显示了配置的展示字段。 在“关联对象”页签中，单击，可查看视图对象对应的SQL语句。

自定义标准模板 参考登录AstroZero新版应用设计器中操作，进入应用设计器。 在应用设计器的左侧导航栏中，选择“界面”。 在页面中，将鼠标放在对应的标准页面上，单击，选择“编辑”。 在标准页面的编辑页面，单击，进入另存为页面。 设置模板标签和名称，打开“另存为模板”开关，单击“创建”。 图1 另存为模板 表1 另存为模板参数说明 参数 说明 标签 输入模板的标签名，用于在页面显示，创建后可修改。 名称 输入模板的名称，名称是模板在系统中的唯一标识，创建后不可修改。 命名要求：必须以字母开头，不允许有连续的下划线，空格和特殊字符。 另存为模板（模板可在标准页面-页面模板中查看到） 勾选后，该标准页面模板，可在页面模板中查看到。 缩略图 显示当前标准页面的缩略图。 另存为完成后，当前用户或同一华为账号下的其他用户，创建类似应用时，可以直接使用该模板来创建。 图2 选择基于模板 图3 我的模板

使用服务编排查询对象数据 使用服务编排中“记录查询”图元，查询自定义对象Class（CNAME__Class__CST）中数据。 参考登录AstroZero新版应用设计器中操作，登录应用设计器。 在左侧导航栏中，选择“逻辑”。 单击编排后的，进入新建服务编排页面。 设置服务编排的标签和名称为“flowSearchData”，单击“添加”。 图4 设置服务编排信息 在服务编排设计器中，单击，在全局上下文中创建变量“name”、“number”，类型分别为“文本”、“数字”。 图5 创建变量 在服务编排的“基本”图元目录下，拖拽一个“记录查询”到画布中。 图6 拖拽记录查询到画布中 参考图7，配置对象和输出。 图7 配置“记录查询” 连接开始图元和记录查询图元，配置服务编排出参。 图8 配置服务编排出参 配置完成后，单击页面上方的，保存服务编排。 单击，运行服务编排。 本服务编排中不需要输入参数，直接单击“运行”，查看输出的json格式结果。 图9 服务编排实现查询自定义对象的字段

使用控制台查询对象数据 参考登录AstroZero新版应用设计器中操作，登录应用设计器。 在左侧导航栏中，单击“命令行”，进入命令行控制台。 在“对象管理”的命令行输入区，输入SQL语句，例如“select CNAME__number__CST from CNAME__Class__CST”。 单击页面右上角的“执行”，即可显示查询的字段列，如图3中③所示。 图1 执行SQL查询对象“Account”数据

数据绑定 通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：值绑定类似vue中的v-model语法，组件上创建双向数据绑定。值绑定会根据组件类型，自动选取正确的方法来更新元素。同时，负责监视各类引起绑定数据变化的事件以更新数据。 在“数据绑定”中，单击“值（value）绑定”中的，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 图2 定义模型 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。 表1 模型来源说明 分类 模型说明 模型参数的定义 模型方法的定义 API调用方法 自定义 开发者自行定义的模型。 由开发者自定义，可以添加子节点。 开发者自定义方法。 $model.ref("modelName").actionName(); 对象 由Object对象表映射生成，关于对象模型的详细介绍，请参见对象。 系统自动获取Object所有的字段，开发者可以从中选择部分字段作为参数。 系统自动生成查询、保存、删除和统计四个方法。 $model.ref("modelName").query(param); $model.ref("modelName").save(); $model.ref("modelName").delete(); $model.ref("modelName").count(); 服务 服务模型由后台服务映射生成，当前支持与服务编排或脚本映射。关于服务模型的详细介绍，请参见服务编排和脚本。 参数根据后台服务的入参、出参，映射生成为inputParam和outputParam节点。 系统自动生成run方法 ，用于执行模型关联的服务编排或脚本。 $model.ref("modelName").run(); 事件 事件模型由后台事件的字段映射生成，并且支持websocket刷新模型数据。 参数根据后台事件的字段映射生成。 直接使用 直接使用 除了在模型中定义的方法，低代码平台还提供了如下标准API，适用于所有的模型。 获取模型数据：$model.ref("modelName").getData(); 设置模型数据：$model.ref("modelName").setData(); 设置模型字段值：$model.ref("modelName").setValue(key,value); 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。 属性值绑定：将容器组件的某个属性，如隐藏、样式、弹性布局等与具体的模型字段相绑定，绑定后组件的属性随模型字段的值变化而变化，类似Vue的v-bind。 在“数据绑定”中，单击“属性值绑定”后的“+”。 在“属性”下拉框中，选择容器的某个属性。 在模型字段中，单击，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。详细介绍，请参见表1。 图3 定义模型 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。

基本属性 基本属性通过数据绑定后，在运行时以数据绑定的值为准。 标签：设置组件的标签名，用于在界面展示。 文本：上传按钮上，显示的文本。 默认已上传的文件列表：默认已上传的文件列表。 存储：上传文件的存储类型，单击该参数后的，可进行配置。 存储：存储器类型。 OBS：通过OBS类型连接器，存储到OBS（Object-based Storage Service）上。 MINIO：通过MINIO类型连接器，存储到MINIO上。 OBJE CTS TORAGEPROXY：通过OBJECTSTORAGEPROXY类型连接器，存储到相应服务器上。 CUSTOMAPI：通过自定义接口，来上传和展示文件。 连接器：当存储配置为OBS、MINIO或OBJECTSTORAGEPROXY时，该参数才会显示，表示具体的连接器。 桶：当存储配置为OBS、MINIO或者OBJECTSTORAGEPROXY时，该参数才会显示，表示具体的存储桶。 上传服务：当存储配置为CUSTOMAPI时，该参数才会显示，选择自定义接口实现上传文件的功能。 展示服务：当存储配置为CUSTOMAPI时，该参数才会显示，选择自定义接口实现展示文件的功能。 过滤文件类型：接受上传的文件类型，为文件原生的属性，会在选择文件时按照文件类型过滤，多个类型格式间以“,”符号隔开，如“image/jpeg,application/msword,text/plain”。 支持文件类型：支持的文件类型，与“过滤文件类型”不同的是，该参数是识别文件的后缀名，“过滤文件类型”为原生的属性，会在选择文件时过滤，可以两者结合使用。 支持多文件：是否支持多选文件。 自定义文件名：上传的单个文件时，可自定义上传的文件名。 同名处理：防止同名文件覆盖，同名文件名后自动增加随机数，也可在“on-before-upload”事件中自定义处理文件名。 上传路径：自定义服务器端上传路径，默认为uistudio/upload，上传路径不能是以“./”或“../”等开头的相对路径。 文件数量：多文件上传时，最大文件数量限制，即允许上传的文件数量，超过此数量后，将不允许上传。 文件大小：单个文件大小限制，单位kb。 文件大小错误描述：当文件超过限制大小时，提示的错误描述。 预览：是否开启预览，只在图片时生效。 图片压缩：是否开启图片压缩功能，当前仅支持jpg、jpeg和png格式的图片。 压缩尺寸：当“图片压缩”开关打开时，该参数才会显示。图片压缩尺寸，分为保持原尺寸和自定义尺寸。 保持原尺寸压缩： 如果设置宽度，高度没设置或高度和宽度都设置了，宽度以设置的为准，高度则按照原来的宽高比例生成。 如果设置高度，宽度没设置，高度以设置的为准，宽度则按照原来的宽高比例生成。如果宽度和高度都没设置，宽高以原图片宽高为准。 自定义尺寸压缩：宽度和高度两个属性都没有设置或者只设置了其中一个，没有设置值的属性以原图片的同属性值为准。 压缩宽度(px)：指定图片压缩的宽度。当“图片压缩”开关打开时，该参数才会显示。 压缩高度(px)：指定图片压缩的高度。当“图片压缩”开关打开时，该参数才会显示。 图片压缩至指定大小(kb)：将图片压缩至指定的大小以下。当“图片压缩”开关打开时，该参数才会显示。 公开读：文件的访问控制权限，默认为“private”（私有），否则为“public-read”（公共读）。 可选择：文件列表是否可以选择，仅为图片时有效。 九宫格：九宫格形态展示图片列表，仅当上传全部为图片时开启效果较好，移动端每行展示4个并且大小自适应。 是否多选：文件列表是否支持多选。当“可选择”开关打开时，该参数才会显示。 选择类型：选择时，展示的样式，包含“遮罩层选择”或“选择框选择”两种类型。当“可选择”开关打开时，该参数才会显示。 选择框内容：设置选择框的内容。当“选择类型”设置为“选择框选择”时，该参数才会显示。 选中时显示内容：选中时，选择框显示的内容。当“选择类型”设置为“选择框选择”时，该参数才会显示。 列表展示位置：相对于上传按钮，上传列表的展示位置，移动端仅下方展示。 列表只显示进度条：上传列表的展示内容仅展示进度条，且文件上传完后进度条消失，目前适用于文档和压缩包。 图片宽高：上传列表中单个图片的宽高，单位像素，移动端不生效。 最大宽度：限制最大的宽度。

服务编排基本能力 拖拉拽式编排流程 以往的传统编程，需要进行变量的声明并编写相应逻辑代码进行服务的开发。使用服务编排进行服务开发，能够通过拖拉拽的方式，将配置项创建的变量以及服务编排中提供的各种功能进行编排，并以流程的方式将服务所要实现的功能展现出来。整个开发过程中无需进行代码的编写，简单快捷，并能够图形化展示服务的逻辑。 逻辑处理 服务编排中提供了逻辑处理的图形化元件，包括赋值、循环、跳出循环、决策和等待。通过这些图元能够实现基本的逻辑处理，并图形化展示，便于开发者理解。 对象处理 服务编排中提供了对象处理的图形化元件，包括记录创建、记录查询、记录更新和记录删除。通过这些图元能够对通过平台创建的自定义对象或标准对象进行相应的增、删、改、查操作，简化处理对象数据的流程，提高开发效率。 服务单元组合脚本、原生服务、BO和第三方服务 服务编排中提供了服务单元组合的图形化元件，包括脚本、子服务编排、原生服务、BO和连接器。通过这些图元能够将平台中已开发完成的服务集成到服务编排中，并重新进行组合，快速扩展出更丰富的业务功能。

服务编排与模块间调用关系 服务编排将平台提供的部分功能模块进行了封装，并提供了平台其他模块调用服务编排的能力，下面介绍其他模块与服务编排是如何进行相互调用的。 脚本 在服务编排中，可通过配置脚本图元，选择当前应用中的脚本，进行脚本的调用。 在脚本中，可以通过引入sys库，再执行“sys.invokeFlow({Flow_Name})”，进行服务编排的调用。其中，“Flow_Name”为服务编排的名称。 对象 在服务编排中，可以通过配置记录创建、查询、更新和删除图元，对当前应用中的对象记录进行增删改查。 标准页面 在标准页面的模型视图中，新建服务模型，能够绑定服务编排，进行服务编排的调用。 工作流 在工作流中，可以通过配置“调用服务编排”活动，选择相应的服务编排，进行服务编排的调用。 API接口 在新建开放接口时，选择资源类型为“服务编排”，并选择相应的服务编排，即可将服务编排绑定到服务接口上，通过API接口进行服务编排的调用。 BO 在服务编排中，调用BO（BO是封装了完整的数据模型、业务逻辑、页面展现的软件单元）进行使用，详情请参见为AstroZero服务编排添加BO图元。 连接器 在服务编排中，调用与第三方系统对接的接口，如对接短信发送、 云存储 、系统中已定义的Action等，详情请参见为AstroZero服务编排添加连接器图元。 服务编排中只允许调用当前应用工程下的资源，如对象、脚本。例如，服务编排A中需要调用脚本B，请确保A和B处于同一应用中。如果需要调用的资源不在同一应用中，则在服务编排A所在的应用中新建脚本B，或选择“使用已有脚本”导入脚本B，再在服务编排A中调用该脚本。 图1 通过“使用已有脚本”导入脚本

步骤2 创建WebSocketAlarmFlow告警服务编排 创建WebSocketAlarmFlow告警编排以触发事件，并在服务编排中配置全局变量和系统（日期/时间）变量为事件传递参数。 如果想快速了解和验证WebSocket使用，可不必创建WebSocketAlarmFlow告警服务编排，采用消息事件的测试功能进行简单验证。您可以直接跳过该步骤，直接执行3，并采用方法一：直接触发事件验证进行效果验证。 创建编排。 参考登录经典应用设计器中操作，登录经典版应用设计器。 将鼠标放在应用的Logic文件夹上，单击加号，选择“服务编排”。 选择“创建一个新的服务编排”，输入标签“WebSocketAlarmFlow”，单击“添加”。 单击名称对应的输入框，系统会根据标签自动生成名称。 图6 创建服务编排WebSocketAlarmFlow 在服务编排画布左侧，单击“基本”，将“发送事件”图元拖入画布中。 图7 拖入“发送事件”图元 添加添服务编排变量。 选中“发送事件”图元，单击画布右侧。 单击“全局上下文”，进入上下文页面。 单击“变量”后的，添加表4中变量。 图8 配置全局变量 表4 告警服务编排的变量 名称 数据类型 AlarmTitle 文本 AlarmContent 文本 在“发送事件”图元中，配置1中创建的事件CNAME__WebSocketAlarmEvent__e（需替换为用户实际创建的事件名称）。 参考下图配置输入参数，通过全局变量AlarmTitle和AlarmContent及系统变量$Flow.CurrentDateTime为事件传参。 图9 事件图元的配置 连接所有图元。 图10 连接图元 选中“开始”图元，单击，参考下图配置服务编排的入参。 入参是从全局上下文的变量中拖入，告警服务编排的入参有AlarmTitle和AlarmContent两个。 图11 配置入参 单击页面上方的，保存服务编排。 单击，启用服务编排。 服务编排只有启用后，才会生效。服务编排在启用后，不可编辑，若需要对其中的图元或参数进行修改，请先单击，禁用该服务编排。

方法二：服务编排触发事件验证 在Logic文件夹中，打开WebSocketAlarmFlow服务编排。 在服务编排页面右上角，单击，运行该服务编排。 在弹出页面的输入参数中，输入如下AlarmTitle和AlarmContent参数值，单击“运行”。 "AlarmTitle": "设备告警", "AlarmContent":"设备C1 本地数据库出错" 图19 服务编发触发事件验证 切换到monitor预览页面，可观察到monitor页面已接收并显示该告警消息。 图20 服务编发触发事件验证效果图

方法一：直接触发事件验证 在Logic文件夹中，打开WebSocketAlarmEvent事件。 在“基本信息”中，单击“发送事件”。 图16 发送事件 在“发送事件测试”页面中，输入参数信息（AlarmDate会自动获取系统日期时间，也可手工编辑修改），单击“发送”。 { "AlarmTitle": "设备告警", "AlarmContent":"设备C1 本地数据库出错", "AlarmDate":"2020-12-12 17:09:20" } 图17 测试发送 切换到monitor预览页面，可观察到monitor页面已接收并显示该告警消息。 图18 直接触发事件验证效果图

步骤1 创建WebSocketAlarmEvent告警事件 创建事件。 参考登录经典应用设计器中操作，登录经典版应用设计器。 将鼠标放在应用的Logic文件夹上，单击加号，选择“事件”。 单击事件后的，进入添加事件页面。 选择“创建新事件”，输入标签和名称“WebSocketAlarmEvent”，单击“添加”。 单击名称对应的输入框，系统会根据标签自动生成名称。系统实际创建的事件名称为“CNAME__WebSocketAlarmEvent__e”，其中“CNAME__”为租户命名空间namespace，“__e”后缀代表是自定义事件。 图3 添加WebSocketAlarmEvent事件 在事件详情页面，选择“自定义参数”页签，单击“新建”。 设置标签、名称和字段类型，单击“保存”，添加事件自定义参数AlarmTitle。 图4 添加事件自定义参数 重复3中操作，创建事件自定义参数AlarmContent、AlarmDate。 表3 事件自定义参数说明 标签 名称 字段类型 AlarmContent 单击名称对应的输入框，系统根据标签自动生成名称。 文本 AlarmDate 单击名称对应的输入框，系统根据标签自动生成名称。 日期/时间 启用告警事件。 在事件详情页面，选择“基本信息”页签。 单击页面右上方的“启用”，启用该事件。 启用成功后，“启用”按钮会变为“禁用”按钮，同时“是否启用”标签变为状态。 图5 启用告警事件 消息事件只有启用成功后，该事件在服务编排或WebSocket中，才会有效。事件启用后，不可编辑，若需要对事件进行参数修改，请先单击“基本信息”下的“禁用”按钮，禁用该事件。

操作场景 添加的 IAM 开发者账号，必须是从华为云IAM同步过来的。用户的个数受业务阈值限制，如何查看用户个数，请参见查看AstroZero账号的业务阈值。 AstroZero中的开发环境、沙箱环境和运行环境是三个独立的环境，在某个环境上添加的用户不能在其他环境上使用，需要重新添加。例如，在开发环境中添加了用户A，用户A只能登录开发环境，无法登录运行环境或沙箱环境。如果用户A需要登录运行环境或沙箱环境，请在运行环境和沙箱环境中执行添加用户的操作。

基本属性 基本属性通过数据绑定后，在运行时以数据绑定的值为准。 文本类型：设置文本类型，如输入框、密码。 标签：输入框在界面的展示标签名，必须是输入框存在于某个表单组件中，该标签设置才生效。 占位符：设置占位符，可辅助元素对齐，让页面更整齐。 可清空：是否可清空输入值。 默认值：输入框默认值。 图标：输入框图标，仅在输入框类型下有效。 图标位置：输入框中的图标位置。 最大字符长度：输入框取值最大字符长度。 最大宽度：输入框最大的宽度。

数据绑定 通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：值绑定类似vue中的v-model语法，组件上创建双向数据绑定。值绑定会根据组件类型，自动选取正确的方法来更新元素。同时，负责监视各类引起绑定数据变化的事件以更新数据。 在“数据绑定”中，单击“值（value）绑定”中的，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 图2 定义模型 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。 表1 模型来源说明 分类 模型说明 模型参数的定义 模型方法的定义 API调用方法 自定义 开发者自行定义的模型。 由开发者自定义，可以添加子节点。 开发者自定义方法。 $model.ref("modelName").actionName(); 对象 由Object对象表映射生成，关于对象模型的详细介绍，请参见对象。 系统自动获取Object所有的字段，开发者可以从中选择部分字段作为参数。 系统自动生成查询、保存、删除和统计四个方法。 $model.ref("modelName").query(param); $model.ref("modelName").save(); $model.ref("modelName").delete(); $model.ref("modelName").count(); 服务 服务模型由后台服务映射生成，当前支持与服务编排或脚本映射。关于服务模型的详细介绍，请参见服务编排和脚本。 参数根据后台服务的入参、出参，映射生成为inputParam和outputParam节点。 系统自动生成run方法 ，用于执行模型关联的服务编排或脚本。 $model.ref("modelName").run(); 事件 事件模型由后台事件的字段映射生成，并且支持websocket刷新模型数据。 参数根据后台事件的字段映射生成。 直接使用 直接使用 除了在模型中定义的方法，低代码平台还提供了如下标准API，适用于所有的模型。 获取模型数据：$model.ref("modelName").getData(); 设置模型数据：$model.ref("modelName").setData(); 设置模型字段值：$model.ref("modelName").setValue(key,value); 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。 属性值绑定：将容器组件的某个属性，如隐藏、样式、弹性布局等与具体的模型字段相绑定，绑定后组件的属性随模型字段的值变化而变化，类似Vue的v-bind。 在“数据绑定”中，单击“属性值绑定”后的“+”。 在“属性”下拉框中，选择容器的某个属性。 在模型字段中，单击，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。详细介绍，请参见表1。 图3 定义模型 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。

前提条件 自定义“我的仓库”前，您需要拥有一个华为账号或一个可用于访问OBS的IAM用户，即先 注册华为账号 开通华为云、完成实名认证、创建IAM用户、充值以及购买资源包，具体操作请参见使用OBS前需要做的准备工作。 参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 在华为OBS上创建存储桶（例如“bing.testonly.1”），用于后续存储资产包使用，具体操作请参见如何创建桶，并记录创建桶时选择的区域。

前台页面常用调测方法 在高级页面的开发中，常借助浏览器内置的 开发者工具 对样式或功能问题进行定位和分析。下面以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 模拟移动设备

基本属性 基本属性通过数据绑定后，在运行时以数据绑定的值为准。 标题：模态框的标题。 确定按钮文字：模态框的“确定”按钮上的文字。 取消按钮文字：模态框的“取消”按钮上的文字。 显示Loading：开启后，确定按钮显示loading状态。 显示遮罩层：开启后，显示遮罩层。 点击遮罩层关闭：开启后，允许单击模态框外的遮罩层关闭模态框。关闭后，必须先对该模态框进行响应，才能将该模态框关闭，例如单击模态框中的按钮（“确定”、“取消”）以及图标。 可拖动：开启后，该容器可拖动。 不显示底部：开启后，隐藏“确认”和“取消”按钮区域。 显示取消按钮：开启后，显示取消按钮。 确定按钮在前：开启后，确认按钮在前。 确定按钮禁用：开启后，确认按钮被禁用。 懒加载：开启后，弹框不打开不渲染，以提高性能。

数据绑定 通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：值绑定类似vue中的v-model语法，组件上创建双向数据绑定。值绑定会根据组件类型，自动选取正确的方法来更新元素。同时，负责监视各类引起绑定数据变化的事件以更新数据。 在“数据绑定”中，单击“值（value）绑定”中的，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 图2 定义模型 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。 表1 模型来源说明 分类 模型说明 模型参数的定义 模型方法的定义 API调用方法 自定义 开发者自行定义的模型。 由开发者自定义，可以添加子节点。 开发者自定义方法。 $model.ref("modelName").actionName(); 对象 由Object对象表映射生成，关于对象模型的详细介绍，请参见对象。 系统自动获取Object所有的字段，开发者可以从中选择部分字段作为参数。 系统自动生成查询、保存、删除和统计四个方法。 $model.ref("modelName").query(param); $model.ref("modelName").save(); $model.ref("modelName").delete(); $model.ref("modelName").count(); 服务 服务模型由后台服务映射生成，当前支持与服务编排或脚本映射。关于服务模型的详细介绍，请参见服务编排和脚本。 参数根据后台服务的入参、出参，映射生成为inputParam和outputParam节点。 系统自动生成run方法 ，用于执行模型关联的服务编排或脚本。 $model.ref("modelName").run(); 事件 事件模型由后台事件的字段映射生成，并且支持websocket刷新模型数据。 参数根据后台事件的字段映射生成。 直接使用 直接使用 除了在模型中定义的方法，低代码平台还提供了如下标准API，适用于所有的模型。 获取模型数据：$model.ref("modelName").getData(); 设置模型数据：$model.ref("modelName").setData(); 设置模型字段值：$model.ref("modelName").setValue(key,value); 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。 属性值绑定：将容器组件的某个属性，如隐藏、样式、弹性布局等与具体的模型字段相绑定，绑定后组件的属性随模型字段的值变化而变化，类似Vue的v-bind。 在“数据绑定”中，单击“属性值绑定”后的“+”。 在“属性”下拉框中，选择容器的某个属性。 在模型字段中，单击，进入选择模型页面。 单击“新增模型”，进入新增模型页面。 设置模型名称与来源，单击“下一步”。 AstroZero支持自定义、对象、服务和事件四类模型，每类模型都包含参数定义和方法定义。方法是在模型上定义的API，通常会在前台组件关联的事件脚本（例如页面加载事件、鼠标单击事件）中调用这些API，以实现某些功能。详细介绍，请参见表1。 图3 定义模型 在新建模型“设置”页面，执行如下操作。 上一步来源选择“自定义”，需要添加子节点自定义参数及类型。 上一步来源选择“对象”，需要配置模型关联的对象以及字段。 上一步来源选择“服务”，需要配置模型关联的后台服务，可以是脚本、服务编排或者公共接口。 上一步来源选择“事件”，需要配置模型关联的事件以及事件字段。 单击“下一步”，设置方法。 方法一般无需添加，如需添加或修改，可参考对象和服务默认生成的方法。 设置完成后，单击“确定”。

认识事件编排器 图1 事件编排器 事件编排是页面的重要组成部分，用于承载页面中的逻辑，完成事件响应，以帮助用户快速高效地实现页面所需要呈现的功能效果。 事件行为区：集中存放事件编排过程中使用的行为节点，包括系统内置的动作（例如打开页面、弹出页面、显示或隐藏控件、定时任务、提交表单、重置表单等）和自定义动作（例如获取当前组件、获取页面模型等）。 事件定义区：事件编排的操作区域，完成对事件逻辑的编排。开发者在代码编写过程中，键入特定的字符，界面会进行提示，从而自动构建智能代码补全服务，增强IDE代码补全能力。 事件内置API补全：输入“context”后，提示事件代码内可调用的API。 图2 事件内置API补全 模型名称补全：输入“context.$model.ref”后，提示当前页面中的模型。 图3 模型名称补全 服务编排名称补全：输入“context.flow”后，提示当前租户下的服务编排。 图4 服务编排名称补全 事件名称补全：输入“context.script”后，提示当前租户下的事件。 图5 事件名称补全 服务名称补全：输入“context.service”后，提示当前租户下的 API服务 ，选择API服务名称后自动补全服务地址。 图6 服务名称补全 图7 自动补全服务地址 华为OneMobile API补全：输入“xm”后，提示华为OneMobile小程序中的API。 图8 华为OneMobile API补全 WeLink API补全：输入“HWH5”后提示WeLink小程序中的API。 图9 WeLink API补全

操作场景 您可以通过明文接入RocketMQ实例，也可以通过密文接入RocketMQ实例，本章节指导您在控制台修改接入方式。 RocketMQ实例支持的接入方式如下： SSL：服务端与客户端之间通过密文传输，安全性较高，性能较低。 PLAINTEXT：服务端与客户端之间通过明文传输，安全性较低，性能较高。 PERMISSIVE：服务端与客户端之间即能通过明文传输又能通过密文传输，传输方式由客户端决定。

初始化Client 初始化RttsClient，其参数包括AuthInfo 表1 AuthInfo 参数名称 是否必选 参数类型 描述 ak 是 String 用户的ak，可参考AK/SK认证。 sk 是 String 用户的sk，可参考AK/SK认证。 projectId 是 String 项目ID，同region一一对应，参考获取项目ID。 region 是 String 区域，如cn-north-4，参考终端节点。 endpoint 否 String 终端节点，参考地区和终端节点。一般使用默认即可。

请求参数 请求类为RttsRequest，详见表 RttsRequest。 表2 RttsRequest 参数名称 是否必选 参数类型 描述 text 是 String 待合成文本，不超过500字。 通过set方法可以设置具体参数，详见表 RttsRequest设置参数 表3 RttsRequest设置参数 方法名称 是否必选 参数类型 描述 SetAudioFormat 否 String 设置语音格式，默认pcm。 SetAudioProperty 否 String 设置 语音合成 特征字符串，{language}_{speaker}_{domain}，即“语种_人员标识_领域”。默认chinese_xiaoyan_common 。详见API文档。 SetSampleRate 否 String 设置采样率：8000、16000，默认8000。 SetPitch 否 Integer 设置音高，-500~500，默认0。 SetVolume 否 Integer 设置音量，0~100，默认50。 SetSpeed 否 Integer 设置语速，-500~500，默认0。

SDK列表 在开始使用之前，请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在 SDK中心 查询版本信息。 表1提供了huaweicloud-sdk-php-v3SIS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 C++ huaweicloud-sdk-cpp-v3 C++ SDK使用指导 .NETet huaweicloud-sdk-net-v3 .NET SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 NodeJs huaweicloud-sdk-nodejs-v3 NodeJs SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导

请求参数 请求类为SasrWsRequest，其中参数详见下表 表7 SasrWsRequest 参数名称 是否必选 参数类型 描述 command 是 String 需设置为START，表示开始识别请求;发送END，表示识别结束请求。 config 是 Object 配置信息，详见下表。 表8 Config 参数名称 是否必选 参数类型 描述 audioFormat 是 String 音频格式，支持pcm，alaw，ulaw等，如pcm8k16bit，具体规格请参见《API参考》中开始识别章节。 property 是 String 属性字符串，language_sampleRate_domain， 如chinese_8k_common。 addPunc 否 String 表示是否在识别结果中添加标点，取值为yes 、 no，默认no。 digitNorm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为yes 、 no，默认为yes。 intermediateResult 否 String 是否显示中间结果，yes 或 no，默认no。 vocabularyId 否 String 热词表id，若没有则不填。 needWordInfo 否 String 表示是否在识别结果中输出分词结果信息，取值为“yes”和“no”，默认为“no”。

初始化Client 初始化SasrWsClient，其中参数包含AuthInfo，SisHttpConfig，SasrWsResponseListener，SasrWsConnProcessListener。 表1 SasrWsClient 参数 是否必选 参数类型 描述 AuthInfo 是 Object 鉴权信息类。 SisHttpConfig 是 Object 连接时网络的配置类。 SasrWsResponseListener 是 Object webSocket回调过程中，业务逻辑的Listener。 SasrWsConnProcessListener 否 Object webSocket生命周期的Listener。 其中AuthInfo和SisHttpConfig的参数如下表所示 表2 AuthInfo 参数名称 是否必选 参数类型 描述 ak 是 String 用户的ak，可参考AK/SK认证。 sk 是 String 用户的sk，可参考AK/SK认证。 serviceRegion 是 String 区域，如cn-north-4，参考终端节点。 projectId 是 String 项目ID，同region一一对应，参考获取项目ID。 serviceEndPoint 否 String 终端节点，参考地区和终端节点。 表3 SisHttpConfig 参数名称 是否必选 参数类型 描述 connectionTimeout 否 Integer 连接超时，默认10000，单位ms。 readTimeout 否 Integer 读取超时，默认10000，单位ms。 websocketWaitTimeout 否 Integer webSocket返回数据时等待时间，默认20000，单位毫秒。 ProxyHostInfo 否 ProxyHostInfo 代理类。 表4 ProxyHostInfo 参数名称 是否必选 参数类型 描述 userName 否 String 代理用户名（例：test）。 passWord 否 String 代理密码（例：test）。 hostName 否 String 代理地址（例：“proxy.huaweicloud.com”）。 port 否 int 代理端口号（例：8080）。 表5 SasrWsResponseListener 函数 描述 void onExceededAudio(); 识别时长超过一分钟时，响应，后续录入音频不在识别。 void onResponseError(AsrResponse response); 识别过程中出现异常，调用。 void onResponseEnd(AsrResponse response); 识别结束时回调。 void onResponseBegin(AsrResponse response); 识别开始时回调。 void onResponseMessage(AsrResponse message); 返回识别的结果。 表6 SasrWsConnProcessListener 函数 描述 void onTranscriptionConnect() webSocket连接建立后回调。 void onTranscriptionClose(); webSocket连接关闭后回调 void onTranscriptionFail(AsrResponse var1); webSocket长连接连接失败是回调。

请求参数 请求类为AsrCustomLongRequest，详见表3。 表3 AsrCustomLongRequest 参数名称 是否必选 参数类型 描述 data_url 是 String 存放录音文件地址： 推荐使用华为云OBS：授权配置请参见OBS配置。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用 域名 ，请尽量避免中文 audio_format 是 String 音频格式，具体信息请参见《API参考》中录音文件识别章节。 model_property 是 String 属性字符串，语言_采样率_模型，如chinese_8k_common。具体信息请参见《API参考》中录音文件识别章节。 add_punc 否 String 表示是否在识别结果中添加标点，取值为yes 、 no，默认no。 digit_norm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为yes 、 no，默认为yes。 need_analysis_info 否 Boolean 是否选择分析信息。 如果选择false，则声道、话者分离、情绪检测、速度信息均无效。默认false。 diarization 否 Boolean 是否需要话者分离，表示识别结果会包含role项，默认true。 channel 否 String 语音文件声道信息，可以为MONO（缺省), LEFT_AGENT， RIGHT_AGENT。默认MONO。 emotion 否 Boolean 是否需要做情绪检测，默认true。 speed 否 Boolean 是否需要输出语速信息，默认true。 vocabulary_id 否 String 热词表id，不使用则不填写。 创建热词表请参考《API参考》中创建热词表章节。 word_info 否 Array of objects 分词信息列表。