UAP报表开发手册

1、UAP报表开发手册说明：本手册是对报表帮助文档的补充，在看本手册前建议先看报表的帮助文档1.数据源定义报表数据源可分为实体关系查询，SQL脚本查询和自定义查询三个类型，如下图所示：1.1查看或修改现有数据源“查看或修改现有数据源”是指对原先已经创建的数据源进行修改（系统预置的数据源不允许修改），或者可以在新建报表时选择已存在的数据源，如下图：报表数齬向导|n|x|报表数齬向导-Inix|ub报表数据向导查看或者修改现有数据源欢迎使用报表数据向导?r新建报表数据源数据源类型数据源名称数据源描述序道着或者修改现有数据源图1.2选“下一步”取消I下一歩|n|x|报表数齬向导|n|x|报表数齬向导us

2、报表数摇向导选择现有的数据源业务对象描述信息项目编码II子产品名称-1衙i数据饗更日志数皓源”前i数据題日志数据源”U870公用目录设遂1aaU870”采购管理aaaaU8CUSTDEF销售管理AAAEi_eemerLtED收付款协違档案1J87LI资金管理AA_B：=LTLkE：O新連业务对象1J87LI丢统管理AACudeCcmt:rarm科目对照业务对象1J87LI系统管理aazwcodeobiect帐务业务对象U870丢统管理Access：ii_iesBO新連业务对象U870丢统管理AcCLilJlLtWum新逹业务对象1J87LI存货檢算AztivitiesBO活动业务对象1J87L

3、I客户关丟管理ActTypeBO活动类型业务对象1J87LI客户关丢管理AdjuetPYoucMlLl货位调整1J87LI库存管理AdiustFVouchsBLi货位调整单表祥U870库存管理APCloseBOU870应付款管理APCIueseBLI1J87LI应付款管理AP_VoucMiLl1J87LI应付款管理AP_VouchEBO1J87LI应付款管理AJlCloeeBO1J87LI应付款管理AJlClosesBLiU870应付款管理AJLVcmcMiUU870应付款管理JlDIFLiroTnEH古卜皆钿筛选器：图1.3则列所有已存在的数据源，选择其中一个，按“下报表数据向导一牛业务对象

4、中可能包含雪牛功能谙选择当前报表数据所使用的功能?功能列表sReportFuncition图1.4功能列表是数据引擎内部使用机制，直接选“下一步”：帮助-Inix|us报表数摇向导配置查询信息？自定岌类型设置|查询结果列丨过滤条件设置数据源服务组件类型:数据源服务类型信息:LfFIDA.Ui3.Services.V：=Lt_iationLogReport.D：at：EL*ari：ationREport,LTIDA.Ui3.Services.V：=Lt_iationLogReport图4.5帮助I这个是设置报表数据源的最后一个步骤，由于选定的数据源为自定义查询类型，所以第一个页签为自定义查询组件

5、的相关信息（关于自定义查询组件的具体情况，请查阅本手册1.3单元）；第二个页签如下图：报表数齬向导报表数齬向导报表数据向导配置查询信息？自定殳类型设置豊询结果列|过滤条件设置I名称数据类型ActiorLN：=uTieBillNoString|String|描述信息（简体）操作类业务对象编码BUN：=jTieCunditicmFieldCaptionString|String|String|业务对象名称批改条件字段名称FieldIDTimeString|IiateTimeI字段功操作时间String|String|Strins|查询结果列是指该数据查询结果的具体情况，包括列UserCode操作员

6、編码V：lueAfterRe：1修改后信息=修改前信图1-6描述信息（繁體）操作類型業務對象編碼業務對象名稱批改條件字段名稱字段ID操作時問操作員編碼修改后信息修改前信息名称，列的数据类型，列的区域语言描述。这些信息将构成报表格式设计时的数据源信息（关于这部分内容的详细情况请参阅UAP报表设计时帮助文档）。另一个页签为“过滤条件设置”，如下图：取消上一歩UperBusiBusiModiFielFielModiUserV：dlu下一歩I凰湘图1.7报秦雜1E向导血e鼻伴宕称iair简体fil拒(EniLi-sJi)EhllT臨a业辜務封弟若轲日呻20:QhTitflA业务羽1!塢码abjectc

