华为云用户手册

日期时间 日期时间组件用于记录时间信息，适用于填写出差、加班日期时间等场景，支持自动获取当前日期时间或自定义其他时间。 如果需要在页面显示当前日期时间，可使用“日期时间”，并勾选字段属性中的“禁用”属性，同时设置默认值为“当前日期”。 在表单开发页面，从“数据组件”中，拖拽“日期时间”组件至表单设计区域，如图1。 图1 日期时间 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 日期格式：系统已预置多种日期格式，请根据需要选择。 验证：对字段进行限制设置。 必填：该字段是否必填。 限定范围：是否限制日期时间的范围，支持选择当前日期和其他字段值。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 当前日期：选择当前时间作为默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

多选 多选组件用于一次性选择多个选项， 例如收集用户兴趣爱好时，可选用该组件。 在表单开发页面，从“数据组件”中，拖拽“多选”组件至表单设计区域，如图1。 图1 多选 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 排列方式：选项值的排列方式，如下拉、竖排、横排。 选项：选项设置。 打开“彩色”开关，选项值字体会不同颜色展示。 直接单击选项名，可设置具体选项值。 单击，可设置该选项值是否为默认值。 单击，调整选项顺序。 单击，可删除选项。 单击“新增选项”，可增加选项值。 单击“批量添加”，可批量添加选项值。 图2 批量添加 单击“问卷模式设置”，可设置是否开启“选项展示顺序随机 ”、“赋分值”、“选项互斥”及“选项关联”功能。单击界面上的，可查看到相关功能介绍。其中“选项关联”功能较复杂，相关介绍可参见如何设置选项关联。 验证：对字段进行限制设置。 必填：该字段是否必填。 限定选择个数：限制勾选选项的个数。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

富文本 富文本组件为升级版的文本的输入，支持填写图文并茂的内容。 在表单开发页面，从“数据组件”中，拖拽“富文本”组件至表单设计区域，如图1。 图1 富文本 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 行数：设置富文本默认行数，支持行高随内容自动调整。 验证：对该字段进行一些限制，设置为“必填”，表示该字段必须配置。 属性：设置字段属性。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 勾选“隐藏”后，单击隐藏后的“设置例外条件”，可设置该字段的显示条件。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

饼图 饼图组件用于实现饼图样式数据报表统计。在报表编辑页面，拖拽“饼图”组件到中间区域，右侧可设置组件属性。 图1 饼图 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 数据 扇区分区：选择哪些字段，作为饼图扇区分区字段。单击，可设置维度名称相同时是否合并。 第几个扇区后合并为其他：设置第几个扇区后，扇区合并为其他。 数值：选择展示数值的字段。设置后，单击，可设置数值汇总方式（如总和、最大值和最小值等）和饼图扇区数据为0时是否显示。 数据更新方式：图表是否需要实时更新，支持设置更新时间间隔。 筛选数据：单击“+添加筛选条件”，设置过滤条件。设置后，可根据条件统计数据。 外观 大小：设置图表的大小，如大、中或小。 样式：选择图表的样式。 布局：是否开启自动布局功能，默认为开启。如果不开启，可根据实际需求进行如下设置。 列表布局：设置图例的列表布局，如垂直、水平。 标签换行：是否开启标签换行。开启后，当标签字数超过设置的单行最多字数时会自动换行。 图2 标签换行 单行最多字数：设置图例单行最多显示多少字，取值为1~50。 图3 单行最多字数 列表项间距：设置图例列表项的间隔距离，单位px。 图4 列表项间距 图例位置(上边距)：设置图例到组件边框顶部的百分比。 图例位置(左边距)：设置图例到组件边框左侧的百分比。 图表位置(上边距)：设置图表到组件边框顶部的百分比。 图表位置(左边距)：设置图表到组件边框左侧的百分比。 图5 图表位置 属性：勾选后，页面上会隐藏该字段。 宽度：该组件框的宽度，占页面宽度的比例。 父主题： 统计页面组件介绍

