U9研发体系(实体操作API参考手册)

U9 操作指引销售管理部份料品：50-0000-0001 指定存储地点及业务员客户：指定交易币种，价目表，出货原则，退货条件，出货条件，收款币种，收款条件，立账条件，其中立账条件及收款币种要与交易币种保持一致（重要）1.下达销售合同（注意起交日期在生效日期与失效日期之间）—提交—审核—客户确认（注意指定合同类型及流程）2.操作—批量生单（注意收款条件币种与单据币种一致）--提交—审核3.标准收货—批量生单—提交—审核4.退回流程：退货申请—批量生单（注意退货处理的单据类型）--受理—提交—审核5.采购管理—收货—销售退回收货—批量生单—进入检验流程6.采购管理—销售退回单—操作—检验—确定—提交—审核采购管理部份：料品：10-0000-0001 ，收货程序,勾选请购及询价属性1.查看是否点收及检验，操作—点收—提交—审核为可改，收货原则要填供应商：付款条件，付款币种，收货原则，立账条件2.下达采购合同（注意起交日期在生效日期与失效日期之间）--提交—审核—供应商确认3.采购申请—合同请购—批量生单（参照采购合同）提交—审核4.采购管理—料品询价范围—询价—批量生单（参照请购单）-比价—接受比价—提交—审核—转PO5.采购订单—提交—审核6.标准收货—批量生单—进入检验流程。

7.采购收货单—操作—检验—确定最终接受数量—提交—审核生产管理部份：料品：50-0000-0001 料品档生产页签可设超领百分比；物料清单中控制页也可以设，优先取物料清单的设置1、生产订单下达新增——单据类型——生产部门——生产数量——完工存储地点——计划开工时间——计划完工时间2、齐套分析指定存储地点——选取成套策略（生产数量、指定数量、可成套数）——选取生产订单——齐套分析3、生产订单开工开工：开工——开工数量——开工反开工：开工——开工历史——反开工4、生产订单领料与退料领料：后续处理——非成套领料——存储地点——实发数量——保存——审核——发料确认退料：生产退料——单据类型——选取生产订单——选取备料单——实退数量——退料理由——保存——审核——退料确认生产订单查询领退料明细、生产订单查询备料5、生产订单完工后续处理——完工——完工数量、报废数量、返工数量——质检页签（没有质检流程时：检验结果、不合格处理方式、数量）——保存——审核——进入质检流程---入库（打开生产订单、取消入库）6、返工生产订单生产管理参数：是否即时产生返工生产订单。