7、ode雕員無Ux.rID7jn间出年時間Eodjfiad.limTitldJC-iptiwilitilDLMCFaAldID手ISID手段IDFidIDActidDL廉惟换熬Qperiticin.tyjfCandiLiariIliadsfid.candltlmi413险处曲Ebl修改前倍息修改前fJ&.V1uabfQfitVJ.ncft.ftfltrEftBiLVilueiftcr具体包括过滤条件名称，过滤条件的区域语言描述，这个将在过滤条件的数据源下拉列表中出现，这些信息将用来设置从过滤控件读去用户输入条件值来对查询的结果进行过滤（具体情况清参阅本手册2.2单元）。之后，选择“完成”即结束数

8、据源定义而进入报表格式定义。报表数齬向导1.2实体关系查询在图1.步1骤中选定“实体关系查询”，点击“下一步”则进入实体关系查询类型的数据源定义：-Inix|U8报表数摇向导选择当前查询需要的实体信息查询设置关联实体|实体关丟|士I添加X删除帮助|冬选定实体，然后点击“确定”：报表数据向导U8报表数据向导选择当前查询需要的实体信息查询设置关联实体I实体关丟I核心实体别名实体揺述（简体）揺述（繁體）AA_B：iiLkErLtityAA_B：iiLkErLtity银行档案实体士I添加x删除报表数齬向导报表数齬向导帮助I图I点击“下一步”（如果选择了多个实体，则还需要定义实体之间的关系。关于如何定义

9、一个实体以及如何定义实体之间的关系，请参阅数据引擎的相关文档）：报表数齬向导厂查询设置添加x删除#丈写當小写-Inix|常用|高级|厂禁止行数据重复属性列|行数据权限|更新描述结果列名称属性名称数据类型描述信息（简体）描述信息（中的“查询结果列”。点击“添帮助|报表数齬向导接着必须添加结果列，即图-hrt”报表数据向导配置查询信息？报表数齬向导这里弹出的列表为选定的单个实体或多个实体能查询到的所有的结果列的信息。选定需要的查询结果列后，点击“确定”：数据引擎相关文档）。报表数齬向导1.3SQL脚本查询（含存储过程在图步骤中选定“脚本查询”，点击“下一步”则进入脚本查询类型的数据源定义：种类别请

10、查阅数据引擎相关文档）。其他三个页签中，“查询结果列”和“过滤条件设置”已经在前面的单元中说明，此处不在详述。其中，这种数据源类型有一个“查询参数设置”页签，如下图：报表数齬向导写参数的信息。需要注意的是，参数的名称必须与存储过程或脚本的名称完全一致。运行时查询参数的具体值来源是通过过滤条件获得的，因此查询参数需要和过滤条件绑定在一起（绑定方法请参阅本手册单元）。由于很多存储过程的数据源内部处理时使用临时表，并且将此临时表的数据作为报表的数据源的物理表，因此，为提高效率，报表系统对此种类型的存储过程将直接使用其生成的临时表进行查询，而不再另外创建查询数据的临时表。为实现上述机制，存储过程需要提

11、供一个名称为tablename的字符串参数，报表系统在查询过程中调用该存储过程时，将对此参数传入一个数据库物理表名，存储过程内部处理数据时，需要将处理的最终结果填写到这个物理表中。需要注意的是，这个物理表需要在存储过程内部创建，从而可达到满足存储过程自身对表结构的控制。以下为一个存储过程例子：创建临时表银行编码银行名称-向临时填入数据中国人民银行报表系统将以如下方式调用此存储过程参数串仅为例子而在获取数据时，报表系统进行如下查询：1.4自定义查询自定义查询是指提供一个组件（通常为组件）或组件（通常为组件）来提供获取数据的方法（脚本，存储过程或数据库临时表）。关于自定义查询组件的建立方法请参阅本

12、手册单元。在图1.步1骤中选定“自定义查询”，点击“下一步”则进入自定义查询类型的数据源定义：图1.16其中数据服务信息指的是自定义组件的相关信息，关于自定义查询组件的建立方法请参阅本手册3.单2元。报表数齬向导2.报表过滤条件过滤条件设计除了本身单独提供了过滤条件的设计工具，报表本身也提供了专门为报表设计过滤条件的快捷方式。以下是报表设计过滤条件的入口：用EEP-iraVAP文件叮视團项目迥編辑格式迪工具窗口帮助迪iwciisssurBEnaiissi；aiei為胡為ix:越岂匹凹报表定交n11口时口口|旦阻丨西層|u自司祁叫臣启迎爱|首氏项目管理采购订收货比議项目资源管理器报表数齬向导圍竹