数值 数值组件用于记录数字类型的数据信息，例如数量、年龄、库存、金额等。数值组件支持输入数字的最大有效长度为15位，数字较长时，系统会自动添加分隔符。如果有超过15位数字的输入要求，建议替换为文本组件。 在表单开发页面，从“数据组件”中，拖拽“数值”组件至表单设计区域，如图1。 图1 数值 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 保留小数位数：支持设置精确保留的小数位数，适用于金额录入等场景。 单位：数字的单位，例如“元”、“页”等，请根据需求进行设置。 显示：填写的数值是否允许为负数，默认允许输入负数，如-123。 验证：对字段进行限制设置。 必填：该字段是否必填。 限定范围：限定数值填写的范围，例如10.01-1000.99。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：字段配置框宽度占页面宽度的比例。 默认值：支持设置如下默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

图片 图片组件用于在页面展示图片。 在表单开发页面，从“通用组件”中，拖拽“图片”组件至表单设计区域，如图1。 图1 图片 显示名称：设置图片显示名称，默认隐藏显示名称。 选择图片：单击“上传图片”，上传需要展示的图片。 点击放大预览：勾选后，可放大预览图片。 移动端独立设置：勾选后，可给移动端单独设置展示的图片。 裁剪：单击“裁剪”，可裁剪图片大小。 图片比例：设置显示的图片比例。 对齐方式：选择图片的对齐方式。 宽度：该组件宽度，占页面宽度的比例。 属性：设置字段的属性，勾选“隐藏”后，页面上会隐藏该字段。 父主题： 零码组件介绍

金额 金额组件用于录入金额。 在表单开发页面，从“数据组件”中，拖拽“金额”组件至表单设计区域，如图1。 图1 金额 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 货币单位：设置货币的单位。 保留小数位数：设置精确保留的小数位数。 验证：对字段进行限制设置。 必填：该字段是否必填。 限定范围：限定数值填写的范围。例如10.01~1000.99。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

矩阵量表 矩阵量表用于形象地评估对事物的喜好程度。 在表单开发页面，从“数据组件”中，拖拽“矩阵量表”组件至表单设计区域，如图1。 图1 矩阵量表 如图2所示，使用矩阵量表对车辆进行评分。 图2 矩阵量表配置示例 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 选项：对事物的评估选项。 单击“新增选项”，可新增评估选项，新增后可直接设置选项名。 单击“批量添加”，可批量添加评估选项。 图3 批量添加评估选项 量表设置：可以设置评估的起始数值及量级。 两级文案：量表两级的文案显示，支持国际化。 外观：量表支持横向显示或者竖向显示。 样式：评估的图标样式。 验证：对该字段进行一些限制，设置为“必填”，表示该字段必须配置。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，该字段只可读。 禁用：勾选后，该字段内容仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段内容。 描述信息：设置组件描述信息，支持换行和国际化配置。 父主题： 零码组件介绍

用户 用户组件可以获取公司通信录中的人员，选择人员时可以使用，例如设置出差申请人、资产责任人、维护人员、流程表单设置审批人时使用。 在表单开发页面，从“数据组件”中，拖拽“用户”组件至表单设计区域，如图1。 图1 用户 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 可选择记录数：设置可选的用户是单选还是多选。 可选范围：单击“选择范围”，设置从哪里获取用户。 显示用户以下信息：勾选显示的用户字段信息，如姓名、账号。 填报数据搜索用户姓名时，页面会展示用户所属部门，当用户有重名的现象时，方便根据所属部门进行确认。 验证：对字段进行限制设置。“可选择记录数”设置为“多选”时，支持限定选择个数。 必填：该字段是否必填。 限定选择个数，支持设置最少和最多数。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 当前登录用户：使用当前用户作为默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

