华为云用户手册

应用包括哪些类型 AppCube低代码平台当前支持创建的应用类型及类型介绍，如表1所示。 图1 应用类型 表1 应用类型介绍 应用类型 介绍 创建方法 轻应用 轻应用一般为轻量级应用，不涉及复杂化的代码，用户低代码（如拖拽组件，简单配置）就能轻松完成应用的搭建。 创建空白轻应用后系统会预置Logic、Model、Page目录。 单击“轻应用”，即可进入轻应用页面，创建一个空白轻应用，或基于应用模板创建一个轻应用。 轻应用、行业应用的创建方法类似，仅是创建入口不同，具体创建方法请参见创建应用。 行业应用 行业应用相对轻应用而言，功能更加丰富，使用AppCube低代码提供的各种能力组件，采用低码或多码化模式开发应用。行业应用是针对不同行业领域如城市、园区、能源以及交通等创建的应用。 创建空白行业应用后，需要自定义目录。 单击“行业应用”，即可进入行业应用页面，创建一个空白行业应用，或基于应用模板创建一个行业应用。 商业对象（Business Object，简称BO），是封装了完整的数据模型、业务逻辑、页面展现的软件单元，通过开放出来的接口为上层应用提供服务。BO也可以提供管理页面，对自身的数据进行配置管理。 用户可基于某些BO，组合、排列并进行配置，如魔方一样创建功能各异的应用。例如，基于设备BO、告警BO以及GIS服务BO等多种BO资产，创建智能烟雾感应用，完成设备数据的接入、处理分析以及告警监控功能。 设备BO：为上层应用提供对设备的统一语义，对设备自身能力进行抽象封装。 告警BO：对所有告警提供统一语义，从各个子系统和上层应用获取告警数据，统一模型统一展现。 GIS服务BO：提供对GIS子系统的租户管理、地图管理、位置服务接口的封装和标准化接口。 请参见如何创建BO。 Addon应用，当需要基于已有应用或解决方案（原有应用只能是资产包形式安装的应用）进行定制时，可以选择Addon类型创建应用。在创建的Addon应用里定制修改，不会影响原有应用的代码。Addon应用和BO的区别是，Addon应用基于的原有应用可理解为一个基础的类，被Addon后相当于重写了其中的一些方法。而BO则像一个库，等待其他应用的引入。 请参见创建Addon应用。 Native Service（原生服务），租户线下开发了一些服务，服务运行在Docker容器中。租户希望可将线下开发的这些服务集成到AppCube上，供AppCube内部应用或者其他第三方系统调用。 请参见原生服务。 大屏应用 大屏应用，也称为DMAX大屏应用，是AppCube中的一款可视化大屏构建工具，DMAX大屏应用提供丰富的可视化组件、灵活的数据接入和多种方式页面构建能力，支持多屏适配，可以帮助开发者快速构建和发布专业水准的实时可视化大屏页面。 请参见用户指南（DMAX大屏）。

应用的生命周期 应用的开发阶段 应用是一个工程，可以创建对象模型，编辑标准页面和高级页面，开发服务编排和脚本逻辑，开发商业应用业务流程等，在应用的开发环境里，可以快速实现底层逻辑。 应用的部署阶段 应用是一个可安装的包，可以实现不同租户间和不同环境间的迁移，用户只要下载和导入这个应用包就可以部署应用。 应用的运行阶段 应用是一个可预览的运行界面。在工程能力中，将详细介绍应用的工程能力、部署打包等能力。

操作步骤 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“布局与颜色”页签，设置应用布局样式。 主题颜色：系统预置的主题颜色，其中“华为云经典”为华为云主题。 图标：设置应用Logo，如更改Logo图片、设置圆形图标和隐藏文字。将鼠标放在“图标”下的图片上，选择“更改”，可更改应用Logo。 布局：选择“布局”中的样式，在右侧区域设置布局参数，如菜单、子菜单、页签、应用标题的字体及颜色等。 布局选项：提供了一些常见选项，用于设置应用布局。 表1 布局选项参数说明 参数 参数说明 启用页签栏 是否启用页签栏。 默认折叠菜单 是否默认折叠菜单。 切换菜单时记录浏览器历史 切换菜单时，是否记录在浏览器历史中。 是否全屏 是否全屏显示页面，全屏后会折叠左侧菜单。 隐藏国际化按钮 是否隐藏右上方国际化按钮。 禁用应用切换 是否禁用应用切换。禁用后，在运行态Portal中单击左上角应用图标，不会再弹出切换应用的界面。 隐藏菜单图标 是否隐藏菜单图标。 隔离其他应用的BPM流程 是否在主页页签（即个人任务相关页）隔离其他应用的BPM流程。勾选后，如果该应用导航条设置了主页页签，预览应用，在应用主页页签“我的待办”中不会显示其他应用的BPM流程，在历史任务“已完成流程历史”、“已终止流程历史”及“已挂起流程历史”页签中也不会显示其他应用的BPM流程。 设置完成后，单击“保存”。 在应用开发页面，单击左侧菜单栏中的，可预览应用查看设置效果。

