配置电子表格——清单表（表格版）

前提条件

• 拥有一个先胜云账号，由空间管理员授权拥有对 电子表格 组件的操作权限。

• 应用中已配置所需数据表。

创建步骤

1. 在 元素管理 界面，点击 + 新建 > 电子表格 > 清单表，会进入清单表的首页。

   

2. 按需设置清单表属性，并配置工作表。

3. 添加数据表，将数据表的字段拖拽到 页面 和 展示列 上，并按需配置页面及展示列字段。

4. 点击右上角 保存 按钮，弹窗中填入编码等必填信息后点击 确定，即完成清单表的创建。

.. note:: 电子表格——清单表首次创建时，必须添加数据表并配置展示列字段，否则无法保存成功。

设置工作表属性

点击编辑视图中工作表，可以设置工作表相关属性：

工作表属性信息如下：

如图为配置完的使用视图。如果想要对整张表进行数据录入，需要把每个字段以及工作表都开启 允许编辑。

添加工作表

点击当前工作表右侧的 +，可添加 sheet 页。支持创建数据透视表、固定格式报表、清单表三种类型的表单，也可通过脚本创建上述表单。

工作表排序

点击 当前工作表 后的下拉按钮打开下拉选项，下拉选项显示当前的工作表列表，可以通过拖拽改变顺序。

切换到 使用 视图，工作表顺序一致，且默认打开的是编辑视图的当前工作表。

删除工作表

鼠标悬停于当前工作表，出现 删除 图标，点击可删除当前工作表。

添加数据表

点击添加按钮，并在弹窗中选择需要的数据表。

点击数据表左侧的三角图标，展开该数据表的字段。

添加数多张据表

支持将多张有共同字段的数据表同时添加到一张清单表中，展示列中可以添加多张表中的字段。

1. 点击图中 + 图标位置，添加另一张数据表。

   

2. 关联 区域会增加一行，左侧选择框默认选第一张数据表，右侧选择框默认选第二张数据表，用户可按需选择其他的数据表。

3. 关联 区域中点击 联接 图标，在 联接 弹框中选择联接关系。

   提供三种联接关系，下图用 leftjoin 举例（显示基表所有字段值，如果无法匹配到从表数据则从表字段显示为空）。

   .. csv-table:: 数据表关联 :header: 联接类型, 效果 :widths: auto

   leftjoin, 显示左侧表所有字段值 join, 只显示匹配的字段值 rightjoin, 显示右侧表所有字段值

4. 点击 联接 界面右侧的 + 按钮，添加基表和从表的关联字段。

   

5. 关联 区域点击 + 图标，可以添加多组关联关系。

   清单表默认以第一组左侧的数据表作为查询基表。

6. 把从表的字段拖入 展示列 中。

   

下图为同时展示两个数据表字段的清单表的使用试图。

配置字段

根据实际需求，将左侧数据表字段拖入 页面 和 展示列，点击字段，在右侧弹出的属性框中设置字段属性。

.. note:: 这里的页面和展示列上的字段可以重复。页面上配置的字段只能关联维度和值列表。展示列上字段可以设置其类型为 文字、数字、值列表、维度、日期时间、用户、自定义列表。

点击字段块，在逻辑属性栏位置配置维度及维度表达式。若在电子表格属性设置时开启了 启用变量 开关，维度表达式穿梭框中存在 全局变量 和 用户变量 标签页，也可选择变量。

字段可配置属性信息如下：

.. csv-table:: 字段配置信息 :header: 配置信息,配置类型,拓展字段,说明 :widths: auto

