浪潮GSPV6011自定义查询用户手册

浪潮GSP应用中间件软件V6.0.11浪潮GSP应用中间件软件浪潮GSP自定义查询用户手册浪潮通用软件有限公司

版权声明本手册的著作权属于浪潮通用软件有限公司，未经浪潮通用软件有限公司事先书面许可，本手册的任何部分不得以任何形式进行增删、改编、节选、翻译、翻印或仿制。本手册的全部内容浪潮通用软件有限公司可能随时加以更改，此类更改将不另行通知，具体应用以软件实际功能为准。“浪潮“、”inspur”是浪潮集团有限公司的注册商标，“通软”为浪潮通用软件有限公司的注册商标。Windows®，WindowsNT®，SQLServer®是MicrosoftCorporation的注册商标。本书中涉及的其它产品商标为相应公司所有。

前言感谢您使用浪潮GSP应用中间件软件，本说明书包括以下内容：系统概述、应用指南、操作指南、应用示例四部分内容。本说明书将帮助您了解和使用浪潮GSP自定义查询。本书读者对象本手册适合在相关业务领域有较好的工作经验和知识，并对浪潮GSP应用中间件软件的基础知识有整体的了解的对象使用。如果您没有使用过本系统，建议您在阅读本手册之前接受一次或者更多的相关培训课程。如何获得帮助您可以通过以下途径获取帮助：在线信息如果您需要及时了解浪潮集团的产品动态，交流产品应用解决方案，可以登录浪潮集团网站（/erp），关注浪潮GSP官方微博（/inspurgsp），以及在微信通讯录中点击添加按钮，搜索并关注浪潮GSP官方微信公众号“Inspur_GSP”。售前咨询服务如果您需要根据企业的发展和信息管理需要，提供管理咨询及解决方案，您可以联系浪潮ERP售前咨询顾问为您做售前咨询服务。产品培训浪潮ERP提供完善的产品培训服务，通过浪潮资深的产品培训讲师，您可以加快了解浪潮GSP应用中间件软件。实施咨询服务通过现场的实施咨询服务，您能够分享实施顾问的经验，深入掌握浪潮GSP应用中间件软件的应用。呼叫中心您可以拨打400-658-6000进行产品咨询和问题答疑。合作伙伴服务浪潮ERP有众多经过认证的合作伙伴，您可以咨询您身边的合作伙伴，寻求服务。关于浪潮ERP浪潮集团是国内知名IT企业，以软硬一体化综合实力而见长。拥有3个上市公司，其中，服务器和ERP管理软件是浪潮集团两大主导产业。浪潮ERP具有20年发展历史，是中国最主流的ERP产品之一，是国内最早定位于高端市场的管理软件厂商，帮助制造业等传统产业通过提升管理水平，促进企业节能降耗、提升效益。浪潮是中国最早的分行业ERP供应商，浪潮ERP