操作步骤 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“导航条”页签中，单击“+”后选择“添加页签”。 图1 新建导航条 配置导航页签信息，单击“保存”。 表1 新建页签参数说明 参数 参数说明 页签类型 选择导航页签的类型。 主页页签：用于展示个人任务相关的信息。 对象页签：关联一个对象的布局，将展示指定对象的某个布局页面。 标准页面页签：用于关联并展示一个标准页面。 高级页面页签：用于关联并展示一个高级页面。 BPM页签：用于关联并展示一个BPM。 Web页签：用于关联一个URL，将展示URL对应的网页或页面。 状态机页签：用于关联并展示一个状态机。 报表页签：用于关联并展示一个报表。 仪表板页签：用于关联并展示一个仪表板。 “页签类型”选项配置不同时，界面参数展示也有所不同。请根据“页签类型”具体选项配置参数。 显示区域 导航页签的显示区域。 主页菜单：会按照设置布局与颜色选择的布局样式进行显示，例如显示在侧栏或者顶栏区域。 自定义菜单栏：选择该方式后，在应用的运行态Portal中，单击右上角用户名，会在下拉选项中显示导航页签。 打开方式 导航页签的打开方法。 当前窗口：选择该导航页签后，在当前窗口打开页面。 新窗口：选择该导航页签后，在新窗口打开页面。 标签 导航页签的展示名称。 名称 导航页签在系统中的存储标识，系统会根据“标签”取值自动生成。 图标 导航页签的展示图标。 描述 导航页签的描述信息。 配置完成后，单击页面上方的保存图标。

操作步骤 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“页面设置”。 在“视图”页签中，设置视图。 图1 设置视图 视图类型 电脑端 + 手机端：支持在Web和Mobile设备上显示。可通过设置“default”设置该站点默认显示视图。 电脑端：只支持在Web设备上显示。 手机端：只支持在Mobile设备上显示。 视图属性 宽度：该视图下站点的显示宽度。 高度：该视图下站点的显示高度。 列数：该视图下站点的显示栅格纵数。 默认：是否为默认视图。 操作：单击，可配置该视图下站点的分辨率、列数、是否默认。单击，可配置该视图下站点页面的页头前缀、页头后缀、Body前缀、Body后缀、页头、页脚、Cookie设置。该配置对此站点所有页面生效，例如在页头前缀中加入脚本或者设置style样式。 当前系统基于业务诉求，对开发者开发的脚本无法从机制上保证安全，需开发者自行保证安全。

应用模板的分类 应用模板涵盖了人事管理、行政办公、问卷调查，以及通用应用等领域，您可以直接使用应用模板快速创建应用，基于应用模板创建应用后，用户还可快速定制和扩展应用，满足自身业务的个性化诉求。 AppCube低代码典型的应用模板如下所示，其他模板介绍请以界面提供的为准。 应用页面支持PC和Phone适配，本文截图以PC端展示为例进行说明。 调查问卷 为企业和个人提供问卷模板，用于收集资料或管理问题记录。该模板以对应用魔方AppCube开发者展开调查问卷为例，您可基于该模板快速自定义调查问卷内容。 智慧烟感 该应用模板提供了常见消防安全应用所涉及的设施管理应用、设备BO、告警BO以及GIS BO等多种资产，使用该模板您可快速接入IOT设备，创建智能烟雾感应用，完成设备数据的接入、处理分析以及告警监控功能。 健康打卡 助力企业或者组织管理者完成员工健康打卡管理，健康打卡包括每日健康打卡、发烧情况跟进、健康打卡管理和发烧跟进管理。 出差 帮助企业快速创建出差申请及审批流程，提高出差审批效率。 财务报销 帮助企业用户快速处理财务报销流程及业务。

增加Action操作 基于该订单聚合对象定义增加操作。 在左侧“操作”下单击“+”，设置增加操作参数。 图8 增加操作 表4 “Property”区域参数说明 参数名称 参数说明 标签 Action在界面的展示名称。 名称 该Action的唯一标识。 操作类型 Action类型。 Flow Action：引用已创建的服务编排Flow执行操作。 Script Action：引用已创建的脚本执行操作。 服务编排/脚本 系统中具体的服务编排Flow或者脚本。 描述 该操作的描述信息。 Flow/Script入参 展示该服务编排或者脚本的输入参数。 Flow/Script出参 展示该服务编排或者脚本的输出参数。 单击“添加操作到聚合对象”。 单击页上方保存图标进行保存。 验证新增的“Insert” Action操作。 在该聚合对象编辑页面，单击选择该聚合对象名称。 图9 选择对象名称 在“属性”页面选择“Insert”操作，输入相关入参，单击“执行”。 图10 执行“insert” 弹出成功提示框。表示执行“Insert”操作成功。关闭该提示框。 使用预置的“查询” Action查询聚合对象数据记录。 在左侧“操作”下单击“查询”，为系统预置的查询聚合对象接口。 在右侧“属性”页面选中“输入根节点记录Id”，在“根节点记录Id”中输入插入数据的记录Id。若可以查出与根节点对象所关联的所有节点对象的数据记录，表示该聚合对象设置成功。 “根节点第一条记录”为查询根节点第一条记录相关的所关联的所有节点对象的数据记录。 “输入根节点记录Id”为查询根节点某条记录相关的所关联的所有节点对象的数据记录。 图11 查询数据

