BL建模平台用户手册.docVIP

Business Logic用户手册Conitect BL 2011 版 关于本手册本用户手册是关于Business Logic（一下简称BL）的使用说明，请在使用本软件之前认真阅读完整的软件用户手册，以获得软件使用操作的全面指导。随着软件系统的升级更新，软件的功能、性能、操作使用以及公司的相关服务承诺将有所变化。作为该软件的设计开发以及版权所有单位，同力天合管理软件有限公司有权对用户手册同步进行更新。对于产品的说明和服务项目说明等所有文字信息都以更新后的最新版本为准。用户手册更新版本后，同力天合管理软件有限公司不再另行通知，用户可登录公司网站()查阅。同力天合管理软件公司对因参照旧版本用户手册而出现的产品使用问题和服务疑问不承担任何责任。疑难问题解答用户在系统使用中的疑难问题，可以通过公司网站获得一般性问题的帮助，进一步的问题解答可以咨询软件销售和实施人员或通过公司客户服务热线获得进一步的帮助。 软件的售后服务请参照相关的售后服务协议。 目录第一章系统简介31.1Business Logic 是什么31.2系统的目标用户类型31.3BL系统结构原理31.4模型驱动软件开发原理41.5应用BL开发实施管理软件过程。5第二章概念及技术说明72.1BLML（Business Logic Markup Language）72.2目标系统 (Target Application)72.3企业(Enterprise)72.4主题域（Subject Domain）82.5实体 （Entity）82.6ERI82.7属性（Property）92.8活动（Activity）92.9包（Package）92.10Web Service及SOAP9第三章数据集主题域10第四章数据定义主题域154.1数据属性定义154.2数据活动定义15第五章视图主题域165.1视图属性定义165.2视图活动定义16第六章编辑主题域186.1编辑属性定义186.2编辑活动25第七章核心业务主题域267.1核心业务属性定义26附录A 系统公式说明27附录B 系统安装部署文件33第一章 系统简介1.1 Business Logic 是什么BL 是一个快速管理软件构建平台。它采用模型驱动架构进行设计，能够用于构造企业模型，并能够通过BL执行环境动态生成管理软件。用BL构建管理软件，不仅能够实现管理经验的积累，更重要的是它能够保证管理软件功能适应管理模式变革的需求，真正实现了，业务最佳实践，软件应需而变。具体来说通过BL能够完成以下工作：1) 创建并维护企业业务模型。 2) 创建并维护软件功能模型3) 解释执行软件功能模型，生成管理软件。1.2 系统的目标用户类型BL作为管理软件构建平台，面向的对象是对管理业务有一定了解的IT 技术人员。 1.3 BL系统结构原理图1.1 BL系统结构原理图BL系统结构原理如图1.1 所示， 图中圆角矩形方框是BL系统功能的三个组成部分，解释如下：1) 建模平台建模平台是创建并维护企业业务模型和软件功能模型的软件环境。构造管理软件首先从企业模型开始，然后转化为软件功能模型。2) 运行平台解释执行软件功能模型，动态生成管理软件，供最终用户使用的软件环境。 图1.1 模型同BL运行平台之间的关系3) 管理工具进行系统配置和授权管理的软件环境。 1.4 模型驱动软件开发原理BL采用“模型驱动架构（Model Driven Architecture，MDA）”进行设计，应用BL构造管理软件的过程是“模型驱动的开发（Model Driven Development，MDD）”过程。 应用模型进行软件开发是软件工程领域的又一重大发展，这种方法使软件开发从原始的用泥土（汇编语言）和砖瓦（高级语言）构造软件的阶段，发展到现代的应用预制件（模型语言）描述系统的构建阶段， 如图1.2所示。 目前模型驱动的开发方法已经成为研究和实践领域所关注的热点，BL是应用这一原理在企业管理软件构建领域构建的一个突破。 图1.2 模型驱动软件（MDD） 开发方法1.5 应用BL开发实施管理软件过程。 1) 企业需求调研阶段由具有企业相关行业管理经验的专家与企业用户进行交流，把好的管理经验介绍给企业，同时也了解企业个性化管理需求，形成相对优化的业务管理模式。 2) 企业业务模型创建阶段根据优化后的业务和管理模式，创建描述企业的业务执行、单据流转、业务规则等的企业业务模型。 3) 软件功能模型创建阶段根据企业模型，通过BL自动生成软件功能模型，并可以手动调优。4) 软件运行测试和模型优化阶段通过BL执行平台执行软件功能模型，进行测试，优化。 5) 系统安装运行阶段系统测试完成后可以交给用户进行实际的使用，通过培训，数据准备等工作，进行系统启用。 第二章 概念及技术说明2.1 BLML（Business Logic Markup Language）BLML 是“Business Logic Modeling Language”的简称，即业务逻辑标记语言， 是BL系统用来描述企业业务模型和软件功能模型的语言工具。 它是应用XML进行领域化定制的一个XML应用。 2.2 目标系统 (Target Application)在本手册中，“目标系统”是指应用BL针对某个企业用户构造的应用系统，它不同于传统的管理软件，不再以模块或者子系统划分系统的范围，因为目标软件的功能完全由软件功能模型（以BLML数据的形式存在）决定，BL运行平台类似Web浏览器（如IE，或Firefox），提供的是对BLML模型的解释执行，因此最终用户虽然用的是BL的运行平台，但具体的功能会根据具体的BLML不同而不同， 因此目标软件实际上指BLML软件功能模型 BL运行平台。2.3 企业(Enterprise)企业是目标软件的应用对象，在BL中“企业”是系统配置的基本单位，企业不同对应的软件功能模型和业务数据套都可以不同。BL目标软件与其他类型的管理软件不同，其他类型的管理软件往往以账套的概念区分软件应用的范围，这类系统中，账套不同意味着软件功能相同，数据所对应的应用对象不同。 在BL中企业不同意味着软件功能（由BLML的模型数据来决定，也是数据）和数据都不同。 2.4 主题域（Subject Domain）对于BL中的企业模型来说，主题域是企业对某种类型业务管理需求的基本单位。 对于BL中的软件功能模型来说，在BL中主题域是指一种类型的抽象功能，例如对于单据的编辑录入主题域、单据的记账主题域、数据查询算法的等。 BL中，无论是企业模型还是软件功能模型都是对主题域的建模。例如数据集作为软件功能模型的一个主题域，具体建模中应给出数据库访问的SQL，查询参数定义，以及查询结果列的标题等信息。 2.5 实体 （Entity）在BL企业模型中实体是基本的业务单位，例如，入库业务，出库业务，产品目录等。 在BL软件功能模型中，实体是软件中基本的功能模块单元。如入库单实体，出库单实体，产品档案实体。 每个实体都会有对应于此实体操作的功能属性，如入库单的录入，入库单的记账，入库单的数据删除，审核等管理功能主题域的模型定义。 实体代表业务处理过程中所涉及的业务对象，如人员、部门、销售单等，业务实体是组织软件功能的基本单位。一个实 体具有多个属性。2.6 ERIEnterprise Resource Identifier ，简称ERI，类似URL是实体和实体属性的地址。 2.7 属性（Property）属性代表对实体操作的功能的一个方面，如人员档案的编辑，人员档案的查询等。属性是对各种系统抽象功能的客户化 过程，对属性的定义是通过 XML 文档客户化定制系统功能的过程。属性具有多种类型，每种类型的属性是系统提供的 一种功能类型。2.8 活动（Activity） 是对属性所代表功能的一种使用方式，如对人员编辑属性来说，可以定义不同的活动，以限定操作的方式和权限。活动是 操作权限分配的基本单位，活动可以定义前提条件和后置活动以及多种其它限定条件。2.9 包（Package）用来组织分类实体和包的基本单位，可以将一个应用系统中的业务实体化分为基础数据包、业务数据包等，基础数据 包下面可以包含部门代码、人员代码等。包可以嵌套，按照层次进行组织，如业务数据又可以划分为销售业务包、采 购业务包等。 2.10 Web Service及SOAPBL系统采用的架构和远程访问方式第三章 数据集主题域数据集是定义数据库查询SQL，数据显示格式和查询参数等的属性。 一般实体会定义几个数据属性，用于数据查询和编辑。 在使用数据集的时候需要指定数据的ERI ,ALIAS 和 FORMAT.查询定义 可以是任意SQL语句系统除了将其中的参数替换外，不进行任何语法检查，直接交给数据库系统执行。 SQL 查询定义，形成最后的结果集，将会从数据库服务器获取数据，并传递给应用服务器，或客户端。 一般是在PRESQL中查询生成临时表，然后在次将临时表中的数据形成最终结果，对于简答的数据则直接写查询sql就可以了。 TABLES: 是FROM 中的的定义。 SELECTxsdid = t_xsdd.xsdid,employeeid = t_xsdd.employeeid,wldwid = t_xsdd.wldwid,khfdid = t_xsdd.khfdid,gsid = t_xsdd.gsid,FROMt_xsdd AS t_xsdd LEFT OUTER JOIN c_khfd AS c_khfd on( t_xsdd.khfdid= c_khfd.khfdid), s_employee AS s_employee, c_gsdn AS c_gsdn, c_wldw AS c_wldw WHERE (t_xsdd.employeeid = s_employee.employeeid) and (t_xsdd.gsid = c_gsdn.gsid) and (t_xsdd.wldwid = c_wldw.wldwid) and (t_xsdd.xsdid = :xsdid )编辑数据后保存到的表，数据集在编辑中使用时，一个数据集只能更新一个表TABLE :被更新的表WHERECOL ： 更新后作为查找记录的条件，只能取值UPD xsdid数据集记录的ID，一般是主表的id数据集查询后的列定义DBNAME： 列对应的数据库表和列名称DATATYPE: 数据类型，3为整数 1为字符串 11为日期，18为decimalALIGNMENT：字段中数据显示的对齐方式。0左对齐，1为右对齐SIZE :小数位数PRECISION : 字段的长度CODE: 列的名称，是SQL中 AS之后或者 之前的列名称NAME:列的汉字名称FORMAT: 数据显示格式MASK ： 数据格式DEFAULTVALUE: 数据的默认值，在新建记录的时候自动填充这个值。数据集的参数定义ecodecreateby 可以作为查询条件的列，在查询数据集中，只有出现在其中的列才是可以作为查询条件的，一般ID号等不作为查询条件。 参数定义。TYPE: 有三种类型 INSQL,ADDON和OPTION ,INSQL 是直接写在sql中的参数， 必须定义参数的数据类型，要使用数据集，INSQL的参数是必须提供的；ADDON 是有系统将参数定义中的条件加到SQL标签中的WHERE 后面的条件，ADDON类型的参数在查询数据集由REQUIRED 属性定义是否必须提供；OPTION 是最灵活的参数，可以放在SQL中的任何位置， 其他方面同ADDON类型参数.CODE ； 参数的名字REQUIRED ：查询数据集的时候是否必须提供此参数。如果为TRUE必须提供参数才能查询数据集。NAME ：参数的名字，用于显示查询条件的时候，作为输入参数的标签。DATATYPE:参数的数据类型，取值同列。ADDON类型参数定义 AND ( t_cpcz.ecode = :ecode ) 如果提供参数，系统将用参数替换此处表达式，然后再将替换后的结果放在查询的后面。 OPTION 类型参数定义 and s_employee.ecode in (:_YWY)如果提供参数，系统将用参数替换此处表达式，然后再将替换后的结果替换查询中对应的参数。数据显示格式定义，数据集同时可以有多个格式定义。格式定义STYLE: 可以有PANEL, STRINGGRID, FORMULA三种类型 CODE: 格式的代码NAME:格式的名称WIDTH: 格式的宽度，对于PANEL有意义HEIGHT: 格式的高度，对PANEL有意义格式中的对象，对于PANEL 和GRID 类型有意义TYPE:格式对象的类型 ,TEXT 文本类型，COL普通的文字输入列，CBX CheckBox类型,DL 下拉列表类型,IMG 图形类型，MEMO 备注文本类型CODE :对象的标识符LABEL:文本类型对象中的文本VISIBLE： 是否显示READONLY: 是否只读X，Y ： x，y坐标对Panel有意义HEIGHT,WIDTH 对象的高度和宽度，HEIGHT 对panel有意义，width对stringgrid和panel有意义。 SIZERATIO ： 当用户resize窗口时，对象位置大小变化的比例，对panel有意义。 取值为 “x，width ” x为当窗口resize时候，x 位置变化比例，width为控件宽度变化比例。 例如窗口增加100时，如果 设定的值为“50,25” 则 控件的新的位置 初始位置 ，宽度为初始宽度STRETCH 是否自动缩放 电子表格打印格式定义，如果文件扩展名称为vts 则系统认为是格式，如果是则认为是文件。GROUPBY : 分组字段，如果需要分组小计，可以在其中设置字段用分割，分组可以有多层。WIDTH ：报表模板中有公式的开始列和结束列， 行默认为1TITLE: 报表标题列的行范围 2,9 是从第二行开始到第9行结束FOOTER ： 报表表底的开始和结束行号HEADER : 为分组开始的SUMARY: 为分组小计（对于整个报表来说是总计） 的开始和结束行号COLUMNS： 暂时无用PAGETYPE: BREAK 为根据分页符来计算页面大小NOPAGE : 为TRUE 不自动分页，连续填充明细记录的范围查询的别名定义，别名代表一种查询方式，其中可以定义过滤条件和参数。别名定义CODE： 别名代码NAME ：别名名称过滤条件定义，用于增加到最后一个SELECT 的WHERE 后面。例如 ( c_wldn.ecode in (sdf,sdf)参数定义,用于报表查询中显示查询参数CODE 参数代码，必须在PARAM定义中出现。VISIBLE: 是否显示DEFAULTVALUE:默认值。关于打印格式的详细说明 1) filename可以是表达式. 根据值使用不同的格式 if(field=en,英文格式.cll,中文格式) 2) NOPAGE 为true不分页 ,部分也就不填充空行 3) REPEATTITLE =FALSE 就不每页都打印title部分和footer部分 ,只有第一页有title和最后一页有title 4) PAGETYPE =BREAK 默认为BREAK 根据分页符的位置计算页面的大小. 5) COVER 封面,BACKCOVER 封底. 即首页和最后一页打印的 6) 视图的属性也适用于页面定义,或者说页面对象也是一个GROUP类型的视图. 例如:7) TYPE=GROUP/BLOCK 没有指定 默认为GROUP; 8) DATASET=对应的子数据集的名称 9) FILTER=过滤条件表达式 10) CODE=视图的代码 11) RECPERPAGE=每页的记录数,12) GROUPBY 排序和分组的依据 13) HEADER=A1:B2 HEADERXH=TRUE SUMMARY=A1:B2 SUMARYXH=TRUE XH=FALSE 14) 关于CrossTable 交叉表系统首先把数据集转化成为交叉表的形式,然后再填充表格, 具体的方法如下: 第四章 数据定义主题域4.1 数据属性定义表定义 MAINTABLE： 主表CODE:表名称IDCOL : 主键 DL，CBX ： 等类型的定义结账时间字段定义4.2 数据活动定义DISABLECMDS : 不可以执行的命令RIGHT:是否能够设定权限。 第五章 单据状态设定第六章 视图主题域6.1 视图属性定义属性定义6.2 视图活动定义企业视图中的视图活动定义文件夹类型的条目TYPE : LINK ,FOLDER,DATASET 视图条目的类型LABEL: 文件夹的标签DESCRIBE ： 描述信息ICON ： 文件夹显示的图标SELECTIONICON: 鼠标选择后的图标连接类型的条目ERI: 连接的视图ACTION:连接的活动普通实体的中视图活动定义TYPE: DATASET 为数据集LABEL：标签ERI:数据集的ERI ALIASES : 用到的别名列表DEFAULTALIAS：采用的别名DEFAULTFORMAT：采用的格式PRINTFORMATS：打印的格式ICON：图标MENUERI :显示的全局菜单MENUACTION :菜单活动DOUBLECLICKCMD : 双击执行的菜单命令PATH: 用来保存查询条件的路径第七章 编辑主题域7.1 编辑属性定义打开编辑界面时，除了显示编辑菜单外，还要显示与被编辑实体相关的其他功能的菜单MENUERI: 菜单属性的ERIMENUACTION :菜单属性的对应的ACTION编辑主题域用到的数据集的定义编辑数据集的布局定义编辑界面中左下方，明细表部分的定义布局元素的定义TYPE : 布局的类型 HORIZON 水平排列；VERTICAL 竖直排列，GRID 单表排列，PAGE 页面布局。对于HORIZON 和VERTICAL 下面只能有两个子LAYOUT；对于GRID 下面不能再有子标记； PAGE 类型仅能跟在EDITLAYOUT和BRLAYOUT 下面，可以有任意多个PAGE类型的子标记定义。TABCAPTIOIN : 布局页的标题，仅用于PAGE类型CAPTION ：布局项的标题，用于GRID, HORIZON,VERTICAL;HEIGHT: 在VERTICAL 布局中，布局项所占用的高度比例（百分号100以内整数），或绝对竖直。WIDTH： 在HORIZON布局中，布局项所占用的宽度比例（百分号100以内整数），或绝对竖直。 DSTYPE: BROWSE或EDIT 两个值，分别是EDITDS 或BROWSEDS 下的数据集DSINDEX ：数据集的在BROWSEDS 或EDITDS中的索引，从1开始。 编辑界面右侧的界面的定义，此部分定义为可选择，如果不出现，则编辑界面的右侧将不出现布局项。此部分定义同EDLAYOUT多层编辑数据集（三层或三层以上需要定义）之间的关系定义，用于定义上层表当前记录变化时，子表记录跟着筛选属于上层表当前记录的记录，同时保存记录时将上层表和下层表记录id之间的对应关系。 关系定义TYPE ： 仅有SUBDETAIL 类型RELFIELDS： 用等号分割，两端是分别来自下层表和上层表的字段。MASTERINDEX: 上层数据集的索引，即在编辑数据集或浏览数据集中的位置，从1开始MASTERTYPE: EDIT 上层表是否是编辑数据集，如果是EDIT则为编辑数据集，否则为浏览数据集DSINDEX : 子数据集的索引，从1开始。ISEDITOR : 子数据集是否是编辑数据集，如果为TRUE 则是编辑数据集，否则为浏览数据集。 备注：暂不支持浏览数据集的关系。 编辑实体的主表ID，用于查询编辑数据集和浏览数据集编辑主题域用到的编辑数据集的定义编辑界面下点击打印和打印预览功能的定义:ER I:是用于打印的数据集定义，ALAIS: 是用于查询数据集的别名，FORAMT: 是用于打印的格式，可以有多个用分割.说明: 编辑中可以制定多个PRINT标签,系统将利用主表数据集(第一个DATASET定义中制定的数据集)计算CON标签中的表达式,知道找到第一个复合条件的打印定义标签,利用它进行打印. 例如: 例如销售合同可以根据客户所在的国家来自动选择不同语言定义的打印格式. 在编辑界面下按下ctr+r或者菜单中选择全部计算时，进行计算处理的定义。DESTDS :计算目标值所在的数据集编辑数据集定义,属性说明如下:CODE: 是任意标识符,在同一编辑中不能重复ERI: 对应的数据集的ERI地址FORMAT: 编辑使用此数据集的格式代码ALIAS: 编辑查询此数据集用到的别名NOROWSAVE:在没有数据记录输入的情况下是否保存,只适用于多行的明细数据集. NEWRECFOCUSFIELD:新增记录时，输入光标会自动放在此列上。 HASRELATION: 是否在RELEATION 定义中作为子数据集出现，如果不是，在工具栏上单击新建的时候或自动增加一个新纪录，如果是，会根据主表中的记录新建情况进行增减记录。 ecodetrantime 数据集中可编辑列的列表用分割, 作为可编辑列,其内容的变化可以触发重新计算和参与事件. 即,只有可编辑列才能作为计算定义中的来源列, 才可以作为被参与的列使用.非编辑列的变化不会引起任何影响. 编辑列并不影响列的只读属性.ecodetrantime 必须输入的列,如果不输入则保存时系统提示必须保存数据, 对于字符串来说空字符串,对于数值来说, 0(零) 都是未输入的内容. 参照列定义, 用于保存时候自动将主数据集中的值填充到本数据集. 例如主表ID字段的内容填充的子表中。COLCODE :被填充的列名称REFCOLCODE : 主数据数据集可以解释的表达式. 自动编号的列定义.CODE: 被自动编号计算值的列代码FORMAT: 生成自动编号的表达式,其中 _SN(string asID) 是用于生成自动编号的公式,从1开始永不重复, asID是一个在本实体内不重复的标识符DEFAULT: 如果指定此属性的内容,则记录内原来的值与DEFAULT定义相同时才自动编号,否则认为是用户手动编号,不再生成编号. 保存之前对于整个数据集进行合法性检查 表达式为FALSE 时，显示错误信息前台检验的业务规则,当输入某个列的值后检查 CODE :输入后检查的列EXPRESS: 表达式，如果为假提示错误。MESSAGE: 不符合规则时提示的信息字段的值输入后执行的命令CODE: 被监视的字段值COMMAND ：执行的菜单命令，本例中，输入的列的内容后首先保存数据，然后再新建记录。REQUIRECOL: 如果没有值，就是删除的行COMPUTERCOL：删除记录后需要重新计算的列，例如，明细记录删除后需要重新计算表头的汇总数据。有客户端判断,录入数据时,在本单据内是否有重复的记录.如在订单中一个产品不允许出现多行. CODE: 被监事的列,输入完此列后检查是否重复. EXP: 用于计算值的表达式, 录入CODE中的列后,计算本记录的EXP 再看其他是否有此值相同的记录. 如果不指定,则使用CODE中指定的列的值. TYPE: 为NO 的时候,不接受重复的值,自动清空输入内容,否则,仅是提示. ecode 服务器端,数据保存之前判断的记录是否重复, 有些列要求全局不能重复,如商品代码,人员代码等.