透视图 透视图用于将数据通过不同的维度进行分类汇总，可以设置多个不同的维度（行维度、列维度），来展现在当前维度下的目标数值。在报表编辑页面，拖拽“透视图”组件到中间区域，右侧可设置组件属性。 图1 透视图 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 数据 维度(行)：单击“添加维度(行)”，勾选所需的行，单击“确定”。单击，可重命名维度、统计空值和设置维度排序方式（如升序、倒序等）。 维度(列)：单击“添加维度(列)”，勾选所需的列，单击“确定”。单击，可重命名维度、统计空值和设置维度排序方式（如升序、倒序等）。 数值：单击“添加数值”，勾选所需的数值，单击“确定”。单击，可重命名数值、统计空值。 图表联动：有多张透视表时，可选择联动透视图。主联动表中，单击某个维度，在被联动表中会出现与之对应的数据。 数据更新方式：图表是否需要实时更新，支持设置实时更新时间间隔。 筛选数据：单击“添加筛选条件”，设置数据筛选条件。 外观 大小：设置图表大小，如小、大、中、全屏等。 汇总：图表是否显示行汇总、列汇总，支持设置汇总行/列名称、汇总方式。 冻结：是否冻结维度行或列，当前仅对PC端生效。 区间配色：给在一定数值范围内的数据，添加配色标记。 单击“设置规则”，进入设置区间配色规则页面。 如果数值同时满足多个条件区间，则默认取按顺序排列的第一个条件设置。 单击“选择数值字段”，选择对应的数值字段，按需设置字段区间配色。 图2 设置区间配色规则 属性：勾选后，页面上会隐藏该字段。 宽度：组件框的宽度，占页面宽度的比例。 父主题： 统计页面组件介绍

电话 电话组件用于录入11位数的手机号码。系统已预置校验格式，当用户输入手机号不正确时，会报错。 在表单开发页面，从“数据组件”中，拖拽“电话”组件至表单设计区域，如图1。 图1 电话 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 验证：对字段进行限制设置。 必填：该字段是否必填。 不允许重复：字段值是否可重复填写。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

多行文本 多行文本组件用于录入较长、较复杂的文字，如描述说明、备注、反馈等。 在表单开发页面，从“数据组件”中，拖拽“多行文本”组件至表单设计区域，如图1。 图1 多行文本 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 行数：文本行数展示的行数。如果需要行高随内容自动调整，请勾选“行高随内容自动调整”。 例如，设置为3行，该组件高度会展示为3行，输入文本超过3行高度后，可拖动滚动条展示文本。 验证：对该字段进行一些限制。 必填：设置为“必填”，表示该字段必须配置。 限定格式：设置为“限定格式”，表示该字段必须按照规定格式进行填写。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 默认值：支持设置如下默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 宽度：字段配置框宽度占页面宽度的比例。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

汇总 汇总组件用于对关联本表单的其他表单中，某些字段数据或记录总数进行数量汇总，即求和。 使用汇总组件，需要存在关联本表单的其他表单。例如，表单A要使用汇总组件，需要先创建一个新表单B，表单B通过关联记录组件关联表单A，才能对表单B的记录做汇总。 在表单开发页面，从“数据组件”中，拖拽“汇总”组件至表单设计区域，如图1。 图1 汇总 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 汇总目标：选择关联本表单的其他要汇总的表单视图。 被汇总字段：被汇总的字段，支持汇总记录总数。 汇总方式：选择字段的汇总方式。 单位：汇总数额的单位，可以设置为中文，也可以设置为英文。 保留小数位数：支持设置精确保留的小数位数。 属性：设置字段属性，勾选“隐藏”后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