场景描述 新建一个订单聚合对象，该聚合对象里产品对象通过Lookup关联价格、库存子节点对象，并基于该订单聚合对象定义增加操作；再通过属性配置关联客户对象。 表1 对象说明 对象名 自定义字段名 字段类型 字段说明 Product__CST description__CST text 产品描述。 Price__CST product__CST Lookup 产品描述。该字段的取值来源于“Product__CST”对象。 price__CST Currency 产品价格。 Stock__CST remain__CST Number 库存数量。 product__CST Lookup 产品描述。该字段的取值来源于“Product__CST”对象。 Customer__CST - - -

创建聚合对象并通过Lookup关联子节点对象 鼠标放在App下的文件夹旁会出现加号，单击加号，选择“聚合对象”。 选择“创建新的聚合对象”，输入基本信息后单击“添加”。 图1 新建聚合对象 表2 参数说明 参数名称 参数说明 标签 该聚合对象的显示标签名。长度不超过64个字节。 名称 该聚合对象的名称，唯一标识，系统自动生成。长度不超过255个字节。 描述 用于描述这个对象。 在“聚合根”中选择根节点对象。 根节点对象为该聚合对象的基础对象。这里根节点对象设置为“Product__CST”。选择根节点对象后，该节点对象的所有字段详情会显示在右下侧区域空白处。 图2 设置根节点对象 单击节点对象详情框中的“+”，选择与根节点关联的对象“Price__CST”，添加关联对象。只能向子对象进行关联。 图3 选择关联对象 选择两个对象之间关联字段“product__CST”。 两个关联对象之间可能会有多个字段进行关联。这里选择希望进行关联的具体字段。 图4 选择关联字段 选择关联字段后，关联对象“Price__CST”的所有字段详情会显示在区域中。两个关联对象之间会有连线，连线上显示关联的具体字段标签。 图5 关联结果 参考4~5，添加与根节点关联的对象“Stock__CST”。 图6 添加关联对象“Stock__CST” （可选）您可单击节点名称，在右侧“Properties”区域设置“Label”参数取值设置节点名称，以便区分不同节点。 图7 设置节点名称 表3 节点名“Properties”区域参数说明 参数名 说明 标签 该节点在界面上的展示名称。可编辑。 名称 该节点的唯一标识。可编辑。 实体对象 该节点对象名。不可编辑。 对象字段 所用到的该节点对象的字段。目前只能选该对象全部字段，不支持选择部分字段。 父对象 该节点对象的父对象。 子对象 该节点对象的子对象。 单击页面上方保存图标，保存该聚合对象设置。 保存后，节点展示名称“标签”取值可更改，节点对象关联关系也可修改。

操作步骤 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“页面设置”。 应用创建后，默认该应用站点处于被解锁状态，“页面设置”页签最上方分别表示锁定、解锁、保存和发布该站点所有页面。 在进行高级页面相关配置前，需要先单击，在弹出的提示框单击“确认”，锁定页面设置。 锁定后，该站点所有页面将会被自动保存并更新至最近版本。 在“常用”页面，配置页面的基本属性。 表1 页面常用配置 参数 说明 站点名 系统默认生成的站点名，不可修改。创建应用时，系统默认会创建并分配一个站点。 站点域名 站点的运行态域名。一般情况下不需要修改，如果您的站点有单独的CDN和域名，则可以在此修改域名。 主页 站点的首页。站点存在页面时，该参数才会显示。 站点导入/导出 导入或导出站点文件，包括站点元数据。 在“插件”页面，可查看并管理当前应用已引用到的所有插件，包括组件、桥接器以及事件/动作。 在“资源”页面，可查看并引用应用需要的Library。 在“属性”页面，可配置站点属性。 站点设置 合并并压缩资源：勾选后，在发布该应用时，对应用中所有高级页面涉及的css和js文件进行合并及压缩，这样可以有效降低运行时服务器压力，但从终端浏览器首次访问该站点页面时，访问时间会稍微增加。 资源延迟加载：勾选后，在body标签中加载资源。 包含HTML5的DOCTYPE标签：勾选后，在发布后的页面中包含HTML5的DOCTYPE标签。 站点属性：单击“新建站点属性”，可添加新的站点属性。 client id：应用ID，不可以修改和删除，是系统预置属性。 client secret：应用认证的密钥，不可以修改和删除，是系统预置属性。 tenant id：租户ID，不可以修改和删除，是系统预置属性。 配置完成后，单击页面上方的保存图标。