13、丨圖报表数齬向导-印报表电标准条件迄）自定殳条件（s报表标题医采购订收货日报表部门編码部门名称供应商編码供应商名称=行标题区S列标题区-1U8T0曰“二1采购管理白”用报表采采采采计计计计计计报表数齬向导到货日期V单据转V自定殳鱼二成本管理报表数齬向导工具箱报表组件匸指针暉文本数据田简单计算列鐵值型rJ?简单计算列贞他疔复杂计算列鐵值型男复杂计算列反他斶日期数据肩数值数据.k动态图片更静态图片何表达式5普通标签曲、TK114咛报表医域Jj属性耳ReportHm注dmtg-C1-|：|EeRuwHh:i1h1-+CrussCijlujTiriHeadiCruEEllet：_|ReportHead

14、erRep背員色rn罚耨育杲色背豈色报表数齬向导就绪wT002费JFaionalC.2WimlowE.T画3Microso.|用友ERf-US.：1.bmp-I图报表数齬向导文件迪视图项目迥編辑迪格式迪工具窗口(1)帮助迪:或I引0I需裁I冥：錨越匹口盪i冈：劉虧亡切换语言工具箱忝加视閣(A)数据源.G)-1-1采购管理-I-E报表删除Q).1单据转+I-I成本管理报表组件自定艮条件C031-简*采采采采计计计计计计ft项目资源管理器-IEhl采购订收货日报表打开)设対默认(?)雇性疋)丑查询条件标堆条件部门編码部门名称供应商編码供应商名称=行标题区.1自定义+KeportHmader庄Cri

15、jssRciwHeaderjCroeeCuliuTiriHH：di报表数齬向导界面说明：是否支持高级条件：选此项后，在运行时过滤窗口中会出现“高级条件”页签，用于用户自由选择过滤条件的组合。规则组件：此项定义由过滤控件回调的规则组件类。是否取消二次开发：此复选项只有在以“U870”项目进入UAP时才会显示，如果被选中，那么以其它项目进入UAP的过滤设计器不能新增和删除过滤条件。此处可新增或修改一个过滤条件。双击某个已存在的过滤条件，则进入这个条件的修改界面：图2.4界面说明：语种：设置过滤条件项显示的语种。中文简体名称：过滤条件项的键值，唯一标识此过滤条件项，不能重复可以以字母、数字或汉字来命

16、名。标题：在运行时过滤窗口中显示的文字，支持多语种设置。编辑类型：过滤条件项的类型，分别为文本框、参照、日期、数字、枚举、SQL语句、自定义。参照ID：当编辑类型选择参照类型后，必须选定一个参照ID。比较符：过滤条件项比较符号。小数位数：当编辑类型为数字类型时，此选项可以设置小数位数。分组：为过滤条件选定一个分组，在运行时将按照分组来显示过滤条件项。数据源：为过滤条件项选定数据源，可以下拉选择或直接手工输入。顺序号：指定过滤条件项在运行时显示的位置，如果不输入，将自动产生。是否常用条件：如果选中，将在运行时显示在“常用”页签中。是否必输：如果选中，在运行时必须输入值，否则会出现提示信息。是否区

17、间条件：如果选中，在运行时将显示为两个输入框组合而成的形式，表示从值1到值2的意思。在运行时，用户选择或输入的不是单值，而表示一个取值范围。是否多选：如果选中，表示此过滤条件项可以选择多个值。允许用户修改比较符：如果选中，用户在运行时可以通过滤设功能改变比较符。作为或条件：如果选中，在运行时将以“或”条件来组合到过滤条件生成的SQL语句中，默认是以“与”条件组合的。参照返回字段：当编辑类型为参照类型时，此选项表示参照返回的是哪个字段的值。编码对应参照中的主键字段，名称对应参照中的描述字段。也可以手工输入要返回的字段名，一定要与参照中的字段名一致。默认值、到：设置过滤条件项的默认值，将在运行时自

18、动显示。如果为区间条件，可以设置“到”默认值。修改界面的第二个页签是过滤条件项窗口枚举：界面说明：枚举(aa_enum):指在U861中使用的枚举型，此类型是在AA_Enum数据表中定义的。枚举类型，枚举类型名称，是EnumType字段值。默认显示，在运行时当用户点击下拉按钮后显示的可供选择的项，注意是以“,”分隔的EnumCode字段的值。枚举类型：指明在Meta库中的MetaEnumDef表中的枚举，对应MetalD字段。枚举串：如果没有在数据库中预制枚举类型，也可以通过此项输入一个枚举串。格式为“0#1#A#B”，在“#”前的为返回值，之后的则为显示值，并且在返回值与显示值中分别以“#”

