应用方案手册-2021.11应用工厂用友网络科技股份有限公司1版权用友集团未经用友集团的书面许可，本应用方案手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本应用方案手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本应用方案手册的内容并不代表用友所做的承诺。用友网络科技股份有限公司2目录变更记录..5第一章总体概述..61.1.应用工厂背景..61.2.什么是应用工厂..61.3.基本概念..61.3.1.数据建模..61.3.2.应用特性..71.3.3.页面建模..7第二章应用定制应用步骤..82.1.整体应用步骤..82.2.新建应用分类..92.3.数据建模..92.3.1.新建应用..102.3.2.配置应用特性..112.3.3.新增子表..112.3.4.维护字段..132.3.5.发布元数据..162.4.发布应用..162.5.页面建模..172.6.规则配置..182.6.1.编码规则定义..182.6.2.打印模板..192.6.3.审批流配置..202.6.4.业务流配置..212.6.5.业务插件注册..242.6.6.移动审批配置..242.7.系统应用..25第三章代码定制应用步骤..263.1.整体应用步骤..263.2.代码定制新增..273.2.1.元数据配置..273.2.2.基础配置..283.2.3.页面配置..293.2.4.参数配置..293.2.5.其他配置项..313.2.6.重新选择元数据..323.2.7.下载源码..333.3.代码定制修改..343.4.应用定制新增..35用友网络科技股份有限公司3附录：本文参见其他手册清单..38用友网络科技股份有限公司4导读此手册面向实施顾问以及企业关键用户，旨在为实施规划、解决方案制定和落实提供指导。手册围绕应用工厂特有的功能展开，完整描述通过应用工厂建立新应用的步骤以及逻辑。本手册包括两大部分：第一部分是对产品背景及基本概念的概要介绍；第二部分是对系统应用步骤的详细介绍。为突出重点，本手册定位于应用工厂特有功能，对于复用NCCloud的功能未做说明，若需要对复用功能进行更详细的了解，可结合本手册查阅如下资料：1.《应用方案手册-流程管理》-----提供关于交易类型、流程设计工具的应用指导。2.《应用方案手册-客户化配置》-----提供关于编码规则定义，页面模版配置的应用指导。用友网络科技股份有限公司5变更记录编写人陈凯、刘伟、杨守平版本修订人审核人起止时间修订/审核章节修订/审核内容2021.11陈凯李聪慧2021.12修订1.3.2应用特性对应用特性进行合并，删除了多余的应用特性。2021.11陈凯李聪慧2021.12修订2.3.4维护字段删除了不支持组织权限的内容。2021.11陈凯李聪慧2021.12修订2.6.2.打印模板修改打印特性为系统特性。2021.11陈凯李聪慧2021.12修订2.6.6移动审批配置修改移动特性为审批流特性。2021.11刘伟李聪慧2021.12新增代码定制相关内容增加代码定制相关内容用友网络科技股份有限公司6第一章总体概述1.1.应用工厂背景信息化系统的不断发展，对项目的灵活性、扩展性提出了越来越高的要求，整个项目的成功，不仅仅依赖于编程人员的努力，同时对二次开发人员和项目实施人员也提出了越来越高的要求。设计一套可扩展而又简单易用的开发平台，是提高项目开发效率、缩短软件交付周期的必然选择。1.2.什么是应用工厂应用工厂是NCCloud的低代码开发平台，其将NCCloud应用特性的共性抽离出来，只需要较少甚至不需要代码开发，通过可视化的配置方式创建新的应用。基于NCCloud基础能力，例如页面模板、审批流定义、业务流定义等，根据业务特性进行应用的定制。应用定制过程中，由于是基于已有能力，因此配置方式与原标准产品一致，从而能够有效的降低入手难度。实施人员或者业务人员可以根据业务需求新增应用，提供了更高的灵活性、扩展性。代码定制是应用工厂的高阶定制，通过五步向导方式配置元数据、基础信息、页面样式与特性插件、参数设置以及代码生成与下载方式等信息，生成小应用的源码后在NCCloudStudio工具中做后续扩展开发。另外，对于应用定制后的小应用可通过代码定制的能力进行能力扩充，功能完善改造，满足更细致的客户需求扩展。1.3.基本概念1.3.1.数据建模数据建模是低代码开发的核心，包含应用特性配置、定义表结构、定义字段信息。经过数据建模可以确定应用可以记录的业务数据和适用的业务场景。用友网络科技股份有限公司71.3.2.应用特性应用特性抽取出应用中不变的部分，将应用生命周期中不变的属性以及稳定的行为封装为一系列特性，用户只需要选择该应用所具有的特性，就可以方便快捷定义应用所具有的属性，以及在此基础上产生的各种行为。图1.3-1应用特性数据交换平台特性：可以通过外部交换平台导入业务数据。系统特性：包含一些默认的字段，附件管理，打印和基本的增删改查功能；单据特性：包含单据状态、编码规则等功能；导入导出特性：支持数据的导入导出；审批流特性：单据可以提交至审批流，完成审批功能；业务流特性：可以定义单据的上下游关系，完成相应的转单功能；1.3.3.页面建模应用发布后系统自动生成页面模版，可以根据实际的业务需求对应用的页面模版进行调整和预览。用友网络科技股份有限公司8第二章应用定制应用步骤本部分描述通过应用工厂创建应用的基本环节和操作步骤，应用特性不同则创建应用的基本环节可能是不同的，例如：未勾选“审批流特性”的应用则不需要进行“审批流配置”环节。2.1.整体应用步骤图2.1-1整体应用步骤用友网络科技股份有限公司92.2.新建应用分类应用分类是对应用进行分类管理的维度，在【动态建模平台】→【应用工厂】→【应用定制】节点，可按照实际的业务需求进行维护。系统预置分类“业务对象默认分组(default)”。图2.2-1新建应用分类2.3.数据建模数据建模是对应用的数据结构和相关功能属性的定义过程，在数据建模前需要依据应用适用的业务场景确定应用需要具备的功能，例如是否可以配置审批流、业务流等，确定应用的应用特性。同时需要对应用承载的数据进行分析，确定数据结构与类型，保证可以完整的记录业务数据。用友网络科技股份有限公司102.3.1.新建应用选择应用分类后点击新增应用按钮可以在该分类下创建应用，需要维护应用的编码、名称信息，对应表名字段由系统自动生成。新增应用后，点击“设计”按钮，可进入应用设计阶段。图2.3-1新增应用用友网络科技股份有限公司11图2.3-2进入应用设计阶段2.3.2.配置应用特性系统预置了10种应用特性，可根据实际的业务需求勾选，勾选相应的特性，则发布后的单据具有相应的功能。应用特性需要慎重选择，发布元数据后不允许对应用特性进行修改。图2.3-3应用特性配置2.3.3.新增子表应用工厂新增应用支持多种数据结构，目前支持单表、主子表、一主多子，暂不支持主子孙表的结构。通过“新增子表”按钮，可以在主表下新增子表，维护子表的编码、名称信息，点击确定即可完成新增子用友网络科技股份有限公司12表的操作。图2.3-4新增子表-子表信息维护图2.3-5新增子表-子表页签用友网络科技股份有限公司132.3.4.维护字段系统预置了部分字段，可点击增行按钮新增字段，根据实际的业务需求设置新增字段的属性信息。图2.3-6新增字段图2.3-7新增字段-维护字段信息字段显示名称：该字段的显示名称；字段类型：定义字段的类型，例如，文本、日期、数值、还是档案参照；卡片是否可见：定义字段在卡片状态的可见性，在页面建模时可再次进行调整；列表是否可见：定义字段在列表状态的可见性，在页面建模时可再次进行调整；字段长度：定义该字段在后台存储的长度；显示顺序：字段在页面上的显示顺序。用友网络科技股份有限公司14对于部分字段，需要定义值的范围，例如：某应用上地区字段只能从华北、东北、华东中选择，可通过新增枚举字段的方式来实现该业务场景。步骤一：通过右上角“枚举”下“新增”按钮新增名称为“地区”的枚举档案。图2.3-8新增枚举图2.3-9新增枚举枚举名称：需要以小写字母开头，可以包含小写字母和数字；返回类型：代表该枚举值在后台存储的数据类型；用友网络科技股份有限公司15枚举值：可以通过增行进行新增，枚举名为该枚举使用时枚举的显示名称，枚举值需要与返回类型保持一致。步骤二：维护字段信息时字段类型选择新增的枚举档案。图2.3-10字段类型引用枚举档案注意：维护单据时，若需要表体组织字段联动显示表头组织字段，则需要使用应用工厂预置的组织字段，例如：某采购单表体的采购组织字段不允许编辑，单据保存后表体采购组织字段需要存储并显示表头采购组织字段值，手工新增组织字段无该逻辑。新增单据时维护组织字段后其他字段才可编辑，该组织字段需要使用主表预置的组织字段。用友网络科技股份有限公司162.3.5.发布元数据完成应用的表结构、字段、应用特性的配置后，点击右上角的“发布元数据”按钮进行元数据发布，发布元数据后不允许更改应用特性配置。图2.3-11发布元数据2.4.发布应用发布元数据后，需要进行应用的发布。布应用时需要选择非末级节点，在职责关联应用时可在该路径下看到发布的应用。图2.4-1发布应用用友网络科技股份有限公司172.5.页面建模应用发布后需要配置应用的页面模板，分配列表模板和卡片模板，配置方式与【动态建模平台】→【客户化配置】→【模板管理】→【模板设置-集团】的配置方式是相同的，关于模板的配置方式详见《应用方案手册-客户化配置》。图2.5-1页面模板配置图2.5-2列表界面模板配置用友网络科技股份有限公司18图2.5-3卡片界面模板配置2.6.规则配置规则配置主要包含编码规则、打印模板、审批流配置、业务流配置、业务插件注册、移动审批配置，数据建模时勾选的的应用特性影响着可以配置的规则，例如：未勾选“审批流特性”的应用则不需要进行“审批流配置”环节。2.6.1.编码规则定义数据建模时勾选了“单据特性”，会生成默认编码规则，并可以进行编码规则定义的调整。编码规则定义的方式与【动态建模平台】→【客户化配置】→【编码规则】→【编码规则定义-全局】处相同，并且数据是同步的。关于配置的方式详见《应用方案手册-客户化配置》。用友网络科技股份有限公司19图2.6-1编码规则定义2.6.2.打印模板数据建模时勾选了“系统特性”则系统自动生成打印模版，在该处可以对打印模板进行调整和预览，打印模板的配置方式与【动态建模平台】→【客户化配置】→【模板管理】→【模板设置-集团】处相同，并且数据是同步的。关于配置方式详见《应用方案手册-客户化配置》。图2.6-2打印模版配置用友网络科技股份有限公司202.6.3.审批流配置数据建模时勾选了“审批流特性”则可以进行审批流定义，审批流的配置方式与【动态建模平台】→【流程管理】→【流程设计】→【审批流定义-集团】处相同，并且数据是同步的。关于配置的方式详见《应用方案手册-流程管理》。图2.6-3审批流定义配置图2.6-4审批流定义配置用友网络科技股份有限公司212.6.4.业务流配置数据建模时勾选了“业务流特性”则可以进行业务流配置，业务流配置包含三方面内容：上下游配置、分单依据注册、定义单据转换规则。图2.6-5业务流配置上下游配置：定义了新增应用与上游单据或者下游单据的关系，同时不支持删除上下游关系，目前系统支持推单，暂不支持业务拉单的场景。通过“新增”按钮可以新增一条上下游关系，选择业务单据后保存即可。用友网络科技股份有限公司22图2.6-6上下游配置分单依据注册：分单是指在业务单据转换过程中，可能会出现上游的一张单据要按某种规则拆分成下游的多张单据。分单依据注册就是注册单据上可以用于分单的属性，以及单据函数。在该处配置的数据与【动态建模平台】→【开发配置】→【交易管理】→【分单依据注册】的数据是同步的。图2.6-7分单依据注册单据转换规则：在进行业务推单的过程中，需要定义上下游单据之间的字段之间的关系，明确下游单据字段值的来源，并确定下游单据如何分单，该关系为单据转换规则。在该处配置的数据与【动态建模平台】→【开发配置】→【交易管理】→【单据转换规则】的数据是同步的，并且配置方式与逻辑是相同的。用友网络科技股份有限公司23图2.6-6单据转换规则配置-交换规则图2.6-7单据转换规则配置-分单规则用友网络科技股份有限公司242.6.5.业务插件注册业务插件注册为开发人员提供用于客开监听事件的扩展，数据建模时勾选了“业务插件注册特性”可以进行业务插件注册。图2.6-8业务插件注册2.6.6.移动审批配置数据建模时勾选了“审批流特性”则该应用支持友空间或独立入口的审批中心审批功能，系统会自动生成预置的移动端模板，在该处可以对移动端模板进行调整和预览。图2.6-9移动审批配置用友网络科技股份有限公司252.7.系统应用在应用工厂发布的应用符合NCCloud的权限管理体系，管理方式与系统预置应用相同。在职责分配应用时，可以选择应用工厂发布的应用。图2.7-1职责分配应用用友网络科技股份有限公司26第三章代码定制应用步骤各级机构的开发人员通过“应用工厂高阶定制”下的“代码定制”节点，可以快速配置生成具体的应用代码，在此基础上再调整完善，以提高一线开发人员的开发效率和项目的快速交付能力，同时代码质量和规范性也得以大大提升。本部分描述通过应用工厂高阶定制的“代码定制”来配置创建业务应用的基本环节和操作步骤以及对创建的代码定制如何进行修改，同时介绍如何对应用工厂设计的小应用进行定制修改。3.1.整体应用步骤图3.1-1整体应用步骤用友网络科技股份有限公司273.2.代码定制新增进入“代码定制”后点击选择工作模式“代码定制新增”（如下图所示），通过选取已有的元数据，配置相应的应用特性、页面样式和参数信息，生成新的小应用代码。主要步骤包括：元数据配置、基础信息配置、页面配置、参数配置、其他配置、生成并下载源代码。图3.2-1代码定制新增3.2.1.元数据配置代码定制第一步，点击“元数据组件”参照框，查询选择要使用的某个元数据：图3.2-2参照选择元数据组件用友网络科技股份有限公司28点击【确定】按钮，所选元数据显示如下：图3.2-3元数据配置版本:自动默认为当前的NCCloud版本，仅显示不可修改。点击【下一步】按钮，进入下面的基础信息设置。3.2.2.基础配置设置业务应用的基本信息，包括：应用分类、应用编码、应用名称、组织类型、功能点类型、上级菜单项、菜单项编码、菜单项名称等信息。图3.2-4基础配置应用分类:用以确定生成的小应用在“应用注册”里面的位置；用友网络科技股份有限公司29应用编码：在整个系统全局范围内应保持唯一。点击【下一步】按钮，进入下面的页面设置。3.2.3.页面配置选择业务应用的页面样式和特性插件：图3.2-5页面配置页面样式:编辑表、主从表、树表、树卡，共四种，单选其一，右侧显示放大的样式图；特性插件：附件管理、打印输出、导入导出、单据特性、档案特性、编码规则、审批流、业务流、拉单、OpenAPI、外部数据交换平台，共11个，点击变色选中或取消，可单选或多选。注意：业务流依赖于审批流，选择审批流插件后才能选择业务流插件。3.2.4.参数配置根据所选的页面样式和特性插件，显示相应的参数配置，填写相应的数据。用友网络科技股份有限公司30图3.2-6参数配置若选择了“主从页面”样式，可配置“列表页显示子表明细”开关参数：图3.2-主从表的参数配置若选择了“树表页面”样式，则还需参照选择“左树元数据”，用于页面左树信息的构建：用友网络科技股份有限公司31图3.2-8树表的参数配置注意：只有选择了“档案特性插件”，才会出现档案特性的参数配置项：生成的参照类型（表型参照、树型参照，二选一）。只有选择了“审批流插件”，才会出现相应的配置信息：单据类型编码、审批页面设置，后续可点击选择审批时是否允许修改以及是否提供附件管理功能。只有选择了“业务流插件”，才会出现相应的配置信息：单据类型编码。只有选择了“拉单插件”，才会出现相应的配置信息：单据类型编码、来源单据类型、子表名称、追溯页面设置，后续可点击选择是否提供附件管理功能。对于审批流插件、业务流插件和拉单插件，输入其中之一的“单据类型编码”，其它两个的信息自动同步显示和更新，方便实用。3.2.5.其他配置项用以设置代码生成和下载的具体方式和路径等内容。用友网络科技股份有限公司32图3.2-9其他配置项查询区仅显示常用项：设置小应用的查询区显示常用查询项还是所有查询项；覆盖创建表：设置下载源码时是否保留原有元数据及物理表；若选择覆盖，则下载源码时会先删除已有的元数据及后台物理表，重新创建新的元数据及物理表；生成元数据文件：设置下载代码的同时是否生成相应的元数据文件；本地开发：若勾选，则可直接填写下方的“前端导出路径”和“后端导出路径”，多在本地的开发环境上操作；若不选，则打包下载到客户端，然后放到NCCloudStudio项目中，多在服务器上操作。3.2.6.重新选择元数据代码定制过程中若发现设置不妥，可滚动鼠标到前面对不合适的内容进行修改；若要更改元数据，则需点击【重新选择元数据】按钮，系统出现提示框：用友网络科技股份有限公司33图3.2-10重新选择元数据在提示框中点击【确定】按钮后，系统将清空所有已设置内容，从头再来：图3.2-11重新选择元数据后重新开始3.2.7.下载源码代码定制所有步骤的设置均已完毕妥当后，点击【下载源码】按钮，系统将根据所设置的内容生成相应的小应用代码，并按设置的下载方式下载下来，最后显示“代码生成完成”。图3.2-12下载源码生成的代码可在NCCloudStudio工具中做后续扩展开发。下载过程中如出现相应的错误提示，可按照指示信息，调整后再下载代码。用友网络科技股份有限公司343.3.代码定制修改代码定制完成后，若需要对定制的内容进行修改调整，可在页面上方点击【代码定制修改】按钮，系统弹出“历史数据”对话框：图3.3-1代码定制修改对话框显示先前已设计定制好的小应用列表，查询选择某个要修改的小应用，点击【确定】按钮；系统自动将该小应用的定制设置内容全部显示出来:用友网络科技股份有限公司35图3.3-2原有的代码定制内容除了元数据配置不许修改外，基础配置、页面配置、参数配置和其它配置的内容，都可以根据需要进行修改调整，最后点击【下载源码】，具体操作与“3.2代码定制新增”相同。注意：应用编码通常不变，若修改则在全局范围内不许重复；对特性插件进行增减调整后，参数配置的内容也需做相应的调整。3.4.应用定制新增对于通过应用定制设计制作的小应用，可以选取过来进行调整完善。具体可点击【应用定制新增】按钮，出现“应用定制”信息项，点击该项信息弹出“应用定制”对话框；用友网络科技股份有限公司36图3.4-1应用定制新增点击第一项“应用定制”，参照选择某个已定制好的小应用，其他信息项自动从应用工厂中带入：图3.4-2选择定制好的小应用上述信息修改完成后点击【确定】按钮，系统自动从所选应用定制中带入所有相关设置内容，填充到代码定制的每个步骤中，可对其内容进行修改：用友网络科技股份有限公司37图3.4-3从应用定制中带入设置的内容除了元数据配置不许修改外，基础配置、页面配置、参数配置和其它配置的内容，都可以根据需要进行修改调整，最后点击【下载源码】，具体操作与“3.2代码定制新增”相同。应用工厂定制的小应用缺少档案特性、拉单和OpenAPI等插件，在这里可根据业务需要对相关的插件进行增减调整，参数配置的内容也会相应的变化，需设置相应的内容。注意：选取“应用定制”的对话框中，“包装类名”和“类全路径名称”均需修改，不能使用默认生成的名称，且多个“类全路径名称”相互间也不许重复。“应用编码”若不修改，将会覆盖原有应用的代码内容。一旦通过应用定制新增完成后，原先应用工厂生成的小应用则无法使用，需由二开人员将下载的代码编译或开发后，放到环境中才能使用。此时，该小应用前后台的处理逻辑完全由代码定制产生的新代码处理，不会按照原先应用工厂的前后台模型实现。用友网络科技股份有限公司38附录：本文参见其他手册清单序号手册名称备注01《应用方案手册-组织管理》02《应用方案手册-基础数据》用友网络科技股份有限公司39用友网络科技股份有限公司YonyouNetworkTechCo.Ltd.大型企业数字化平台ADigitalPlatformforLarge-scaleEnterprises用友网络科技股份有限公司
