华为云用户手册

  • 扩展名 因为脚本实际上是存在数据库中的,所以脚本没有路径的概念,扩展名也没有特别的意义。 导入模块时,尽量采用不带扩展的方式。 import * as circle from './circle'; 平台只允许“.ts”扩展名文件存在,不允许包含“.js”后缀的模块,请尽量不要使用待扩展名的导入方式。如下方式等同上面的举例,但不推荐。 import * as circle from './circle.ts';
  • 开发流程 开发Native Service前,请先了解整个Native Service的开发流程。 图1 流程图 创建Native Service AstroZero平台提供了创建原生服务工程的能力,原生服务工程本质上起到一种桥接的作用,用于将原生服务的API集成到AstroZero,使得运行于AstroZero之上的应用,更容易地使用原生服务的API。 配置Chart 通过AstroZero提供的图形化界面,配置部署Docker容器时需要的资源、存储和网络等一系列参数。配置后,生成Chart包并进行导出。导出后,可通过云容器引擎(Cloud Container Engine,简称CCE),在其他平台上部署安装Docker容器。 配置API 原生服务旨在帮助您在AstroZero平台上或外部系统,调用已开发好的服务。为了完成调用,需要知道服务开放了哪些接口,以及这些接口的请求参数、返回参数,完成设计API后,可在服务编排中进行调用,也可将API再封装为自定义公共接口,供外部系统调用自定义公共接口。 部署Native Service 配置完API后,还需要部署才可使用Native Service。请使用此前设计的Chart包,在CCE上完成服务的部署。 管理Native Service 部署Native Service后,您可以通过CCE控制台对其执行升级、查看日志、监控、伸缩、回退、删除等操作。 注册Native Service 注册Native Service后,才可以在AstroZero的其他组件内(如脚本、服务编排等)调用原生服务的接口,也可将该原生服务开放给第三方系统进行访问。 在服务编排或脚本中调用原生服务 Native Service部署成功且在AstroZero中接入服务实例后,系统会把在Native Service中配置的API接口生成相应的restaction。在服务编排中,可进行调用该restaction。 自定义公共接口 使用公共接口,可以将原生服务API发布到外部网关,第三方系统可以通过OAuth2.0调用AstroZero上的原生服务。 导出Native Service包给其他用户使用 当服务编排中,可以成功调用原生服务后,说明整个流程已经测通。此时,可以导出Native Service包给其他用户,其他用户可以在沙箱环境或者运行环境中安装该包,以便于使用该软件或进行定制。 父主题: 如何创建原生服务
  • 属性 在属性中,设置散点图组件的位置、边框、背景等。 图2 属性 基础 组件标题:设置组件的标题。 组件名称:设置组件的名称。 位置 距离左端:组件到页面左侧的距离,单位为px。 距离顶端:组件到页面顶部的距离,单位为px。 宽度:组件的宽度,单位为px。 高度:组件的高度,单位为px。 堆叠顺序:设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”,数字越大,显示越靠前。当需要让组件置底时,可设置堆叠顺序为“0”。 自适应高度:组件的高度是否随宽度改变。 边框:设置组件的边框样式,如全边框或角边框。 背景 样式:设置背景的样式,如普通、居中、拉伸等。 图片链接:背景图片URL。 颜色:设置背景的颜色。
  • 安装应用有哪些方式 AstroZero低代码平台提供了如何通过导入方式安装应用和如何在我的仓库安装应用两种应用安装方式,请根据实际操作场景,选择安装应用的方式。应用安装场景及对应的安装方式介绍,如表1所示。 表1 应用安装场景及方式 场景 应用包来源 安装方式 安装环境 用途 安装当前租户 我的仓库 我的仓库 沙箱、运行环境 测试、部署运行 线下获取的应用资产包 导入方式 沙箱、运行环境 测试、部署运行 安装其他租户的应用 线下获取的应用源码包/资产包 导入方式 开发环境 二次开发、参考或查看 说明: 导入应用源码包支持二次开发,导入资产包只支持查看。如何编译应用包,请参见导入导出应用源码包。 线下获取的应用资产包 导入方式 沙箱、运行环境 测试、部署运行
  • 应用安装场景 应用开发编译发布成应用包后,可在开发环境、沙箱环境和运行环境中安装使用。应用包典型安装场景,有如下两种: 应用包的开发者租户,可以在当前租户的运行环境以及沙箱环境安装应用资产包,安装后进行测试或直接部署运行该应用。 其他租户可以在开发环境安装应用源码包,进行二次开发、参考或查看。在沙箱环境、运行环境中安装应用资产包,进行测试或直接部署运行该应用。 什么是源码包?与资产包有什么区别,详细介绍请参见导入导出应用源码包。
  • 在标准页面中与BPM交互 在标准页面的自定义事件中,内置了一些交互的API : 获取变量:context.$bpm.loadVariables(): Promise 提交任务、流程: context.$bpm.submitTask(variables: {[key: string]: any}): Promise 修改变量: context.$bpm.putVariables(variables: {[key: string]: any}): Promise 图2 在标准页面的事件代码中与BPM交互
  • 服务编排基本能力 拖拉拽式编排流程 以往的传统编程,需要进行变量的声明并编写相应逻辑代码进行服务的开发。使用服务编排进行服务开发,能够通过拖拉拽的方式,将配置项创建的变量以及服务编排中提供的各种功能进行编排,并以流程的方式将服务所要实现的功能展现出来。整个开发过程中无需进行代码的编写,简单快捷,并能够图形化展示服务的逻辑。 逻辑处理 服务编排中提供了逻辑处理的图形化元件,包括赋值、循环、跳出循环、决策和等待。通过这些图元能够实现基本的逻辑处理,并图形化展示,便于开发者理解,详情可参考操作步骤中对逻辑处理图元的使用。 对象处理 服务编排中提供了对象处理的图形化元件,包括记录创建、记录查询、记录更新和记录删除。通过这些图元能够对通过平台创建的自定义对象或标准对象进行相应的增、删、改、查操作,简化处理对象数据的流程,提高开发效率,详情可参考如何使用服务编排开发数据的增删改查中对象处理图元的使用。 服务单元组合脚本、原生服务、BO、第三方服务 服务编排中提供了服务单元组合的图形化元件,包括脚本、子服务编排、原生服务、BO和连接器。通过这些图元能够将平台中已开发完成的服务集成到服务编排中,并重新进行组合,快速扩展出更丰富的业务功能。
  • 服务编排与模块间调用关系 服务编排将平台提供的部分功能模块进行了封装,并提供了平台其他模块调用服务编排的能力,下面介绍其他模块与服务编排是如何进行相互调用的。 脚本 在服务编排中可以通过配置脚本图元,选择当前应用中的脚本进行脚本的调用。 在脚本中可以通过引入sys库,然后执行sys.invokeFlow({Flow_Name}),进行服务编排的调用。其中,Flow_Name为服务编排的名称。 对象 在服务编排中,可以通过配置记录创建、查询、更新、删除图元,对当前应用中的对象记录进行增删改查的操作,详情请参考如何使用服务编排开发数据的增删改查。 标准页面 在标准页面的模型视图中新建服务模型,能够绑定服务编排,进行服务编排的调用。 BPM 在BPM中可以通过配置“调用服务编排”活动,选择相应的服务编排进行服务编排的调用。 API接口 在新建接口时选择资源类型为“服务编排”,并选择相应的服务编排,即可将服务编排绑定到服务接口上,通过API接口进行服务编排的调用。 BO 在服务编排中调用BO(BO是封装了完整的数据模型、业务逻辑、页面展现的软件单元)进行使用,详情请参考BO图元。 连接器 在服务编排中调用与第三方系统对接的接口,如对接短信发送、 云存储 、系统中已定义的Action等,详情请参考连接器图元。
  • 开启日志监控 选择以下任意一种方式,进入日志跟踪页面。 方式一:在AstroZero经典版应用设计器中,单击左下角的,进入日志跟踪页面。 图1 在App开发页面开启日志跟踪 方式二:在AstroZero经典版环境配置中,单击页面右下角的,进入日志跟踪页面。 图2 进入日志跟踪页面 单击,可以开启十分钟内的AstroZero的后台日志追踪。 如果需要停止跟踪,可单击,将停止追踪且不会获取日志文件。 图3 开启日志跟踪 表1 日志跟踪参数说明 参数 说明 日志级别 日志级别,取值说明如下: 会话级:只打印当前会话的日志。 租户级:打印租户所有会话的日志。 日志类型 日志类型,取值说明如下: 业务日志:输出业务相关的跟踪日志。 完整日志:输出业务日志,以及数据库、中间件等的详细日志,主要用于AstroZero问题定位。 下载日志文件。 单击下载,可下载日志文件。下载后会自动停止跟踪,日志格式为“时间|操作ID|业务部件|动作描述”。 单击,可从新窗口打开日志跟踪页面。 单击,可最小化显示日志跟踪页面。 单击最小化图标后,日志跟踪页面将会被隐藏。在AstroZero管理中心页面的右下角,可以看到日志跟踪剩余时间。单击该时间,将重新弹出日志跟踪页面。 图4 日志跟踪时间
  • 如何使用决策图元 在逻辑中,拖拽“决策”图元至画布中。 选中决策图元,单击,设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签,用于在页面显示。系统会自动填入该值,格式为Decision序号,序号从“0”开始,表示同类型图元序号。 名称 该图元的标识,请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击,在“决策”页面进行配置。 图1 配置决策图元 表2 决策图元配置参数说明 参数 参数说明 可编辑的结果 所有的判断条件。 可通过单击“新增”,新增判断条件分支,界面右侧区域配置分支条件。 默认:默认输出,当其他所有条件均不满足情况下,进入该分支。 可视 当选择“可视”时,可配置分支的判断条件。单击“新增”,可新增判断条件,条件显示为“资源”、“比较符”、“值”。 资源:从全局上下文拖拽变量或者直接输入“{!变量名}”。 比较符:从下拉框中选择。 值:从全局上下文拖拽变量或者直接输入“{!变量名}”,也可以是常量。 公式 可采用公式设置该分支条件。 公式中的变量,可从全局上下文拖拽变量或者直接输入变量。 选择连接条件 当选择“可视”并设置多条判断条件时,需要设置选择连接条件“或”或者“且”。 或:表示满足多条判断条件的其中一条,便可进入该分支。 且:表示必须同时满足多条判断条件,才可进入该分支。
  • 是否可以多人编辑服务编排 当多人编辑已有服务编排时,为防止多人篡改,低代码平台提供了一套保护机制。假设,A用户打开X服务编排,编辑前单击锁定服务编排,A用户进行编辑,此时B用户也打开X服务编排,B用户的服务编排编辑器将自动进入锁定模式。 保持A用户对X流程的编辑设计权限。A用户编辑完成后,需要单击,进行解锁或者单击启用按钮进行自动解锁。 当A用户锁定X流程后,系统会只读模式锁定B用户对X流程的操作,B用户的服务编排编辑器页面会有提示“该资源已经由A用户锁定,点击此处强制获得编辑权”。B用户如果按照提示强制获得编辑权,A用户的X流程编辑器画面会自动锁定。 当多人编辑已有BPM、触发器、标准页面或状态机时,AstroZero提供的保护机制是相同的,后续不再分别介绍。 父主题: 服务编排
  • 如何使用发送事件图元 在基本中,拖拽“发送事件”图元至画布中。 选中发送事件图元,单击,设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签,用于在页面显示。系统会自动填入该值,格式为Event序号,序号从“0”开始,表示同类型图元序号。 名称 该图元的标识,请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击,在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 参数说明 事件 选择待发送的事件。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段,则根据该字段值进行路由,相同的值将路由到同一个Kafka分区;如果不指定,则默认随机路由到不同Kafka分区,从而提升并发处理性能。 须知: 建议选择有区分度的关键字段,该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 若不勾选“发送到外部”,表示将事件数据发到默认的Topic上。 若勾选“发送到外部”,表示将事件数据发送到与AstroZero相连Kafka的其他Topic上,此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束(提交或回滚)后才发送 是否延迟到该服务编排事务结束后,才发送事件。 默认不勾选,表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时,该参数才会显示,表示非系统配置的默认Topic。 需要从与AstroZero相连Kafka处,获取其他主题Topic。 目标/源 配置事件数据,为该事件自定义参数赋值,将“源”取值赋值到“目标”中。单击“新增行”,可添加并进行赋值。 目标:从下拉框中,选择事件的自定义参数。 源:从全局上下文拖拽变量或直接输入“{!变量名}”,给目标赋值。
  • 如何使用跳出循环图元 在逻辑中,拖拽“跳出循环”图元至画布中。 选中跳出循环图元,单击,设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签,用于在页面显示。系统会自动填入该值,格式为Break序号,序号从“0”开始,表示同类型图元序号。 名称 该图元的标识,请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击,在“跳出循环”页面的“循环”下拉框中,选择当前服务编排中需要中断的循环。 图1 配置跳出循环图元
  • 操作步骤 进入数据调试页面。 方式一:在AstroZero经典版应用设计器中,单击左下角的,进入数据调试页面。 图1 从应用开发页面进入数据调试页面 方式二:在AstroZero经典版环境配置中,单击页面右下角的,进入数据调试页面。 图2 从环境配置页面进入数据调试页面 方式三:直接在浏览器中,输入“https://AstroZero 域名 /studio/console.html”,进入控制台页面进行数据调试。 控制台页面如图3所示,界面分为多个区域,展示不同的内容。 图3 控制台 区域1:数据调试控制台支持的所有操作。 对象管理:关于对象表的操作。 缓存管理:对AstroZero系统的缓存进行管理,主要是清理所有缓存或清理某个特定缓存的命令。 任务查询:对AstroZero的一些历史任务或表数据统计的可用命令展示。 搜索管理:展示Elasticsearch中的可搜索表或字段。 区域2:根据区域1的操作从而展示对应的内容。 单击区域1的“对象管理”,则会在区域2中展示该用户有权限看到的所有表。 单击区域1“缓存管理”,则会在区域2中展示管理缓存相关的命令。 单击区域1“任务查询”,则会在区域2中展示任务管理相关的命令。 单击区域1“搜索管理”,则会在区域2中展示搜索管理相关的命令,支持根据应用进行过滤,默认显示“全部”,即搜索所有应用数据。 区域3:展示命令的说明或提示文字。 单击区域2展示的命令时,会在该区域展示该命令的简单说明或展示一些提示文字。 区域4:操作按钮区域。 单击“执行”(快捷键为Ctrl + Enter),可执行用户在区域5输入的命令。或者选中区域5输入的某个命令,单击“执行选择项”进行执行。命令执行完成后,单击“清除”,可清除执行结果的展示。 区域5:命令输入区,用户可以在该区域进行表数据查询,支持多种表操作的SQL语句。 例如:在单击区域1的“对象管理”时,会在区域2展示所有对象表,单击某个表,便可复制该表名。用户在区域5输入命令时,可快速复制粘贴要查询的表名。且对于区域2展示的所有命令,可通过双击鼠标左键,可直接将命令展示在该区域,然后单击区域4“执行”,执行该命令,减少了用户手动输入命令的动作。 区域6:展示相关命令的执行结果。 区域7:展示系统的发行版本和发行时间。 区域8:记录用户在区域5成功执行的所有命令。 单击该区域的命令,可将选中的命令填充到区域5,单击区域4的“执行”按钮,便可执行该历史命令。 根据 “支持SQL语句列表”提示,输入SQL查询语句,执行查询。 对象管理中除了系统预置的标准对象、用户定制的自定义对象、视图对象和聚合对象,还有一种系统对象,即AstroZero各项系统功能模块所使用到的对象,如服务编排、脚本。此类对象一般无需关注,若需要定位问题可在数据调试控制台使用SQL语句进行查询。 图4 执行SQL语句查询
  • 如何使用记录更新图元 在基本中,拖拽“记录更新”图元至画布中。 选中记录更新图元,单击,设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签,用于页面显示。系统会自动填入该值,格式为RecordUpdate序号,序号从“0”开始,表示同类型图元序号。 名称 该图元的标识,请确保在当前服务编排中唯一。 描述 该图元的描述信息。 使用快速更新模式 是否启用快速更新模式。 若勾选该参数,表示为快速模式。 根据对象变量中的记录ID,将对象变量更新到数据库中。更新的值,来源于对象变量中的值。如果对象变量为数组,则根据对象变量中的记录ID,批量将对象变量数组更新到数据库中。 不勾选,表示为普通模式。 根据条件更新对象记录,需要配置修改记录对应的对象名,更新条件,更新的各个字段的值。 默认不勾选。 单击,在“记录更新”页面进行配置。 若上一步勾选“使用快速更新模式”,则需要指定一个预先定义的对象变量或者对象变量数组,并将该对象变量或对象变量数组拖拽到“变量”输入框中。即可根据对象变量中的记录ID,将对象变量更新到数据库中,更新的值来源于对象变量中的值。如下图所示,根据对象变量“Accountupdate”中的记录ID将对象变量中的值更新到数据库中。 图1 快速更新模式 表2 快速更新模式参数说明 参数 参数说明 变量 预先定义的对象变量或者对象变量数组。 根据对象变量中的记录ID,将对象变量更新到数据库中。更新的值来源于对象变量中的值。如果变量为对象数组,则根据对象变量中的记录ID,批量将对象变量数组更新到数据库中。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前服务编排出现错误时回滚 当前服务编排出现错误时回滚到上一个流程。 默认为勾选。若无特殊要求,请不要更改设置。 若上一步未勾选“使用快速更新模式”,则需要指定对象并在条件中,设置指定对象部分字段的值。在赋值中,设置需要更新的目标字段及更新值,最后根据条件查找符合条件的对象记录,并将赋值中的值更新到数据库中。如下图所示,更新“Account”对象“name”为“Lily”的记录,将变量“var_record_id”值更新到“id”字段。 图2 普通更新模式 表3 普通更新模式参数说明 参数 参数说明 对象 更新的具体对象名。 当前服务编排出现错误时回滚 当前服务编排出现错误时,回滚到上一个流程。 默认为勾选。若无特殊要求,请不要更改设置。 条件 选中对象后,该条件区域“字段”列会出现该对象的字段。单击“新增行”,可设置更新数据的条件。 在“字段”中选择要进行判断的对象字段。 在“比较符”中选择相应的比较符 “值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 赋值 选中对象后,该赋值区域“目标”列会出现该对象的字段。如果需要给多个字段赋值,则单击“新增行”,定义其他字段的值。 在“目标”中选择需要赋值的对象字段。 “源”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。
  • 测试场景下创建证书和私钥的操作方法 该方法创建的证书通常只适用于测试场景。 执行如下命令生成密钥文件tls.key。 openssl genrsa -out tls.key 2048 命令执行后将在当前目录生成一个tls.key的私钥文件。 生成的密钥格式必须为: ----BEGIN RSA PRIVATE KEY-----……………………………………………..-----END RSA PRIVATE KEY----- 用此私钥去签发生成自己的证书文件tls.crt。 openssl req -new -x509 -key tls.key -out tls.crt -days 3650 根据提示输入国家、省、市、公司、部门、申请人和邮箱,按回车键确认。 生成的证书格式必须为: -----BEGIN CERTIFICATE-----……………………………………………………………-----END CERTIFICATE-----
  • 属性 在属性中,设置仪表盘组件的位置、边框、背景等。 图2 属性 基础 组件标题:设置组件的标题。 组件名称:设置组件的名称。 位置 距离左端:组件到页面左侧的距离,单位为px。 距离顶端:组件到页面顶部的距离,单位为px。 宽度:组件的宽度,单位为px。 高度:组件的高度,单位为px。 堆叠顺序:设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”,数字越大,显示越靠前。当需要让组件置底时,可设置堆叠顺序为“0”。 自适应高度:组件的高度是否随宽度改变。 边框:设置组件的边框样式,如全边框或角边框。 背景 样式:设置背景的样式,如普通、居中、拉伸等。 图片链接:背景图片URL。 颜色:设置背景的颜色。
  • 自定义布局样式 如果导航页面,想实现如下图所示布局效果,即整个页面不需要有滚动条,而其中导航组件区域和全局路由视图组件区域可随滚动条滚动时,可参考如下步骤实现。 图13 自定义布局样式页面效果 在头部组件的“.css”样式文件中,指定头部组件的高度。 样例代码如下: #headerWidget { height: 90px;} 参考基于预置组件进行自定义中操作,下载预置组件路由导航(示例),解压global_NavigatorWidget.zip。 修改解压后的“Navigator_Widget.css”文件,该文件是Widget的样式文件,在该文件中编写Widget的css样式。 样例代码如下: html[app=desktop] body { overflow: hidden;} #navigatorWidget, #global_RouterViewWidget { height: calc(100% - 90px); overflow: scroll;} 将修改后的头部组件和组件路由导航组件文件,重新打成zip包。 参考基于预置组件进行自定义中操作,上传重新打包后的组件。 在高级页面设计器左上方,单击,拖出上传的头部组件、路由导航组件和预置的路由视图组件至设计页面。 单击页面上方的,保存页面。 保存成功后,单击,发布页面。 发布成功后,单击,可查看页面效果。
  • 响应式组件开发基本原则 组件的响应式设计,是高级页面适配多终端的重要前提。为确保自定义组件能够自适应不同分辨率设备,在组件开发中用户需要遵从响应式设计的基本原则。 根据内容设计。 不专注于特定屏幕宽度,而是专注于内容设计,当屏幕越小或浏览器窗口越窄时,内容所占的垂直高度越来越多,内容就要向下方自然延伸。建议从小屏幕开始,逐步设置断点(例如设备宽度320px、768px、1024px),针对不同设备进行设计,形成流动布局。 针对复杂情况,可以使用 CSS 3的@media查询。针对不同的终端类型和不同屏幕分辨率的设备,定义不同样式,选择应用不同的 CS S规则。只有当该设定媒体查询与正在使用的设备匹配时,其对应的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的复杂度,通过补充设计的方式逐步丰富布局。这样,通过移动优先,可以更轻松地开发响应式布局。
  • 购买沙箱 以创建用户并授权使用AstroZero中创建 IAM 用户进入购买Astro轻应用沙箱实例页面。 在购买AstroZero实例页面,设置对应参数,单击“立即购买”。 图1 购买沙箱 表1 购买沙箱参数说明 参数 说明 实例版本 待购买实例的版本,请选择“测试沙箱环境”。 实例名称 新建实例的名称,同一账号下实例不可重名,创建后不可修改。命名要求如下: 长度为4~64个字符。 必须以英文字母开头,只能英文字母、数字或下划线组成。 数量 输入购买沙箱的个数,一次性最多支持购买5个,可进行多次购买。 规格说明 AstroZero沙箱实例规格说明,详细介绍请参见产品规格差异。 购买时长 设置沙箱的购买时长,最短1个月,最长3年。 在购买Astro轻应用页面,确认支付方式,单击“去在线支付”。 图2 支付订单 支付成功后,单击“返回Astro轻应用控制台”,即可进入AstroZero服务控制台。 进入AstroZero沙箱环境。 创建功能调试沙箱实例预计需要几分钟,请耐心等待。创建成功后,控制台会显示已成功购买的沙箱环境实例,单击相应沙箱环境实例的“管理沙箱环境”,即可进入相应环境。
  • 应用后端开发概述 后端开发主要包括模型开发、逻辑开发和流程开发三大类。各类中包含的具体功能,如图1所示。 图1 后端开发 模型开发:在AstroZero中是以模型驱动,快速构建业务场景的,因此首先要定义应用的数据模型,就是应用中的业务数据存储在哪里,也就是通常所说的搭建数据库、创建数据库表等。这些动作,对应AstroZero中的对象,对象可以理解为数据库中表的概念。例如,在开发某个仓库商品管理应用时,需要创建商品和仓库两个对象,来分别存储商品信息(如商品编码、商品状态、库存总量、现存数量和仓库商品关系等)和仓库信息(如仓库名称、仓库编码、仓库地址和记录ID等)。如果需要实现多个对象之间关联数据查询功能,可通过创建对象视图来实现。 逻辑开发:数据模型开发完成后,相关的业务功能实现可能和某些数据做对接,也可能是一些数据的处理,这就涉及要业务接口和逻辑的开发。脚本和服务编排都是负责业务接口和逻辑开发的,两者的主要区别是脚本是代码化的,而服务编排是图形化的;服务编排适用于业务逻辑比较简单的场景(建议不超过20个图元),对于业务逻辑比较复杂的场景需要使用脚本。触发器以图形表示的方式,将业务流程呈现给用户,触发器配置好后,用户不必手动执行这些操作,系统会自动执行。触发器的典型使用场景是脚本已实现了逻辑开发,这时不想修改脚本但需要去实现某个功能,此时可选择使用触发器。 流程开发:与服务编排类似,工作流也是一套图形化的流程编排引擎,但是工作流着重于构建带有用户交互行为的业务流程,例如审批流、工单派发流程等。在实际的业务流程开发中,通常会将工作流与服务编排结合使用,即服务编排用于实现系统的具体逻辑操作,工作流通过调用服务编排、关联用户任务与页面,实现多次人机交互的流程。此外,在业务系统中通常存在很多场景不需要人工参与,可以在系统后台定期完成的,此时可通过创建定时任务来实现。例如,通过创建定时任务,在每天凌晨3点,定时将到期的商品进行下架处理。 表1 后端开发 分类 特性 特性说明 模型开发 对象 对象(也可以称为Object)相当于传统方式开发业务系统时,数据库中的一个表。每个对象对应一张数据库表,用于保存业务系统需要的配置数据和业务数据。 事件 在业务流程中,有意义的状态变化都可称为事件。自定义好事件后,可基于该事件实现事件发送、事件订阅,对发送的事件数据进行分析处理等功能。 逻辑开发 脚本 脚本和服务编排一样,都是完成业务接口和逻辑开发的,脚本是基于TypeScript语言,适用于业务逻辑比较复杂的场景。 服务编排 服务编排和脚本一样,都是完成业务接口和逻辑开发的,服务编排是图形化的,适用于业务逻辑比较简单的场景(建议图元不超过20个)。 触发器 触发器以图形表示的方式将业务流程呈现给用户,触发器配置好后,用户不必手动执行这些操作,系统会自动执行。 流程开发 工作流 与服务编排类似,工作流也是一套图形化的流程编排引擎,但是工作流着重于构建带有用户交互行为的业务流程,例如审批流、工单派发流程等。 定时任务 通过创建定时任务,让系统自动执行某脚本、服务编排完成业务功能。例如,系统中存在一个定时任务,在每天凌晨3点,定时将到期的商品进行下架处理。 父主题: 使用AstroZero开发应用后端
  • 属性 在属性中,设置基本折线图组件的位置、边框、背景等。 图2 属性 基础 组件标题:设置组件的标题。 组件名称:设置组件的名称。 位置 距离左端:组件到页面左侧的距离,单位为px。 距离顶端:组件到页面顶部的距离,单位为px。 宽度:组件的宽度,单位为px。 高度:组件的高度,单位为px。 堆叠顺序:设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”,数字越大,显示越靠前。当需要让组件置底时,可设置堆叠顺序为“0”。 自适应高度:组件的高度是否随宽度改变。 边框:设置组件的边框样式,如全边框或角边框。 背景 样式:设置背景的样式,如普通、居中、拉伸等。 图片链接:背景图片URL。 颜色:设置背景的颜色。
  • 如何设置数据系列 选择基本柱图组件,单击鼠标右键选择“高级设置”。 展开数据系列配置,单击旁边的“+”,添加数据系列。 图5 配置数据系列 在右侧“数据”页签,配置该数据系列的数据。 例如,在使用系统预置的静态数据基础上,添加如下加粗代码,配置新增数据系列的数据。也可以使用“动态数据”调用后台接口URL返回如下结构模型数据。 {"resCode": "0","resMsg": "成功","result": [{"order": {"dataX": ["保洁","安管","工程","绿化","消杀","特约"],"dataValue": [{"title": "工单总数","value": [411,965,427,630,85,800]},{"title": "费用","value": [500,1065,327,730,185,1000]}]}}]} 配置添加的数据系列柱状条颜色、柱状条宽度、柱条边框圆角、数值是否显示,柱状图上显示的数值对应上述静态数据中的数值。 设置完成后,单击“确定”。
  • 属性 数据绑定:通过建立不同类型的视图模型,将各种数据源和组件的返回值或者属性值进行关联,实现动态数据效果。 值绑定:设置组件绑定的数据模型,数据模型一般有以下几种。更多介绍,请参见值绑定。 自定义:由用户自定义的前端模型,可以在模型树上快速创建自定义字段。 对象:由后台对象模型映射创建,支持选择字段。 服务:由后台服务的出入参数模型创建,分别生成inputParam和outputParam节点。 事件:由后台事件的字段映射创建,并且支持websocket刷新模型数据。 属性值绑定,用于对该组件所有属性的动态设置。当某一属性被动态绑定时,以绑定值为准。更多介绍,请参见属性绑定。 基本属性:基本属性通过数据绑定后,在运行时以数据绑定的值为准。 内容或链接:设置扫描二维码后,要展示的文本内容或者跳转的链接地址。 宽度:二维码的宽度,单位像素。默认值为150。 容错级别:二维码被遮挡或残破时依然能被识别的几率,容错级别越高抗残破或遮挡的能力就越强。 空白间距:四周空白间距,单位像素。 前景色:二维码的颜色。 背景色:背景颜色。 中间Logo:二维码中间Logo图片,可不用设置。设置Logo后,如果扫描二维码识别失败,可以调高容错级别或调大二维码。 Logo大小:设置Logo的大小,单位像素。 公共 控件名称:当前组件的名称。 隐藏:是否隐藏该组件,此方式为静态配置该组件的隐藏。还可以将该组件属性值“隐藏”配置为布尔类型模型字段,在自定义JS代码中来控制模型字段取值,从而设置该组件是否隐藏,这种动态设置优先级是最高的。 样式 布局:设置组件的宽度、高度等。 字体:设置字体大小、字体样式、颜色等。 背景:设置背景颜色、透明度。 边框:设置边框颜色、宽度等,单位为px。 阴影:设置阴影颜色、模糊、扩散等,单位为px。 高级设置 样式源码:组件具体样式代码,组件样式设置后,样式代码将自动显示在“样式源码”中,也可以自定义样式代码,对组件进行详细配置,自定义代码支持多行输入,并高亮显示样式参数。 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。
  • 属性 在属性中,设置基本柱图组件的位置、边框、背景等。 图2 属性 基础 组件标题:设置组件的标题。 组件名称:设置组件的名称。 位置 距离左端:组件到页面左侧的距离,单位为px。 距离顶端:组件到页面顶部的距离,单位为px。 宽度:组件的宽度,单位为px。 高度:组件的高度,单位为px。 堆叠顺序:设置组件层叠显示顺序。组件的堆叠顺序默认都是“1”,数字越大,显示越靠前。当需要让组件置底时,可设置堆叠顺序为“0”。 自适应高度:组件的高度是否随宽度改变。 边框:设置组件的边框样式,如全边框或角边框。 背景 样式:设置背景的样式,如普通、居中、拉伸等。 图片链接:背景图片URL。 颜色:设置背景的颜色。
  • 使用自定义错误码 自定义错误码创建完成后,可在脚本中使用。在脚本中,调用抛出错误信息的error函数I18nError('ErrorCodeName','变量1','变量2')。该函数中,输入参数为错误码名称“t__testErrorCode”和错误码信息中所携带的变量("val1"和"val2")。 创建脚本。 参考创建空白AstroZero脚本中操作,创建一个空白脚本。 在脚本编辑器中,输入如下代码。 // test custom error func , get diff language error by user langimport * as error from 'error';export class TestDemo { @action.method({ label: 'test', description: 'error code', input: 'No input', output: 'No output' }) public test() { //使用I18nError函数设定错误码和错误码信息携带变量 throw new error.I18nError('t__testErrorCode', ["val1", "val2"]); }} 其中,“t__testErrorCode”为自定义错误码名称,请根据实际情况配置。 单击,保存脚本后,单击,启用脚本。 按照定义API接口中操作,绑定上述开发的脚本,进行测试。 图3 自定义错误信息测试
  • 如何导入导出数据 实例化数据可以通过AstroZero平台的“数据导出”功能,以对象的方式导出到本地。安装实例化数据,可以通过平台的“数据导入”功能实现。关于数据的导入导出操作,请参见如何导入导出数据。 数据修改后,升级没变化:不是同一条数据,即ID不一致。 对象存在,但数据导出里面找不到该表:开发界面里对象属性“允许API批量访问”未勾上。 报错“parsing request parameters content of JSON failed: 'record'”:表中存在lookup/masterdetail类型的字段,该字段的值必须为id,不能是普通的值。 报错“file server exception, receive response failed, TrackerTask RecvHeader recv resp status 28 != 0”:文件服务器异常,需要咨询运维处理。
  • 什么是实例化数据包 实例化数据是应用需要自带的预设数据,用于支持应用的默认行为。 在AstroZero平台中,实例化数据包是由以下三种类型数据的整体或部分构成的数据压缩包: 系统对象数据 AstroZero系统定义的实例化数据主要是用户在开发应用过程中平台产生或用户使用平台功能生成的,在应用安装完成后能够进行配置的数据。 标准对象数据 AstroZero平台内部自带的或第三方提供的标准对象数据,标准对象实例化数据包括了平台内置的(例如Account、Contact)以及订购了基线应用所提供的对象的实例化数据。 自定义对象数据 由用户通过建立自定义对象,并通过界面或接口生成的记录数据。 应用在发布时,包含一些初始化的数据,可通过单击,使用SQL语句查询对象及对象的数据,详情可参考使用控制台分析查询SQL。
  • 调试过程 单击页面上方的,输入参数后单击“运行”,运行服务编排。 在“输入参数”中,输入如下参数: { "ownerId":"123", "limit":3, "offset":1} 检查输出页签的结果,是否符合预期。 输出如下: { "interviewId": "002N000000P4ApgMJOM4", "outputs": { "resource": [ { "ownerId": "123", "resourceName": "Folder01", "status": "Waiting", "type": "Folder" }, { "ownerId": "123", "resourceName": "File02", "status": "Waiting", "type": "File" }, { "ownerId": "123", "resourceName": "Folder02", "status": "Waiting", "type": "Folder" } ], "totalCount": 100 }} 单击服务编排编辑器页面右上方的“跟踪”,打开“日志跟踪器”页面。 在“日志跟踪器”页面,可查看服务编排执行的每一步的详细信息。 图10 查看日志详情 单击页面上方的,启用服务编排。
  • 前提条件 已创建名为“Approved Resource”的Object,用于存储资源数据,该对象中需要包含如下字段。 表2 Approved Resource对象说明 字段标签 字段名称 (系统自动生成) 字段类型 取值 读写权限 是否加入界面布局 含义 ownerId ownerId__CST 文本 长度:255 全选 不勾选 资源拥有者ID ResourceName ResourceName__CST 文本 长度:255 全选 不勾选 资源名称 Type Type__CST 选项列表 枚举值如下: File Folder 全选 不勾选 资源类型 SubmitDate SubmitDate__CST 日期/时间 不涉及 全选 不勾选 资源提交时间 ApproveDate ApproveDate__CST 日期/时间 不涉及 全选 不勾选 资源审批时间 Status Status__CST 选项列表 枚举值如下: Waiting Submitted Approved 全选 不勾选 审批状态 已创建场景描述中的脚本。该脚本根据对象的数据生成资源列表数据,用于前台数据呈现。示例脚本为“ResourceListScript.zip”,单击下载链接可获取该脚本包。该脚本中定义的入参和出参说明,如表3和表4所示。 表3 入参说明 参数 参数类型 说明 ownerId string 资源拥有者ID。 limit number 每页展示的资源条数。 offset number 每页展示第一条资源的偏移量,即从offset+1条资源开始展示。 表4 出参说明 参数 参数类型 说明 resource struct 返回资源数组集合。 approveDate:审批时间,若该记录已审批则返回审批时间。 ownerId:资源拥有者Id。 resourceName:资源名称。 status:资源状态。 Waiting:记录未提交。 Submitted:记录已提交未审批。 Approved:记录已审批。 submitDate:资源提交时间。 type:资源类型。 totalCount number 资源总数(固定100)。
共99354条