19、分隔。只能定义以上三种枚举中的一种，否则会出现提示信息。修改界面的第三个页签是过滤条件项窗口SQL语句：界面说明：SQL文本框：在SQL文本框中输入SQL语句，可以不用加别名。标题：在运行时中显示的列标题，标题数量与上面的SQL的字段对应，并用“,”分隔，例如“标题1,标题2”。返回字段：用此字段的值构成过滤控件返回调用者的过滤SQL语句。显示字段：显示在运行时过滤窗口中的值。在U870中，SQL语句类型的过滤条件主要为兼容以前版本，所以如果在U870中新建过滤条件时，请不要选用SQL语句类型，而改用参照类型。修改界面的第四个页签是过滤条件项窗口SQL语句：弹出式和下拉式，默认为弹出式。分别为

20、关于过滤最后值得特别指出的是，过滤条件之间可控制相互关系，例如两个过滤条件都有参照，则可控制其中一个过滤条件的参照取值范围由另一个过滤条件的取值来决定。此外还存在其他相关控制行为，这些功能都是通过规则组件来实现的。关于规则组件的详细实现，请参阅过滤条件的相关文档。过滤条件与数据源的关系此处主要说明如何把过滤条件跟数据源关联起来，以达到由用户输入来实现查询不同数据的目的。对于实体关系类型的数据源，只要在过滤条件的基本属性页中选择数据源的相应列就能实现，如下图：报表数齬向导用友EBTTUSUAP文件叮视图项目巴編辑格式D工具窗口(1)帮助迪=snT&iwciiaz*nrflEsaiissi厂筒濟匹

