如何创建自定义应用程序

创建自定义对象

管理员登录进入系统后点击右上角的“⚙”--“设置”进入设置界面，当我们需要创建自定义对象时点击“对象设置”->"对象”界面右上角的“新建”按钮。

• 数据源：选择该对象所属数据源，该对象的数据将保存到指定数据源中，默认数据源使用的是mongodb数据库。
• 显示名：界面上将显示该名称来表示该对象。
• API名称：字段唯一标识符，只能包含小写字母、数字，必须以字母开头，不能以下划线字符结尾或包含两个连续的下划线字符。
• 图标： 为您的对象选择合适的图标。
• 开发状态：此对象的开发状态，“开发中”的对象只有管理员才可以访问，当对象相关功能已经就绪时，您应该把它设置为“已部署”。
• 备注：输入此对象的描述。
• 外部数据源：引用第三方数据库的数据。
• 功能开关：设置此对象上开放的功能，勾选表示开启相关功能。

设置对象字段

新建对象后，您需要进一步描述该对象有哪些属性，比如对于 “报价(offer)” 对象，您可能希望新建“报价编号(offer_id)“、”到期日期(offer_date)“、”报价名称(offer_name)“等字段。

自定义字段

新建的对象，默认只有4个字段，即“名称(name)”、“所有者(owner)”、“创建人(created_by)”、“修改人(modified_by)”。例如我们需要添加一个 ”报价名称” 字段，点击右上角的 “新建” 按钮弹出 “编辑 对象字段”窗口，填写必填项显示名称 ”报价名称“ 、字段名 “offer_name” 、字段类型 “文本”，点击保存即完成一个字段的创建。

• 所属对象：该字段所属对象，默认为当前对象。
• 显示名称：字段最终显示的名称，由用户自定义。
• 字段名：用来保存到数据库的字段名称，名称只能包含小写字母，数字，必须以字母开头。不能以下划线结尾或包含两个连续的下划线符号。
• 字段类型：根据需求设置该字段的类型。
• 默认值：设定字段的默认值，可以是固定值。
• 字段分组：在记录的显示页面和编辑页面，将字段分组显示。

字段显示公式

在高级-字段显示公式：该字段增加显示条件，示例："{{formData.type__c === 'leader' ? true: false}}"，当字段type__c等于leader值时，才显示当前字段，否则隐藏该字段。

与关联表建立联系

以“报价(offer)”对象为例，我们可能希望描述每份报价关联客户是谁，此时我们可以新建一个“客户(client)”对象与之关联，关于如何创建业务对象关联的方法请阅览相关表字段类型。

建立主表/子表关系

在相关表字段的基础上，可以额外设置两个对象间的主表/子表关系，比如 “报价(offer)” 中可能需要引用 ”业务机会“ 对象，字段类型设置为主表/子表，引用 “业务机会“ 对象 。使用方法和相关表一样，区别在于设置为主表/子表类型的字段可以在“相关子表”里设置关联子表显示的列。有关如何使用的详情信息请阅览主表/子表字段类型。

配置列表视图

列表视图是用来定义前台数据列表展示的数据，您可以自定义需要显示的字段，从不同的维度定义视图展示不一样的数据，设定筛选条件和排序规则等参数。例如“报价(offer)”对象，您可能希望有一个“我的报价”列表视图来展示“报价编号(offer_id)”、“报价名称(offer_name)”、“报价客户(offer_client)”、“状态(state)”等多个数据。用户在界面上可以很方便快捷的切换列表视图、添加筛选条件、查找数据、新建视图等等。如何自定义列表视图。

关于对象功能开关

• 允许搜索：此对象可以通过全局检索查询。
• 允许上传附件：此对象可以上传附件。
• 允许添加任务：此对象中的业务数据，可以添加任务。
• 允许添加备注：此对象中的业务数据，可以添加备忘。
• 允许添加事件：此对象中的业务数据，可以添加任务。
• 允许共享记录：启用此功能可以设置该对象对于其他对象的记录共享。
• 允许配置对象流程：只有启用此功能的业务对象，才能显示在对象流程的配置菜单中。
• 允许查看申请单：此对象中的业务数据，可以进行审批。
• 允许添加留言：用户对数据可以添加留言。
• 记录字段历史：启用此功能后系统会自动记录此字段的修改记录。
• 允许编辑单个字段：只有启用此功能的业务对象，才能单个编辑字段数据。

关于对象权限

您可以设置该对象的权限，包括简档对该对象的操作权限，禁用列表视图、禁用操作、不可见字段、不可编辑字段、禁用关联对象等等。有关对象权限详细介绍请阅览对象权限

列表视图

概述