柱状图 柱状图组件用于实现柱状图样式数据报表统计。在报表编辑页面，拖拽“柱状图”组件到中间区域，右侧可设置组件属性。 图1 柱状图 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 数据 维度：选择字段作为维度字段。单击，可设置维度排序方式（如升序、倒序等）和维度名称相同时是否合并。 柱状图支持将矩阵量表的选项字段作为柱状图维度，每一个量级作为柱状图的一个数值字段进行展示。 第几个柱子后合并为其他：设置第几个柱子后，合并为其他。 数值：选择展示数值的字段。 数据更新方式：图表是否需要实时更新，支持设置实时更新时间间隔。 筛选数据：单击“+添加筛选条件”，设置过滤条件。设置后，可根据条件统计数据。 外观 大小：设置图表的大小。 样式：选择图表的样式。 横轴标签 标签换行：横轴标签字数过多时是否换行。 单行最多字数：横轴标签字数过多时单行最多字数，没有设置换行多余字数会省略。 标签旋转角度：标签旋转角度设置。 纵轴范围 最小值：设置纵坐标的最小值，默认为自动。 最大值：设置纵坐标的最大值，默认为自动。 布局：是否开启自动布局功能，默认为开启。如果不开启，可根据实际需求进行如下设置。 列表布局：设置图例的列表布局，如垂直、水平。 标签换行：是否开启标签换行。开启后，当标签字数超过设置的单行最多字数时会自动换行。 单行最多字数：设置图例单行最多显示多少字，取值为1~50。 列表项间距：设置图例列表项的间隔距离，单位px。 图例位置(上边距)：设置图例到组件边框顶部的百分比。 图例位置(右边距)：设置图例到组件边框右侧的百分比。 宽度：设置柱状图中，图柱的宽度。 图2 宽度 属性：勾选后，页面上会隐藏该字段。 宽度：该组件框的宽度，占页面宽度的比例。 父主题： 统计页面组件介绍

附件 附件是数据组件的一种，用于上传证件照片等，支持单击或拖拽上传。 在表单开发页面，从“数据组件”中，拖拽“附件”组件至表单设计区域，如图1。 图1 附件 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 文件大小(KB)：限制上传文件的大小，最大可设置为204800KB。 限制文件类型（最少选择一项）：限制上传的文件类型。 图片：支持的图片后缀为png、jpg、jpeg和gif。 文档：支持的文件后缀为pdf、doc、docx、xls、xlsx、ppt、pptx、txt、htm和html。 视频：支持的视频后缀为mp4、mkv、swf、wmv、mpg、rmvb和avi。 压缩包：支持的压缩包后缀为zip、rar。 自定义：自定义文件的扩展名，如wps、gz、7z等。 访问权限：设置附件的访问权限。 公开：所有人公开。 受限：选择受限后，要设置有访问权限的角色。 验证：对该字段进行一些限制。 必填：勾选后，该字段必须填写。 限制文件上传个数：勾选后，可设置文件上传个数。 属性：设置字段属性。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

引用 引用组件用于从关联的记录中引用某个字段数据显示在当前页面中。选用该组件需要在页面中已使用关联记录。 在表单开发页面，从“数据组件”中，拖拽“引用”组件至表单设计区域，如图1。 图1 引用 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 关联字段：选择当前页面中的关联记录。 引用字段：选择引用的具体字段。 属性：设置字段的属性，勾选“隐藏”后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

公式 公式组件用于将记录内的字段进行数据运算。 在表单开发页面，从“数据组件”中，拖拽“公式”组件至表单设计区域，如图1。 图1 公式 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 计算方式：根据实际需求选择计算方式，支持求和、平均值、乘积和自定义等。 保留小数位数：支持设置精确保留的小数位数。 单位：数字的单位，请根据需求进行设置。 属性：设置字段属性，勾选“隐藏”后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

分段 分段组件通常用于对下文做出说明、解释，或者将表单分成不同的部分，使得结构更加清晰。 在表单开发页面，从“通用组件”中，拖拽“分段”组件至表单设计区域，如图1。 图1 分段 显示名称：分段的说明文字，通常用于对下文做出说明、解释。 样式：分段的样式。 标题大小：设置标题的大小。 标题颜色：显示名称的字体颜色。 背景颜色：设置组件的背景颜色。 显示分割线：是否显示分割线。 属性：设置字段的属性，例如勾选“隐藏”后，页面上会隐藏该字段。 父主题： 零码组件介绍