21、曙釦阿创亘旦血11?：0：11=报表定殳过酒设计誥过溥頌目语种I简体中文崖I嗇圖丑k|简7|士I新増|X删除眇_即报表视侵*指针丟统观图工具(D帮助財简易桌面基本设置厂是否支持高级条件报表组件晋通标赛基本|枚举|5QL语句祥式报表时进行过滤_重注册|砂退出關快速使用向导，帮助QDj我的报表名称标题编辑类型参照功比较符小数位数分组数据源顺序号磺是否常用条件厂是否区间条件厂允许用户修改比较符厂作为参数SIL,ex:jjiipleex:iJTiple文本框二企业账号是否定长平人账号是否定长是否丢统预制银行编码单位编码银行标识企业账号长度平人账号长度自动带出的平人账号长度时间戳1:園會丨X+石库存管理

22、+仃出口管理+仃结算中心管理-_自定交报表+仃应收款管理-_应付款管理U1应付业务审计查询-_销售管理I89|-11banklrUlCross1-11T77Ji销售订发货日报表“销售订发货月报表J销售订发货周报表J1销售业务审计查询“预测订单对比日报表J预测订单对比月报表J1预测订单对比周报表-_库存管理J库存业务审计查询-_考勤休假管理“考勤日报汇总表J考勤日结果异常报表J1考勤日结果异常报表-_已发布报表-_销售管理劇旳:缺省视(2008-C亀旳:缺省(2008-Cgjbankl：bankl(2008-Cgjbankl：bankl(2008-C員jbankl：bankl(2008-C消息中

23、吞干选项过谑座刷新x删除曰新連通知1_3短信息.保存常用条件加载过滤方案常用条件|exsample中国银仃观图分组bank3毎页行数40审是否显示明细行过滤I取:报表数齬向导对于脚本类型的数据源，无论是简单的脚本类型还是存储过程，都是通过将其参数与过滤条件进行绑定来实现的。如下图：报表数据向导配置查询信息查询脚本设置I查询结果列查询参数设置I过滤条件设置I刷新I过滤条件与脚本或存储过程的联系可分别有两种方式：I帮助I从过滤条件传入单个参数。假如s脚本或存储过程中有两个参数分别为：和C则必须要在数据源设计时的“查询参数设置”页签中分别为每一个参数设置其相关信息。然后再设计过滤条件：QSQL.报表

24、数齬向导用友EBTTUSUAP文件叮视图项目巴編辑格式D工具窗口（1）帮助迪:沉国角|締r轉丨讯會记回己丨瞻因丨越:圏関匹曙釦口口戸旦|叵I孕囲眉报表定殳过酒设计誥过溥頌目_即报表视侵rSO.豹grid语种I简体中文基本|枚举5QL语句祥式|工具箱报表组件.晋通标签设处需要注数为设置”的勺参数为名称标题|#新増|删除空基本设置厂是否支持高级条件图“名称”必须，则“名称”名称标题编辑类型参照功比较符小数位数分组数据源顺序号磺是否常用条件厂是否区间条件厂允许用1修改比较符厂是否哆选厂作为或条件以这样的规则命名：“查询参数为Pa,两者之间相差一个符缺龍E亠一一1亠亠-人、八、十号“”，并且同时可在数

25、据源下拉列表里指定其只（数据源的下拉列表是由数据源设计的“过滤条件设置”页签中的内容决的）。需要注意：此处过滤条件名称的命名方式与其指定哪数据源项没有必然的联系,生有各的作用，具体请参照方式的例确定7良1片子子。用公式胡适从才报表医域取消|却本或存储过程提供了一个名称字符串参数,贝调用时此参数的内容为组织好的fythingwouldbebe11ef整体参数传入。如的一个条件SQ串，其包括的组织项为上述方式1中指定.的数据源11鶴用项，其具体组织成的内容请参阅下述例子。此种方式的目的主要为了方便数据源提供者使用全部的过滤条件。以下为一个存储过程例子（假设使用以上的参数设置）存储过程为：报表数齬向

26、导如果查询报表时的输入为：则报表系统将以如下方式调用存储过程数据源设计者可根据此种调用方式来设置参数的使用情况，其中需要指出的是，中的是数据源设计的“过滤条件设置”页签中的“过滤条件名称”，设计者需要正确的设置此名称才能使在数据源内部能够正确使用。同时可归纳出，方式1中“名称”的命名影响存储过程具体参数的绑定，而数据源的指定影响中具体内容的拼接。报表数齬向导3.报表系统API3.1自定义报表查询入口所谓自定义报表查询入口指的是用设计了一张自定义报表，除了默认的查询入口：门户-视图-我的报表-自定义报表，另外为此报表设置单独的菜单节点来进行查询。只要在此节点的点击事件处理函数中调用报表系统的以下

27、接口就可实现：A.PublicFunctionOpenReport(_sReportIDAsString,_objU8LoginAsObject,_OptionalsubidAsString=,_OptionalrawfilterAsObject=Nothing)AsBooleanB.PublicFunctionOpenReportNoneFilterUI(_sReportIDAsString,_objU8LoginAsObject,_OptionalsubidAsString=,_OptionalrawfilterAsObject=Nothing)AsBoolean接口功能及使用说明：这两个

28、接口是对象中的函数需要引用组件：这两个接口的功能是打开一张报表，两个接口的差异在于前者在打开报表之前会先显示过滤界面，而后者不会(例如在使用联查报表的时候有时不需要进行过滤)。此接口在业务组在其需要打开一张报表时调用。参数介绍：报表的，即将要打开的报表标识。对象，注意：这个对象必须是封装的报表所属的子产品号，这个参数是可选的。注意：当指定了此参数，接口会在随后的处理中按照的规则拼接成真正的报表。可选过滤条件对象（或自定义的过滤条件对象），此对象中必须是（见第四个接口）的一个实现。这个参数通常报表的自定义行为（如联查）时，需要有过滤的情形时会使用到。至于怎么在中设置自己的菜单节点，请参阅门户相关

29、文档。自定义数据源组件报表的自定义数据源是指单独写一个组件来提供报表数据，这种数据源实现方法的优点强大的数据处理能力，这是其他类型的数据源所不具备的。实现方法为：组件中必须实现以下接口publicinterfaceIGetSqlvoidGetSql（IFilterArgse）;接口功能及使用说明：此接口为报表提供自定义数据源。组件的提供方式为首先提供一个实现的组件（组件只需有一个声明相同的函数的类即可），之后将其绑定到报表的数据源（具体方法是请参考本接口示例）。组件的工作方式为报表系统会在展现报表的过程中实例化一个此种类型的对象，通过调用函数来获取数据源。参数介绍：参数是中的类型，在报表系统调

30、用自定义数据源组件的时通过此参数将组件需要的环境信息传入，而自定义数据源组件则将其处理结果通过此参数返回给报表系统。中包含的常用接口：的对象报表数齬向导过滤对象组件数据源返回类型，其值与对应类型为0脚本1存储过程2：临时表其默认值为2脚本或临时表名称存储过程名称示例：以下提供一个名为的的，此组件中定义一个名为类，其代码如下(的)：PublicSubGetSql(eAsIFilterArgs)e.DataSource.sql=“select*fromAA_Bank”e.DataSource.Type=0EndSub构造好组件之后，需要将组件绑定到报表的数据源，绑定方法如下：假设组件名称为：而实现IGetSql的类型名称为：组件的绑定方法：注意：需要注册，不要求具体存放目录，一般推荐存放目录为：.U8SOFTufcomsq，报表数齬向导自定义行为组件自定义行为是指在报表查询结束后，设计