YonBIPV3.0(R6_2407_1)旗舰版云平台-连接集成平台-数据集成用友网络科技股份有限公司2024年9月用户手册1/36版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/36目录第一章总体概述..............................................................4第二章应用地图..............................................................5第三章应用价值..............................................................5第四章应用场景..............................................................64.1场景：ERP-采购服务集成................................................64.1.1业务描述...............................................6第五章集成设计..............................................................75.1总体概述..............................................................75.2数据转换规则..........................................................75.2.1功能描述...............................................75.2.2业务规则...............................................75.2.3操作说明...............................................75.3集成方案设计..........................................................85.3.1功能描述...............................................85.3.2关键应用...............................................95.3.3栏目说明...............................................95.3.4操作说明..............................................10第六章集成任务.............................................................196.1总体概述.............................................................196.2数据同步任务.........................................................196.2.1功能描述..............................................196.2.2业务规则..............................................196.2.3栏目说明..............................................206.2.4操作说明..............................................22第七章集成监控.............................................................347.1总体概述.............................................................347.2预警配置.............................................................34用户手册3/367.2.1功能描述..............................................347.2.2业务规则..............................................347.2.3操作说明..............................................34用户手册4/36第一章总体概述数据集成主要承接用友云与ERP混合云应用场景及社会化应用的数据集成；提供连接配置、、数据交换定义、数据同步任务、定时任务管理，在云计算时代，企业应用系统的架构往往以混合云的方式存在，如购买的ERP部署在私有云环境下，而某领域的业务系统是基于云服务架构，则可通过数据集成来打通主数据、业务单据的协同，同时开放连接服务也提供丰富的电商连接器来帮助企业快速对接社会化的电商平台，实现产品采购的合作和寻源。数据集成通过预置提前将功能实现好，为企业提供开箱即用式的集成服务，为企业提供200多项数据的同步，连接多种ERP（NC、NCC、U8、U8C、U9等）。如已经是NC/NCC/U8/U8C/U9的客户，在保持现有系统不变的情况，需要加购云服务（协同云、人力云、营销云、采购云、财务云等），则可通过数据集成的数据集成来实现主数据的同步，业务单据的协作，主数据以ERP为主控方，即主数据的主要维护方为ERP，维护好的主数据通过数据集成同步到云上，作为云上开展业务的数据基础，业务单据的集成主要根据领域的场景不同而不同，如采购场景，采购需求单上传云端，友云采发起寻源等采购过程，生成采购订单后回传ERP，从而实现业务的一体化。主数据预置人员、组织、物料、供应商、客户），主数据的同步目前只支持单集团的集成，业务单据一般由不同领域实现预置成集成资产。用户手册5/36主数据同步：用友ERP客户，经过多年的系统运营，积累了业务依赖的主数据，当采购用友的SaaS服务后，需要实现一体化的体验，则首先需要将主数据同步到用友云，作为业务的黄金数据，而集成服务通过开箱即用、向导式配置的方式实现跨网络环境、跨系统的主数据同步，为业务协同打好基础。业务协同：在主数据同步的基础，实现业务单据在ERP与云服务之间的流转，促成业务的跨系统、跨云的协同，保障用友客户一体化的体验，形成流畅的产品融合集成体系，并支持形成开箱即用的集成资产，对一线人员可直接实施复用第二章应用地图•数据转换规则•集成方案设计•数据同步任务•预警配置第三章应用价值·以业务场景出发，将集成开发资产化，场景涵盖之内的集成场景，在实施时不需要开发即可实现ERP与云服务的集成；·与数据集成做了适配的领域云主要有：人力云、协同云、采购云、营销云、制造云等，这部分领域可通数据集成实现ERP与YonBP的主数据同步，也可通过数据集成网关来解决私有环境与公有云的安全连通问题；·各领域通过数据集成集成预置了大量的数据同步资产，初始化完成后即可快速实现数据的集成，以NCC为例预置了费用项目、客户、物料、结算方式、产品线、计量单位、客户基本分类、物料分类、品牌、客户银行账户、物料分配关系、客户收货地址、客户联系人、行政组织、预制全局集团组织、部门、财务组织、资产职能、人员类别、人员、核算委托关系、职能共享主表、职务类别、职务、职能共享子表、职位、员工银行账户、国家地区、银行网点、行政区划、证件类型、币种、银行类型、项目类型、项目、组织银行账户、组织现金账用户手册6/36户、自定义档案维护、职业资格、客户属性、供应商联系人、供应商分类、供应商、供应商银行账户、供应商联系人、证件类型、多语种、银行类型、币种、银行档案、国家地区、民族、学历、学位、学习方式、户口性质、点检标准关联设备、专业、资产类别、资产卡片、资产状态、测量项目、点检标准设置、供应商联系人、技术参数、资产类别技术参数、关键程度、位置、点检标准、奖励情况、职级、职业资格、职称记录、人员离职、变动类型、职等、人员兼职、人员合同、人员社会关系、变动原因、合同主体、退货原因、人员学历、工作信息、人员履历、人员绩效；·数据同步任务的管理为用户提供一定的扩展能力，通过抓紧数据的脚本的修改，很方便的解决同步数据的行、列级的数据范围，从而可快速满足客户个性化需求。·数据集成支持使用公共底座连接器，实现跨系统的数据同步需求，例如BIP与三方系统单据集成第四章应用场景4.1场景：ERP-采购服务集成注：业务场景只举一个领域的例子，在使用中可咨询相应的领域产品对接人，获取业务方案。4.1.1业务描述典型场景：ERP-采购服务集成ERP与采购云通过数据集成实现基础数据的同步，基于基础数据同步的前提下实现采购场景的业务在跨系统之间的协作，实现在ERP中生成请购单，通过数据集成开箱即用的集成资产，将erp与BIP单据进行双向同步，并生成采购需求，在采购服务中完成寻源采购，生成的采购订单回传给ERP，采购的商品到货后生成到货单，同时将到货单同步给ERP。通过数据集成的混合云通道与集成资产实现业务的数据同步，促成跨环境、跨应用的业务流转。用户手册7/36第五章集成设计5.1总体概述在快速数据集成场景中，提供的相对于固化的集成流。是通过可视化配置方式，实现一对集成对象的集成过程设计，适用于系统间基础数据同步、上下游业务数据协同场景5.2数据转换规则5.2.1功能描述数据转换规则，租户可以进行映射关系的修改，一般情况不需要进行调整，反而调整后可能映射不正确的情况，特殊情况下，如企业有个性的映射的需求时才进行映射的修改。5.2.2业务规则•对数据交换定义进行映射关系的管理；•增加、删除数据映射。5.2.3操作说明用户手册8/36功能入口：通过菜单，集成连接服务>数据集成>集成设计>数据转换规则，进入功能点击操作列按钮进入数据交换映射配置页面：点击映射关系，展示数据映射，可以根据实际需要更改映射关系维护完成后点击<保存>后完成数据映射的配置。5.3集成方案设计5.3.1功能描述用户手册9/36集成方案升级为新版集成应用；一个集成应用将包含多个集成方案完成一个完整的业务场景；集成应用包含一对连接器进行数据集成设计；集成方案使用该连接器下的对象、操作、映射关系、值转换规则、来源操作、目标操作进行间数据方案合集。5.3.2关键应用•新增/编辑应用：创建集成应用，选定使用的连接器；•新增/编辑集成方案：集成方案的设计，包括集成对象选择、设置映射关系、设置前置任务和其他操作方案、过滤条件的设置；•初始化集成应用：根据购买的集成资产包进行集成应该初始化。5.3.3栏目说明栏目名称说明集成应用编码用于区分不同的集成应用编码集成应用名称用于区分不同的集成应用名称集成方案编码用于区分不同的集成方案编码集成方案名称用于区分不同的集成方案名称来源集成对象用于集成的作为数据来源方的集成对象目标集成对象用于集成的作为数据目标方的集成对象模式数据同步碰到问题时的后续处理方案，可以选择错误时忽略，错误时终止用户手册10/36自动映射规则来源对象与目标对象的自动映射的规则，提供无、按编码、按名称映射三种规则是否树形档案是否为树状结构的档案启用特征新架构支持使用特征自由辅助属性进行数据同步数据转换规则设定来源对象与目标对象的映射关系翻译器来源与目标数据映射翻译能力操作设定来源操作获取数据、目标操作写入数据方式5.3.4操作说明5.3.4.1新增/编辑集成应用1.填写集成集成应用基本信息：需要填写名称、编码，并选择一对连接器确定后续集成方案、任务运行的通道；连接器一旦选定无法修改，只能修改连接配置后续集成方案均会使用该连接器与连接配置用户手册11/362.初始化集成应用：根据购买的资产包，将支持一键会初始化集成应用。5.3.4.2新增/编辑集成方案1.点击集成应用进入该应用下的方案管理；方案支持编辑删除来源连接为统一底座提供的连接器时，支持将该方案发布为api到开放平台进行调用用户手册12/362.新增/编辑⚫填写方案名称与编码：编码不能重复⚫来源与目标连接器选择：根据所属集成应用，选择来源与目标连接配置⚫来源与目标对象：选择该连接器下的对象用于该方案的字段关系映射◼其中旗舰版连接器来源对象或目标对象即为API网关中发布的API⚫错误处理方式：错误忽略、错误跳过，批量执行时产生错误将根据选项进行处理⚫自动映射：根据名称或编码进行转换关系映射⚫树形档案：支持设定该集成方案是否支持树形档案重复推送⚫对应模型编码：设定该集成方案运行时，产生的数据映射关系存储模型，该模型将被其他方案翻译时引用⚫每分钟执行次数：设定该方案每分钟执行上限⚫支持特征转换，如果该方案中有特征自有辅助属性弹性字段，开启将自动通过特征定义翻译自有辅助属性⚫附件传输方案：设定该方案支持附件传输能力，需要连接器支持附件拉取推送能力用户手册13/363.检查编辑映射关系；来源字段与目标字段支持搜索选择支持配置默认值，当来源为空时生效支持配置翻译器，将来源字段翻译为目标字段所需数据翻译器包含档案翻译，常量翻译，公式编辑器处理翻译支持选择翻译失败处理方式，报错、返回原值、返回空值用户手册14/36用户手册15/364.设置前置任务及数据处理方式。支持选择该方案的潜质方案，在运行时支持自动前置依赖，5.来源数据设置左侧操作基本信息⚫获取数据方式：主动拉取，需要填写拉取条件指定拉取来源数据推送至目标系统；⚫获取数据方式：被动推送，通过API网关能力使用API接口调用方案，直接推送数据至目用户手册16/36标；⚫操作：选在该连接器对象的操作进行数据获取⚫分页大小：每次拉取的数据量；⚫分页方式：页码递增，偏移量递增；⚫总数字段设置：来源接口获取总数的字段，分页同步所必须的字段；需要在来源的返回接口参数中加入该字段，该字段可不出现在数据映射规则中⚫起始页页码：指定第几页获取数据⚫来源数据节点：设定获取数据API结构中的数据部分⚫主键名称：用来确认数据唯一性，保证主键回写；⚫来源对象的父级对象字段：同步档案时设置该档案的父级字段；⚫增量字段：查询接口根据增量字段查询最新数据；代表数据新增/修改的时间字段；⚫排序：选择根据哪个字段排序右侧数据查询条件根据选择的操作，展示该API的查询条件，来自于制作连接器时填写的API操作用户手册17/36被动推送操作，仅需要记录主键id用户手册18/366.根据目标对象所带的api，选择对应的操作，并填写对应的参数需求7.支持设置互斥方案，当本方案运行时，互斥方案将会自动停用8.支持设置回调信息，根据回调接口返回数据给与来源用户手册19/365.3.4.3删除集成应用与方案需要先删除集成方案后，才能删除集成应用第六章集成任务6.1总体概述作为集成任务的统一监控，提供可视化，可追溯的链路监控能力，排查数据在同步过程中的数据详情与错误原因6.2数据同步任务6.2.1功能描述配置完成ERP连接后，数据同步的任务清单将出现在数据同步任务，将企业提供综合管理的能力，帮助企业管理数据同步。6.2.2业务规则用户手册20/36•数据同步任务来自连接配置和集成方案设计两个来源；•支持企业管理立即执行某个同步任务；•支持企业管理定时执行某个同步任务；•支持企业管理排查执行某个同步任务，可以人工定时和加入系统级定时任务；•支持数据同步的运行记录查看；•支持企业管理修改默认认连接选择的设置；•支持数据同步任务的停用；•支持视图列定义；•支持视图条件定义，根据企业个性化需求修改同步数据的条件；•支持编辑数据视图，调整获取数据脚本，主键、分页大小；•支持按条件拉取数据；•支持详细数据的查看；•支持数据映射的查看，查看ERP与BIP对应的主键映射关系；•支持公共档案关联的查看，查看此数据同步任务关联了那些公共档案；•支持数据同步任务的执行日志查看；•支持点击集成方案名称跳转集成方案设计菜单；•支持点击定时同步列表查看定时同步任务。6.2.3栏目说明•列表字段：栏目名称说明方案编码与名称来自erp连接配置和集成方案设计的编码与名称触发方式该方案的来源系统数据获取方式，被动获取将无法立即执行、定时执行、排查执行运行状态该方案的最后一次执行的成功、失败等状态显示连接配置该方案执行在哪个连接上用户手册21/36启用状态该方案是否可以执行开始时间该方案最后一次执行开始时间结束时间该方案最后一次执行结束时间•视图列定义：栏目名称说明字段列明字段实际名称字段名称字段中文字段类型字段实际类型参照档案该字段翻译时，使用的档案枚举映射该字段翻译时，使用的枚举•视图条件定义：栏目名称说明SQL条件where后面的查询条件是否启用增量是否启用增量数据的同步的标记，勾中启用增量数据同步•编辑数据视图：栏目名称说明SQL语句必填，从ERP获取数据的SQL语句ERP主键名称必填，ERP主键字段名称分页大小必填，数据同步一次的传输的数据量大小•连接配置：栏目名称说明编码使用连接配置的编码名称使用连接配置的名称用户手册22/36•数据详情：栏目名称说明来源主键必填，此数据在ERP的主键值目标主键必填，此数据在SaaS的主键值•定时任务：栏目名称说明自定义定时任务用户自己设计定时任务时间系统级定时任务和系统级时间一致形成定时任务•排查执行：栏目名称说明条件追加查询条件6.2.4操作说明•功能入口：通过菜单，连接集成服务>数据集成>数据同步任务。•方案管理：点击方案名称弹出方案管理，连接配置的预置档案视图将弹窗显示，集成方案设计将跳转集成方案设计；用户手册23/36•视图管理：查看视图属性定义、编辑视图任务条件、编辑数据视图、查看历史sql、切换执行的连接、公共档案管理；视图列定义中支持配置翻译档案视图条件定义中支持设定条件与增量时间用户手册24/36编辑数据视图中支持修改sql，支持获取云端标准视图•立即执行：企业管理员可以点击立即执行数据同步任务；•定时执行：企业管理员可以点击定时执进行条件表达式配置进行数据同步任务；用户手册25/36•排查执行：支持带条件查看运行数据与真实报文用户手册26/36•查看运行记录：可以点击【运行记录】查看某个任务的运行日志，可进看失败日志；支持查看运行记录，与实际运行时的sql（仅预置档案支持）支持将任务重置为失败（仅支持异步回调的物料、客户、供应商档案）用户手册27/36•查看详细数据：点击【数据详情】的【查看详细数据】，来查看数据同步的详细数据情况；用户手册28/36•查看数据映射：点击【数据详情】的【查看数据映射】，来查看数据映射的情况，同时也可支持人工增加主键映射关系的配置；用户手册29/36•问题数据重传：数据出现问题，支持最后一次数据重传；支持查看依赖错误与一键重传用户手册30/36•同步任务执行日志：点击右上角的同步任务执行日志，查看任务执行的日志及详情。用户手册31/36展示任务运行情况，包括1、视图名称编码；2、任务数量；3、触发类型，实时，定时，被动；4、执行时间与结束时间；5、执行状态，成功、失败、部分成功；6、执行详情，所有任务的执行合集详情。•任务详情：连接集成服务-数据集成-集成监控-详情展示本次执行任务与前置依赖任务的所有运行情况：1、展示成功、失败信息；2、根据依赖关系前后顺序展示；3、支持展示错误原因备注；用户手册32/364、支持点击日志查看日志详情。•任务详情：点击日志进入链路追踪展示任务运行的详细链路：•第一个节点：展示任务启动状态，由定时任务启动、手动启动、API触发启动，将会展示来源与目标接口地址；•第二个节点：定时任务展示来源查询数据情况，API触发展示数据转换规则，均会展示数据列表、基本信息、原始报文；•第三个节点：根据实际链路情况展示网关信息，如存在则展示，不存在不展示，将会展示网关在线情况；•第四个节点：展示推送目标系统，将会展示数据列表、基本信息、原始报文；•第五个节点：根据实际链路情况展示回写操作，如存在则展示。用户手册33/36用户手册34/36第七章集成监控7.1总体概述作为集成平台统一的监控，提供每个任务的详细同步日志与监控大盘，支持客户实时查看数据同步量与成功失败原因7.2预警配置7.2.1功能描述企业使用集成服务，可根据自身需求来启用、停用邮箱，启用邮箱通知后数据同步时会将同步结果以邮件发送给租房管理员。7.2.2业务规则•支持邮箱通知的启用、停用。7.2.3操作说明功能入口：通过菜单，集成服务>数据集成>数据同步>预警配置。用户手册35/36•支持设置网关离线预警，支持根据24小时离线次数阈值发送邮件•支持设置网关每次离线均发送邮件•支持设置任务异常时发送邮件