部门 部门组件用于获取组织机构。 在表单开发页面，从“数据组件”中，拖拽“部门”组件至表单设计区域，如图1。 图1 部门 显示名称：该组件在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 可选择记录数：选择组织内配置好的部门，支持单选或多选。 可选范围：选中“可选范围”，单击“选择范围”，即可选择对应的部门。如果需要包含所选部门下的子部门，请“勾选包含所选部门下的子部门”。 验证：对该字段进行一些限制，设置为“必填”，表示该字段必须配置。“可选记录数”设置为“多选”时，支持限定选择个数。 属性：设置字段属性。 只读：勾选后，页面上该字段只可读。 隐藏：勾选后，页面上会隐藏该字段。 勾选“隐藏”后，单击隐藏后的“设置例外条件”，可设置该字段的显示条件。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 当前用户所属部门：选择当前用户所在的部门作为默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

邮箱 邮箱组件用于录入邮箱信息。系统已预置校验格式，当用户输入邮箱格式不正确时，会报错，参考格式为“***@example.com”。 在表单开发页面，从“数据组件”中，拖拽“邮箱”组件至表单设计区域，如图1。 图1 邮箱 显示名称：该字段在页面呈现给用户的名称，可以设置为中文，也可以设置为英文。 只读时展示为超链接：“字段属性”设置为“只读”时，该字段会展示为超链接。 验证：对字段进行限制设置。 必填：该字段是否必填。 不允许重复：字段值是否可重复填写。 属性：设置字段的属性，包括只读、禁用和隐藏。 只读：勾选后，页面上该字段只可读。 禁用：勾选后，页面上该字段仍可显示，但不可进行配置。 隐藏：勾选后，页面上会隐藏该字段。 宽度：该字段配置框的宽度，占页面宽度的比例。 默认值：支持设置如下默认值。 其他字段值：该表单内的其他定位组件、关联记录中的定位字段。 关联数据：关联已有数据，即取查询到的，最新的一条数据作为默认值。 图2 配置默认值 公式编辑：给表单中的某个字段编辑公式后，在填写表单或修改表单数据时，可以使该字段的值根据公式自动计算出来，不需要再手动填写，提高效率。 引导文字：当用户没有配置该字段值时，在界面显示的引导文字，可以设置为中文，也可以设置为英文。 问号提示：当该字段较难理解时，可通过配置“问号提示”告诉用户该字段的含义、如何配置等，可以设置为中文，也可以设置为英文。 设置后，页面该字段旁会有问号图标，单击后会显示配置的“问号提示”内容。 描述信息：设置组件的描述信息。 父主题： 零码组件介绍

权重合并和转换介绍 模型训练完成后，训练的产物包括模型的权重、优化器状态、loss等信息。这些内容可用于断点续训、模型评测或推理任务等。 在进行模型评测或推理任务前，需要将训练后生成的多个权重文件合并，并转换成Huggingface格式的权重文件。 权重文件的合并转换操作都要求在训练的环境中进行。 预训练或SFT全参微调产生的权重文件的合并与转换操作，请参考多卡权重合并进行操作。 LoRA微调训练产生的权重文件的合并与转换操作，请参考LoRA权重合并进行操作。 父主题： 推理前的权重合并转换

Alpaca数据 本教程使用到的训练数据集是Alpaca数据集。Alpaca是由OpenAI的text-davinci-003引擎生成的包含52k条指令和演示的数据集。这些指令数据可以用来对语言模型进行指令调优，使语言模型更好地遵循指令。 预训练数据集下载：https://huggingface.co/datasets/tatsu-lab/alpaca/resolve/main/data/train-00000-of-00001-a09b74b3ef9c3b56.parquet，数据大小：24M左右。 SFT全参微调、LoRA微调训练数据集下载： http://github.com/tatsu-lab/stanford_alpaca/blob/main/alpaca_data.json，数据大小：22M左右。

