YonBIPV3.0(R6_2407_1)旗舰版云平台-开发平台-开发框架用友网络科技股份有限公司2024年9月用户手册1/10版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/10目录第一章Yonsuite_MDD框架......................................................31.1功能描述..............................................................31.2关键能力..............................................................31.3主要对接支撑服务说明..................................................31.4主要操作说明..........................................................4第二章Yonsuite_MDF框架......................................................42.1功能描述..............................................................42.2MDF核心模块...........................................................42.3名词说明..............................................................52.4主要操作说明..........................................................52.5MDF扩展开发机制.......................................................5第三章Yonsuite_YNF框架......................................................63.1功能描述..............................................................63.2YNF特点...............................................................63.3名词说明..............................................................63.4主要操作说明..........................................................73.4.1YNF扩展开发机制.......................................7第四章帮助手册_Yonsuite_YPD框架.............................................74.1功能描述..............................................................74.2关键能力..............................................................84.3主要对接支撑服务说明..................................................84.4主要操作说明..........................................................9用户手册3/10第一章Yonsuite_MDD框架1.1功能描述MDD（ModelDrivenDevelopment），是一种企业开发常用的开发模式，主要通过使用高度抽象的领域业务模型作为构件，完成代码转换实现或各种模型驱动引擎配置支撑，降低开发成本，应对复杂需求变更。MDD开发框架，是用友云针对企业数字化中台理念实现的一套开发框架。从企业云服务核心问题域出发，总结提炼出最佳实践，且形成了统一的标准及规约。致力于支撑中台能力快速孵化，形成中台各能力间连接的纽带，最终实现中台基础上的企业数字化业务重构及创新快速开发实现。框架的主要目的实现模型和技术框架的分离，系统的业务部分和技术部分都可以各自进化而互不影响，让开发者更专注业务，并能够让初级的研发人员快速的开发出复杂的业务功能，其余由框架来封装屏蔽技术细节，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。同时通过各种业务模型沉淀，也能为实现企业实现业务的技术积累，有助于企业业务分析。1.2关键能力⚫Mdd脚手架搭建➢拉取脚手架代码；➢修改application.properties文件；➢在YMS控制台配置好数据源redis等配置；➢本地启动项目。⚫Mdd脚手架能力➢配合页面建模默认支持的增删改查基本功能；➢对接标准的支撑服务能力，比如元数据，UI模板，权限，公式，工作流，业务流，打印，导入，导出，编码规则，任务调度，事件中心，业务日志等。1.3主要对接支撑服务说明字段名称说明用户手册4/10元数据平台数据建模能力，定义数据结构UI模板平台页面建模能力，定义页面展示数据权限对数据按权限进行过滤功能权限对按钮按权限进行过滤公式公式计算能力工作流审批流工作流能力业务流多业务之间的流转能力导入Excel批量导入能力导出Excel批量导出能力1.4主要操作说明⚫增加框架依赖既提供了脚手架模板可以直接下载；也可以pom增加parentyonbip-2nd-parent，依赖iuap-ap-mdd-starter后即可具有MDD框架的标准能力。⚫扩展开发能力可以在想要扩展的标准action的rule规则链中增加新的rule来进行业务扩展。第二章Yonsuite_MDF框架2.1功能描述MDF（ModelDrivenFramework：前端应用架构）是一个基于元数据的模型驱动开发框架。它支持通过模式化的配置自动生成并渲染页面，继承了bpass业务中台的支撑服务和能力中心相关能力。Web开发和Mobile移动开发共用一套开发框架，共用一套扩展脚本，并支持不同维度的扩展开发（js扩展脚本、新增Metaui扩展组件、扩展及配置组件样式和交互等）。具有分层架构，分包解耦，架构灵活的特点。2.2MDF核心模块PackageNamePackageDescription用户手册5/10mdf-cubeCubeCoreSDK--含ViewModelmdf-baseui基于tinper-next组件库的公共交互层mdf-baseui-mobile基于antd-mobile组件库的公共交互层mdf-metaui-mobileMetaUI组件包（Mobile交互风格）mdf-metaui-webMetaUI组件包（Web交互风格）mdf-middlewares-authBFF服务：权限验证KOA中间件mdf-middlewares-log4jsBFF服务：日志KOA中间件mdf-plugin-metaBFF服务：UI元数据、前端JS代码生成2.3名词说明名词说明元数据（Metadata）用来描述数据的数据ViewModel为编程模型，所有可编程操作的对象均为viewmodel。小到一个组件、大到一个UI模板均为一个viewModel对象。UI模版基于元数据配置和生成的模式化页面，一个模板由实体元数据和UI元数据进行抽象描述。Node层基于NodeJS的BFF中间层，能够实现微服务接口的聚合、转发、跨域、资源托管、自动生成模板级viewmodel（js可执行代码）等能力。BFFBackendForFrontend：用户体验适配层。（领域模型与页面数据是两种思维模式，通过BFF可以很好地解耦开，让彼此更专业高效。）2.4主要操作说明2.5MDF扩展开发机制⚫扩展脚本在src/business中扩展；⚫扩展组件在src/client/web|mobile/components中扩展；⚫扩展reducers在src/client/mobile/redux/reducers.jsx中扩展；⚫扩展路由在src/client/mobile/routes/index.jsx中扩展；⚫扩展样式在src/client/mobile/styles中扩展；⚫扩展Actionsrc/client/common/biz/actions.js中扩展；用户手册6/10⚫在src/client/web|mobile.jsx中还可以注入多语资源和变量。第三章Yonsuite_YNF框架3.1功能描述随着YonBIP产品的快速发展，针对产品体验相关的交互效果、布局灵活性和扩展开发等需求越来越高。在产品智能化和研发提效方面，需要为实现AI友好的、智能化的产品体验提供重要的前端技术支撑。领域、行业、项目、ISV等开发者对原厂产品能力的扩展需求和自定义业务开发的需求旺盛，前端编程模型上需要对开发者更友好，让开发者更易于学习和理解，更具备可扩展、可编程的能力。YNF统一前端框架的能力设计的初衷，就是从需求出发、从底层设计开始，基于协议和规范逐步打造的一个完整前端开发体系。3.2YNF特点⚫响应式编程风格：引入MobX响应式数据方案，降低业务复杂度，开发规范化；⚫分层设计：框架只实现必要的核心功能，且进行了合理的分层设计和实现，并提供默认扩展；⚫降低开发门槛：框架提供的框架方法属性大幅减少，开发者无需掌握大量框架API的使用；⚫提供程序主动权：领域业务开发受框架制约少，增加领域开发对代码的掌控度，赋能创新；⚫界面灵活多变：实现页面布局灵活性，渲染模式由模板式生成升级为组合式生成。3.3名词说明用户手册7/101.YNF是YonyouNew-generationFront-end-framework的简称，即用友新一代统一前端框架。2.MobX是一款简单的、可扩展的状态管理库，它通过运用透明的函数式响应编程使状态管理变得简单和可扩展。3.TinperNext是基于React技术实现的新一代Web前端基础组件库。4.ArcUI是基于React技术实现的移动基础组件库。5.TNS是TinperNextServer的简称，支持YonBIP前端统一部署、统一前端三方包管理等公共能力。6.YonDesign是YonyouDesignSystem的简称，特指YonBIP的统一设计语言系统。7.YPD是YonyouPlatformDevelopment的简称，指新一代的YonBIP平台开发框架。3.4主要操作说明3.4.1YNF扩展开发机制⚫创建扩展脚本工程；⚫Action扩展方案；⚫Reaction扩展方案；⚫Store扩展方案；⚫页面公共扩展方案；⚫样式扩展方案。第四章帮助手册_Yonsuite_YPD框架4.1功能描述YPD框架是一种企业开发常用的开发模式，主要通过使用高度抽象的领域业务模型作为构件，完成代码转换实现或各种模型驱动引擎配置支撑，降低开发成本，应对复杂需求变更。用户手册8/10YPD开发框架，是用友云针对企业数字化中台理念实现的一套开发框架。从企业云服务核心问题域出发，总结提炼出最佳实践，且形成了统一的标准及规约。致力于支撑中台能力快速孵化，形成中台各能力间连接的纽带，最终实现中台基础上的企业数字化业务重构及创新快速开发实现。框架的主要目的实现模型和技术框架的分离，系统的业务部分和技术部分都可以各自进化而互不影响，让开发者更专注业务，并能够让初级的研发人员快速的开发出复杂的业务功能，其余由框架来封装屏蔽技术细节，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。同时通过各种业务模型沉淀，也能为实现企业实现业务的技术积累，有助于企业业务分析。4.2关键能力⚫YPD脚手架搭建➢拉取脚手架代码；➢修改application.properties文件；➢在YMS控制台配置好数据源redis等配置；➢本地启动项目。⚫YPD脚手架能力➢配合页面建模默认支持的增删改查基本功能；➢对接标准的支撑服务能力，比如元数据，UI模板，权限，公式，工作流，业务流，打印，导入，导出，编码规则，任务调度，事件中心，业务日志等。4.3主要对接支撑服务说明字段名称说明元数据平台数据建模能力，定义数据结构UI模板平台页面建模能力，定义页面展示数据权限对数据按权限进行过滤功能权限对按钮按权限进行过滤公式公式计算能力工作流审批流工作流能力业务流多业务之间的流转能力用户手册9/10导入Excel批量导入能力导出Excel批量导出能力4.4主要操作说明⚫增加框架依赖既提供了脚手架模板可以直接下载；也可以pom增加parentyonbip-2nd-parent，依赖iuap-ap-ypd-starter后即可具有YPD框架的标准能力。⚫扩展开发能力可以在想要扩展的标准action的前置或者后置扩展点plugin中进行业务扩展。
