YonBIPV3.0(R5_2312)YonSuite云平台篇-连接集成服务-数据集成用友网络科技股份有限公司2024年1月用户手册1/29版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/29目录第一章总体概述...............................................................................................................................................31.1产品概述...............................................................................................................................................31.2产品价值...............................................................................................................................................4第二章应用场景...............................................................................................................................................5第三章操作指南...............................................................................................................................................63.1集成设计...............................................................................................................................................63.1.1总体概述...........................................................................................................63.1.2数据转换规则..................................................................................................63.1.3集成方案设计..................................................................................................83.2集成任务.............................................................................................................................................153.2.1数据同步任务................................................................................................153.3集成监控.............................................................................................................................................253.3.1预警配置.........................................................................................................253.3.2集成任务监控................................................................................................26用户手册3/29第一章总体概述1.1产品概述数据集成主要承接用友云与ERP混合云应用场景及社会化应用的数据集成；提供连接配置、、数据交换定义、数据同步任务、定时任务管理，在云计算时代，企业应用系统的架构往往以混合云的方式存在，如购买的ERP部署在私有云环境下，而某领域的业务系统是基于云服务架构，则可通过数据集成来打通主数据、业务单据的协同，同时开放连接服务也提供丰富的电商连接器来帮助企业快速对接社会化的电商平台，实现产品采购的合作和寻源。数据集成通过预置提前将功能实现好，为企业提供开箱即用式的集成服务，为企业提供200多项数据的同步，连接多种ERP（NC、NCC、U8、U8C、U9等）。如已经是NC/NCC/U8/U8C/U9的客户，在保持现有系统不变的情况，需要加购云服务（协同云、人力云、营销云、采购云、财务云等），则可通过数据集成的数据集成来实现主数据的同步，业务单据的协作，主数据以ERP为主控方，即主数据的主要维护方为ERP，维护好的主数据通过数据集成同步到云上，作为云上开展业务的数据基础，业务单据的集成主要根据领域的场景不同而不同，如采购场景，采购需求单上传云端，友云采发起寻源等采购过程，生成采购订单后回传ERP，从而实现业务的一体化。主数据预置人员、组织、物料、供应商、客户），主数据的同步目前只支持单集团的集成，业务单据一般由不同领域实现预置成集成资产。用户手册4/29主数据同步：用友ERP客户，经过多年的系统运营，积累了业务依赖的主数据，当采购用友的SaaS服务后，需要实现一体化的体验，则首先需要将主数据同步到用友云，作为业务的黄金数据，而集成服务通过开箱即用、向导式配置的方式实现跨网络环境、跨系统的主数据同步，为业务协同打好基础。业务协同：在主数据同步的基础，实现业务单据在ERP与云服务之间的流转，促成业务的跨系统、跨云的协同，保障用友客户一体化的体验，形成流畅的产品融合集成体系，并支持形成开箱即用的集成资产，对一线人员可直接实施复用1.2产品价值以业务场景出发，将集成开发资产化，场景涵盖之内的集成场景，在实施时不需要开发即可实现ERP与云服务的集成；用户手册5/29与数据集成做了适配的领域云主要有：人力云、协同云、采购云、营销云、制造云等，这部分领域可通数据集成实现ERP与YonBP的主数据同步，也可通过数据集成网关来解决私有环境与公有云的安全连通问题；各领域通过数据集成集成预置了大量的数据同步资产，初始化完成后即可快速实现数据的集成，以NCC为例预置了费用项目、客户、物料、结算方式、产品线、计量单位、客户基本分类、物料分类、品牌、客户银行账户、物料分配关系、客户收货地址、客户联系人、行政组织、预制全局集团组织、部门、财务组织、资产职能、人员类别、人员、核算委托关系、职能共享主表、职务类别、职务、职能共享子表、职位、员工银行账户、国家地区、银行网点、行政区划、证件类型、币种、银行类型、项目类型、项目、组织银行账户、组织现金账户、自定义档案维护、职业资格、客户属性、供应商联系人、供应商分类、供应商、供应商银行账户、供应商联系人、证件类型、多语种、银行类型、币种、银行档案、国家地区、民族、学历、学位、学习方式、户口性质、点检标准关联设备、专业、资产类别、资产卡片、资产状态、测量项目、点检标准设置、供应商联系人、技术参数、资产类别技术参数、关键程度、位置、点检标准、奖励情况、职级、职业资格、职称记录、人员离职、变动类型、职等、人员兼职、人员合同、人员社会关系、变动原因、合同主体、退货原因、人员学历、工作信息、人员履历、人员绩效；数据同步任务的管理为用户提供一定的扩展能力，通过抓紧数据的脚本的修改，很方便的解决同步数据的行、列级的数据范围，从而可快速满足客户个性化需求。数据集成支持使用公共底座连接器，实现跨系统的数据同步需求，例如BIP与三方系统单据集成第二章应用场景典型场景：ERP-采购服务集成ERP与采购云通过数据集成实现基础数据的同步，基于基础数据同步的前提下实现采购场景的业务在跨系统之间的协作，实现在ERP中生成请购单，通过数据集成开箱即用的集成资产，将erp与BIP单据进行双向同步，并生成采购需求，在采购服务中完成寻源采购，生成的采购订单回传给ERP，采购的商品到货后生成到货单，同时将到货单同步给ERP。通过数据集成用户手册6/29的混合云通道与集成资产实现业务的数据同步，促成跨环境、跨应用的业务流转。第三章操作指南3.1集成设计3.1.1总体概述数据同步：主要包括数据转换规则、数据同步任务3.1.2数据转换规则3.1.2.1功能描述数据转换规则，租户可以进行映射关系的修改，一般情况不需要进行调整，反而调整后可能映射不正确的情况，特殊情况下，如企业有个性的映射的需求时才进行映射的修改。3.1.2.2业务规则对数据交换定义进行映射关系的管理；用户手册7/29增加、删除数据映射。3.1.2.3操作说明功能入口：通过菜单，集成连接服务>数据集成>集成设计>数据转换规则，进入功能点击操作列按钮进入数据交换映射配置页面：点击映射关系，展示数据映射，可以根据实际需要更改映射关系维护完成后点击<保存>后完成数据映射的配置。用户手册8/293.1.3集成方案设计3.1.3.1功能描述集成方案升级为新版集成应用；一个集成应用将包含多个集成方案完成一个完整的业务场景；集成应用包含一对连接器进行数据集成设计；集成方案使用该连接器下的对象、操作、映射关系、值转换规则、来源操作、目标操作进行间数据方案合集。3.1.3.2关键应用新增/编辑应用：创建集成应用，选定使用的连接器；新增/编辑集成方案：集成方案的设计，包括集成对象选择、设置映射关系、设置前置任务和其他操作方案、过滤条件的设置；初始化集成应用：根据购买的集成资产包进行集成应该初始化。3.1.3.3栏目说明栏目名称说明集成应用编码用于区分不同的集成应用编码集成应用名称用于区分不同的集成应用名称集成方案编码用于区分不同的集成方案编码集成方案名称用于区分不同的集成方案名称来源集成对象用于集成的作为数据来源方的集成对象用户手册9/29目标集成对象用于集成的作为数据目标方的集成对象模式数据同步碰到问题时的后续处理方案，可以选择错误时忽略，错误时终止自动映射规则来源对象与目标对象的自动映射的规则，提供无、按编码、按名称映射三种规则是否树形档案是否为树状结构的档案启用特征新架构支持使用特征自由辅助属性进行数据同步数据转换规则设定来源对象与目标对象的映射关系翻译器来源与目标数据映射翻译能力操作设定来源操作获取数据、目标操作写入数据方式3.1.3.4操作说明3.1.3.4.1新增/编辑集成应用1.填写集成集成应用基本信息：需要填写名称、编码，并选择一对连接器确定后续集成方案、任务运行的通道；2.连接器一旦选定无法修改，只能修改连接配置3.后续集成方案均会使用该连接器与连接配置用户手册10/292.初始化集成应用：根据购买的资产包，将支持一键会初始化集成应用。3.1.3.4.2新增/编辑集成方案1.点击集成应用进入该应用下的方案管理；2.方案支持编辑删除3.来源连接为统一底座提供的连接器时，支持将该方案发布为api到开放平台进行调用用户手册11/292.新增/集成方案：点击新增或编辑进入集成方案；3.需要填写名称编码等信息4.将会根据选择的连接器，选择该连接器下的分类与对象作为后续映射关系的制作5.支持选择翻译失败时的处理方式，支持忽略与停止6.支持选择根据编码或名称自动进行来源与目标对象的映射7.支持选择模型编码进行数据关系统一存储8.方案支持附件与特征的传递3.检查编辑映射关系；来源字段与目标字段支持搜索选择用户手册12/29支持配置默认值，当来源为空时生效支持配置翻译器，将来源字段翻译为目标字段所需数据翻译器包含档案翻译，常量翻译，公式编辑器处理翻译支持选择翻译失败处理方式，报错、返回原值、返回空值4.设置前置任务及数据处理方式。5.支持选择该方案的潜质方案，在运行时支持自动前置依赖，用户手册13/296.根据来源对象所带的api，选择对应的操作，并填写对应的参数需求7.主动执行的操作，需要增量字段，分页大小，其实页面，主键id，访问参数等字段信息8.来源数据处理设置需要设置查询方法，过滤条件（例如BIP同步组织需要设置code不等于global00）参数设置上设置分页大小、分页方式、总数字字段设置（MDD的均为data）、起始页码1、主键名称、来源对象的父级对象字段（树形结构的必填）、增量字段（用来判断增量的标识）。被动推送操作，仅需要记录主键id用户手册14/299.根据目标对象所带的api，选择对应的操作，并填写对应的参数需求10.支持设置互斥方案，当本方案运行时，互斥方案将会自动停用用户手册15/2911.支持设置回调信息，根据回调接口返回数据给与来源3.1.3.4.3删除集成应用与方案需要先删除集成方案后，才能删除集成应用3.2集成任务3.2.1数据同步任务用户手册16/293.2.1.1功能描述配置完成ERP连接后，数据同步的任务清单将出现在数据同步任务，将企业提供综合管理的能力，帮助企业管理数据同步。3.2.1.2业务规则数据同步任务来自连接配置和集成方案设计两个来源；支持企业管理立即执行某个同步任务；支持企业管理定时执行某个同步任务；支持企业管理排查执行某个同步任务，可以人工定时和加入系统级定时任务；支持数据同步的运行记录查看；支持企业管理修改默认认连接选择的设置；支持数据同步任务的停用；支持视图列定义；支持视图条件定义，根据企业个性化需求修改同步数据的条件；支持编辑数据视图，调整获取数据脚本，主键、分页大小；支持按条件拉取数据；支持详细数据的查看；支持数据映射的查看，查看ERP与BIP对应的主键映射关系；支持公共档案关联的查看，查看此数据同步任务关联了那些公共档案；支持数据同步任务的执行日志查看；支持点击集成方案名称跳转集成方案设计菜单；支持点击定时同步列表查看定时同步任务。3.2.1.3栏目说明列表字段：栏目名称说明方案编码与名称来自erp连接配置和集成方案设计的编码与名称触发方式该方案的来源系统数据获取方式，被动获取将无法立即执行、定时执行、排查执行运行状态该方案的最后一次执行的成功、失败等状态显示连接配置该方案执行在哪个连接上用户手册17/29启用状态该方案是否可以执行开始时间该方案最后一次执行开始时间结束时间该方案最后一次执行结束时间视图列定义：栏目名称说明字段列明字段实际名称字段名称字段中文字段类型字段实际类型参照档案该字段翻译时，使用的档案枚举映射该字段翻译时，使用的枚举视图条件定义：栏目名称说明SQL条件where后面的查询条件是否启用增量是否启用增量数据的同步的标记，勾中启用增量数据同步编辑数据视图：栏目名称说明SQL语句必填，从ERP获取数据的SQL语句ERP主键名称必填，ERP主键字段名称分页大小必填，数据同步一次的传输的数据量大小连接配置：栏目名称说明编码使用连接配置的编码名称使用连接配置的名称数据详情：用户手册18/29栏目名称说明来源主键必填，此数据在ERP的主键值目标主键必填，此数据在SaaS的主键值定时任务：栏目名称说明自定义定时任务用户自己设计定时任务时间系统级定时任务和系统级时间一致形成定时任务排查执行：栏目名称说明条件追加查询条件3.2.1.4操作说明功能入口：通过菜单，连接集成服务>数据集成>数据同步任务。方案管理：点击方案名称弹出方案管理，连接配置的预置档案视图将弹窗显示，集成方案设计将跳转集成方案设计；视图管理：查看视图属性定义、编辑视图任务条件、编辑数据视图、查看历史sql、切换执行的连接、公共档案管理；视图列定义中支持配置翻译档案用户手册19/29视图条件定义中支持设定条件与增量时间用户手册20/29编辑数据视图中支持修改sql立即执行：企业管理员可以点击立即执行数据同步任务；；定时执行：企业管理员可以点击定时执进行条件表达式配置进行数据同步任务；用户手册21/29排查执行：支持带条件查看运行数据与真实报文查看运行记录：可以点击【运行记录】查看某个任务的运行日志，可进看失败日志；支持查看运行记录，与实际运行时的sql（仅预置档案支持）支持将任务重置为失败（仅支持异步回调的物料、客户、供应商档案）用户手册22/29查看详细数据：点击【数据详情】的【查看详细数据】，来查看数据同步的详细数据情况；用户手册23/29查看数据映射：点击【数据详情】的【查看数据映射】，来查看数据映射的情况，同时也可支持人工增加主键映射关系的配置；问题数据重传：数据出现问题，支持最后一次数据重传；支持查看依赖错误与一键重传用户手册24/29同步任务执行日志：点击右上角的同步任务执行日志，查看任务执行的日志及详情。用户手册25/293.3集成监控3.3.1预警配置3.3.1.1功能描述企业使用集成服务，可根据自身需求来启用、停用邮箱，启用邮箱通知后数据同步时会将同步结果以邮件发送给租房管理员。3.3.1.2业务规则支持邮箱通知的启用、停用。3.3.1.3操作说明功能入口：通过菜单，集成服务>数据集成>数据同步>预警配置。支持设置网关离线预警，支持根据24小时离线次数阈值发送邮件支持设置网关每次离线均发送邮件用户手册26/29支持设置任务异常时发送邮件3.3.2集成任务监控用户手册27/293.3.2.1功能描述监控数据通任务的运行情况。3.3.2.2业务规则所有的运行任务请情况均会在这里显示。3.3.2.3操作说明功能入口：连接集成服务-数据集成-集成监控展示任务运行情况，包括1、视图名称编码；2、任务数量；3、触发类型，实时，定时，被动；4、执行时间与结束时间；5、执行状态，成功、失败、部分成功；6、执行详情，所有任务的执行合集详情。用户手册28/29任务详情：连接集成服务-数据集成-集成监控-详情展示本次执行任务与前置依赖任务的所有运行情况1、展示成功、失败信息2、根据依赖关系前后顺序展示3、支持展示错误原因备注4、支持点击日志查看日志详情
