YonBIPV3.0(R5_2312)YonSuite云平台-数字化建模-实施工具-导入导出用友网络科技股份有限公司2024年1月用户手册1/34版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/34目录第一章总体概述..............................................................................................................................................41.1总体概述..............................................................................................................................................41.2总体价值..............................................................................................................................................4第二章操作指南..............................................................................................................................................42.1导出日志..............................................................................................................................................42.1.1功能描述...........................................................................................................42.1.2关键应用...........................................................................................................42.1.3字段说明...........................................................................................................52.1.4操作说明...........................................................................................................52.2导入导出模板.....................................................................................................................................62.2.1产品价值...........................................................................................................62.2.2操作指南...........................................................................................................62.3导入日志............................................................................................................................................122.3.1功能描述.........................................................................................................122.3.2关键应用.........................................................................................................122.3.3字段说明.........................................................................................................122.3.4操作说明.........................................................................................................132.4数据导入............................................................................................................................................152.4.1功能描述.........................................................................................................152.4.2业务规则.........................................................................................................15用户手册3/342.4.3操作说明.........................................................................................................162.5UI模板................................................................................................................................................252.5.1产品价值.........................................................................................................252.5.2操作指南.........................................................................................................25用户手册4/34第一章总体概述1.1总体概述实施工具是能够降低客户实施成本、缩短产品初始化上线周期、行业特性推荐为目标所涉及的工具类产品。1.2总体价值实施工具旨在降低产品的使用门槛，为客户带来更平滑易用的上线过程。第二章操作指南2.1导出日志2.1.1功能描述【导出日志】是为方便客户自助查找在【组织管理】【基础数据】等模块节点使用导出的操作动作日志。该板块提供了导出日志节点列表、查询功能；该节点涵盖了在使用过程的所有历史操作记录。2.1.2关键应用在档案节点使用导出功能后，右下角会弹出结果，关闭后弹框消失，而【导出日志】提供统一的查找日志管理；用户手册5/342.1.2.1导出日志将每一次的导出记录全部记录列出来，提供了“对象、数据量、操作员、操作时间”信息列表展示，搜索栏可以根据查询条件搜索，操作按钮导出文件可以下载查看导出文件的错误信息。2.1.3字段说明暂无2.1.4操作说明入口：通过菜单【数字化建模】→【实施工具】→【导出日志】，进入功能。页面说明：支持查看档案节点导出操作动作后的历史记录。2.1.4.1导出日志：1）操作流程：客户在【组织管理】【基础数据】等模块节点选择导出节点对象，导出后的操作记录展示在此列表，页面包含信息如下图所示：用户手册6/342）搜索功能：根据业务对象、操作时间进行搜索，查看所需要的记录，选择业务对象部门、操作时间选择起始时间和结束时间后，点击搜索，搜索结果如下图：3）导出文件：导出日志的导出文件支持下载复用。2.2导入导出模板导入导出模板，是提供给实施顾问、系统管理员对租户级导入导出模板的设计管理，支持创建导入导出模板时选择模板来源，模板来源于原厂预置和已启用的UI模板；实现了导入导出模板租户级的个性化扩展业务场景能力。2.2.1产品价值不同租户级不同模板：实现租户级不同用户打开导入导出显示字段显隐不同、是否必填不同、是否列入模板不同；不同交易类型不同模板：实现交易类型单据不同显示字段显隐不同、是否必填不同、是否列入模板不同。2.2.2操作指南2.2.2.1导入导出模板管理整体说明支持不同租户、交易类型维度的多模板管理，在管理形式上展示为模板列表管理，分为导入用户手册7/34和导出两个栏目管理，默认各1条系统级模板，如下图所示：1.左边树：为业务对象管理树，支持业务对象名称搜索功能。2.查询区：为方便查找多数量模板，增加查询区，支持按页面类型、交易类型查询。3.列表导航栏目：分为导入和导出两个tab栏目，默认各1条系统级模版数，来源于系统级UI模板。4.新增按钮：点新增按钮，在弹出窗创建导入/导出模板的名称、模板来源等字段信息。2.2.2.2功能描述2.2.2.2.1导入模板管理入口：通过菜单【数字化建模】→【模板管理】→【导入导出模板】，进入模板管理页面：1．默认展示导入栏目，且展示1条系统级导入模板：用户手册8/34备注：系统级模板属于自动获取系统级UI模板，若仅有0租户UI模板，自动获取0租户UI模板；若有租户级UI模板，自动获取租户系统级UI模板。2．点击新增按钮，弹出框如下：弹框字段解释说明：字段名称解释说明页面类型包含列表、详情及其他页面类型，数据来源于领域原厂预置。交易类型交易类型分为两种数据来源：领域原厂预置、用户自建，支持已启用的页面类型。模板形式根据平台新架构，目前包含4种形式：1.多页签；2.单页签_按手工码关联；3，单页签_按行关联；4.zip混合模板。模板名称最多支持50个字符。备注最多支持100个字符。模板来源来源于领域原厂预置或已启用的UI模板。用户手册9/34填写完弹框内容保存后，新增1条待发布的模板。3．点击编辑按钮，弹出框如下：备注：仅支持修改模板名称、备注，交易类型、模板来源已经是保存入库的内容，无法再次编辑，支持删除，重新创建。3．点击发布按钮后，该条模板为已发布状态，运行态则新增1条租户级模板，如下图：业务入口运行态增加该条租户级模板，且仅支持预览、查看、下载使用、自定义设置模板，如下图:用户手册10/34允许业务入口的导入用户选择一个租户级模板进行自定义模板显隐、必填、是否列入模板的设置。2.2.2.2.2导出模板管理入口：1．点击导出栏目，展示1条系统级导出模板：备注：系统级模板属于自动获取系统级UI模板，若仅有0租户UI模板，自动获取0租户UI模板；若有租户级UI模板，自动获取租户系统级UI模板。2．点击新增按钮，弹出框如下：用户手册11/34弹框字段解释说明：字段名称解释说明导出类型页面类型为详情时，包含更新导入的导出、详情导出。填写完弹框内容保存后，新增1条待发布的模板。3．点击编辑按钮，选择导出类型为更新导入的导出，弹出框如下：备注：仅支持修改模板形式、模板名称、备注，交易类型、模板来源已经是保存入库的内容，无法再次编辑，支持删除，重新创建。3．点击发布按钮后，该条模板为已发布状态，运行态-导出工作台-按更新导入的导出里，则新增1条租户级模板，如下图：业务入口运行态导出工作台上，增加该条租户级模板，且仅支持查看、下载使用、自定义设置模板，如下图:用户手册12/34允许业务入口的更新导入的导出用户选择一个租户级模板进行自定义模板显隐、必填、是否列入模板的设置。2.3导入日志2.3.1功能描述【导入日志】是为方便客户自助查找在档案/单据档案入口、【数据导入】节点入口，使用导入的操作动作日志。该板块提供了导入日志节点列表、查询功能；该节点涵盖了在使用过程的所有历史操作记录。2.3.2关键应用在档案节点使用导入功能后，右下角会弹出结果，关闭后弹框消失，而【导入日志】提供统一的查找错误位置、原因结果等信息的日志管理；2.3.2.1导入日志将每一次的导入记录全部记录列出来，提供了“批次号、导入对象、成功/失败数、操作员、操作时间、状态”等信息列表展示，同事也提供【数据导入】批量包导入的日志管理，搜索栏可以根据查询条件搜索，操作按钮导出文件可以下载查看导入文件的错误信息。2.3.3字段说明用户手册13/34以下为导入日志展示的重要字段说明，如下所示：字段名称说明对象档案/单据节点名称、数据导入节点导入对象相关属性档案节点划分为一个组，如组织数据，包含组织、部门、职务、职级等导入成功数按主表导入成功的数据来统计记录条数导入失败数按主表导入失败的数据来统计记录条数操作类型包含新增、更新两种类型导入动作状态包含完成、进行中、导入失败三种状态操作类型包含新增、更新两种类型导入动作，如下图：2.3.4操作说明用户手册14/34入口：通过菜单【数字化建模】→【实施工具】→【导入日志】，进入功能。页面说明：支持查看档案节点导入操作动作后的历史记录。2.3.4.1导入日志：1）操作流程：客户在【组织管理】【基础数据】等模块节点选择导入节点对象，导入后的操作记录展示在此列表，包含完成、进行中、导入失败三种状态，展示具体信息如下图所示：2）搜索功能：根据数据类型、导入对象组、操作者进行搜索，查询所需要的记录；根据这三个条件进行搜索后，搜索结果如下图：用户手册15/343）导出文件：鼠标移到列表上，显示操作按钮“导出文件”，点击按钮后，文件进行自动下载，如下图：下载完成后打开excel文件，可以看到“错误信息”一列的具体原因，如下图：2.4数据导入2.4.1功能描述数据导入是为了方便客户自助实施、节约客户的实施成本、降低实施周期所设立的节点。该节点涵盖了在初始化上线过程中，涉及到的每一个环节。即便是不了解产品结构的用户也能自助操作完成实施上线工作。本功能是系统类节点，目前仅限租户管理员使用。2.4.2业务规则用户手册16/34为用友云的客户节省实施费用；减少我们客户的学习成本，降低实施门槛。2.4.3操作说明2.4.3.1导入模板说明导入新架构已提供5种模板形式：1.多页签模板-手工码关联；2.单页签-手工码关联（子表行独立）；3.单页签-主行号关联（子孙同行）；4.单多页签混合-行号关联（物料专用）；5.单页签-交叉表-手工码关联；其中领域对接适配最常用模版形式1，多页签模板，有4个隐藏行，2个隐藏页签，红字为含义说明；另外隐藏行内容都是导入时用来做数据解析使用，不能删除，否则导入失败。其中关于模板，涉及的6个术语需要说明，如下表：字段名称解释说明1.多页签模板-手工码关联指在excel模板里，呈现出主子孙表各有自己的sheet页签去管理字段，通过“平台手工码”关联主子孙业务关系，如员工信息的手工码。同时支持“单据指定业务编码”关联每个sheet页数据对应的业务关系。客户档案里的客户编码等。用户手册17/342.4.3.2数据导入功能描述入口：通过菜单，数字化建模>实施工具>数据导入，进入功能。2.单页签-手工码关联在excel模板里，主子孙表呈现在1个sheet页签进行字段管理；通过外键“手工码”关联主子孙数据3.单页签-主行号关联（子孙同行）指在excel模板里，主子孙表呈现在1个sheet页签进行字段管理；主子孙数据录入在同一行，根据所在行的单据唯一标识关联。4.单多页签混合-行号关联支持附件导入的Zip包模板，解压后包含excel模板、导入说明、图片/视频/附件等文件夹。而物料Excel模板是一种混合主子孙型根据业务分组的结构形式。5.单页签-交叉表-手工码关联是人力云基于业务场景体验做的交叉表导入的模板形式。主键每条单据导入都需指定某个字段作为主键去判断入库校验的唯一标识，由领域单据产品根据业务指定。外键手工码导入框架提供的手工码，有关联主子孙为1条数据的指定作用。无业务含义，由领域自己选择是否使用，若不使用，可以选择自己的业务字段替换手工码的作用，如客户档案的客户编码、物料档案物料编码。用户手册18/34页面说明：1.左树右表结构：左边领域业务对象，右边模板下载功能和上传文件功能，提升了交付团队老师可以通过左边树高效率完成模板下载和导入excel文件；2.数据导入同步的是档案/单据业务入口的下载模板能力、导入能力，按左侧树业务对象统一管理，提升了易用性；3.为进一步提升初始化系统高效率交付工具，实现了批量包导入能力，批量包导入支持3个规则、批量包导入日志、持批量包下载能力、在线矫正数据继续导入能力；下载模板：1）TAB下载模版栏目下，默认展示1条系统级模板；模板分为系统级模板、租户级模板、自定义模板；用户手册19/341.默认展示系统级模板，此条数据来源分为两种情况：一方面，领域预置的导入模板；另一方面，如果没有预置导入模板，取系统级UI模板；若启用租户级UI模板后，则采用预置UI模板；2.租户级模板，来源菜单节点【导入导出模板】的创建和发布，如果创建、分配、发布了租户级模版，会在次列表中进行展示。如：【导入导出模板】创建租户级模板并发布后，会自动隐藏系统级模板，但可以给系统级模板分配。3.自定义模板，通过自定义模版按钮创建并发布，属于用户级，权限来源于右上角当前登录用户；另外，右上角当前登录用户在业务入口进行自定义发布后也会进行展示；2）页面类型切换：顶部查询区，支持切换不同的页面类型，模板列表展示对应页面类型下模板；另外，页面类型属于领域注册的billNo来源，因为导入仅支持详情页面类型，因此过滤掉了列表类型的页面类型。用户手册20/34导入文件：导入文件TAB栏下，是单个excel的文件导入，分成前置校验和保存入库的业务校验两个环节，根据页面类型的选择传值过来，选择不同的交易类型，上传的模板文件会对不同的交易类型进行校验；另外，当原厂单据没有交易类型或导入非交易类型的文件时，可以不用选择，直接上传文件导入，如下图：批量包下载：系统级批量管理：属于预置的系统级批量包，便于用户直接下载；批量包包含模版列表展示：bIllNo、单据名称、导入顺序，都是来自于领域注册信息；批量包导入：用户手册21/341.批量导入支持3个导入规则，包含【新增】、【覆盖更新】、【覆盖更新和新增】；导入开始到导入结束，包含三个进程环节：上传文件、前置校验、确认导入；2.导入规则说明：【新增】通过下载的excel模板录入数据后，根据唯一标识主键，以新增规则保存校验入库的过程；【覆盖更新】是根据唯一标识主键，覆盖更新掉系统上已存在的数据；例：若excel模板某行某单元格内含有空格，系统内对应行上有数据，选择覆盖更新后则会覆盖更新清空掉已有数据；【覆盖更新和新增】是根据唯一标识主键判断系统有数据做覆盖更新操作，若未有则新增操作；例：excel模板含有11条数据，10条系统数据库已存在，1条属于新增数据，则选择【覆盖更新和新增】后，10条数据会覆盖更新掉已存在数据，另外1条则以新增方式保存校验入库；注意事项：为保证数据安全，【覆盖更新】【覆盖更新和新增】建议检查好数据再使用，所有操作都会记录在【操作日志】节点内管理；3.上传文件：先选择导入规则才能进行上传文件，若未选择，提示语：“您好，请选择导入规则。”上传的文件仅支持zip包导入，文件大小1GB以内，超过之后提示：“您好，上传文件已超出文件大小，请调整后重新上传。”4.前置校验：上传zip文件后，批量包里包含的excel并联进行解析，有异常后，展示异常框，第一个默认打开，其它默认收起状态，如下图；用户手册22/34支持导出异常原因进行下载修改，修改后，需重新打包，重新上传；5.确认导入：若前置校验通过后，需点击确认导入按钮，进入异步导入状态，调后端接口和领域业务接口进行业务层面数据校验，走页面的保存逻辑入库。若网络异常、关闭当前页面后，导入后端进程继续进行；但看不到当前批次的进程，因此若关闭当前页面提示：“您好，若关闭当期页面，将无法看到导入进程，是否关闭？”用户手册23/346.确认导入后进行保存校验：点确认确认导入后，按照ZIP批量包的顺序关系，分别进行导入，若保存校验有错误，排在此excel文件后面顺序的文件停止导入。在线矫正：，如果错误数量在100条以内，则使用“在线矫正”工具，在线打开excel修改数据，提交后，重新保存校验。重新上传文件并导入：如果错误数量较多，可以导出错误原因，按照错误原因指导，修改excel的数据，修改完成后，点击“上传文件”重新进行保存校验，如下图：用户手册24/347.导入进度-查看导入进程：点按钮后新打开导入进程页面。展示导入校验进程的详细信息，可以查看子任务的原始信息，找出报错的原因。8.查看【导入日志】：点击导入日志，找到当前导入批次任务的日志记录信息。用户手册25/342.5UI模板UI模板，是原厂单据在运行态的显示扩展，UI模板对单据UI元数据进行扩展配置，通过UI元数据配置和高级设计器的扩展配置，依赖MDD和MDF对元数据在运行态的公式能力、参照带入能力、交互规则能力、组件显示属性自定义以及页面布局能力的支撑，结合UI模板多维度的管理分配以及业务规则预置功能，满足原厂单据在不同业务场景的个性化支持。2.5.1产品价值不同角色不同模板：实现租户级不同用户打开业务单据显示字段数量不同、名称不同、布局不同等；不同组织不同模板：实现租户级单据不同业务组织单据显示字段数量不同、名称不同、布局不同等；运用公式满足个性化需求：通过模板配置公式能力，满足客户提出的业务计算、档案取数的个性化逻辑等；在当前组织管理下的自定义UI模板基，支持关联“业务规则、交易类型”，支持分配“参照类型、用户、角色”；2.5.2操作指南2.5.2.1UI模板管理功能布局说明任何一份新的UI模板的生成，都是源于用户想在单据运行时，目标是加载什么条件的模板。基于这种模板使用需求，UI模板管理界面提供了在模板上关联业务条件和分配对象条件，去完成运行态按条件加载目标模板。以下是UI模板管理界面左树右表结构，功能整体介绍：用户手册26/341.未升级原UI模板入口：是原厂领域单据未升级最新UI模板的管理入口，若自定义更多UI模板能力，可联系领域规划升级排期。2.UI模板帮助组件：新增视频和文字说明的帮助组件，通过4分钟视频讲解了两个场景案例，让大家快速理解UI模板的功能和使用方法；点收起后，默认下载收起状态。3.查询区：组织管理放到查询区，默认显示企业账号级；新增业务规则，数据来源于【业务规则】服务节点的新建；交易类型数据来源于【交易类型】服务节点的新建和领域原厂单据的预置交易类型；通过以上三项可精确查询UI模板，并支持优先级设置运行态加载排序。4.优先级设置：在查询区精确选择“业务规则”、“交易类型”后，点优先级设置弹框里显示对应的UI模板，可进行运行态加载排序。5.0租户模板：原厂提供的系统级模板都罗列展示在0租户模板管理列表；6.UI模版列表操作按钮：预置模板操作按钮支持复制、设计、配置、多语、多语；自定义模板支持复制、编辑、设计、配置、预览、启用、删除。2.5.2.2详细功能描述2.5.2.2.1UI模板管理入口：通过菜单【数字化建模】→【模板管理】→【UI模板】，进入模板管理页面。用户手册27/34UI模板管理界面视频讲解的2个场景案例步骤操作：案例一、自定义模板时，支持关联多个业务规则和交易类型，实现共享一个UI模板场景：1.【业务规则】菜单节点里，创建好业务规则；2.【交易类型】菜单节点里，原厂已有预置或创建好交易类型；3.【工作流设计】菜单节点里，流程已关联“业务规则”；4.【UI模板】菜单节点里，自定义UI模板时，关联“业务规则和交易类型”；5.业务单据提交审核，在【代办消息】里，点待办审批单据，加载的UI模板即是关联的业务规则和交易类型下加载的模板；案例二、相同关联条件有多个自定义模版时，通过设置优先级，加载设计的目标模版：1.【UI模板】-查询区，选择好“业务规则”或“交易类型”数据进行查询；2.【UI模板】-列表区，多个U模板时，设置优先级时，把目标模板排序为第一；3.业务单据提交审核，在【代办消息】里，点待办审批单据，加载的UI模板即是排序为第一的UI模板；用户手册28/34UI模板升级后重点说明：升级为新UI模板管理后，主要提升了交互易用性，不会对未升级前UI模板数据造成影响。2.2.2组织管理模板1）所属组织：点击所属组织后，弹框里展示与用户所属权限内的组织。2）展开：如果组织层级多，点击展开方便查找。展示弹框如下图所示：3）组织模板管理：选择不同的组织，打开组织对应的左边树和右边对应组织下的模板管理；默认“企业账户级”；若选择其他组织，选择页面类型，UI模板管理列表没有模板时，可通过点击新增按钮，选中目标模板，复制一份到当前组织下，操作流程如下3张图：用户手册29/34复制成功后，点击“启用”后，对于是否有关联的业务条件和分配条件，在页面类型为详情页是，单据运行态会加载该模板。组织管理重点规则说明：组织下的UI模板属于模糊匹配，在单据运行态做单据时，选了业务条件，而加载的UI模板，若当前组织下没有UI模板，或没有加载对应关联条件的模板，运行态会逐级往上找，直到加载企业账号级组织条件下的目标UI模板。用户手册30/342.5.2.2.2查询区和列表管理：1）查询区默认是全部打开查询条件：默认组织管理为企业账号级，默认终端类型为PC；展示对应页面类型下，所有关联业务规则、交易类型，和是否有分配条件的所有模板：2）启用租户级模板：未启用租户级模板时，列表为空，默认展示按钮“启用租户模板”；点击启用后，则显示预置模板：预置模板支持复制、配置、设计、多语、预览的操作；备注：若模板需要个性化复杂设计，建议复制一份新的模板进行设计；预置模板一旦设计出问题，与原厂系统级模板相差太大，仅支持手动恢复。3）自定义模板：基于业务需求设计一份新的模板，通过点击复制按钮，打开弹框，是否设置两次加载条件：1、关联条件“业务规则”、“交易类型”、“组织管理”，组织管理数据值仅支持从查询区选择后默认回显；2、分配条件“参照类型”（领域单据若适配此能力后才会显示参照类型选项）、“用户”、“角色”；用户手册31/34确定后会生成一份自定义模板类型，自定义模板类型支持编辑、删除；4）默认排序：默认情况下，管理列表显示的优先级排序为原厂提供的主排序；若调整加载顺序，需要通过“优先级设置”调整排序顺序：操作步骤：o查询区选择2个条件“业务规则和交易类型”；o点击优先级设置，弹出当前生效条件下的模板列表；o通过上移、下移，调整优先级顺序；o点确定后，便会展示生效条件下的模板顺序；用户手册32/342.5.2.2.3租户模板管理：1）0租户模板概念：指由原厂单据提供的UI模板，未启用租户级模板前，默认加载的是0租户模板，类型是“系统模板”，状态是“未初始化”；一旦启用租户模板后，默认加载的是租户级模板，0租户模板状态显示“已初始化”；2）添加到租户级：一旦启用租户模板后，原厂再次预置了其它系统模板，需要用户点击”添加到租户级”去复制到租户级UI模板管理列表；点击”添加到租户级”去初始化到租户级UI模板管理列表，点完之后，提示“添加成功”，若PC下没有，则点击终端类型Mobile去查看，如下图，显示在了移动端类型下：而添加完后，0租户级模板列表，状态显示为“已初始化”：用户手册33/34