在军工、装备制造业、建筑、制药、快消品、化工、国资监管等行业应用具有领导地位。目前，公司提供了“集团财务、资金管理、财务控制、全面预算、资产管理、供应链管理、销售与分销、生产管理、人力资源管理、商务智能、协同办公”等解决方案，成功协助国务院国资委直属38%的企业进行了信息化改造。公司提出了以客户需求为导向的“3+1战略”，即将“引领高端、专注行业、普及应用”作为三个战略方向，以实现“与战略性客户（SCB）共成长”为核心战略目标，为客户创造价值，与中国企业共成长是浪潮ERP不断前进的永恒动力。浪潮素以技术见长著称。浪潮ERP是中国最早的基于大型关系型数据库开发的企业管理软件，也是中国第一个同时支持国内（PRC）和国际（IAS）两种会计准则的管理软件。浪潮ERP参与制定并通过了ERP领域第一个中国国家标准（GB/T19581－2004）。浪潮ERP、SCM、CRM全部列入中国国家863计划。浪潮长期与IBM、微软等国际知名厂商及普华永道等咨询公司合作，并于2004年以来与微软公司建立了全球战略合作伙伴关系，使浪潮ERP成为目前中国最先进的基于.net平台的ERP软件产品。浪潮秉承“以客户关注为焦点”的企业文化，在全球构建起以中国为核心，覆盖日本、中国香港、新加坡、美国、委内瑞拉等多个国家和地区的服务支持网络。浪潮强调ERP研发前移（CCD），并在ISO9001:2000版国际质量体系认证的基础上，建立起全面的客户服务平台。编写约定在本书中有许多约定，在使用过程中您会发现他们很有用。1、注意事项的标注，如下所示：注意：本书中大部分章节都会涉及这样的注意事项，用来帮助你解决一些常见的问题以及疑难，或者提出一些中肯的意见。2、【】：表示窗口中的项目或栏目、按钮。3、<>：表示键盘上的一个功能键。例：<Enter>、<Esc>等。如何使用本手册本操作手册分为四部分：系统概述、应用指南、操作指南、应用示例。如果您想了解本系统的概貌及系统中能够处理的特色业务场景，您可以重点关注系统概述和应用指南部分，这两部分对您诊断与规划系统具有指导意义；如果您需要知道如何在软件当中进行操作，您可以参照操作指南、应用示例部分，这两部分能够指导您操作浪潮GSP应用中间件软件。软件操作约定登陆浪潮GS管理软件套件后，主界面显示如下：框架工具栏：系统框架的常用功能放在此处，如我的首页、功能快速查找打开等功能。模块列表区：功能菜单的模块级导航树，便于功能菜单的打开。模块功能区：功能菜单列表，按功能菜单分组展示。状态信息区：显示当前登陆信息。协同中心：消息、任务中心，接受、查看、发送消息，显示任务处理情况。权限切换区：根据模块业务处理需要，各模块可相应切换权限信息，如：财务会计可以切换核算组织、业务日期等权限信息；预算可以切换预算组织、业务日期等权限信息。GSP平台不需要切换权限信息。目录1系统概述 81.1操作流程图 82操作指南 82.1自定义查询设计 82.1.1自定义查询设计管理界面 82.1.2自定义查询向导 92.1.3自定义查询修改 282.2自定义查询导出 342.3自定义查询导入 35附录一：查询手工开发步骤 381查询条件开发 381.1定义查询条件数据模型 381.2根据提供的条件表单模板，生成条件表单 381.3将数据模型中条件字段拖到表单中，如需要，为表单编写业务上下文相关控制器方法； 382查询数据处理 392.1SQL 392.2存储过程 392.3服务器程序集IBusinessQueryServer接口实现类 393查询结果展示 393.1展现 393.2联查 394查询元数据编辑 404.1查询包元数据 404.2结果界面配置 424.3展示控件配置 424.4联查配置 424.5查询展现 444.6查询格式处理 455 功能发布 455.1将最初定义的条件表单发布为构件； 455.2功能菜单中配置构件参数{FORMSTATE~QUERYPKGID}=myQDPDemo形式； 455.3配置功能菜单的下载单元依赖于如下三个下载项 455.4将相关表LSQryPackage、LSQryData、LSQryCond、LSDYGS等内容连同表单、构件元数据一并导出连同业务构件打包到补丁文件中提供给最终用户。 466各表单模板对应使用场景 466.1简单条件表单（无方案） 466.2简单条件表单（带方案） 466.3条件表单（无方案带过滤） 476.4条件表单（带方案带过滤） 486.5复杂条件表单（带方案带过滤当前界面显示） 486.6复杂条件表单（带方案带过滤） 497基础控制器方法 497.1统一查询平台条件控制器方法 497.2统一查询平台结果控制器方法 50附录二技术支持 51系统概述长期以来，各个业务模块都有自己的查询功能，然而实际应用过程中，固有的查询或多或少地无法满足客户需求。一些较大的通用需求可以通过业务模块完善查询功能来提供，而一直缺少一套简单易用的工具供实施服务人员、系统管理员来处理非常个性化、多样化的需求，为此，我们提供了本功能。操作流程图 完整操作流程如下图，分为三部分：自定义查询设计、导出、导入。其中设计又分为向导、编辑、发布等三部分。整个功能以自定义查询设计为主线，导入导出是为便于功能复制、部署而提供。操作指南本章节将指导您完成软件的具体操作，操作步骤指导您在软件中的菜单路径，项目说明指导您了解软件项目的含义，操作流程是对一些复杂流程处理的说明，操作说明是对软件功能的动作解释，注意事项是对一些容易引起的错误和疑问进行的说明。自定义查询设计自定义查询设计管理界面操作步骤登录系统，点击【GSP平台】→【专业开发平台】→【查询平台】→【自定义查询设计】操作说明 按功能位置打开，进入功能界面如下图所示，管理界面分为三个区域，分别是操作区、业务对象树区和自定义查询列表区。当选择左栏业务对象树某一节点，右栏列表将显示按业务对象过滤后的可用查询。也可在右栏过滤区输入内容以显示符合条件的查询。功能说明 【新增】：点击本按钮，将以新开窗口方式显示自定义查询定义向导，如果点击前已经在左栏选择某一具体的业务对象，则向导中新增的自定义查询将自动带出该业务对象，否则需要指定。 【修改】：选择右栏列表中某一查询后点击本按钮，将以新开窗口方式显示当前选中查询的所有定义信息以便操作员进行修改。 【删除】：选择右栏列表中某一查询后点击本按钮，系统提示是否删除的确认窗口，确认则定义的查询和据此发布的功能菜单将被删除。 【预览】：选择右栏列表中某一查询后点击本按钮，可以预览查询效果，注意，只有发布为功能菜单的查询方可预览。 【发布】：选择右栏列表中某一查询后点击本按钮，将弹出查询发布窗口，本功能仅对尚未发布到功能菜单的查询有效，如果想修改功能菜单相关信息，可以到功能菜单维护中修改或在本界面取消发布后再点击本按钮。注意，受客户端框架更新机制限制，功能菜单的更新必须重启客户端方可生效。 【取消发布】选择右栏列表中某一查询后点击本按钮，将删除查询在功能菜单中定义，本功能仅对已经发布到功能菜单的查询有效。注意，受客户端框架更新机制限制，功能菜单的更新必须重启客户端方可生效。 【关闭】：退出本功能。自定义查询向导操作步骤见2.1.1节【新增】功能说明。操作说明 点击管理界面【新增】按钮，将以新开窗口方式弹出查询定义向导，整个向导分为基本信息定义、数据组织定义、查询参数定义、结果显示格式定义、功能发布、定义综述六个步骤。操作员可在每页定义完毕点击下一步进入下一页定义，或点击上一步重新修改定义。以下逐一展开说明。基本信息定义操作说明 界面如下图所示，本界面分为基本信息、数据组织方式选择、结果展示形式选择三部分。功能说明 【基本信息】：包含对编号、名称、业务对象的定义，编号和名称均不允许与已有自定义查询重复。系统默认按QDP+年+月+小时分秒方式形成编号和名称，建议根据要查询的内容修改为好记、容易理解的编号和名称。注意，发布功能菜单时默认采用此处定义的名称。如果在管理界面已经选择了一个业务对象，业务对象栏将直接采用，否则必须由用户指定一个。以上三项内容均不允许为空。【发布平台】：可以选择将自定义查询发布为适用于Winform平台的查询或者是适用于Web平台的查询。【取数方式】：系统提供SQL、存储过程、程序集、数据模型四类数据组织方式，默认为SQL方式，操作员可根据实际情况选取。【结果展现模板】：系统支持以网格、树形、交叉表三种方式展现数据。注意，如果选择树形展示，必须指定展示的依据，目前支持主从节点方式和分级码方式。数据组织定义数据组织定义根据第一步选择的组织类型不同而不同，以下将展开详述。参数管理操作说明数据组织中的参数是后台数据库执行获取数据时做变量值替换用的。由于每种数据组织定义中的参数管理都具有共性，在此统一说明。参数管理界面如图所示：功能说明【新增参数】：新增一个参数到参数列表中，存储过程方式无法使用本操作。【删除参数】：删除一个已经定义好的参数，存储过程方式无法使用本操作。如果是SQL方式，在下一步或保存时将检查参数是否在SQL中用到了，如果没用到，会提示操作员是否删除，此时选择是即可。【添加参数到SQL编辑器】：将在SQL当前光标位置插入当前行的参数名，以降低操作员手工添加的复杂度，避免出错。也可双击当前参数行最左侧“>”添加到SQL编辑器中。本操作仅对SQL数据组织有效。【参数列表内容】：<取数参数>：数据组织时参数的名称，一般为具有一定上下文含义的英文单词。要求名称不能重复。对于数据模型方式，由于允许为同一参数设置不同比较符，可以增加并从下拉列表中选择相同名称参数，如图（数据模型方式参数选择）所示。（数据模型方式参数选择）<类型>：目前支持字符、整型、数值、日期四种。<值>：参数的值既可以来自查询参数界面，也可以来自系统级上下文信息或通过表达式计算获得。下图列示了值的几种来源。注意，在值内容上双击即可打开表达式编辑器。（参数值来源于查询参数）（参数值来源于表达式）<调试值>：为了数据预览和显示格式设计用，如果输入了调试值，可以直接预览显示效果。<作为查询参数>：如果选中，则该参数将自动追加到查询参数列表中并在查询参数界面上显示，对于有些直接取自系统Session信息的参数，不必选中本选项。在数据库执行方面，存储过程具有严格语法，要求必须参数名、参数类型一致，所以存储过程方式时参数值、参数类型都不允许变更，直接读自存储过程定义本身。【树形结构设置】：为了能够以树形方式显示数据，需要定义其显示依据。以下分别是主从节点方式和分级码方式定义界面。如果输入了正确的调试值，并且执行了预览，操作员可以从下拉列表中选择主节点、上级节点或分级对应的字段，否则需要手工输入。分级结构只允许是数值，如科目字典一般采用422方式，例如：科目形式为1001-22-01，此处分级结构输入422即可。（主从节点树形方式）（分级码树形方式）SQL方式操作说明 初次进入SQL定义界面时如下图所示，有一段简短的使用说明，可通过双击编辑器清除掉。建议操作员在数据库系统自带的SQL查询分析器中验证SQL语法通过后粘贴到本编辑器中。（SQL方式初始界面）（SQL方式定义界面）功能说明 【语法检查】：对当前定义的SQL进行语法合法性检查，语法检查不通过不允许执行下一步，由于采用了预执行检查方式，要求操作员必须数据可以正确执行的调试值。 【数据预览】：按照操作员提供的调试值，系统会获取相关符合条件的数据并展示，如下图所示： 【参数管理】：点击本按钮，系统会显示/隐藏参数管理界面。存储过程方式操作说明 存储过程定义界面如下图（存储过程方式初始界面）所示。操作员进入后可点击选择存储过程右侧编辑框的“…”按钮，系统会列出本数据库实例中所有可用存储过程，如图（存储过程选择界面）所示。选择某一存储过程后点击确定，系统将自动添加存储过程所需参数及类型如图（带存储过程参数界面）所示，操作员只需输入调试值尝试预览即可。（存储过程方式初始主界面）（存储过程选择界面）（带存储过程参数界面）功能说明 【数据预览】：按照操作员提供的调试值，系统会获取相关符合条件的数据并展示。程序集方式操作说明 程序集定义界面同存储过程定义界面类似。操作员进入后可点击选择程序集右侧编辑框的“…”按钮，系统会列出本数据库实例中所有可用程序集，如图（程序集方式选择界面）所示。选择某一包含实现了IBusinessQueryServer接口类的程序集后点击确定，取数参数可在此添加或在下一步查询参数中定义。（程序集方式选择界面）功能说明 关于IBusinessQueryServer接口方法说明见附录。数据模型方式操作说明 操作员进入后可点击选择数据模型右侧编辑框的“…”按钮，系统会列出本数据库实例中所有可用数据模型，如图（数据模型方式选择界面）所示。选择某数据模型后点击确定，系统将自动生成数据组织参数如图（数据模型方式参数初始界面）所示。操作员可将不希望参与到条件中的参数删除，并为不同的参数设置比较符，最终形成如图（数据模型方式参数定义完成界面）所示。（数据模型方式选择界面）（数据模型方式参数初始界面）（数据模型方式参数定义完成界面） 本示例的含意是取员工内码为9999，单位内码为GSP的员工在2011年1月1日至31日期间工时大于3小时的任务项。其中员工内码和单位内码可以在后续查询参数界面中定义为帮助类型， 无需手工输入。功能说明 【数据预览】：按照操作员提供的调试值，系统会获取相关符合条件的数据并展示。查询参数定义操作说明系统会自动将上一步定义的作为查询参数的数据组织参数带到本界面，只需简单修改下即可。根据上一步的工作日志数据模型形成的查询参数如下图所示。查询参数是在打开功能时条件界面上显示的可视化输入框，可同数据组织中参数保持一致，也可比其参数更多或更少，二者是弱引用的关系。可以通过上移下移调整界面中显示顺序。功能说明【增加】：新增一个查询参数到列表中，新增的参数不允许重名。【删除】：删除一个已经定义好的查询参数。【上移】：将当前选中的参数上移一行。【下移】：将当前选中的参数下移一行。【参数列表内容】：<参数>：查询参数界面控件的名称，一般为具有一定上下文含义的英文单词。要求名称不能重复。<显示名称>：查询参数界面控件的标签，建议定义为便于理解的汉字，如起始日期、姓名、单位等。<输入类型>：系统支持手工输入、帮助、标准编码、只读四种。其中定义为只读的只在界面上显示，不允许功能使用者修改，一般用于根据系统登录Session信息进行查询过滤的场景。本演示中员工内码默认值即来自于系统Session中登录账号。<是否显示>：选择是，则本参数在界面上显示，否则不显示。<是否必输入>：选择是，则功能使用者必须输入值方可查询，否则不允许查询。<默认值>：可定义界面显示时输入框的默认值，可以来自于系统Session信息，双击单元格即可调出表达式编辑器，便于公式定义。查询结果展示格式定义操作说明 如果操作员定义了调试值，将在本界面显示格式预览。最初执行时将按数据库中实际字段名称显示，如图（初始格式）所示。可通过点击【格式设置】按钮进行修饰，最终如图（修饰后格式）所示（初始格式）功能说明【刷新数据】：可以在修改数据组织的调试值后点击本按钮重新获取数据。【格式设置】：点击本按钮弹出格式设置窗口，可对标题、内容、页面、字体四组内容进行设置。设置完毕点击【保存并退出】或【另存为】按钮存储为新的格式，也可点击【格式预览】按钮查看打印预览效果。以下为每组具体设置内容。<标题>：包括总标题和副标题的设置，以及高度，其中副标题内容可取自查询参数或系统变量。 <内容>：包括每列显示设置，以及列显示顺序。通过功能菜单中【上移】、【下移】、【左移】、【右移】来设置显示列的顺序以及多级表头的格式。通过功能菜单中【删除】可删除某些查询结果列，使之不在查询列表中显示。通过功能菜单中【新增】可以增加虚拟列。右栏有具体列属性设置，包括列标题、宽度、显示格式、对齐方式等内容。 <内容>中的列表模式：可以切换格式设置界面的样式，实现批量设置字段属性。点击【列表模式】显示如下图。可以通过Ctrl或Shift多选字段或通过上方的全选按钮选择全部字段，通过点击【应用】按钮将相应属性设置到多个字段。如果结果展现模板使用树形，在<内容>页面中，会有对不同级次缩进及缩进大小的设置。如何在列表查询结果的列上设置计算表达式？例如：设置某列所显示的数据为另外两列的加和。第一步：点击【新增】，新增一个字段。第二步：设置显示的列标题为“新增计算列”。第三步：设置字段类型。字段类型默认为“绑定”，为取查询结果集中的字段，将其修改为其他类型，如“小数”。