列表视图是用来定义前台数据列表展示的数据，您可以自定义需要显示的字段，从不同的维度定义视图展示不一样的数据，设定筛选条件和排序规则等参数。例如“报价(offer)”对象，可以定义所有报价、我的报价等多个视图。 用户在界面上可以很方便快捷的切换列表视图、添加筛选条件、查找数据、新建视图等等。

如何创建列表视图

新建的对象默认有两个列表视图，分别是：所有和最近查看。默认展示的数据只有“名称”一个字段。当用户需要添加新视图的时候，可以进入对象详情界面找到“列表视图”-->“新建”弹出“新建 列表视图”窗口。填写必填项显示名称“所有报价”、API名称“offer_view”、对象“报价”、过滤范围“工作区”、并把需要显示的列添加上去，设置它的宽度和是否换行。

• 显示名称：最终视图在界面中展示的名称。
• API名称：该名称作为API名称是唯一标识符，只能包含小写字母、数字，必须以字母开头，不能以下划线字符结尾或包含两个连续的下划线字符。
• 对象：该视图所属的对象，默认为当前对象。
• 过滤范围：有“工作区”和“我的”两个范围供用户选择，默认为“工作区”，用户也可以调整修改为“我的”，两者的区别在于“工作区”以当前整个工作区作为数据查找范围，而“我的”则只显示owner为当前登录用户的相关数据；
• 显示条目数：在视图名称右侧显示该视图一共有多少条数据。
• 显示的列：选择您需要展示的字段，并设置它的宽度和是否换行，点击下方的“新增一行”可以添加新的字段，若没有勾选 “是否换行”，表格中文字将始终显示为单行且超出部分显示省略号；
• 默认过滤的字段：过滤用户选择的字段不显示在视图中。
• 默认排序规则：选择您需要排序的字段，并指定排序方式（正序或者倒序），如果未配置，将按创建时间倒序来显示列表数据。

关于列表视图权限

用户可以设置权限集对于列表视图的权限操作，包括修改，删除，允许查看的字段，允许修改的字段等等。有关具体的示例请阅览权限集。

页面布局

在创建对象时，我们已经给对象增加了相应的字段，系统会自动生成对象记录的详情显示页面。

默认显示页面

系统默认的详情显示页面，主要包括以下内容：

• 对象信息，按字段的排序号，显示所有字段的值
• 操作按钮，包括：新建、编辑、删除等
• 相关子表的记录列表，并附新建按钮

如果希望修改这个显示页面，就可以自定义页面布局。

新建页面布局

其中，简档可选择“用户”

每个页面布局都需对应一个简档，关于内置/自定义简档的详情，会在后续课程中展开。这里，先理解为：每个用户都属于一个简档；除管理员外，其他用户都默认属于用户这个简档。

配置显示字段

默认列出所有的字段。

可以点击字段列表右侧按钮，删除不需要显示在页面上的字段，也可以点击页面首列上下拖拽来调整字段的显示顺序。

配置操作按钮

对象权限

对象的操作权限包括查看、创建、编辑、删除。举例来说，当用户点击“删除”按钮时，系统会校验用户所属简档和权限集下的所有对象权限的设置：如果对当前对象有“删除”的操作权限，则可以进行下一步操作；反之则不能继续操作。

哪里可以设置对象权限？

在简档和权限集里，都可以设置对象权限。 在权限集里，点击某权限集名称、进入详情页，在对象权限一栏，点击具体对象后面的下拉框即可进行权限设置。对简档进行设置，也是同样的方式。

如何创建对象权限？

在简档和权限集，点击显示名称进入详情页，在对象权限右上角可以看到新建按钮，点击即可进行创建。 在权限集输入框选择将要授权的权限集，选择将要授权的对象，设定某类用户对特定对象的所拥有的操作权限。

• 允许查看 勾选后，supplier可以查看合同对象相关信息。
• 允许创建 勾选后，supplier有权限在合同对象里面创建一条合同记录。
• 允许编辑 勾选后，supplier有权限对合同信息进行编辑。
• 允许删除 勾选后，supplier有删除合同对象的权限。
• 查看所有记录 勾选后，supplier可以查看所有的合同记录，通常可以为管理员配置此权限。
• 修改所有记录 勾选后，supplier可以修改所有的合同记录，通常可以为管理员配置此权限。
• 查看本分部 勾选后，supplier只能查看所属分部的合同记录，普通用户通常设置为此权限。
• 修改本分部 勾选后，supplier只能修改本分部的合同记录，普通用户通常设置为此权限。

以上各对象权限选项的意义也可以参考此图。