自定义数据 用户也可以自行准备训练数据。数据要求如下： 使用标准的.json格式的数据，通过设置--json-key来指定需要参与训练的列。 请注意huggingface中的数据集具有如下this格式。可以使用–json-key标志更改数据集文本字段的名称，默认为text。在维基百科数据集中，它有四列，分别是id、url、title和text。可以指定–json-key 标志来选择用于训练的列。 { 'id': '1', 'url': 'https://simple.wikipedia.org/wiki/April', 'title': 'April', 'text': 'April is the fourth month...' } 将下载的原始数据存放在/home/ma-user/ws/datasets/data目录下。具体步骤如下： 进入到/home/ma-user/ws/目录下。 创建目录“datasets/data”，并将原始数据放置在此处。 mkdir -p datasets/data 数据存放参考目录结构如下： ${workdir}（例如/home/ma-user/ws ） ├── datasets ├── data #原始数据集 ├── train-00000-of-00001-a09b74b3ef9c3b56.parquet #预训练原始数据集 ├── alpaca_data.json #微调原始数据集

预训练权重合并及转换 由于预训练或SFT全参微调时产出的权重文件（TP和PP文件）个数比较多，推理前需要把多个权重文件合并为一个文件，并转换为HuggingFace格式。Llama2-13B一般使用单卡推理。 基于预训练或SFT全参微调完成的模型，进行推理部署时，权重合并和转换操作建议参考本章节。 脚本convert_weights_to_huggingface.py包含了权重文件合并和转换操作，具体的脚本内容和参数解释如下。 该脚本的执行需要在/home/ma-user/ws/AscendCloud-3rdLLM-6.3.902/llm_train/AscendSpeed/代码目录下进行。 python scripts/tools/ckpt_convert/llama/convert_weights_to_huggingface.py \ --input-model-dir ${ASCNEDSPEED_CKPT_PATH} \ --output-model-dir ${MERGE_CKPT_PATH} \ --src-tensor-model-parallel-size ${TENSOR-MODEL-PARALLEL-SIZE} \ --src-pipeline-model-parallel-size ${PIPELINE-MODEL-PARALLEL-SIZE} \ --type ${TYPE} \ --org-huggingface-dir ${HUGGINFGFACE_DIR} \ --merge-mlp 参数说明： ${ASCNEDSPEED_CKPT_PATH}：训练生成的AscendSpeed格式权重目录，多机多卡场景下需要把多个节点上的权重文件都放到任意一个节点的这个目录下；需要指定到含有mp_rank_xxxxxxx的目录，一般为iter_xxxxx或release。 ${MERGE_CKPT_PATH}：合并后的权重路径。 ${TENSOR-MODEL-PARALLEL-SIZE}：原始模型的TP配置大小，取值来自训练中的配置，此处需要手动输入。 ${PIPELINE-MODEL-PARALLEL-SIZE}：原始模型的PP配置大小，取值来自训练中的配置，此处需要手动输入。 ${TYPE}：原始模型参数大小，支持参数配置： 7B、13B、70B，按实际模型要求设置。 ${HUGGINFGFACE_DIR}：可选，开源HuggingFace权重目录，用于将开源权重内的配置文件，复制到转换后权重的输出目录中。 下面提供一个convert_weights_to_huggingface.py脚本的实际样例，供参考。 python scripts/tools/ckpt_convert/llama/convert_weights_to_huggingface.py \ --input-model-dir /home/ma-user/ws/AscendCloud-3rdLLM-6.3.902/llm_train/AscendSpeed/ckpt/ckpt-llama2-13b-sft/iter_xxxxxxx \ --output-model-dir /home/ma-user/ws/weight/ckpt-llama2-13b-sft-hf \ --src-tensor-model-parallel-size 8 \ --src-pipeline-model-parallel-size 1 \ --type 13B \ --org-huggingface-dir /home/ma-user/ws/tokenizers/llama2-13b-hf \ --merge-mlp 父主题： 推理前的权重合并转换

LoRA微调权重转换 LoRA微调训练前，需要先把训练权重文件转换为AscendSpeed格式。 基于预训练或SFT全参微调生成的权重文件已经是AscendSpeed格式，进行LoRA微调训练时，不需要再单独做权重转换，可以跳过此章节。 基于原始HuggingFace权重进行LoRA微调训练时，需要将Huggingface格式权重转换为AscendSpeed格式。 LoRA微调训练和SFT全参微调使用的是同一个HuggingFace权重文件，转换为AscendSpeed格式后的结果也是通用的。如果在SFT全参微调任务中已经完成了HuggingFace权重转换操作，此处无需重复操作，可以直接使用SFT全参微调中的权重转换结果。如果前面没有执行HuggingFace权重转换任务，可以参考SFT全参微调权重转换章节完成。 父主题： LoRA微调训练