第四步：设置计算表达式。点击“计算表达式”右侧帮助按钮，打开语义化表达式编辑器，设置计算表达式。<页面>：包括纸张、页宽、固定列数、上下边距、显示方向、打印比例、是否补空行等内容。<字体>：可分别设置标题、副标题、表头、表体、表尾的字体大小和样式。【刷新】刷新当前显示格式。【保存】可以直接在主界面上进行列拖拽，点击保存可以保存当前格式或新增一套新的格式。【预览】可以查看打印预览的效果。【打印】直接输出到打印机。【导出Excel】将查询结果导出为Excel文件。导出Excel目前支持3种方式，<按值导出>、<按文本导出>、<极速导出>。<按值导出>：保留数据本身的数据类型及属性。<按文本导出>：将所有数据导出为文本类型。<极速导出>：针对大数据量（超过65536条数据），极速导出可防止内存溢出问题，但是导出格式的还原度较其他两种方式差点。【导出Dbf】将查询结果导出为FoxPro文件。【样式】可以设置显示控件的全局属性和每列的样式属性包括列分组合计、汇总合计、条件样式等内容。以下为修饰后查询结果展示效果。（修饰后格式）功能发布操作说明可以将定义好的查询直接发布到功能菜单，以后直接在功能菜单上点开运行功能即可。如下图所示功能说明 左侧显示当先功能树列表，选择一个明细节点作为功能要发布到的父菜单。右栏可以设置功能菜单的标识、编号、名称和默认业务操作。发布选项设置将该查询发布为功能菜单或联查。注意标识和编号不能与已有功能菜单重复。下栏的参数信息和动作授权可按默认设置，不必修改。注意，一定要分配合理的业务操作，否则会导致相关操作员无法查看到菜单或越权使用查询。定义综述操作说明 上述所有信息定义完毕，系统会自动列出整个定义过程中的相关信息，包括基本信息、数据组织方式、查询参数列表等内容，如下图所示。如果操作员确认无误，点击完成结束整个向导过程。功能说明【编辑查询参数界面】由于系统默认情况下采用表格布局方式形成查询参数界面，美观性不是很好，操作员可点击本按钮进行调整。具体调整细节见查询功能调整。【完成】点击完成，整个向导过程结束，此时系统会建议操作员重新登录以使新功能菜单生效可见。自定义查询修改操作步骤见1.1节【修改】功能说明。操作说明 本功能针对通过向导定义好的查询功能进行细化调整。包括操作区和属性区两大部分，如图所示。其中操作区保存、预览、发布、取消发布、关闭功能同1.1节中相关描述。属性区中包含基本信息、条件参数、数据组织、结果展现、联查五个属性页，前四个属性页设置同2.1节中相关描述。（自定义查询编辑）其中，在“基本信息”页中，增加了“条件表单”与“功能菜单”的设置。【条件表单】：重新选择查询条件界面表单。点击条件表单帮助，弹出表单选择窗口，选择本查询对应的查询条件表单。【功能菜单】：修改本查询对应的功能菜单信息。点击功能菜单帮助，弹出功能菜单发布窗口：可以在右侧菜单树中调整本查询对应的功能菜单的路径，也可以在左侧区域中修改功能菜单标识、编号、名称、参数信息等。编辑参数界面操作说明 点击【编辑参数界面】按钮，弹出运行时定制窗口，包含根据查询参数形成的ADP界面，如图所示。功能说明本功能可分为操作区、字段调整区、界面区、属性区四个部分。 操作区包括保存、预览、发布和视图切换功能。系统默认按业务视图显示，如需进行详细属性设置可切换为基础视图。 字段调整区包括业务实体调整、布局设置、字段工具箱、字段模板等四组内容。 实体调整可设置业务实体的相关字段属性信息； 布局设置可对界面进行标题设置、样式设置、字段数需调整、表头分组设置、表头字段设置等内容，具体可参考运行时定制操作手册。 字段工具箱和字段模板可不必调整。以下分别为未调整前参数界面和调整后参数界面（调整前参数界面）（调整后参数界面）联查发布操作说明 点击【联查】->【联查发布】两层Tab页按钮，转到定义窗口，分为操作区和数据区两部分，如图所示。本功能是将一个查询对外所需的参数发布出去，默认情况下按查询参数列表中内容发布。功能说明【新增】新增一个联查参数。【删除】删除一个已有的联查参数。【数据区内容描述】包括参数名、显示名称以及是否必输项三部分。联查订阅操作说明点击【联查】->【联查订阅】两层Tab页按钮，转到定义窗口，分为操作区、功能订阅区、功能参数区三部分，如图所示。本功能可以在结果展示界面上以右键方式联查到单据或其他查询功能。功能说明【新增联查】新增一个联查，新增后，可点击功能编号行内【…】按钮，点开功能菜单列表选择一个联查目标功能，如图所示。如选择的功能是一个查询，系统会自动读出订阅查询所需的参数并形成到列表中，无需操作员手工添加；否则，需手工定义所需参数，注意，参数必须与该功能发布时的参数顺序、参数名都保持一致。【删除联查】删除一个定义好的联查。【联查功能定义】包括功能编号、标题、联查依据的主键、联查展现形式、可见表达式和是否双击联查等内容。联查展现形式包括新开窗口显示和当前窗口追加两种。可见表达式用以根据本查询结果上的当前单元格信息来决定是否显示联查功能，可点其中的【…】进行表达式定义。点开后会弹出如图所示联查扩展编辑器。联查扩展编辑器分为操作区、编辑区、参数及函数帮助区等内容。可对表达式进行保存、校验操作。表达式采用JavaScript作为脚本引擎，符合JavaScript语言规范即可，其中双击参数帮助中的字段或上下文变量或函数会自动在编辑区当前光标位置进行追加。编辑区默认有一个定义帮助，可双击清除其内容。具体函数使用说明请参考附录。【新增联查参数】如果新订阅的功能不是一个查询，需要手工增加打开目标功能所需参数。【删除联查参数】删除一个定义好的联查参数。【联查参数定义】包括参数名、显示名称、值等内容，参数名称必须同目标功能中已经发布的参数保持一致。点击值所在单元格其中的【…】可进行参数取值定义，也即联查到的功能参数值来源于本查询结果上的某一单元格数据或查询参数值。点开后会弹出联查扩展编辑器，具体功能同可见表达式定义。下图所示就是目标功能的账户内码参数来源于操作员选择的当前行的人员内码字段值。自定义查询导出操作步骤登录系统，点击【GSP平台】→【专业开发平台】→【查询平台】→【自定义查询导出】操作说明 按功能位置打开，进入功能界面如下图所示，管理界面分为三个区域，分别是操作区、业务对象树区和自定义查询列表区。当选择左栏业务对象树某一节点，右栏列表将显示按业务对象过滤后的可用查询。也可在右栏过滤区输入内容以显示符合条件的查询。功能说明分别在需要导出的自定义查询后点击选择，或点击【全选】选择全部查询。 【导出】点击本按钮，将弹出如下图所示保存文件窗口，选择一个合适的位置，点击【保存】按钮，系统自动将选中的自定义查询导出为元数据文件，导出完成后系统会提示导出成功。【关闭】退出本功能。注意，本功能仅对购买了专业开发平台模块的客户有效，没有购买的客户不能执行本功能。自定义查询导入操作步骤登录系统，点击【GSP平台】→【专业开发平台】→【查询平台】→【自定义查询导入】操作说明按功能位置打开，进入功能界面如下图所示，根据向导一步步操作即可。功能说明 【第一步】选择要导入的数据文件【第二步】选择要导入的元数据【第三步】选择要导入的数据表【第四步】导入进度附录一：查询手工开发步骤1查询条件开发1.1定义查询条件数据模型 模型可采用以下方式快速生成：根据已有数据对象生成；根据业务模型另存。1.2根据提供的条件表单模板，生成条件表单目前系统提供以下6个条件模板，可参考后面的查询场景选择不同模板简单条件表单（无方案）简单条件表单（带方案）条件表单（无方案带过滤）条件表单（带方案带过滤）复杂条件表单（带方案带过滤当前界面显示）复杂条件表单（带方案带过滤）1.3将数据模型中条件字段拖到表单中，如需要，为表单编写业务上下文相关控制器方法；注意：业务模型中一般会有日期字段，而出现在条件中时会以起始日期、截止日期形式，此时条件模型中需要拆成2个字段；必须增加一个QueryID的虚字段，类型为varchar(36)即可，建议为其设置默认值，该字段的目的是为了指定结果的默认显示格式，同LSDYGS中F_ID对应，也可在表单默认值或控制器方法中赋值。同一个查询功能可以有多个不同的QueryID值，这样便于处理“包含外币与不包含外币采用不同显示格式”的场景。模板中提供的过滤、排序BindConditionControl()、BindGridOrderControl()默认都是绑定当前表单的模型，如需动态绑定或按照LSSTRU、List<Element>方式，请自行编写控制器方法替换。2查询数据处理 组织数据目前支持三种形式：2.1SQL注意：需在元数据中定义对应关系，如select*fromTab1whereID={0}andNAME={1}，则在组织数据中需要顺次定义参数如下：<ParameterAssigningName="UserID"Value="CONDID"/> <ParameterAssigningName="UserName"Value="CONDNAME"/>其中的Name不做要求，但顺序必须同SQL中{0}、{1}对应，Value对应条件数据模型字段名。2.2存储过程注意：涉及的条件参数，需在元数据中定义对应关系，如Proc_QDP_GSPUser中包含UserCode、UserName、UserMail三个参数，需定义参数如下： <ParameterAssigningName="UserCode"Value="CODE"/> <ParameterAssigningName="UserName"Value="NAME"/> <ParameterAssigningName="UserMail"Value="Email"/>其中Name要求同存储过程中定义的参数名一致，Value对应条件数据模型字段名。2.3服务器程序集IBusinessQueryServer接口实现类实现其中GetDataSet、GetDataSetByPage方法即可，组织数据期间可以写回变量和替换变量，其中的context中可以读出由客户端传递过来的各个条件字段实际值。DataSetGetDataSet(IQueryServerContextcontext) 一次性返回所有数据DataSetGetDataSetByPage(IQueryServerContextcontext,intstartRecNum,intendRecNum) 分页获取数据查询结果展示3.1展现 查询展现目前提供表格、树形、交叉表三种形式，可在查询元数据中定义默认采用哪种。可以在开发阶段将默认显示的结果样式保存下来，待都稳定后随元数据一起导出即可（存储在LSDYGS表中，注意将相关F_GSBH、Owner字段清除）。3.2联查一般需根据数据上下文决定可用联查，以下是一个联查定义Demo<RelaQueryTargetType="OTHER"LinkCol="F_NM"Target="RPC0602"Location="Open"Caption="联查单据"> <ParameterAssigningName="dataID"Value="GetRowData('F_NM')"/> <ParameterAssigningName="actionID"Value="'ViewCard'"/> <ParameterAssigningName="argumentString"Value="getValue();functiongetValue(){Vartemp='isRunTime=1&FirstLatitude='+GetRowData('F_FKLX')+'&SecondLatitude=&BillType='+GetRowData('F_FKLX')+'&{FORMSTATE~Mode}=CX&{FORMSTATE~BillID}='+GetRowData('F_NM');returntemp;}"/> </RelaQuery>其中联查目标功能中的dataID（主键）参数来自当前行F_NM字段，actionID（动作）为ViewCard（仅查看），打开参数通过扩展函数getValue()根据上下文拼出来。4查询元数据编辑通过集成开发平台新建查询元数据，定义查询条件、查询数据组织、查询包三类数据的属性。4.1查询包元数据查询包定义（LSQRYPackage）F_NAME：查询包编号F_DATAID：对应数据源编号F_CONID：对应索引界面定义编号F_KIND：类型，未用，保留F_XML：查询包描述内容例：<?xmlversion="1.0"encoding="UTF-8"?><QueryObject> <!--ResultFormInfo对应结果组合界面--> <ResultFormInfoType="ADP"ID="bff9e276-72cf-4208-960d-83856efec4ac"Param=""Title="查询性能测试"/> <!--展现控件Active=”1”代表使用Grid展示--> <ViewsActive="1"> <ViewId="1"Kind="vtGrid"/> <ViewId="2"Kind="vtTree"/> <ViewId="3"Kind="vtPivot"/><ViewId="4"Kind="vtPivotGrid"/> <ViewId="5"Kind="vtChart"/> </Views> <!--联查列表--> <RelaQueryInfo> <!--联查项--> <RelaQueryTargetType="CUI"LinkCol="SetLinkCol();"Target="ZWREFNEW014"VisibleExpression="ValidCol();"Location="Open"Caption="明细账"> <ParameterAssigningName="GNID"Value="'KMSLZ'"/> <ParameterAssigningName="TxtZj"Value="GetParamValue('ZWCX_ZJBH')"/> <ParameterAssigningName="HdnUnit"Value="GetSessionData('gsHsdw')"/> <ParameterAssigningName="HdnHbDwf"Value="GetSessionData('gsHsxz')"/> <ParameterAssigningName="TxtYear"Value="GetRowData('F_YEAR')"/> <ParameterAssigningName="TxtStartMonth"Value="GetRowData('F_KJQJ')"/> <ParameterAssigningName="TxtEndMonth"Value="GetRowData('F_KJQJ')"/> <ParameterAssigningName="SelFormat"Value="'1'"/> <ParameterAssigningName="TxtSubject"Value="GetRowData('F_KMBH')"/> <ParameterAssigningName="SelCurrency"Value="''"/> <ParameterAssigningName="HdnCondition"Value="''"/> </RelaQuery> </RelaQueryInfo> <Parameters> <!--参数--> <ParameterName="p_kmbhBegin"Caption="开始科目编号"IsRequired="true"HelpInput=""/> <ParameterName="p_kmbhEnd"Caption="结束科目编号"IsRequired="true"HelpInput=""/> <ParameterName="p_dwbh"Caption="核算单位"IsRequired="true"HelpInput=""/> </Parameters><!—业务扩展程序集--><AssemblyForGetDataClientAssemblyName=""ClientClassName=""ServerAssemblyName=""ServerClassName=""></AssemblyForGetData><!--扩展参数--><ExtendedProperty><PropertyName="OrgToken"Value=""/><PropertyName="KeyApp"Value=""/></ExtendedProperty></QueryObject>注：5.5Session改造之后，查询元数据增加了一个【ExtendedProperty】扩展属性节，可以在此配置【OrgToken】等参数。4.2结果界面配置<ResultFormInfoType="ADP"ID="bff9e276-72cf-4208-960d-83856efec4ac"Param=""Title="查询性能测试"/>4.3展示控件配置 <!--展现控件Active=”1”代表使用Grid展示--> <ViewsActive="1"AllowStyle="true"AllowSort="true"AllowFilter="true"AllowGroup="true"AllowSummary="true"AllowConditionStyle="true"> <ViewId="1"Kind="vtGrid"/> <ViewId="2"Kind="vtTree"/><PropertyName="IsUnique"Value="false"/>