U9研发体系(查询过滤条件API参考手册)文件编号：U9-SE-××-SPEC-××适用版本：U9 V1.5 UBF2.0修改状态：编写人：李东滨审核人：目 录1. 类型 (3)1.1 FilterDefine 过滤条件模型 (3)1.2 DefaultValue 默认值定义 (6)1.3 FilterValue 过滤条件值 (7)1.4 RangeEnabled 使能控制 (9)1.5 RangeEnabledExpression 使能条件 (9)1.6 Reference 条件参照定义 (10)1.7 ReferenceObject 描述参照内容的参照对象 (11)1.8 EnumeratorKeyPair 枚举键值对 (12)1.9 EnumeratorKeyPairs 枚举键值对集合 (13)1.10 RefCondition 参照条件 (14)1.11 EnumRestrict 枚举约束 (15)1.12 RefConditions 条件参照项集合 (15)1.13 FilterBuilder 查询条件构造器 (16)2. 枚举 (19)2.1 enuOperatorLogicType (19)2.2 enuOperatorType (19)2.3 enuOperatorListType (20)2.4 FilterDataType (20)2.5 enumFilterValueType (20)2.6 enuSelectOptionType (21)2.7 enuReferenceType (21)2.8 enuFilterItemType (21)2.9 enuFilterLevelType (21)2.10 enuPageOfInputFilterValueType (22)2.11 SimpleOperator (22)2.12 enuNodeExpandType (22)1. 类型概要所在程序集：UFSoft.UBF.Report.Filter.FilterModel.dll命名空间：UFSoft.UBF.Report.Filter.FilterModel1.1 FilterDefine 过滤条件模型属性1public int ID名称：ID语法：说明：过滤条件的唯一标识2public string Name名称：名称语法说明：过滤条件名称3public string FullPath名称：在树结构中的路径语法说明：记录过滤条件在过滤条件树中的全路径4public string Expression名称：条件字段表达式语法说明：最后形成where子句时候的左表达式5public string Label名称：显示标题语法说明：条件显示标题6public bool Visible名称：条件是否显示语法说明：该条件在条件树中是否显示7public FilterDataType DataType名称：条件数据类型语法说明：为FilterDataType枚举类型8public DefaultValue DefaultValue名称：条件默认值说明9public Reference Reference名称：条件参照定义语法说明：记录有关条件参照的信息，包括枚举条件和参照条件等10public List<enuOperatorListType> OperatorList名称：固定操作符列表语法说明：该条件支持的条件比较符11public FilterDefines SubFilters名称：子条件项列表语法说明：指该条件项下的子条件项，在树结构中表示一个条件项节点下的子节点12public enuFilterLevelType Level名称：条件级别属性语法说明：为enuFilterLevelType枚举类型【即是基本条件还是高级条件】13public enuFilterItemType Type名称：条件类型语法说明：为enuFilterItemType枚举类型【目录或条件项】14public bool Fixed名称：是否为必输项目语法说明15public string Tag名称：条件标记语法说明16public bool AllowBlank名称：是否允许为空语法说明17public bool IsJudgeBlank名称：是否对不可为空的条件项进行判读处理语法说明18public bool IsBuildWhereStr名称：是否参与条件构造语法说明：是否形成最后的where子句19public string ParentID名称：父条件项ID说明20public bool PopulateOnDemand名称：是否懒加载语法说明21public bool ChildIsAllLoad名称：子条件项是否加载语法说明22public RangeEnabled RangeEnabledDefine名称：使能条件定义语法说明23public bool RaiseChangeEvent名称：是否触发事件语法说明：当该条件项的值发生变化后是否触发事件24public string EntityFullName名称：实体全名语法说明25public enuNodeExpandType NodeExpandType名称：节点展开类型语法说明26public bool Auto名称：是否DataCommand自动生成语法说明27public FlexFieldValueSetDef FlexFieldValueSetDef 名称：当节点为描述性弹性域的值集定义信息语法说明28public string DescFieldContextValue名称：描述性弹性域的上下文值语法说明29public bool ViriantCtrlEnabled名称：设置值对话框中的变量控件是否可用语法说明30public string DescartesPath名称：该条件项的笛卡尔路径说明方法1public FilterDefine()名称：FilterDefine的构造函数语法：说明：2public object Clone()名称：复制对象自身语法：说明：3public void GetObjectData()名称：获取对象数据语法：说明：实现ISerializable接口成员4public override string ToString()名称：重写的基类的ToString方法语法：说明：返回字符串为FilterDefine的Name加FullPath属性1.2 DefaultValue 默认值定义属性1public bool IsContext名称：是否采用“变量”机制语法：说明：是的话这里面的Values会被解释为上下文字段2public enuOperatorListType RelationOperator名称：关系比较符语法：说明：3public List<string> Values名称：条件的默认值定义语法：说明：4public List<string> Labels名称：语法：说明：5public List<ReferenceValue> ReferenceValues名称：语法：说明：方法1public DefaultValue()名称：默认值构造函数语法：说明：1.3 FilterValue 过滤条件值属性1public int FilterItemID名称：条件项ID号语法：说明：2public bool IsClearByEnabled名称：是否根据使能清空语法：说明：3public enuOperatorListType LogicOperator名称：逻辑操作符ID语法：说明：4public string LeftBracket名称：左括号语法说明5public string Name名称：条件值名称语法：说明：6public enuReferenceType ReferenceType名称：在FilterValue中加上参照的类型语法：说明：在FilterValue中加上参照的类型,为解决条件构造中一些特殊的情况，如枚举型is null及小于操作符等的处理,要考虑-1的情况7public enuOperatorListType RelationOperator名称：关系操作符ID语法：说明：8public string RightBracket名称：右括号）语法：说明：9public enuPageOfInputFilterValueType PageType 名称：描述当前条件值是从那一页签输入语法：说明：10public ValueContext Values名称：条件值集合，只读属性语法：说明：11public enumFilterValueType ValueType名称：条件值类型语法：说明：方法1public void AddValue(string value)名称：追加条件值语法：说明：2public string GetValue()名称：取得第一个条件值语法：说明：3public string GetValue(int index)名称：取得条件值语法：说明：根据index取得相应的条件值4public List<string> GetValues()名称：取得条件值集合语法：说明：5public void SetValue(int index, string value)名称：设置具体条件值语法：说明：设置第index的条件值为value6public void SetValues(List<string> values)名称：设置条件值集合语法：说明：7public string GetSecValue()名称：取得第二个条件值语法：说明：8public int ValueCount()名称：条件值数量语法：说明：9public override string ToString()名称：输出到字符串语法：说明：10public void FromString(string value)名称：从字符串输入语法：说明：1.4 RangeEnabled 使能控制属性1public List<RangeEnabledExpression> ExpressionList 名称：使能条件表达式集合语法：说明：2public List<SimpleOperator> LogicTypeList名称：逻辑比较符集合语法：说明：1.5 RangeEnabledExpression 使能条件属性1public string DefineName名称：要定义的使能条件名称语法：说明：2public enuOperatorListType Operator名称：使能操作符语法：说明：3public List<string> ValueList名称：使能比较定义的值集语法：说明：4public bool UnDefined名称：是否未定义标识语法：说明：可以设置当条件没有设置值时，被影响的控件是否可用；默认是没值时，可用比如A受B影响，设置A:DefineName=B,UnDefined=true, 如果B没有值，A就不可用5public bool IsDefined名称：是否已定义标识语法：说明：条件项被设置值时，被影响的控件是否可用，比如A受B的影响，当B有值时,A就不可用，这时设置A:DefineName=B,IsDefined=true, 在解析使能条件时，发现B有值，A就不可用。