定义自定义对象的字段（Fields） 自定义对象创建完成后，系统默认预置了一些标准字段，为了满足业务需求，往往还需修改标准字段或新建自定义字段，字段就是对象的属性描述。 本节主要介绍手动创建自定义字段，AppCube还支持批量创建自定义字段，详细操作请参见如何使用对象的字段模板批量创建自定义字段。 当前平台支持创建的字段类型如下表所示，您可以根据实际需要，使用对应字段类型进行创建。 表4 字段类型 字段类型 字段说明 文本 任何字母和数字组合，最多可输入255个字符。 加密文本 任何字母和数字的组合，并且以加密格式存储，最多可输入111个字符。 须知： 该类型字段不能唯一，不能建索引，不能用于条件字段及公式字段。 文本区 允许用户输入多行文本，最多可输入1024K字符。 数字 允许用户输入任何数字。保存数据时，会删除前置零。 百分比 允许用户输入百分比数字（例如，"10"），并自动向数字添加百分号。 电话 允许用户输入任何电话号码，并自动将其转换为电话号码格式。 币种金额 允许用户输入美元或其他币种金额，并自动将其转换为币种金额格式。 日期 允许用户输入日期或从弹出式日历中选择日期。 日期/时间 允许用户输入日期和时间，或从弹出式日历中选择日期、并自动获取当前时间。 电子邮件 用户输入电子邮件地址时，将对其进行验证以确保格式正确。 复选框 允许用户选择“真”（选取）或“假”（不选取）。 选项列表 允许用户从定义的列表中选择值。 选项列表（多项选择） 允许用户从定义的列表中选择多个值，最多可存放12个选项值。 URL 允许用户输入任何有效的网址。当用户单击该字段时，该URL将在单独的浏览器窗口中打开。 查找关系 通过关联当前字段与另一对象的ID字段，创建本对象与另一对象的引用关系。定义了查找关系后，本字段的取值只能来源于关联对象。 自动编号 系统使用您定义的格式生成序列编号，该编号对于每条新记录会自动递增。 公式 系统使用您定义的公式表达式生成只读字段，表达式中使用的源字段值变化时，本字段值同步更新。 主从关系类型 通过关联当前字段与另一对象的ID字段，创建本对象与另一对象的主从关系。定义了主从关系后，本字段的取值只能来源于关联主对象。并且，当用户删除关联主对象中的数据时，本对象中的从数据也会被删除。 多语言 允许用户从自定义资源表中选择多种语言内容。 预置的标准字段，仅name支持修改，如果有需要，您可以参考以下操作修改系统预置的标准字段name的标签： 在对象配置页面，单击“标准字段”页签，可以看到系统预置的标准字段。系统会为对象的每一条记录自动创建一个name字段，作为该条记录的标识。 本任务中将其用于标识出班级的名字，如20届一班。单击，可以修改字段的标签。 图8 系统预置字段 下面将以创建班级Class对象中的“班级编号number”字段为例，为您介绍如何在低代码平台对象界面中，跟随页面提示创建一个自定义字段。 新建自定义字段班级编号（number）。 在“自定义字段”页签，单击“新建”。 图9 新建自定义字段 字段类型选择“数字”，单击“下一步”。 图10 字段类型 设置“班级编号”字段的详情信息，单击“下一步”。 图11 字段详情 表5 参数说明 参数 说明 标签 字段在界面的展示名，此处配置为“number”。 名称 单击输入框系统自动生成，表示字段在系统中的记录值。 字段帮助 字段提示的帮助信息。 描述 字段的描述信息。 数据长度 字段的字符长度，数字类型长度默认为18。 小数点后位数 根据实际需求设置。 默认值 该字段默认取值。 是否必填 勾选表示是必填字段。 是否唯一 勾选表示字段唯一。 是否可搜 是否能在前端开发者控制台或脚本中使用search语句搜索该字段。 只有加密文本、选项列表、选项列表（多项选择）和公式类型以外的字段才会有该参数配置。 search语句可以理解为sql语句的子集，系统支持大部分常用的sql查询语句，只需把sql查询语句开头的select关键词修改为search即可。 search语句特点和限制如下： search语句当前对分组、通配符、去重distinct等功能暂未支持。 search语句不支持通配符，in查询可进行模糊查询。 search语句除了聚合函数（AVG、COUNT、MAX、MIN、SUM），其他必须带有where从句，否则报错。 字符串类型默认都转为es中text类型，因此可以实现分词的倒排索引。由于默认未设置Fielddata=on（会很耗性能），所以字符串类型无法排序。 不支持search语句where从句中有非可搜索字段，如不支持search from myobject where t1 = 'abc' （此处t1为非可搜字段）。 search语句目前只可进行单表搜索。 search语句不支持HAVING子句、OFFSET。 search语句不支持同时普通查询和聚合。例如：不支持“search count(列名)，列名 from 列表名;”。 search语句不支持列表名别名后“.*”全部查询。例如：不支持“search T.from 列表名 as T where condition条件;”。 text类型采用了英语分词器，因此大小写单复数不敏感，“movie”可匹配“Movies”。 同sql语句一样，search语句也大小写不敏感。 设置“班级编号”字段的访问权限，即设置哪些权限集可以查看或修改该字段，然后单击“下一步”。 图12 字段权限 AppCube预置了一些权限集，并提供了自定义对象中字段级的安全控制，这些权限配置是由管理员预置的，权限集介绍及设置方法的详细介绍，请参见了解权限配置。 设置“班级编号”字段是否加入布局。该配置用于将“班级编号”字段加入到对象默认的布局页面。 图13 加入布局 对于租户创建的自定义对象，系统会自动创建对象的页面布局：Detail和Records。自定义对象的页面布局是AppCube提供的一种管理对象的方式，自定义对象页面布局详细介绍请参见如何使用布局增删改查对象数据。 单击“保存”，字段则创建成功。 自定义字段创建后，系统会自动为自定义字段添加“__CST”后缀，以及命名空间前缀。 （可选，当需要给对象创建索引字段时，请执行该步骤）在“自定义字段”页签单击“自定义索引”，在弹出的页面单击“添加自定义索引”。 图14 添加自定义索引 表6 “添加自定义索引”页面参数说明 参数 说明 名称 自定义索引的名称。 类型 索引类型。 普通索引 唯一索引 唯一索引字段的字段取值必须唯一。 字段 从下拉框选择已创建的自定义字段作为索引字段。 默认最多只能创建一个索引，每个索引中最多创建两个索引字段。 创建后，索引字段会显示在“自定义索引”页面，您也可单击删除索引。