Step2 创建数据集并上传至OBS 进入网站http://www.cs.toronto.edu/~kriz/cifar.html，下载“CIFAR-10 binary version (suitable for C programs)”，解压后将数据上传至OBS桶的“obs://test-modelarts/mindspore-gpu/cifar-10-batches-bin/”文件夹下。OBS桶中数据集如下所示： 图1 数据集

资源和成本规划 在实际业务使用时GeminiDB、 GaussDB (for MySQL)服务会产生费用，该解决方案预估的费用，仅供参考，实际收费请参考各个云服务的计费详情。 表1 资源和成本规划（按需计费） 华为云服务 配置示例 每月预估花费 GeminiDB服务 按需计费：5.39元/小时。更多计费详情请参见价格详情。 区域：华北-北京四 节点规格：geminidb.redis.large.4 CPU (2 vCPUs) 节点数量：3 存储容量：40GB 5.39 * 24 * 30 = 3,880.8 元 GaussDB(for MySQL)服务 按需计费：4.74元/小时。更多计费详情请参见价格详情。 区域：华北-北京四 节点规格：独享版，4 vCPUs | 16 GB 只读节点数量：1 4.74 * 24 * 30 = 3,412.8 元 合计 7293.6 元 表2 资源和成本规划（包年包月） 华为云服务 配置示例 每月预估花费 GeminiDB服务 区域：华北-北京四 节点规格：geminidb.redis.large.4 CPU (2 vCPUs) 节点数量：3 存储容量：40GB 1953.4 元 GaussDB(for MySQL)服务 区域：华北-北京四 节点规格：独享版，4 vCPUs | 16 GB 只读节点数量：1 2374 元 合计 4327.4 元

（可选）创建rf_admin_trust委托 进入华为云官网，打开控制台管理界面，鼠标移动至个人账号处，打开“ 统一身份认证 ”菜单。 图1 控制台管理界面 图2 统一身份认证菜单 进入“委托”菜单，搜索“rf_admin_trust”委托。 图3 委托列表 如果委托存在，则不用执行接下来的创建委托的步骤 如果委托不存在时执行接下来的步骤创建委托 单击步骤2界面中右上角的“创建委托”按钮，在委托名称中输入“rf_admin_trust”，选择“普通账号”，委托的账号，输入“op_svc_IAC”，单击“下一步”。 图4 创建委托 在搜索框中输入“Tenant Administrator”权限，并勾选搜索结果。 图5 选择策略 选择“所有资源”，并单击下一步完成配置。 图6 设置授权范围 “委托”列表中出现“rf_admin_trust”委托则创建成功。 图7 委托列表

名词解释 基本概念、云服务简介、专有名词解释： GaussDB(for MySQL)：是华为自研的最新一代高性能企业级分布式关系型数据库，完全兼容MySQL。基于华为最新一代DFV分布式存储，采用计算存储分离架构，最高支持128TB的海量存储，可实现超百万级QPS吞吐，支持跨AZ部署，既拥有商业数据库的性能和可靠性，又具备开源数据库的灵活性。 GeminiDB：采用云原生分布式架构，完全兼容Redis®协议，支持丰富数据类型。 提供数据实时持久化、多副本强一致保障，以及实时监控、弹性伸缩、自动备份等一站式服务。

操作场景 该章节指导用户开启Guardian组件存算分离操作。开启后Guardian可以在存算分离场景下为HDFS、Hive、Spark、Loader、HetuEngine等服务提供访问OBS的临时认证凭据。 配置Guardian服务对接OBS主要操作如下： 创建OBS并行文件系统 创建云服务委托并绑定集群 创建普通账号委托 配置云服务委托 为Guardian组件配置访问OBS权限 开启Hive表的级联授权功能 配置回收站清理策略