U9 数据库访问API参考手册适用版本：U9 V1.5 UBF2.0修改状态：编写人：叶琳审核人：此部分要记录该文档形成过程中的历次版本变更过程及变更的内容版本修改与参与人修改时间修改原因修改内容审批人1.0 叶琳2008-7-8 原始文档建立叶琳2008-7-9 加上类的名空间概述U9数据库访问的API集中在UFSoft.UBF.Util.DataAccess.dll中，主要是封装直接执行sql和存储过程DataAccessorUFSoft.UBF.Util.DataAccess.dll下的DataAccessor主要对外提供直接执行sql和存储过程的方法，名空间为UFSoft.UBF.Util.DataAccess方法：public static IDbConnection GetConn()取当前的连接注意：这个连接是通过DatabaseManager.GetCurrentConnection()取得，是取当前环境下的连接static public int RunSP(string sprocName, DataParamList dataParams)用当前连接执行存储过程参数：sprocName 存储过程名dataParams 参数列表static public int RunSP(string sprocName, DataParamList dataParams, outDataSet ds)用当前连接执行存储过程参数：sprocName 存储过程名dataParams 参数列表ds 输出结果static public int RunSP(string sprocName, DataParamList dataParams, out IDataReader dr)用当前连接执行存储过程参数：sprocName 存储过程名dataParams 参数列表dr 输出结果static public int RunSP(string sprocName, DataParamList dataParams, out object obj)用当前连接执行存储过程参数：sprocName 存储过程名dataParams 参数列表obj输出结果static public int RunSP(IDbConnection conn, string sprocName, DataParamList dataParams)执行存储过程参数：c onn 数据库连接sprocName 存储过程名dataParams 参数列表static public int RunSP(IDbConnection conn, string sprocName, DataParamList dataParams, out DataSet ds)执行存储过程参数：c onn 数据库连接sprocName 存储过程名dataParams 参数列表ds 输出结果static public int RunSP(IDbConnection conn, string sprocName, DataParamList dataParams, out IDataReader dr)执行存储过程参数：c onn 数据库连接sprocName 存储过程名dataParams 参数列表dr输出结果static public int RunSP(IDbConnection conn, string sprocName, DataParamList dataParams, out object obj)执行存储过程参数：c onn 数据库连接sprocName 存储过程名dataParams 参数列表obj输出结果static public int RunSQL(IDbConnection con, string commandText, DataParamList dataParams)执行sql参数c on 数据库连接commandText sql语句dataParams 参数static public int RunSQL(IDbConnection con, string commandText, DataParamList dataParams, bool needCloseConn)执行sql参数c on 数据库连接commandText sql语句dataParams 参数needCloseConn 执行完后是否需要平台自动关闭连接static public int RunSQL(IDbConnection con, string commandText, DataParamList dataParams,bool needCloseConn, out IDataReader dr)执行sql参数c on 数据库连接commandText sql语句dataParams 参数needCloseConn 执行完后是否需要平台自动关闭连接dr 输出结果static public int RunSQL(IDbConnection con, string commandText, DataParamList dataParams, out DataSet ds)执行sql参数c on 数据库连接commandText sql语句dataParams 参数ds 输出结果static public int RunSQL(IDbConnection con, string commandText, DataParamList dataParams, out IDataReader dr)执行sql参数c on 数据库连接commandText sql语句dataParams 参数dr 输出结果static public int RunSQL(IDbConnection con, string commandText,DataParamList dataParams, out object obj)执行sql参数c on 数据库连接commandText sql语句dataParams 参数obj 输出结果public static IDataReader GetDataReaderByPage(string tableName, intpageSize,Int64pageIndex, string selectSql,string whereSql, stringorderbySql, string optimizesql, string aliasFileds, DataParamList dataParams)分页查询，返回IDataReader参数：tableName 主table名pageSize 页面大小pageIndex 页面索引selectSql 查询子句whereSql 条件子句orderbySql 排序子句optimizesql 优化子句aliasFileds 别名列，一般可以用*dataParams 参数列表注意，这个方法这个方法的参数很多，较复杂，一般平台用，开发尽量避免直接使用public static DataSet GetObjectsByPage(string tableName, int pageSize,Int64 pageIndex, string selectSql, string whereSql, string orderbySql,string optimizesql, string aliasFileds, DataParamList dataParams)分页查询，返回DataSet参数：tableName 主table名pageSize 页面大小pageIndex 页面索引selectSql 查询子句whereSql 条件子句orderbySql 排序子句optimizesql 优化子句aliasFileds 别名列，一般可以用*dataParams 参数列表注意，这个方法这个方法的参数很多，较复杂，一般平台用，开发尽量避免直接使用KeyGeneratorU9实体的ID是通过存储过程产生，UFSoft.UBF.Util.DataAccess.dll下的KeyGenerator 提供一个辅助的方式提供一个新的ID,以避免直接访问产生ID的存储过程，名空间为UFSoft.UBF.Util.DataAccess方法：static public Int64 NewValue()取一个新的ID值。