基本, , ,字段基本信息配置 序号, , ,根据界面 pov 的字段顺序排序，从0开始，不可编辑 别名, , ,默认设置为字段名称，必填可更改 名称（中文）, , ,默认设置为字段名称，非必填 名称（英文）, , ,默认设置为字段名称，非必填 详细信息, , ,字段的详细信息配置 数据库属性, , ,字段的数据库配置，自动从字段对应的数据表带来，不可修改 逻辑属性, , ,字段在清单表中的逻辑属性配置 字段类型,文本,长度,可修改 , ,作为快速搜索条件,在使用视图增加该字段搜索 ,数字,整数部分长度,可修改 , ,小数部分长度,可修改 , ,数值范围,可修改 , ,作为快速搜索条件,在使用视图增加该字段搜索 ,值列表,值列表,关联已配置的值列表元素 , ,值列表路径,显示关联的值列表所在位置，自动带出，不可修改 , ,值列表成员,选择值列表成员 , ,作为快速搜索条件,在使用视图增加该字段搜索 , 维度,维度,关联已配置的维度元素，必填 , ,维度路径,显示关联的维度所在位置，自动带出，不可修改 , ,维度表达式,配置该字段值的可选范围（可使用变量） , ,权限方案,关联已配置的权限方案 , ,权限方案路径,显示关联的权限方案所在位置，自动带出，不可修改 , ,角色/角色组,根据角色方案中【用户】-【角色】-【维度】的关联关系，控制使用用户拉下所能选择的成员范围，具体见 控制逻辑 , ,作为快速搜索条件,在使用视图增加该字段搜索 , 日期时间,日期时间内容,选择日期模式 , ,作为快速搜索条件,在使用视图增加该字段搜索 , 用户,作为快速搜索条件,在使用视图增加该字段搜索 , 自定义列表, 自定义列表, 输入多个预设值，用逗号分开 , , 作为快速搜索条件, 在使用视图增加该字段搜索 显示属性, , ,设置使用试图的显示效果 字段类型,数字,小数部分显示长度,设置小数部分可显示的长度 , ,百分比,勾选后，以百分比形式显示数字 , ,千分位,勾选后，显示数字的千分位符 ,值列表,值列表显示方式,成员值：仅显示值列表成员编码；描述：仅显示值列表成员名称；成员值-描述（默认）：以 编码-名称 显示。对值列表类字段必填 ,维度,维度显示方式,成员名称：仅显示维度成员编码；描述：仅显示维度成员名称；成员名称-描述（默认）：以 编码-名称 显示 , ,显示树形结构,勾选后，可选维度成员以树形结构展示，否则以列表形式展示，对维度类字段必填 ,日期时间,日期显示格式,选择日期时间显示的形式，对日期时间类字段必填 ,用户,显示信息,可选 昵称、用户名、邮箱、手机号，对用户类字段必填 列宽, , ,设置列宽，可选 默认（102像素）、小（70像素）、中（120像素）、大（200像素）、自适应、自定义，仅适用于展示列字段 隐藏, , ,勾选后，隐藏该列不显示，仅适用于展示列字段 列冻结, , ,勾选后，冻结该列，不可录入数据，仅适用于展示列字段 编辑和权限属性, , , 允许编辑, , ,该列数据允许编辑，默认勾选，仅适用于展示列字段 允许为空, , ,该列数据允许为空，默认不勾选，仅适用于展示列字段 启用权限控制, , ,勾选后，该字段可配置权限控制

配置自定义列

页面 和 展示列 可以配置自定义列。配置自定义列后，可以对使用视图上的数据进行 sql 语句操作后再进行展示。

点击 页面 或 展示列 最右侧的 + 图标，在 自定义列 弹框中输入：

• 自定义列SQL：输入数据处理的 SQL 语句，最大的输入字数为1024

• 自定义列别名：输入自定义列名称，必填

自定义列字段的 基本 属性设置可以输入 sql 语句，详细信息 配置与一般的展示列字段相同。

配置过滤条件、分组字段和排序字段

参考 配置清单表。

角色设置

1. 点击 角色设置 的下拉框，选择要关联的角色方案与角色/角色组。

   

2. 勾选清单表中用作角色字段的维度，并选择关联其在角色方案中的维度。

   

状态设置

在清单表中所有值列表类型字段中勾选，并关联值列表元素。用作状态字段的字段将添加在 权限设置 区域做值列表下成员的权限控制。

权限设置

仅勾选了 启用权限控制 的字段，才可以在 页面/展示字段 选择框中被选到。数据与按钮的权限，可通过直接配置字段或权限控制单元来控制字段的读写权限。