• 禁用列表视图 启用后，将不能看到对象的这些列表视图。例如，普通用户可以禁用“所有记录”这一项，而只展示“我的记录”这一项列表视图。
• 禁用操作 启用后，将不显示对象的操作按钮，也就不可以进行这些操作。例如，可以对普通用户禁用“发起审批”操作。
• 不可见字段 用于隐藏对象的某些敏感字段。比如，对普通用户隐藏合同对象的“合同金额”字段后，这些用户访问合同记录时，将不会显示“合同金额”字段。
• 不可编辑字段 对某个字段启用了不可编辑后，即不能对该字段进行编辑修改。比如对合同对象设置了不能编辑“名称”字段后，用户就不能修改合同的“名称”了。
• 禁用关联对象 启用后，相关联的对象将不会被启用。比如可以禁用合同里面的付款或者附件对象。

权限叠加规则

虽然每个用户只属于一个简档，但是可能同时属于多个权限集，当一个用户属于多个权限集时，实际拥有的权限为各权限集权限的叠加。权限叠加规则请参考下图。

如何撤销用户权限

如果要撤销某个用户的权限，一般有两种方式：一是在简档或是权限集里面，把对象权限的范围缩小，比如不允许创建、不允许编辑或删除等，但这样做，同时也缩小了属于此简档的其他用户的权限。第二种是把这个用户移出权限集，再重新为他配置特定的权限集权限。

创建自定义应用

建立好合同、付款等对象后，我们可以建立自定义应用：合同。

新建应用：合同

管理员，进入 设置》应用程序》应用程序，点击新建按钮，输入应用程序的名称、API名称等，选择好桌面主菜单、手机主菜单，点击保存按钮。

试用合同应用

建立自定义应用后，就可以进入应用，查看这个应用的具体情况了。

进入应用：合同

点击左上角的“应用程序启动器”图标，可以点击进入合同应用。里面已经有之前在预览时录入的数据。

查看合同详情页，不但显示合同的详情，也会将作为子表的付款记录列表显示。

经过上述的配置，我们就建立起了合同管理系统的框架。具备了合同应用的基本功能，比如管理合同，建立和跟踪合同的付款记录等。

软件包

经过上述步骤我们初步实现了合同应用的构架，我们还可以进一步通过安装软件包的方式来丰富合同管理系统的功能，比如项目管理软件包以增加项目管理模块等。

要安装软件包，请在“设置”应用中进入“应用程序→软件包”界面并点击右上角的应用商城来浏览和购买软件包，购买后的软件包可以在这里点击“安装已购买应用”来一键安装，安装后就可以在系统中使用这些软件包功能了。

选项卡

智企易码云平台新加了选项卡功能，设置好的选项卡会显示在页面顶部的Tab导航上，需要在“设置”应用中进入“应用程序→选项卡”来配置选项卡。

• 显示名称：选项卡的显示名称。
• API名称：选项卡的api名称。
• 图标：选项卡要额外显示的图标。
• 类型：选项卡类型，目前支持“对象”、“外部链接”和“页面”。
• 对象：从下拉菜单中选择该选项卡要关联到哪个对象上。
• 外部链接：该选项卡要关联到的URL地址，可以输入相对地址也可以输入绝对地址。
• 页面：从下拉菜单中选择该选项卡关联的页面。
• 显示在手机菜单中：是否显示在手机菜单中。
• 显示在桌面菜单中：是否显示在桌面菜单中。
• 描述：可以在这里输入选项卡备注。

对象选项卡

当选项卡类型为“对象”时，需要配置其要关联的对象，当用户在顶部导航点击该选项卡时会显示对象主页。

外部链接选项卡

当选项卡类型为“外部链接”时，需要配置其要跳转到的链接地址，这里可以输入系统内的相关地址，也可以输入外部的绝对地址。

值得一提的是在外部链接属性中输入的地址是支持公式脚本的，当需要给地址配置动态参数时可以通过设置公式脚本来实现。

通常来说我们会使用这种类型的选项卡来显示第三方应用，我们通常也会在这里输入带参数的仪表盘的访问地址，以向用户展示带参数的仪表盘报表，格式为/builder/[?动态参数，以p_开头]#/page/public/${pageApiName}[?hidden_title]，详细请参考仪表盘开发向导。

页面选项卡

这里的页面指的就是仪表盘，当我们想在应用中展示开发好的仪表盘报表时就需要配置该类型的选项卡，不过这种类型的选项卡只能配置出不带参数的仪表盘，需要指向带参数的仪表盘的话，只能使用上面提到的外部链接选项卡，详细请参考仪表盘开发向导。

统计分析

我们经常需要在系统中开发各种报表来展示统计分析数据，比如上面我们开发好的合同应用就可能会需要展示每年月度收款金额对比曲线图。