YonBIPV3.0(R5_2312)YonSuite财务云篇-企业绩效服务-EPM数据归集用友网络科技股份有限公司2024年1月版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。目录第一章总体概述..........................................................................................................................................4第二章操作指南..........................................................................................................................................42.1集成设置..........................................................................................................................................42.1.1总体概述............................................................................................................................52.1.2外部系统............................................................................................................................52.1.3导入规则.........................................................................................................................112.1.4期间映射.........................................................................................................................172.1.5任务创建.........................................................................................................................202.1.6任务分组.........................................................................................................................222.2用户执行.......................................................................................................................................242.2.1总体概述.........................................................................................................................242.2.2任务执行.........................................................................................................................242.2.3数据工作台....................................................................................................................292.2.4映射维护.........................................................................................................................31第一章总体概述EPM数据集成的主要功能是从外部系统获取数据，然后使用系统内置处理或者使用规则等方式将数据处理为多维格式，最终把数据通过映射导入到目标系统。EPM数据集成支持数据、凭证和维度的导入，导入时可以选择目标为合并报表、计划预算或者企业报表。EPM数据集成常用术语的定义：•应用模型：指的是在合并、预算等系统所构建的每一个模型；•外部系统：指来源系统，一般指业务系统、数据仓库、文件等数据来源系统；•业务对象：一组数据的集合，一般与表对应，也可以跟文件、SQL查询结果等对应，一个外部系统可以包含任意个业务对象；•导入规则：用于把每一个具体的业务对象与通用接口表关联起来；•任务：用户操作的最小单元，通过任务可以把外部的数据导入到目标系统；•定时任务：由系统启动，任务在某一个时间点（单次或者按某个时间间隔）自动循环执行；•专用接口表：专用接口表与业务对象一对一，保存从外部导入的原始数据,同时保存执行时的任务信息；•通用接口表：所有数据经过处理后都会进入到该接口表，通用接口表除包含业务数据信息以外，也需要包含任务信息等；•期间映射：在创建任务时需要选择期间映射，其中源期间作为源数据的过滤条件，目标期间是指将数据导入到指定的期间；•数据映射：数据进入到通用接口表后，通过维护的数据映射转换后，进入到最终的目标模型中。第二章操作指南2.1集成设置2.1.1总体概述集成设置用于定义集成的外部系统、业务对象、设置业务对象与通用接口表的关联关系等，集成设置一般由管理员完成。包含以下功能：外部系统；导入规则；事件脚本；期间映射；任务创建；任务分组。2.1.2外部系统2.1.2.1功能描述外部系统包括取数来源系统及需取数对象的合集,外部系统为数据归集的起点，必须定义外部系统。2.1.2.2操作说明2.1.2.2.1外部系统2.1.2.2.1.1新增新增外部系统时，选择界面左侧上方的<新增外部系统>按钮新增时，需指定系统类型，填写系统编码，系统简称和说明。系统类型包括：数据库连接、文件、总账、语义模型、计划预算、合并报表和U8。•数据库连接:一般情况下，选择此类型，需要设置数据库连接属性，连接属性作为外部系统的一个参数；•文件：需要文件导入时，选择此类型；•总账：需要从旗舰版总账取数时，选择此类型；•语义模型：需要从语义模型取数时，选择此类型；•计划预算：需要从计划预算取数到合并报表时，选择此类型；•合并报表：需要从合并报表取数到计划预算时，选择此类型；•U8：需要从U8总账取数时，选择此类型。系统默认包含以下参数：•year:年•month:月•period:期间•entity:主体•periodFrom：期间自•periodTo：期间至如果需要增加参数，在新增界面上选择<增行>，会在最下面增加一行空行，参数类型默认为自定义2.1.2.2.1.2编辑当左侧树中选择的是外部系统时，选择<编辑>按钮，可以对已存在的外部系统进行修改。进入修改状态以后，可以修改外部系统说明，参数的默认值、说明、增加参数等。2.1.2.2.1.3删除当左侧树中选择的是外部系统时，选择<删除>按钮，可以删除外部系统及外部系统下的所有业务对象，前提是所选系统中的业务对象没有被引用，否则不能删除。2.1.2.2.1.4新增目录当鼠标悬浮在左侧外部系统上时，点击<+>按钮，可以在该外部系统下新增目录。打开新增目录弹窗后，需填写目录编码和目录名称，新增完成后可在该目录下新增业务对象。2.1.2.2.1.5导出选择<导出>按钮，可以导出当前选中的外部系统定义和业务对象，支持对业务对象进行选择；导出文件不具有可读性，不可修改。2.1.2.2.1.6导入导入外部系统及业务对象，常用于不同环境间的数据迁移。2.1.2.2.2业务对象2.1.2.2.2.1新增新建业务对象时，选择业务对象对应的外部系统，然后选择界面右侧上方的<新增业务对象>按钮打开业务对象新增界面系统支持以下来源类型：•表：当外部系统为“数据库连接”时，支持此选项，可在来源对象中搜索数据库表名选择使用；•SQL：当外部系统为“数据库连接”时，支持此选项；•文件：当外部系统类型为“文件”时，只能选择“文件”；•余额表：当外部系统类型为“总账”时，支持此选项；•现金流量表：当外部系统类型为“总账”时，支持此选项；•语义模型：当外部系统类型为“语义模型”时，可在来源对象中搜索具体语义模型选择使用；•计划预算：当外部系统类型为“计划预算”时，可在来源对象中选择计划预算的应用模型使用；•合并报表：当外部系统类型为“合并报表”时，可在来源对象中选择合并报表的应用模型使用；•U8科目余额表：当外部系统类型为“U8”时，支持此选项；•U8辅助余额表：当外部系统类型为“U8”时，支持此选项；•U8现金流量表：当外部系统类型为“U8”时，支持此选项。当外部系统类型为“数据库连接”、“语义模型”、“U8”时，支持引用外部系统或业务对象（参数页签）所定义的参数，参数的写法为’$参数名$’,参数名区分大小写。比如引用年作为参数，在SQL中可以这样写：WHEREYEAR=‘$year$’；当为“表”类型时可以这样写：YEAR=‘$year$’。2.1.2.2.2.2编辑当左侧树中选择的是业务对象时，选择“编辑”按钮，可以对已经存在的业务对象进行修改。进入修改状态以后，可以修改字段信息，增加、删除字段，增加、删除过滤条件等。2.1.2.2.2.3删除当左侧树中选择的是业务对象时，选择“删除”按钮，业务对象，前提是业务对象没有被导入规则引用，否则不能删除。2.1.3导入规则2.1.3.1功能描述导入规则将业务对象（专用接口表）和通用接口表连接起来，建立业务对象字段与通用接口字段的映射。2.1.3.2操作说明2.1.3.2.1新增新增时，首先选择目标产品：合并报表、《计划预算》，默认显示当前产品下所有的导入规则，可以在上方选择模型来过滤只显示当前模型下的规则。在主界面选择<新增>，会在最下面一行增加一行空行，需要填写以下信息：•规则编码：必填，需要填写；•规则名称：必填，需要填写；•规则类型：必填，合并报表包含数据、凭证、维度和映射四种类型，《计划预算》只有数据和维度两种类型；•业务对象：必填，所有的业务对象列表；•维度：可选，当规则类型为“维度”或者“映射”时必填，其他不需要填写。2.1.3.2.2修改只支持对导入规则名称的修改，需要修改时，选择<修改>，界面进入编辑模式，可以根据需要修改规则名称；如果不需要修改，选择<取消>。2.1.3.2.3编辑详细信息新增完导入规则，保存之后，需要编辑导入规则的详细信息，操作如下图：选择<编辑详细信息>以后，打开导入规则详细信息界面：在详细信息界面对业务对象与通用接口表之间的关联关系进行设定，同时可以自定义字段是否显示以及显示顺序。2.1.3.3事件脚本2.1.3.4功能描述事件脚本区分合并报表、《计划预算》两类产品，用于按照业务对象和导入规则增加处理脚本，方便用户处理复杂的业务逻辑，支持Kettle调用、数据转置、Python脚本、数据库存储过程四种类型。事件脚本区分应用模型和业务对象，导入规则作为可选项，即对相同的应用模型、业务对象可以创建处理脚本，也可以为基于该业务对象所创建的不同导入规则创建不同的处理脚本。2.1.3.5业务规则脚本编辑器支持以下事件：•专用接口导入前:可使用Kettle或数据转置（针对取多数据列进行转置操作）作为处理工具/脚本，两者只能选择一个，不能同时使用（同条件下只能使用一个）；•通用接口导入前：可使用Python脚本或数据库存储过程，两者只能选择一个，不能同时使用（同条件下只能使用一个）。数据库存储过程仅仅是对存储过程的调用，不支持存储过程的编写。一次只能使用一个存储过程，支持对参数的引用(执行的期间名称、执行ID、执行任务的参数等），确保执行的数据可以精确定位到每个不同任务的数据。2.1.3.6应用举例Python脚本示例：#coding:UTF-8#备注：查询无数据时，默认展示该Python脚本模板#main入口函数defmain(context):mapping=context[‘mapping’]dataList=context[‘dataList’]params=context[‘params’]retList=[]fordataindataList:retList.append(fun_mapping(data,mapping))returnretList#数据映射deffun_mapping(data,mapping):age=int(data[‘AGE_DAYS’])/30mapped={}forkey,valueinmapping.items():if(key==‘C2’orkey==‘C3’orkey==‘C4’orkey==‘C5’):mapped[key]=‘[None]’continueif(key==‘C1’):if(age>=1andage<6):mapped[key]=‘AGE1’continueelif(age>=6andage<12):mapped[key]=‘AGE2’continueelif(age>=12andage<24):mapped[key]=‘AGE3’continueelif(age>=24andage<36):mapped[key]=‘AGE4’continueelif(age>=36):mapped[key]=‘AGE5’continuedataValue=data.get(value)if(dataValue==None):mapped[key]=valueelse:mapped[key]=dataValuereturnmapped上面的代码设置C2,C3,C4,C5为[None],然后通过专用接口表字段AGE_DAYS，设置C1的值。2.1.4期间映射2.1.4.1功能描述期间是执行凭证/数据导入任务时的必选参数，但是由于来源系统、目标应用模型不同，对应的期间格式/会计期间有可能不同，为了解决各系统间期间的差异，需要设置期间映射。期间映射按照目标产品、应用模型、外部系统、期间类型区分，期间类型和期间名称在应用模型和外部系统内唯一。2.1.4.2操作说明2.1.4.2.1新增新增期间映射时，首先选择目标产品、应用模型以及外部系统，在主界面选择<新增>，这时会在界面下方新增一行空行，需要填写期间类型、期间名称等信息，其中期间名称仅支持YYYY-MM的形式。2.1.4.2.2修改修改期间映射时，在主界面选择<修改>，用户可以修改任何信息，修改完成以后，选择<保存>；也可以取消修改操作。2.1.4.2.3复制修改期间映射时，在主界面选择<复制>，打开复制界面，填写/选择来源和目标，选择<确定>复制期间到目标。2.1.4.2.4导出模板在主界面选择<导出模板>，系统会导出模板Excel文件，可按照文件中示例修改内容后再将文件导入系统：2.1.4.2.5导出选择部分或全部期间映射关系后，在主界面选择<导出>，可将系统中期间映射关系导出到Excel文件中，常用于不同环境间数据迁移使用。2.1.4.2.6导入期间映射不仅支持复制，还支持EXCEL导入，模板字段与界面排列一致，第一行为标题行；在主界面选择<导入>，可通过Excel文件导入期间映射关系到系统中：2.1.5任务创建2.1.5.1功能描述创建最终用户执行的任务，分为任务和任务明细，任务与导入规则对应，一个任务对应一个导入规则，但是一个导入规则可以创建不同的任务，可以选择应用模型来过滤显示的任务：2.1.5.2业务规则参数由选择的导入规则决定，参数包含导入规则对应的业务对象中引用的参数和导入规则中定义的参数两部分。创建任务时，只能修改参数的值，不能新增、修改参数的名称。注意：如果在创建任务时，没有期间相关的参数，需要检查导入规则的设置,否则所有期间的数据会不经过滤导入到选择的期间当中。其他信息:由导入规则决定，在任务创建界面不能编辑其他信息的内容，只能查看。2.1.5.3操作说明2.1.5.3.1新建新建任务时，任务创建界面选择<新增>按钮，打开任务新建界面：2.1.5.3.2任务信息•导入规则：必填，可选择；•任务名称：必填，默认与导入规则相同，可以修改；•任务说明：可选，默认使用导入规则的说明，可以修改；•期间类型：必填，可选择；•安全类：必填，可选择；•规则类型：由导入规则确定，不可修改；•业务对象：由导入规则确定，不可修改；•源系统：由导入规则确定，不可修改。2.1.5.3.3导出模板任务创建界面选择<导出模板>按钮，导出模板Excel文件，常用于不同环境间的数据迁移：2.1.5.3.4导出选择系统中部分或所有任务，在任务创建界面选择<导出>按钮，导出所选任务及任务明细到Excel文件中。2.1.5.3.5导入在任务创建界面选择<导入>按钮，通过Excel文件导入任务及任务明细到系统中。2.1.6任务分组2.1.6.1功能描述任务分组可以把多个任务打包成一个任务组，可以在任务执行时直接执行任务组，组名称在模型内唯一，组名称由英文、数字、下划线组成：2.1.6.2操作说明2.1.6.2.1新建任务分组创建任务组时，首先选择目标产品，点击主界面上的<新增>，这时打开新增界面，需要填写组名称，期间类型，说明，选择安全类以及执行方式；执行方式分为串行和并行，选择串行时需要制定组内每个任务的执行顺序，执行顺序按照数字填写即可。填好任务组信息以后，通过<新增>按钮增加任务组中的任务。选择任务时，只能选择到与任务组有相同期间类型的任务，选择的任务也不能包括来源为文件的任务；另外，不能将跨产品类别的任务设置为一个任务组。2.2用户执行2.2.1总体概述与集成设置不同的是，用户执行由最终用户或者集成管理员操作，用户执行包含任务执行、执行结果、数据工作台和映射维护等。2.2.2任务执行2.2.2.1功能描述任务执行界面显示用户权限范围内可以执行的全部任务，可以按照产品类别、应用模型、任务类型或者任务名称筛选任务。任务执行界面包括任务信息、参数、其他信息三部分内容。任务信息显示任务相关的属性，比如任务的类型、对应的导入规则类型等；参数显示该任务执行时的参数，用户可以修改参数的值（与期间相关的参数在执行界面不显示）；其他信息为任务对应导入规则中映射类型为特定值的字段。任务的状态为任务最后一次执行的状态，日志为最后一次执行的日志记录。执行任务时，选择需要执行的任务，选择〖执行〗。用户执行后，根据任务类型的不同，会打开不同的执行界面供用户选择执行的期间、执行的步骤等。2.2.2.2业务规则当规则类型为“维度”时:需要选择执行步骤，执行步骤分为导入到接口和导入到系统两个选项。导入到接口指从外部系统获取数据，经过处理后保存数据到接口，然后用户可以在数据工作台检查数据，检查完成以后在数据工作台执行导入操作；导入到系统指数据经过处理后直接进入系统，不需要用户再去数据工作台执行导入操作。当规则类型为“数据”时:来源类型：数据库需要选择执行期间和执行选项，执行选项包含按任务和按公司两个选项。如果选择“按任务”，则在数据在导入多维系统前，根据执行的任务、执行期间删除系统中上一次导入的数据；如果选择“按公司”，则在数据在导入多维系统前，根据执行期间、执行任务包含的实体删除系统中导入的数据，不同选项右侧均有具体说明。特殊来源类型：总账当任务的来源系统为总账时，执行任务时，可根据所选账簿及期间执行导入操作。特殊来源类型:文件当任务的来源系统为文件时，执行任务时，需要先选择对应的文件，然后才能执行导入操作。2.2.2.3执行结果2.2.2.4功能描述用于查看任务的详细执行情况，包括执行状态、日志、开始时间、结束时间以及本次执行是否是由分组任务执行等，还可以查看每个步骤的执行时间、操作的记录数。执行结果按照执行ID倒序排序。2.2.2.5操作说明2.2.2.5.1日志查看点击日志列的<查看>按钮，可以查看详细的日志信息。2.2.2.5.2跳转数据工作台点击数据详情列的<已导入>或<未导入>按钮，可以跳转到数据工作台节点查看该任务最后一次执行时的数据详情。2.2.3数据工作台2.2.3.1功能描述数据工作台用于分步查看接口数据和导入状态，也可以在数据工作台分步执行任务。支持按照产品类别、应用模型、任务和期间查看数据、执行任务，支持将查看的数据导出到EXCEL中。2.2.3.2操作说明2.2.3.2.1数据查看如果需要查看某个步骤的数据，只需要选择相应步骤的序号，序号颜色分为以下三种：•白色：未执行；•蓝色：当前选中节点；•绿色：已经执行。2.2.3.2.2分步执行如果需要执行某个步骤，需要点击步骤序号下面的步骤名称。对于数据和凭证类型的任务，包括三个步骤：从源导入、数据处理和导入系统。对于维度类型的任务，可以在数据工作台检查、修改数据，然后导入到系统维度中。执行步骤出错时，相应的步骤的名称会变成红色，可以在执行结果节点查看详细日志。•从源导入：把数据从源系统同步到专用接口表中；•数据处理：专用接口表中的数据经过逻辑加工处理并且映射以后保存到通用接口表中；•导入系统：将通用接口表中的数据导入到目标应用模型中,导入成功后，状态为“执行成功”，因为数据问题导入失败时，状态为“执行失败”，这时，执行详情中有相关的错误信息。数据导入时，可以分步执行。维度导入时，支持编辑2.2.3.2.3数据筛选在数据工作台上查看数据时，支持按照字段筛选数据。筛选时，单击需要筛选的字段，打开筛选界面。也可以点击任意字段，打开筛选界面，然后在筛选界面切换需要筛选的字段，可以根据需要，增加多个字段。2.2.4映射维护2.2.4.1功能描述用于维护业务数据到最终应用模型的映射关系。对于合并报表来说，可以按照应用模型、目标维度、来源系统和导入规则建立映射，来源系统和导入规则可以为空；对于计划预算来说，可以按照目标维度、维度体系、来源系统和导入规则建立映射，来源系统和导入规则可以为空。除期间（年、月）、业务方案(SCENARIO)、度量维（VIEW）、审计线索（TRAIL）、合并范围(SCOPE)、版本(VERSION)、币种(CURRENCY)等以外的维度都需要创建映射。2.2.4.2业务规则2.2.4.2.1映射类型支持一对一、BETWEEN、IN、多维匹配、模糊匹配等映射类型，除一对一映射以外，其他类型维护时都需要填写映射的规则名称。下面以实体为例说明这几类映射的使用方法：一对一映射：顾名思义，来源系统中的一个值，只能映射到目标模型中的一个具体的值。例如：IN：来源系统中的几个具体的值，可以映射到目标模型中某一个具体的值，值与值之间用逗号分隔。例如：Between：来源系统中一个连续范围内的值，可以映射到目标模型中一个具体的值，最大最小值之间用~分隔。例如：多维匹配：一对一映射、IN、BETWEEN这3类映射只能从一个字段映射到目标维度，多维匹配是来源中的几个字段形成一个组合条件，以此来决定数据映射到目标模型中的哪个值。例如：模糊匹配可以使用“*”号来指定具有相同特征的一部分值如何映射，“*”指任意个字符。最简单的一个例子是“*”对“*”，也就是原值和目标值一致。也可以做一些其他的映射规则，比如在源值前面加一定的字段作为目标值，比如“*”对“A*”,这个映射的作用就是在每个科目前加字母A作为目标值。各页签支持目标使用“ignore”对数据进行忽略。2.2.4.2.2映射的顺序映射按照以下顺序使用：一对一INBETWEEN多维匹配模糊匹配在同一个类型中，按照映射规则名称的字母升序优先选择。2.2.4.3操作说明2.2.4.3.1映射的使用确定映射大类对于每一个需要映射的维度来说，可以按照应用模型、来源系统和导入规则建立映射，因此，查找时，先从最细的粒度查找维度对应的映射，找到以后不再继续查找。1.根据导入规则、外部系统、应用模型去查找映射，如果有，该任务使用找到的映射进行处理；2.按照1查不到时，则按照外部系统、应用模型查找映射，如果有，使用该映射；3.按照2查不到时，则按照应用模型查找，如果还是找不到，则执行时数据无法进行映射处理。查找具体的映射查找完使用哪个大类的映射以后，按照映射的顺序依次查找具体的映射的值，找到第一个满足条件的映射后不再继续查找。