<PropertyName="KeyFieldName"Value="实际的值"/>

<PropertyName="ParentFieldName"Value="实际的值"/><PropertyName="ClassifyStruc"Value="分级结构（例4333）"/>

<PropertyName="ClassifyField"Value="分级字段"/> <ViewId="3"Kind="vtPivot"/><ViewId="4"Kind="vtPivotGrid"/> <ViewId="5"Kind="vtChart"/> </Views>默认视图下增加扩展属性列表是为了解决TD140493问题，对不满足树形父子级关系的数据进行预处理后进行绑定。不满足的数据，业务需要做以下二者之一：（1）程序中传递KeyFieldName和ParentFieldName变量的同时，增加变量IsUnique=false;

（2）在查询包中增加配置如下，不需要在程序中传递变量了增加AllowStyle等属性是为了对结果界面上的按钮进行更精细的控制。树形展示增加了对分级结构的支持，业务组需要传递两个信息：分级结构和分级字段。业务可以根据情况在查询包配置中，也可以在程序中进行传递。4.4联查配置<RelaQueryInfo>对应于一个联查列表，节点下可以包含多个<RelaQuery>子节点，每一个<RelaQuery>子节点对应一个联查项。对于每一个联查项<RelaQuery>，属性如下：【TargetType】为联查对象类型。URL表明联查对象是一个web地址,CUI为联查功能。【Target】联查信息的目标，URL类型为URL地址，CUI类型的为功能ID。【LinkCol】联查的主键列，这几列的值为空时，不能联查。【Location】联查结果的打开类型Open打开一个新的Tab，Append在当前结果上追加数据【Caption】联查名称，对应于右键联查菜单中的菜单项名称【VisibleExpression】是否可见表达式。True表示应在右键菜单中显示，false不显示每一个联查项<RelaQuery>可以包含多个<ParameterAssigningName="HdnCondition"Value="''"/>节点，这里每个节点对应一个联查参数。【IsDoubleClick】是否为双击联查<!--联查列表--> <RelaQueryInfo> <!--联查项--> <RelaQueryTargetType="CUI"LinkCol="SetLinkCol();”Location="Open"Caption="明细账"IsDoubleClick=”true”> <ParameterAssigningName="GNID"Value="'KMSLZ'"/> <ParameterAssigningName="TxtZj"Value="GetParamValue('ZWCX_ZJBH')"/> <ParameterAssigningName="HdnUnit"Value="GetSessionData('gsHsdw')"/> <ParameterAssigningName="SelFormat"Value="'1'"/> <ParameterAssigningName="TxtUnit"Value="SetUnit();/> <ParameterAssigningName="TxtSubject"Value="GetRowData('F_KMBH')"/> <ParameterAssigningName="SelCurrency"Value="''"/> </RelaQuery><RelaQuery>……</RelaQueryTargetType="CUI"LinkCol="SetLinkCol();”Location="Open"Caption="明细账"> </RelaQueryInfo> 通过前面的xml，大家可以看到，联查配置中属性的值可以是一些javascript表达式。这是因为公共部分在统一查询平台客户端增加了脚本引擎并内置了一些公共函数，业务组在预置的时候可以直接使用，这样大大增强程序的灵活性和可扩展性。内置公共函数列表如下：///<summary>///获取当前单元格的值///</summary>///<paramname="datestr"></param>stringGetActiveCellValue()///<summary>///获取列信息///</summary>stringGetColInfo(stringkey)///<summary>///获取当前行上某列的值///</summary>stringGetRowData(stringkey)///<summary>///获取条件界面参数中的值///</summary>stringGetParamValue(stringkey)///<summary>///获取Session中某个变量的值///</summary>stringGetSessionData(stringkey)///<summary>///获取日期字符串例：20100108///</summary>stringGetDateString(stringdatestr)///<summary>///获取业务变量///</summary>stringGetBusinessVariable(stringkey)注：5.5之后，aspx和统一查询平台两套查询均可采用查询元数据配置联查项，并且都支持了双击联查功能。4.5查询展现对于一些比较简单的查询，利用公共部分的实现，可能已经可以满足要求了。但是对于一些比较复杂的查询来说，公共部分的实现就显得比较单薄了，这种情况下，业务组人员可以通过扩展、重写展示逻辑来达到目的。GS5.5的用户可以从BasicPubQueryClient类进行派生，增加或者重写其中的方法，并将派生的新类在查询包中进行配置即可。<!—业务扩展程序集--><AssemblyForGetDataClientAssemblyName=""ClientClassName=""ServerAssemblyName=""ServerClassName=""></AssemblyForGetData>对于逻辑型字段的显示，我们增加了对码表的支持，将多个DataTable放在一个DataSet中，但必须得按照以下约定：1、展示结果DataTable的表名必须为：QueryResult2、QueryResult.ExtendedProperties[“HasLogic”]=true;3、需要特殊处理的逻辑字段（ID）的DataColumn也需要设置扩展属性 DataColumndc=queryResult.Columns[“ID”]; dc.ExtendedProperties[“ID”]=”table1~ID~DescField”.Table1为码表，descField为显示字段且descField不在查询结果Table中。4.6查询格式处理查询结果是按照定义的查询格式来展现的，查询格式包含主标题、副标题、表体、列、表尾等各部分的定义，存储在LSDYGS表中。查询要求业务部分必须指定QueryID，可以在数据模型中定义一个虚字段，也可以直接放在参数中并将其传给公共部分。QueryID是不同格式进行分类的依据，QueryID不同对应的格式不同。查询格式可以不进行预制，这是展示控件会根据DataTable的ColumnName和Caption自动生成一套格式。GS中许多功能可能使用了运行时定制，这样用户就有可能会通过运行时定制增加部分字段，为了使这些字段能够尽快的在查询格式中体现，展示部分对此作了一部分支持。只要业务部分在组织数据完DataTable后，在DataTable的扩展属性加一个HasNew的总开关，然后在新增字段的DataColumn的扩展属性上增加一个属性即可：例： DataTable.ExtendedProperties[“HasNew”]=true;DataColumn.ExtendedProperties[“New”]=true.功能发布5.1将最初定义的条件表单发布为构件；5.2功能菜单中配置构件参数{FORMSTATE~QUERYPKGID}=myQDPDemo形式；表单formload中选择InitQueryContextInfoWithPkgID可以在动作管理中设置参数关联查询元数据；表单formload中选择InitQueryContextInfo可以功能菜单—高级信息—参数信息—argumentString中设置{FORMSTATE~QUERYPKGID}=myQDPDemo关联。5.3配置功能菜单的下载单元依赖于如下三个下载项<RefIDs><string>CommQuery</string><string>CommPrint</string><string>FromRunTi