场景描述 本章节从如何新建对象，到定义对象的字段来添加属性，让您快速熟悉数据对象建模的过程。 示例：以新建一个班级Class对象为例介绍如何进行数据对象建模。在班级Class对象，将会添加一个自定义字段班级编号number，并给name（标准字段）和number赋值。 表2 对象的字段 对象 字段来源 字段名称 字段数据类型 Class 标准字段，不需要创建 name 文本 自定义字段，手动创建 number 班级编号

创建自定义数据对象 创建班级管理系统App应用，创建操作请参见从空白开始创建一个全新的应用。 将鼠标放在应用视图下的Model文件夹上，单击，选择“对象”。 图3 新建对象 选择“创建新对象”，输入基本信息后单击“添加”。 图4 新建Object 表3 新建对象参数说明 参数名称 参数说明 标签 对象展示名称，例如Class。 名称 输入标签值后单击该参数的输入框，系统会自动生成对象的名称。例如Class，您可以根据需要修改。 系统会自动增加租户命名空间前缀及“__CST”后缀，作为对象的唯一标识。 描述 对象的描述信息。 创建对象建议在应用开发工作台中进行创建。您也可以通过全局视图新建对象，如图5所示。两种方式创建的对象都是全局对象，在全局视图对象列表中都可查看到。不同点是在全局视图中创建的对象，可参考图6和图7在应用开发工作台目录中手动导入。一个自定义对象（即定制对象）只能被一个应用导入（标准对象可被多个应用导入），例如：应用A中导入全局视图中创建的自定义对象B后，其他应用不可再导入自定义对象B。 图5 全局视图新建对象 图6 应用中导入对象步骤1 图7 应用中导入对象步骤2

操作步骤 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“定时任务”页签，设置“显示名称”，该名称将会显示在运营配置页签。 单击“新建”，新建定时任务，也可以单击“导入”，选择系统中已创建的定时任务进行导入。 参照表1，设置定时任务参数，单击“保存”。 表1 定时任务参数说明 参数 参数说明 名称 新建定时任务的名称。 类型 选择定时任务的执行类型，支持脚本或服务编排。 服务编排/脚本 选择定时任务执行的脚本或服务编排。 任务首次执行时间 首次执行脚本的时间。 执行次数 定时任务执行次数，支持“仅执行一次”和“按设置的频率执行多次”。 执行周期单位 当“执行次数”配置为“按设置的频率执行多次”时，需要设置执行任务的时间间隔单位，如月、天、小时或分钟。 执行周期 当“执行次数”配置为“按设置的频率执行多次”时需要设置。 描述 该定时任务的描述信息，建议描述其用途。 定时任务创建成功后，默认为启用状态，在定时任务详情页单击“禁用”，可禁用定时任务。

场景描述 创建一个定时任务“OfferingOffline”，用于实现从2018-12-28开始，每天零点自动将过期商品下架。其中，将过期商品下架的功能由“OfferingOffline”脚本实现。 在创建定时任务前，需要先开发实现定时任务功能的Script脚本，Script脚本的开发可参考脚本开发。 本章节介绍的是在应用内配置定时任务，也可以在管理中心下创建定时任务，相关操作请参考创建定时任务。两者的区别是在应用里配置的定时任务，可在打包发布应用时，将定时任务一起发布，在管理中心设置的定时任务无法随应用发布。