U9开发环境手册文件编号:U9-SE-××-SPEC-××版本号:修改状态:0编写人:张璋审核人:适用对象该手册适用于U9本部开发人员、客户化开发人员。

版本记录【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】版本修改与参与人修改时间修改原因修改概述审批人1.0 张璋 2008/07/10 原始文档建立1.1 张璋 2008/08/12 按照本部级评审意见修改相关文档名词解释z U9AppCode(U9业务逻辑视图目录z U9Data(U9数据视图目录z U9Product(U9开发环境目录z U9UICode(U9UI逻辑视图目录手册正文1.U9基础开发环境1.1 OS环境推荐使用“Windows Server 2003(企业版,SP2”,U9本部人员可以在如下地址访问获取:\\u9domain\data\Download\0C - 操作系统1.2 IIS6.0推荐安装OS后,立即安装IIS,以保证在安装 2.0之前IIS已经安装完毕。

IIS6.0的安装位置在:添加或删除程序->添加删除Windows组件->应用程序服务器->详细信息->Internet信息服务(IIS。

按照下图红色数字顺序,安装IIS6.0。

点击【确定】、【下一步】后,系统提示插入操作系统光盘,可以插入系统光盘,如果没有系统光盘,可以定位到操作系统文件夹的i386文件夹。

1.3 Framework V3.0U9本部人员可以在如下地址访问获取:\\u9domain\data\Download\0C - Visual Studio系列1.4 浏览器推荐使用“IE7”,U9本部人员可以在如下地址访问获取:\\u9domain\data\Download\0C - Office系列1.5 数据库开发环境推荐先安装SQL Server 2005,再安装Visual Studio 2005。

U9研发体系(UIACTION使用手册)此部分要记录该文档形成过程中的历次版本变更过程及变更的内容版本修改与参与人熊悦阅修改时间修改原因修改内容审批人1.02022-7-8原始文档建立刘小东1.概述UFIDAUIAction是表示层MVC框架中Controller一部分，它与CodeBehind构成完整的UIController，CodeBehind完成Web响应的流转控制，UIAction完成一个独立的行为，如保存、加载、翻页等等。

2.构架原理2.1UIAction在表示层构架中的位置和作用2.2UIAction的主要内容3.1.1Load方法Load方法完成加载数据到IUIModel的过程，包含以下多种声明：声明IUIModelLoad()IUIModelLoad(IUIModel)IUIModelLoad(IUIModel,bool)说明加载当前IUIModel加载指定的IUIModel加载指定的IUIModel第二个参数控制是否清空IUIModel的数据IUIModelLoad(IUIView,bool)IUIModelLoad(paramIUIView[])IUIModelLo ad(paramIUIViewBindingControl[])加载一个视图，是否根据父视图进行过滤加载指定的多个视图加载指定的多个UI绑定控件对应的视图3.1.2LoadChildView方法LoadChildView方法加载指定视图的下级视图数据：声明VoidLoadChildView(IUIView)说明加载的数据存放在视图的ContainerModel中3.1.3Save方法Save方法将IUIModel的变化更新到后台持久层声明IUIModelSave()IUIModelSave(IUIModel)保存后会回刷IUIModel的数据到前台。

说明加载的数据存放在视图的ContainerModel 中3.2NavigationAction部分声明voidFirtPage(IUIViewBindingControl)voidLatPage(IUIViewBindingControl)voidNe某tPage(IUIViewBindingControl)说明加载的数据存放在视图的ContainerModel中加载最后一页的数据加载下一页的数据。

物料服务版本记录修改时间修改原因修改内容版本修改与参与人设计毛鸿涛2009-12-18 按照规范进行修改V1.0 杜华侨2010-01-18 按照设计文档整理基于U9标准产品的最低版本最低版本号：V2.0sp1服务清单在此处列举文档中包含的服务，并简要介绍功能，及使用注意事项服务说明创建物料服务删除物料服务修改物料服务查询物料服务1、创建物料服务使用说明说明服务使用前提，使用注意所属DLLUFIDA.U9.ISV.Item. Agent.dll服务全名称UFIDA.U9.ISV.Item. BatchCreateItemByDTOSRV 接口说明接口名称（英文）接口名称（中文）类型（英文）类型（中文描述）入/返说明可空ItemInfoDTOList物料主档DTO列表List<物料主档DTO>ItemDTOList入NList<Item> 返参数1：物料主档DTO集合物料主档DTO全路径名：UFIDA.U9.ISV.Item.ItemMasterDTO类图：业务主键：组织+编码名称中文名称类型说明必赋值ID ID Long ◆创建时为空◆修改时,ID和Code不能同时为空Code 编码String ◆默认为空◆创建时非空◆修改时,ID和Code不能同时为空Org 组织通用档案DTO ◆如果为空,取上下文组织Code1 参考料号1 String ◆如果非空，则不能重复◆可以是对应政府/行业组织的物料编码Code2 参考料号2 String ◆如果非空，则不能重复◆可以是对应政府/行业组织的物料编码Name 品名String ◆可空◆创建时非空,修改时可空AliasName 别名String ◆SPECS 规格String ◆CatalogNO 目录编号String ◆SearchCode 搜索码String ◆IsVersionQtyControl 版本数量控制Bool ◆默认为空◆库存交易时是否要输入物料的版本号，库存数量是否按物料版本号保存。

U9研发体系自定义报表开发手册(DOC 109页)U9研发体系（自定义报表开发手册）文件U9-SE-UBF-SPEC-RE PORT编号：版本号：修改状态：编郭玉平（二开总部）写人：刘小东审核人：手册前3章介绍报表开发准备工作。

从第4章到第10章介绍了报表《XX月生产计划与实绩统计》实际开发流程，在流程中的每个步骤中介绍了使用UBF平台开发报表所涉及到的知识点。

第11章是一些知识点的详细介绍。

目录第1章开发基础篇--U9系统的环境配置 (14)1.1系统环境 (14)1.1.1Window 2003 标准版、企业版141.1.2Microsoft .net Framework V3.0141.1.3 ............................................................ I IS6.0141.1.4 ............................................................. I E7.0151.1.5MS SQL Server 2005151.2开发环境 (18)1.3运行时环境 (20)1.3.1需要运行两个服务201.3.2设置IIS中的站点201.3.3配置U9站点、企业221.4数据库的导出、导入 (26)1.4.1数据库导出261.4.2数据导入311.4.2.1.使用“用友__数据管理工具”还原311.4.2.2.使用“用友__系统管理工具”还原361.5模板的导入、导出 (40)1.5.1配置IDEConfig401.5.2新建解决方案411.5.3建分析项目421.5.4打开模型元数据管理421.5.5连接报表元数据库431.5.6模板导入、导出441.6报表服务器的配置 (46)1.6.1安装运行Sql Server Reporting Services461.6.2配置报表服务站点ReportServer461.6.3部署自定义报表的DataCommand46第2章报表开发环境 (49)2.1UBF介绍 (49)2.2报表开发环境 (50)2.3报表开发环境参数配置 (52)2.3.1UBF环境设置522.3.2UBF连接到数据库522.3.3启动两个服务542.3.4运行UBFdevenv.exe552.3.5登录数据库服务器562.3.6连接报表元数据库58第3章报表开发基础 (60)3.1.1实体603.1.2 .............................................................. OQL603.1.3报表制作流程的简单介绍623.1.3.1.DataCommand设计623.1.3.2.报表模板设计633.1.3.3.报表模板发布633.1.3.4.部署DataCommand的dll，策略的dll63第4章命名规范 (63)4.1概论 (63)4.2ReportTemplate（报表模版） (63)4.3解决方案命名规则 (64)4.4DataCommand（报表数据） (65)第5章需求、设计 (65)5.1需求 (66)5.1.1样表665.1.2表头685.1.3表体685.2设计 (69)5.2.1查找条件695.2.2栏目说明715.2.3算法说明72第6章新建报表模板 (75)6.1第一步：新建报表目录 (76)6.2第二步：新建报表容器 (76)6.3第三步：新建报表页面 (77)第7章新建DadaCommand (78)7.1打开DadaCommand工具集 (79)7.2建立DadaCommand目录 (79)7.3选择字段 (80)7.3.1查询实体807.3.2选择属性(字段)807.4配置字段信息 (83)7.5数据源命名 (84)7.6信息确认 (84)第8章编写DadaCommand业务逻辑 (85)8.1主要编程界面简介 (86)8.1.1 ........................................................... M oDs.cs868.1.2 ..................................................... MODsExtend.cs878.1.3 .................................................... MOCmdExtend.cs888.1.4 .................................................... PubFunction.cs898.2DataCommand 主要属性、方法 (89)8.2.1ShowMode 参数908.2.2EntityViewQuery ：viewQuery908.2.3报表相关集合918.2.4 ............................................... ExecuteDataReader()928.2.5其它集合958.3编写实例业务逻辑 (95)8.3.1第一步：选取生产订单字段968.3.2第二步：选取完工报告字段1008.3.3第三步：连接临时表1028.3.4第四步：定义临时表1038.3.5第五步：生成解决方案104第9章报表模板设计 (105)9.1导入DataCommand (106)9.2模板布局设计 (107)9.2.1删除系统预定义布局1079.2.2设计表头1079.2.3设计表体1099.3报表参数设计 (111)9.3.1基本属性1129.3.2参照1139.3.3操作符列表1149.4字段的扩展属性 (114)第10章报表处理策略 (115)10.1策略概念 (115)10.2编写策略方法 (116)10.3配置策略文件 (117)第11章发布浏览 (118)11.1发布报表模板 (118)11.1.1打开报表发布向导11811.1.2报表发布向导第一步：选择报表类型11911.1.3报表发布向导第二步：程序集部署12011.1.4报表发布向导第三步：发布菜单12111.1.5报表发布向导第四步：报表部署12211.1.6报表发布向导第五步：完成12311.2部署DataCommand (124)11.3菜单授权 (126)11.3.1进入U9页面12611.3.2分配权限12611.3.2.1.进入路径12611.3.2.2.执行操作12711.4效果预览 (128)11.4.1查询界面12811.4.2效果界面128第12章高级话题 (129)12.1报表中嵌入代码 (129)12.2弹性域 (132)12.2.1弹性域概念13212.2.2在模板中使用弹性域13312.3存储过程的调用 (137)12.4任意条件的撷取 (137)12.5Oql 的使用方法 (139)12.5.1基本功能13912.5.2优势与比较14012.5.3安装14012.5.4语言指南14212.5.4.1.对象查询语言OQL有两种风格14212.5.4.2.简单条件过滤14212.5.4.2.1.简单条件： (143)12.5.4.2.2.多Entity Join条件： (143)12.5.4.2.3.OPath风格指定条件： (143)12.5.4.2.4.Between and (144)12.5.4.2.5.逻辑或条件+ 参数 (144)12.5.4.2.6. ........................................ in (144)12.5.4.2.7.like & not like (144)12.5.4.3.复杂报表查询14512.5.4.3.1.兼容性注意问题 (146)12.5.4.3.2.基本语法 (146)12.5.4.3.3.使用实体类 (146)12.5.4.3.4.from子句 (147)12.5.4.3.5.left join (147)12.5.4.3.6.inner join (148)12.5.4.3.7.Cross join (149)12.5.4.3.8.Distinct关键字 (149)12.5.4.3.9.数据库函数 (149)12.5.4.3.10. ..................................... C ount (149)12.5.4.3.11.Min，Max (150)12.5.4.3.12.Group by (150)12.5.4.3.13.子查询 (150)12.5.4.3.14.子查询 (150)12.5.4.3.15.对dateadd/datediff/datepart/datename中关键字的支持 (152)12.5.4.3.16.对cast类型转换函数的支持 (154)12.5.4.3.17.left right字符串函数 (154)12.5.4.3.18.对Update & Delete语句的支持 (154)12.5.4.4.OQL风格指南15512.5.4.4.1.别名形式 (156)12.5.4.4.2.主实体+ 相对于主实体开始的导航表达式 (158)12.5.4.5.用户自定义函数与SQL标准函数16012.5.4.6.临时表16112.5.4.7.全景体验16412.5.5API 编程接口 16512.5.5.1............................................ QueryParser16512.5.5.2.QueryCompiler、CompiledQuery实例16612.5.5.3.QueryBuilder、CompiledQuery实例168第1章开发基础篇--U9系统的环境配置1.1 系统环境1.1.1Window 2003 标准版、企业版操作系统安装过程。

U9升级工具使用手册文件编号：U9-SE-××-SPEC-××版本号： 1.0修改状态：0编写人：李靖和审核人：目录1. 适用对象 (3)2. 版本记录 (3)3. 使用说明 (3)3.1 数据库升级 (3)3.2 报表升级 (5)4. 常见问题 (6)4.1 为什么元数据升级不能指定连接串 (6)4.2 当DBServer和WebServer部署在不同服务器时如何升级报表元数据 (6)4.3 能否只针对更新的报表元数据进行升级 (6)1.适用对象该规范适用于系统实施、测试人员以及其它和系统升级相关的操作人员。

2.版本记录版本修改与参与人修改时间修改原因修改概述审批人1.0 李靖和 2008-6-30 原始文档建立3.使用说明3.1 数据库升级执行UFIDA.UBF.Build.Install.exe，操作用户必须具有windows管理员权限，在数据库服务器本机执行，如图:点击“获取”按钮，工具将获取本地SQL服务器默认实例下的所有数据库，选择要升级的数据库。

点击打开文件按钮，选择补丁包文件，如下图:选择好文件，后点击“数据升级”按钮。

升级完成后，系统弹出如下窗口：标识该补丁包已经升级完毕。

日志文件参考执行目录下的xxxxinstall.log(xxxx为补丁包文件名)3.2 报表升级选择报表路径：报表路径一般为${protal}\ApplicationServer\Libs\SqlScript\ReportMetaData，“${protal}”为IIS中U9portal对应的目录。

选择报表工具路径，一般为${U9}\ReportServer\Tool\import”，${U9}为Portal的上层目录。

选择完之后点击“报表升级”，稍候即可。

如果数据库不在本地，请指定连接串。

4.常见问题4.1 为什么元数据升级不能指定连接串为了提高数据更新效率，元数据升级采用SQLServer的Bulk Insert方式导入，所以升级程序必须在数据库本地执行。

U9研发体系(查询过滤条件API参考手册)文件编号：U9-SE-××-SPEC-××适用版本：U9 V1.5 UBF2.0修改状态：编写人：李东滨审核人：目 录1. 类型 (3)1.1 FilterDefine 过滤条件模型 (3)1.2 DefaultValue 默认值定义 (6)1.3 FilterValue 过滤条件值 (7)1.4 RangeEnabled 使能控制 (9)1.5 RangeEnabledExpression 使能条件 (9)1.6 Reference 条件参照定义 (10)1.7 ReferenceObject 描述参照内容的参照对象 (11)1.8 EnumeratorKeyPair 枚举键值对 (12)1.9 EnumeratorKeyPairs 枚举键值对集合 (13)1.10 RefCondition 参照条件 (14)1.11 EnumRestrict 枚举约束 (15)1.12 RefConditions 条件参照项集合 (15)1.13 FilterBuilder 查询条件构造器 (16)2. 枚举 (19)2.1 enuOperatorLogicType (19)2.2 enuOperatorType (19)2.3 enuOperatorListType (20)2.4 FilterDataType (20)2.5 enumFilterValueType (20)2.6 enuSelectOptionType (21)2.7 enuReferenceType (21)2.8 enuFilterItemType (21)2.9 enuFilterLevelType (21)2.10 enuPageOfInputFilterValueType (22)2.11 SimpleOperator (22)2.12 enuNodeExpandType (22)1. 类型概要所在程序集：UFSoft.UBF.Report.Filter.FilterModel.dll命名空间：UFSoft.UBF.Report.Filter.FilterModel1.1 FilterDefine 过滤条件模型属性1public int ID名称：ID语法：说明：过滤条件的唯一标识2public string Name名称：名称语法说明：过滤条件名称3public string FullPath名称：在树结构中的路径语法说明：记录过滤条件在过滤条件树中的全路径4public string Expression名称：条件字段表达式语法说明：最后形成where子句时候的左表达式5public string Label名称：显示标题语法说明：条件显示标题6public bool Visible名称：条件是否显示语法说明：该条件在条件树中是否显示7public FilterDataType DataType名称：条件数据类型语法说明：为FilterDataType枚举类型8public DefaultValue DefaultValue名称：条件默认值说明9public Reference Reference名称：条件参照定义语法说明：记录有关条件参照的信息，包括枚举条件和参照条件等10public List<enuOperatorListType> OperatorList名称：固定操作符列表语法说明：该条件支持的条件比较符11public FilterDefines SubFilters名称：子条件项列表语法说明：指该条件项下的子条件项，在树结构中表示一个条件项节点下的子节点12public enuFilterLevelType Level名称：条件级别属性语法说明：为enuFilterLevelType枚举类型【即是基本条件还是高级条件】13public enuFilterItemType Type名称：条件类型语法说明：为enuFilterItemType枚举类型【目录或条件项】14public bool Fixed名称：是否为必输项目语法说明15public string Tag名称：条件标记语法说明16public bool AllowBlank名称：是否允许为空语法说明17public bool IsJudgeBlank名称：是否对不可为空的条件项进行判读处理语法说明18public bool IsBuildWhereStr名称：是否参与条件构造语法说明：是否形成最后的where子句19public string ParentID名称：父条件项ID说明20public bool PopulateOnDemand名称：是否懒加载语法说明21public bool ChildIsAllLoad名称：子条件项是否加载语法说明22public RangeEnabled RangeEnabledDefine名称：使能条件定义语法说明23public bool RaiseChangeEvent名称：是否触发事件语法说明：当该条件项的值发生变化后是否触发事件24public string EntityFullName名称：实体全名语法说明25public enuNodeExpandType NodeExpandType名称：节点展开类型语法说明26public bool Auto名称：是否DataCommand自动生成语法说明27public FlexFieldValueSetDef FlexFieldValueSetDef 名称：当节点为描述性弹性域的值集定义信息语法说明28public string DescFieldContextValue名称：描述性弹性域的上下文值语法说明29public bool ViriantCtrlEnabled名称：设置值对话框中的变量控件是否可用语法说明30public string DescartesPath名称：该条件项的笛卡尔路径说明方法1public FilterDefine()名称：FilterDefine的构造函数语法：说明：2public object Clone()名称：复制对象自身语法：说明：3public void GetObjectData()名称：获取对象数据语法：说明：实现ISerializable接口成员4public override string ToString()名称：重写的基类的ToString方法语法：说明：返回字符串为FilterDefine的Name加FullPath属性1.2 DefaultValue 默认值定义属性1public bool IsContext名称：是否采用“变量”机制语法：说明：是的话这里面的Values会被解释为上下文字段2public enuOperatorListType RelationOperator名称：关系比较符语法：说明：3public List<string> Values名称：条件的默认值定义语法：说明：4public List<string> Labels名称：语法：说明：5public List<ReferenceValue> ReferenceValues名称：语法：说明：方法1public DefaultValue()名称：默认值构造函数语法：说明：1.3 FilterValue 过滤条件值属性1public int FilterItemID名称：条件项ID号语法：说明：2public bool IsClearByEnabled名称：是否根据使能清空语法：说明：3public enuOperatorListType LogicOperator名称：逻辑操作符ID语法：说明：4public string LeftBracket名称：左括号语法说明5public string Name名称：条件值名称语法：说明：6public enuReferenceType ReferenceType名称：在FilterValue中加上参照的类型语法：说明：在FilterValue中加上参照的类型,为解决条件构造中一些特殊的情况，如枚举型is null及小于操作符等的处理,要考虑-1的情况7public enuOperatorListType RelationOperator名称：关系操作符ID语法：说明：8public string RightBracket名称：右括号）语法：说明：9public enuPageOfInputFilterValueType PageType 名称：描述当前条件值是从那一页签输入语法：说明：10public ValueContext Values名称：条件值集合，只读属性语法：说明：11public enumFilterValueType ValueType名称：条件值类型语法：说明：方法1public void AddValue(string value)名称：追加条件值语法：说明：2public string GetValue()名称：取得第一个条件值语法：说明：3public string GetValue(int index)名称：取得条件值语法：说明：根据index取得相应的条件值4public List<string> GetValues()名称：取得条件值集合语法：说明：5public void SetValue(int index, string value)名称：设置具体条件值语法：说明：设置第index的条件值为value6public void SetValues(List<string> values)名称：设置条件值集合语法：说明：7public string GetSecValue()名称：取得第二个条件值语法：说明：8public int ValueCount()名称：条件值数量语法：说明：9public override string ToString()名称：输出到字符串语法：说明：10public void FromString(string value)名称：从字符串输入语法：说明：1.4 RangeEnabled 使能控制属性1public List<RangeEnabledExpression> ExpressionList 名称：使能条件表达式集合语法：说明：2public List<SimpleOperator> LogicTypeList名称：逻辑比较符集合语法：说明：1.5 RangeEnabledExpression 使能条件属性1public string DefineName名称：要定义的使能条件名称语法：说明：2public enuOperatorListType Operator名称：使能操作符语法：说明：3public List<string> ValueList名称：使能比较定义的值集语法：说明：4public bool UnDefined名称：是否未定义标识语法：说明：可以设置当条件没有设置值时，被影响的控件是否可用；默认是没值时，可用比如A受B影响，设置A:DefineName=B,UnDefined=true, 如果B没有值，A就不可用5public bool IsDefined名称：是否已定义标识语法：说明：条件项被设置值时，被影响的控件是否可用，比如A受B的影响，当B有值时,A就不可用，这时设置A:DefineName=B,IsDefined=true, 在解析使能条件时，发现B有值，A就不可用。

U9 BP服务开发指南文件编号：版本号： 1.0修改状态：0编写人：祁宏伟审核人：适用对象该规范适用于U9所有BP和服务的开发人员版本记录【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】版本修改与参与人修改时间修改原因修改概述审批人1.0 祁宏伟 2008-7-10 原始版本创建1.1 祁宏伟 2008-7-30 增加模型设计，调整格式相关文档名词解释BP： business operation 业务操作，指一个业务操作单元．可以理解成一个有平台元数据和框架引擎支撑的业务方法．主要用于对于UI调用后台的业务数据操作和后台业务操作的逻辑封装． SV：服务，和BP一样同样也是业务操作单元， 但服务从设计上是用于为外部服务组外部应用提供的业务接口，可以进行webService发布．U9中使用BP和服务的主要场景：对于支持IIS和应用服务可分布的场景，UI在IIS服务器，调用应用服务器的处理必须要走BP，来支持跨进程，机器调用．此时该BP主要用于对UI的数据请求作处理和返回．对于应用服务间业务逻辑的处理过程中，常常有需要对业务逻辑进行一定的封装，此时用BP封装业务逻辑，主要是包装多个业务操作，提供功能接口．对于服务，只用于跨服务组，跨组织，跨Site情况下的业务功能接口访问．手册正文1BP，SV模型设计：BP与SV的模型设计是一样的，下面用BP的模型来演示．1.1创建BP项目打开UBF，解决方案中右键 “Solution’demo’”弹出菜单选择新建弹出创建对话框1.选择区域1操作项目 BP2.项目名称 SubmitSOBP3.点击确定保存退出这时解决方案中就多了一个项目” SubmitSOBP.ubfb”1.2 设计BP第一步: 双击SubmitSOBP进入BP设计区第二步: 拖入操作BP从工具箱中选择‘操作’拖入工作区中如图区域2所示修改操作属性名称为SumitSO显示名称为审核第三步新增BP传入参数在模型图中选中BP，在详细信息视图中添加传入参数类型的设置，同实体的设置方法一样第四步 设置BP属性选中BP, 点属性窗口1．修改名称2．修改显示名称3．修改返回类型，在这里默认为空类型，也就是V oid型4．是否是实体的主键5．事务类型选择6．是否需要权限的控制。