如何使用选项列表 选项列表创建后，可以在对象模型、标准页面、决策表中使用。 当对象的某字段类型为“选项列表”或“选项列表（多项选择）”时，可引入已有的选项列表。在“值”下方选中“全局选项列表”后，可以在右侧的选项列表里选中当前应用下定义或者导入的选项列表。 标准页面下拉框组件中设置选项列表，在下拉框“属性”下的“选项列表”中单击齿轮图标，在弹窗中搜索需要用到的选项列表，单击“确定”。 在标准页面与在对象中调用不一致的内容：在对象中能选择的选项列表是应用级的，即当前应用下配置里的选项列表可用；但是在标准页面里是可以选择全局选项列表的，如果标准页面里选中的全局选项列表，需要在配置里导入或者定义，否则在打包应用时，可能会因为选项列表的缺失而导致下拉框空白现象。 BPM中决策表的出参、入参类型为选项列表时，可引入已有的选项列表。

如何创建选项列表 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“选项列表”页签，设置“显示名称”，该名称将会显示在运营配置页签。 单击“新建”，新建一个选项列表，也可以单击“导入”，选择系统中已创建的选项列表进行导入。 输入标签、名称，在“值”区域单击“新增”并输入值的标签和值。 图1 配置选项列表 表1 参数说明 参数名称 参数说明 标签 选项列表在用户界面展示的名称，必填字段，可以由字母，数字，下划线组成。 名称 选项列表的唯一标识，供AppCube的其他区域引用选项列表时使用。 值/标签 选项列表的一组可选值在用户界面展示的名称。 值/值 选项列表的一组可选值。 单击“新增”可添加选项列表值。 单击“新建”，返回选项列表页面。 在选项列表中，单击刚创建的选项列表。 系统显示选项列表详情页面，在详情页面中，可以修改此选项列表的标签名、描述和值，启用或者禁用选项列表。也可以单击某个选项列表值后的编辑按钮，勾选某个值的“默认”选项，单击“保存”，设置该值为默认值。 图2 选项列表详细信息

如何创建错误码 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“自定义错误码”页签，设置“显示名称”，该名称将会显示在运营配置页签。 单击“新建”，新建错误码，也可以单击“导入”，选择系统中已创建的错误码进行导入。 配置错误码参数，单击“保存”。 图1 新建错误码 表1 错误码参数说明 参数 参数说明 名称 用户自定义的错误码名称，长度不能超过64个字节，包括命名空间。 例如：配置为“Error001”。 系统会根据“名称”和“语言”匹配错误码进行展示，请确保“名称”、“语言”是唯一的。 类别 新增错误码所属的分类。 Http状态码 Http协议状态码。 语言 请根据实际情况从下拉列表中，选择语言类型。目前支持中文、英文、西班牙语、法语和缅甸语。 单击“新增”，支持创建多语言错误码。 若支持的语言未在下拉框中显示，可单击语言后的，再单击“翻译工作台”，跳转到翻译工作台配置页面，添加支持的语言。 格式 新增错误码的信息描述，长度不能超过255个字节。 在描述中，可以用{Number}表示变量名。例如， {0} 表示第一个输出变量，{1} 表示第二个输出变量，以此类推。 例如：配置为“这个是{0}的报错：{1}！”。

如何使用错误码 在脚本里使用错误码： 通过新建脚本将上文创建的错误码抛出，在脚本中增加抛出错误信息的context函数setI18nError('错误码名称','变量1','变量2')。 在应用开发页面，创建一个新脚本。 鼠标放在应用开发工作台的某一文件夹旁会出现加号，单击加号，选择“脚本”。选择“创建一个新脚本”，输入脚本名称，单击“添加”。 在脚本编辑器中录入如下代码，并单击上方按钮区域的保存图标。 import*as context from'context';context.setI18nError('命名空间__Error001','测试用例','脚本使用错误码的用例解读') 测试执行脚本。 单击代码编辑器上方的，执行脚本。在页面底部，单击测试窗口右上角的图标。在“输出参数”页签，可查看到抛出的错误码信息，如图2所示。 图2 运行脚本后显示界面 单击代码编辑页面上方的，启用脚本。 在服务编排里使用错误码： 在“全局上下文”中，新建公式变量，使用表达式SETI18NERROR(ErrorCodeName','变量1','变量2')方式引入错误码。 图3 服务编排里使用错误码 目前BPM中错误码由BPM调用的脚本和服务编排抛出。

场景描述 新增、查询系统参数并进行修改。系统参数创建后，可以在其他地方以{!parameter_name}方式引用。例如，在如下两个场景使用系统参数： 将系统公用邮箱设置为系统参数。 将系统定时数据清理的执行时间设置为系统参数。例如系统执行数据清理任务时，会自动查询是否配置了系统参数“bingo.expiretask.execute.time”（AppCube已预置该系统参数），查询到后，会按照配置的时间来启动数据清理 本节介绍的是在App内配置系统参数，您还可以在管理台下创建系统参数，相关操作请参考配置系统参数。两者的区别是在App里配置系统参数，可在打包发布App时，将系统参数一起发布出去，在管理台设置系统参数无法随App发布出去。

如何创建系统参数 登录低代码开发页面。 在我的应用中，单击对应的应用，进入应用开发页面。 在页面左下角，选择“配置”，进入应用配置页面。 在“系统参数”页签，配置“显示名称”，该名称将会显示在运营配置页签。 单击“新建”，新建参数，也可以单击“导入”，选择系统中已创建的系统参数进行导入。 配置相关参数，单击“新建”。 表1 参数说明 参数 参数说明 使用命名空间 系统参数名称中，是否加“命名空间__”前缀。 勾选该选项时，可确保跨租户全局唯一。 名称 系统参数名称，名称需要能尽可能的表明参数的业务含义，避免与其它参数混淆。建议您使用“APP/BO名称_系统参数名称”来命名。 例如：APPName_MaxValue。 值类型 系统参数取值类型。 时间 文本 数字 布尔 值 参数取值，根据所选的不同参数类型来设置参数取值。 文本类型的值可以设置是否加密。 描述 系统参数的简要说明。 是否默认 打包时，是否保留当前参数的取值进行打包。 是否加密 值是否加密保存。 当值类型为“文本”时，该参数才会显示。 权限 配置哪些权限可以读取该系统参数。

如何使用系统参数 系统参数创建完成后，可在脚本、服务编排、流程编排BPM和数据接入中使用。 脚本：脚本代码引入系统参数的代码行中，引入“sys”系统库，并使用“sys.getParameter('系统参数名')”引入系统参数。 例如，脚本里编辑如下代码，执行脚本，不用输入入参，查看“日志”页签打印的日志。 import * as sys from 'sys'; let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); console.log("MaxValue:", sysParam); 服务编排：在服务编排的“全局上下文”中，新增公式变量，表达式输入“SYSPARAMETER('系统参数名')”，引入系统参数，注意数据类型保持一致。 BPM：在BPM的“全局上下文”中，新增相同数据类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('系统参数名')”，引入系统参数。 数据接入：在数据接入的输入源“添加5G消息”页面勾选“引用变量”，以“{!系统参数名}”方式引入系统参数。注意数据类型要符合数据接入定义的要求。 图1 数据接入中引入系统参数 Rest服务连接器：在Rest服务类型连接器（自定义连接器）的“动作”页签，单击“新建”。在“新建REST Action”页面的URL内，使用“{!系统参数名}”方式引入系统参数。 图2 “Rest服务”连接器中引入系统参数

如何在脚本、服务编排、BPM中加密数据？ 用户使用AppCube的脚本、服务编排、流程编排BPM等开发的内容是不会加密存储的。如果用户需要加密数据，请使用加密类型的系统参数。 参考如何创建系统参数中操作，新建加密类型的系统参数。 例如，appClientId，注意要勾选“是否加密”。 图3 进入新建系统参数页面 图4 新建appClientId系统参数 在脚本、服务编排、流程编排BPM中，使用上一步创建的系统参数。 脚本：脚本代码中引入系统参数的代码行中，引入系统库，并使用“sys.getParameter('appClientId')”引入系统参数。 import * as sys from 'sys'; ...... let cliendId = sys.getParameter('appClientId'); 服务编排：在服务编排“全局上下文”中新增公式变量，表达式输入“SYSPARAMETER('appClientId')”，引入系统参数。 BPM：在BPM的“全局上下文”中，新增文本类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('appClientId')”，引入系统参数。

操作步骤 在App视图下左侧菜单栏下方选择“配置”，在打开的页签选择“数据导入模板”。 配置“显示名称”，该名称将会显示在运营配置页签。 单击“新建”。 您也可单击“导入”，选择系统中已创建的模板进行导入。 配置参数信息。 图1 定义模板 表1 参数说明表 区域 参数 说明 基本信息 名称 数据导入模板的名称。 脚本 提前定义好的数据处理脚本。 您需要在脚本中声明一个集合属性的入参，脚本中入参的变量名与Excel模板中入参变量名保持一致。 描述 该数据导入模板 Excel映射 名称 定义输出到脚本的入参变量名，请和脚本中入参变量名保持一致。 列 Excel模板中具体的列。按照顺序定义，例如：A、B、C。 表头 Excel模板中第一行的列名。 操作 复制或者删除操作。 单击“保存”。 在“数据导入模板”列表页面该模板所在行单击，下载模板到本地，录入数据并保存Excel。 导入数据。 在“数据导入模板”列表页面该模板所在行单击，在导入页面拖入上一步录好数据的Excel，单击“导入”，上传数据。 图2 导入数据 页面弹出提示框“导入成功后您将会收到邮件”。单击“确定”。 界面跳转到“数据导入”页面，等待导入任务的状态为“Completed”后，在该页面查看具体导入结果。

场景描述 本节介绍的是在App内创建业务权限凭证，您还可以在管理台下进行配置，相关操作请参考设置业务权限。两者的区别是在App里创建业务权限凭证，可在打包发布App时，将业务权限凭证一起发布出去，在管理台创建业务权限凭证无法随App发布出去。 通过该章节创建业务权限后，参考设置业务权限在权限配置的“业务权限凭证”页签配置用户的业务权限。在自定义接口URL时，可通过配置该业务权限，控制只有该业务权限的用户才可访问自定义接口URL。自定义接口的业务权限配置可参考如何自定义调用脚本的URL和如何自定义调用服务编排的URL。

新增多语言资源 在App视图下左侧菜单栏下方选择“配置”，在打开的页签选择“翻译”。 配置“显示名称”，该名称将会显示在运营配置页签。 配置翻译任务，单击“保存”。 参数说明如表1所示。 表1 参数说明 参数 说明 语言 选择要翻译的目标语种。翻译员被分配到某个语种的翻译，才可在此选择。 组件 需要翻译的组件。系统支持以下几种。 菜单 定制配置 标准对象 自定义对象 标准字段 自定义字段 按钮或链接 选项 选项值 审批流 触发器 服务编排 BPM 状态机 脚本 事件 数据接入 事件流 报表 仪表板 系统参数 自定义应用程序 当“组件”设置为“菜单”时，该参数才会显示。您需要设置待翻译的菜单属于具体哪个应用程序。 对象 当“组件”设置为“标准字段”、“自定义字段”或者“按钮或链接”时，该参数才会显示。您需要设置待翻译的内容属于具体哪个对象中。 方面 当“组件”设置为“标准字段”、“自定义字段”等时，该参数才会显示。表示需要翻译的内容属于哪一方面，取值说明如下。 字段标签：字段的标签 字段帮助：字段的帮助内容 主题：工作流任务的主题 评论：工作流任务的评论 选项列表 当“组件”设置为“选项值”时，该参数才会显示。您需要设置待翻译的选项值是属于哪个选项列表。

操作步骤 在开发环境“首页”下单击应用上的齿轮图标。 如果应用类型为轻应用、行业应用、Addon应用、5G消息。则说明如下： 基本：该页签下可修改设置以下参数。 标签：应用的展示名称。 运行时版本：该应用兼容配套的运行环境版本，默认会选择最新的运行环境版本。该应用是基于所选的运行时版本进行开发的，打包编译时是基于该版本进行编译的，打出的包后续在该版本运行环境部署上线时，不会产生兼容性问题。若在其他版本运行环境上线，可能会有兼容性问题。 描述：轻应用的描述信息。 服务：可查看应用引用的其他应用、BO以及Native Service信息。 应用组件：可查看并删除该应用的组件（例如标准页面、BPM、脚本等）。 如果应用类型为BO或者Native Service。则说明如下： 基本：可查看应用的基本信息，包括标签、名称、所有者、分类、标志、描述和运行时版本。 服务项：可查看并删除该应用的组件（例如标准页面、BPM、脚本等）。 API和事件：可查看BO所有对外的API和事件。 应用：可查看应用引用的其他应用、BO以及Native Service信息。

创建常量 在服务编排编辑器页面右侧选择。在全局上下文页面单击“常量”后的加号。 单击新增常量后的“...”，选择“设置”。 设置页面参数，单击“保存”。 图3 配置常量 表2 常量参数说明 参数名 参数说明 如何配置 名称 常量名称，必填。 直接填写。 数据类型 常量的数据类型，必填。 文本 数字 货币 日期 日期/时间 复选框 在下拉框里选择需要的类型。 值 常量取值，必填。 手动输入值作为常量值。 描述 该常量的描述信息。 选填项，一般建议填写常量的作用。

创建普通变量或者集合变量 在服务编排编辑器页面右侧选择。在全局上下文页面单击“变量”后的加号。 图1 创建变量 单击新增变量后的“...”，选择“设置”。 设置页面参数，单击“保存”。 图2 配置变量 表1 变量参数说明 参数名 参数说明 如何配置 名称 变量名称，必填。 直接填写。 数据类型 变量的数据类型，必填。 文本 数字 货币 日期 日期/时间 复选框 任意 在下拉框里选择需要的类型。 默认值 变量的默认取值。 若需要配置默认值，请直接填写。 描述 该变量的描述信息。 选填项，一般建议填写变量的作用。 是否为数组 是否为数组型变量即集合变量。 勾选表示为数组。

创建公式变量 公式变量主要用于变量赋值，表达式计算，参数传递等。 在服务编排编辑器页面右侧选择。在全局上下文页面单击“公式”后的加号。 设置页面参数，单击“保存”。 图4 配置公式变量 表3 公式变量参数说明 参数名 参数说明 如何配置 名称 公式变量名称，必填。 直接填写。 数据类型 公式变量的数据类型。 文本 数字 货币 日期 日期/时间 复选框 结构体 在下拉框里选择需要的类型。 描述 该公式变量的描述信息。 选填项，一般建议填写公式变量的作用。 表达式 表达式。 若表达式中需要运用公式，您可根据需要双击“公式”区域中系统预置的公式，该公式会显示在右侧“表达式”区域中。当表达式中需要有变量参数时，您可从变量区域中直接选择变量拖入到表达式中。