biztool: 3UCS BizXML Tool, 自动读取表结构及关联表信息与逻辑后生成BizXML（3UCS xPlus应用）代码，提供给3UCS xPlus服务端、PC客户端、手机客户端、web服务引擎解析执行实现诸如ERP、CRM、MES、工业互联网等信息化、自动化服务，支持MySQL、MSSQL、SQLite等等 https://github.com/dspflash/biztool

## 3UCS BizXML Tool	(http://3ucs.com/x/)

参见doc

## 安装

3UCS Server安装时会自动安装biztool，此处的代码与安装包只存在版本新旧问题，直接替换即可。

BizTool自动化工具

&nbsp;

（分分钟快速定制您的专属个性化软件应用）

(使用入门视频演示：<a
href="http://3ucs.com/dl49.html">http://3ucs.com/dl49.html</a>)

&nbsp;

<a
href="#_Toc27056922">2.&nbsp;&nbsp;&nbsp;&nbsp; BizTool
介绍... 3</a>

<a
href="#_Toc27056923">3.&nbsp;&nbsp;&nbsp;&nbsp; 页面级别配置及操作... 4</a>

<a
href="#_Toc27056924">4.&nbsp;&nbsp;&nbsp;&nbsp; 字段级基础配置及操作... 7</a>

<a
href="#_Toc27056925">5.&nbsp;&nbsp;&nbsp;&nbsp; 字段级扩展属性配置及操作... 9</a>

<a
href="#_Toc27056926">6.&nbsp;&nbsp;&nbsp;&nbsp; 一个简单实例... 11</a>

&nbsp;

&nbsp;

&nbsp;“我们能在几分钟内设计出专业的个性化应用软件”，3UCS的工程师如是说。

&nbsp;

事实上这一点儿也不夸张，您也可以做到，并且可以做得更好，随心所欲的定制您的CRM、OA、ERP、企业信息化、呼叫中心业务等等各类应用，因为这得益于3UCS发布的BizXML工具，凭借此自动化工具您可以之下花不到一分钟的时间生成一个应用界面，根据您的需要自动生成一组页面后您还可以根据自己的应用需求进一步的个性化您的业务逻辑和流程，以及各种多语言的设计，比如A用户使用中文、B用户使用英文、C用户使用德文之类，这些事情最快就可以在几分钟内完成。

<h1 style='margin-left:21.0pt;text-indent:-21.0pt;page-break-before:always'><a
name="_Toc27056922">2.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BizTool </a>介绍</h1>

什么是BizXML工具了？它就是遵循BizXML业务应用规范的一个工具软件，采用“所见即所得”技术，根据您自己的业务数据库结构自动生成应用界面及BizXML代码，生成的标准BizXML应用可以立即被BizXML业务平台解析执行，真实数据在线预览，显示的界面直接可以操作进行数据更新等，执行效果完全与实际应用相同。同时提供相关个性化参数设置并提供在线修改调整，方便您根据自己的意愿配置页面布局、数据间关系等实用性手段，也支持后续的逻辑流程控制修改调整。

下面就简单了解下BizXML Tool工具，如下图所示，该工具与数据库管理相结合，根据数据库表结构信息工作，不单单支持MySQL，其他数据库相类似，提供预览方便工程师随时直观的看到生成的应用界面，根据需要调整相应的字段参数来调整相关表的关系字段与内容，调整完毕后可以直接输出保存应用界面，同时可以生成语言包，以方便多语言支持，工程师只需修改语言包的内容为所需语言版本，用户界面将自动呈现诸如简体中文、英文、法文等多语言支持。

该工具可自动化识别数据表结构信息，根据表结构信息自动组装SQL语句、匹配相应类型控件生成页面，即在无任何配置情况下（您无需写代码、编辑SQL语句等）也可生成应用，同时还提供了丰富的界面生成参数设置，例如拟生成的应用界面宽度、表字段长度与控件宽度的系数值、控件等宽设置、表间关系字段等等。

<h1 style='margin-left:21.0pt;text-indent:-21.0pt;page-break-before:always'><a
name="_Toc27056923">3.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 页面级别配置及操作</a></h1>

图中① 选择要生成应用的数据库；

② 刷新数据库列表；

③ 选择要生成页面的是表还是视图；

④ 选择生成应用的表或视图；

⑤ 刷新数据表或视图；

⑥ BizXML Tool工具页面；

⑦ BizXML代码编辑测试页面；

⑧ 显示表预览数据或SQL执行结果数据；

⑨ 执行/编辑SQL语句；

⑩ 页面级别的设置部分，用于对表/视图应用页面的全局属性的设置；

&#9322; 字段基础属性的设置部分，用于对字段与页面控件的关系、属性设置，如控件类型、大小等；

&#9323; 字段扩展属性的设置部分，用于设置对应控件属性的设置，如与其他表的关联等；

&#9324;加载页面配置文件时字段名/控件映射关系设置，当我们修改表中字段名后重新生成页面时需配置来指示字段新名称与旧名称的匹配关系，例如将字段名“hr_shift_id”修改为“idx”则应设置&lt;dfmap&gt;&lt;map name=&quot;hr_shift_id&quot; value=&quot;idx&quot;/&gt;&lt;/dfmap&gt;，系统将自动配置“hr_shift_id”所有属性给“idx”；

&#9325;加载配置按钮，用于加载页面配置文件xpj，默认配置文件名为表/视图名称，系统读取配置并设置好相应的参数，系统在生成保存应用代码的同时会自动保存一个同名的配置文件，例如保存的应用页面名为hr_shift,系统会自动保存hr_shift.xpj；

&#9326;页面显示的数据视图的模式，默认为列表（ListCtrl)；

&#9327;保存应用时是否生成语言包，至少应该生成一次，用于汉化或配置为个性化语言如法语德语等；

&#9328;保存应用时是否自动添加至应用根文件，若需要能在主页面目录直接方面该页面，应该添加一次；

&#9329;保存应用时是否生成2pages页面，默认生成的是一个页面，显示与查增改删在同一个页面（主文件为xxx.xml,例如“hr_shift.xml”，子文件分别是“hr_shift_GBDEDIT.xml”、“hr_shift_GBDV.xml”、“hr_shift_GBOPE.xml”、“hr_shift_GBOPV.xml”），跟预览时看到的相同，系统提供了2Pages模式，自动生成2个页面，一个用于显示/查删，一个用于增改(主文件为xxx_v.xml,例如“hr_shift_v.xml”，子文件分别为“hr_shift_V.xml”、“hr_shift_Ve.xml”、“hr_shift_Vh.xml”、“hr_shift_Vs.xml”、“hr_shift_Vv.xml”、“hr_shift_Vpg.xml”、“hr_shift_Vpgop.xml”),系统在添加至应用根文件时会根据该项配置选择对应的主文件；

&#9330;勾选该项时点击“生成应用&#9331;”将预览页面，否则保存至文件；

&#9331;根据“&#9330;预览”是否勾选来决定是预览页面还是保存至文件；

&#12881;拟生成的应用界面宽度；

&#12882;尺寸系数,即表字段长度与控件宽度的系数值；

&#12883; 等宽设置,默认值为0,若非0值则启用所有控件等宽,若控件含有label则label宽度也分享该宽度值；

&#12884; lable默认宽度值；

&#12885; 下拉框Combobox默认宽度值；

&#12886; 日期时间DateTime控件默认宽度值；

&#12887; 日期控件Date默认宽度值；

&#12888; tab方式生成的页面及tab个数（单页面有效）；

&#12889; 初始化表同时加载数据（单页面有效）！

&#12890; 加载数据自动触发Click事件（单页面有效）！

&#12891; 更新操作关联表内容（有primary key）（单页面有效）！

&#12892; 关联表，显示关联表内容替代主表ID，让列表内容更具可读性（单页面有效）；

&#12893; 拟生成的应用界面数据视图（如ListCtrl）附加属性参数,eg:Size=&quot;15,20&quot;
Text=&quot;5&quot;；

&#12894; 拟生成的应用界面数据视图（如ListCtrl）附加元素,eg:&lt;dfmap&gt;&lt;map
name=&quot;text&quot; value=&quot;name&quot;/&gt;&lt;/dfmap&gt;；&#12895; 弹出式菜单项，Operators For view
list,eg:&lt;operator firstpage=&quot;1&quot; nextpage=&quot;1&quot;
refresh=&quot;1&quot; prepage=&quot;1&quot;&gt;&lt;op
text=&quot;xx&quot;&gt;x&lt;/op&gt;&lt;/operator&gt;；

&#12977; 附加控件项，在页面末尾增加定义的控件；AddOn control for this
Tap；

&#12978; 附加选择字段名，在选择语句（select）data 末尾部分增加相应的字段，additional data field
for select；

&#12979; 表头-行结构之字段ID，用于关联该表对应的表头（例如订单行表关联订单头，此处设置订单行表中订单头ID）；Header-line link, header primary key field name,
eg:cc_co_header_id of table cc_co_header; if not empty sys will auto generate menu
'addone' from list view；

&#12980; 表头-行结构之行表名，用于关联该表对应的表行（例如订单头表关联订单行，则此处设置订单行表名），Header-line link, line
table name, eg:cc_co_line, seperate by ','; if not empty sys will generate
Ve/VV links and query action on header_id'modification&quot;；

&#12981; 自定义插入语句，替换自动生成的sql语句；Query Format for Create op,
eg:insert into %{table} %{data}；

&#12982; 自定义更新语句，替换自动生成的sql语句；Query Format for Update op,
eg:update %{table} set %{data} where %{where}；

&#12983; 打开选择窗口为“&#12893;”选择元素属性；

&#12984; 打开选择窗口为“&#12894;”选择元素属性；

&#12985; 打开选择窗口为“&#12895;”选择弹出式菜单（模板）；

&#12986; 打开选择窗口为“&#12977;”选择附加控件（模块）；

&#12987; 字段信息；

<h1 style='margin-left:21.0pt;text-indent:-21.0pt;page-break-before:always'><a
name="_Toc27056924">4.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 字段级基础配置及操作</a></h1>

图中① 将选中的字段移动至最顶端（应用生成时将作为第一个控件）；

② 将选中的字段上移一行；

③ 将选中的字段下移一行；

④ 将选中的字段动至最尾端（应用生成时将作为最后一个控件）；

⑤ 若勾选该字段无效，既不生成控件出现在中也不参与sql数据的查增改删；

⑥ 将所有字段至无效，然后可以个别字段通过手动方式启用；

⑦ 该字段是否必须输入值，在执行“增改”操作时做检查；

⑧ 该字段是否可为空，缺省为均可不填，但若有指定某字段可不填，则其他未明确设定的均为必填项；

⑨ 自动化数据，无须添加或更新的字段，自增字段应设置；

⑩ 是否隐藏该字段内容；

&#9322; 该字段只读，内容不可修改；

&#9323; 所有字段将统一设置为只读，不可修改；

&#9324; 控件前留空默认20个单位尺寸；

&#9325; No Label，该字段的生成控件时不生成相对应的Label，默认跟随字段属性；

&#9326; 与前面的字段生成的控件合并在一个显示单元里（合并至前一字段对应控件的GroupBox）,默认跟随字段属性；

&#9327; 该控件前另起一行；

&#9328; ；

&#9329; ctrl的text属性，默认显示的文字；

&#9330; ctrl的size属性，控件长宽值，用逗号分隔，eg:100,20；亦可只设置宽度，省去逗号及高度，高度将使用默认值；

&#9331; 对页面做多Tab显示控制，每个Tab显示的第一个字段设置这个Tab的名称，不得使用控件名(字段名)；

&#12881; 插入数据（insert）时是否插入该字段值，默认为是；

&#12882; 插入数据（insert）时自定义字段取值,eg:%{x[x]},@xyz，默认为系统自动匹配；

&#12883; 修改数据（update）时是否修改该字段值，默认为是；

&#12884; 修改数据（update）时自定义字段取值,eg:%{x[x]},@xyz，默认为系统自动匹配；

&#12885; 读取（select）操作时是否修改该字段值，默认为是；

&#12886; 读取（select）操作时自定义字段格式,eg:bc as xyz，默认为系统自动匹配；

&#12887; 附加控件项（与该控件合并在同一显示单元GroupBox）；AddOn control(merged in) for
after this control；

&#12888; 附加控件项（添加在该控件后）；AddOn
control(External) for after this control；&#12889; 附加选择字段名，添加到查询语句（select）里，紧跟在该字段后，additional data field
for select after this control；

&#12890; 打开选择窗口为“&#12888;”选择附加控件（模块）；

&#12891; 打开选择窗口为“&#12889;”选择附加控件（模块）；

<h1 style='margin-left:21.0pt;text-indent:-21.0pt;page-break-before:always'><a
name="_Toc27056925">5.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 字段级扩展属性配置及操作</a></h1>

图中① 设定字段控件类型；

② 数据表字段控件自动匹配；

③&nbsp; 重置下面的信息以重新选择或输入；

④&nbsp; 字段附加属性参数,eg:Size=&quot;15,20&quot;
Text=&quot;5&quot;；

⑤&nbsp; 字段对应控件附加元素,eg:&lt;dfmap&gt;&lt;map
name=&quot;text&quot; value=&quot;name&quot;/&gt;&lt;/dfmap&gt;；

⑥&nbsp; 表/视图;Table|View，选择“⑦”显示的是表还是视图；

⑦&nbsp; 当前数据库表/视图，选中后填入“⑩”更新“⑧”的数据；

⑧&nbsp; 表/视图的字段，选中后填入“&#9322;”更新“⑨”；

⑨&nbsp; 控件数据与表中关联的字段ctrldb data rel,；

⑩&nbsp; 控件项值读取表ctrldbtable；

&#9322;&nbsp; 控件项值字段列表, ctrldbdata，当数据库表为空时则为选项内容（选项格式支持为1|2|3,1~3,1~3*10）；

&#9323;&nbsp; 控件项值读取条件，ctrldb where，eg: id=0, id=%{id[id]}；

&#9324;&nbsp; 控件项值自定义读取格式(query format)，默认自动生成，eg:select %{data} from %{dbtable}；

&#9325;&nbsp; ；

<h1 style='margin-left:21.0pt;text-indent:-21.0pt;page-break-before:always'><a
name="_Toc27056926">6.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 一个简单实例</a></h1>

下面以OrderInfo表为例展示X+平台一次生成同时兼容电脑客户端、手机客户端、浏览器的页面自适应显示、访问及操作。

设置相应参数后单页面显示如下，三个Tab显示（BizTool预览显示）：

2Pages模式显示如下（额外生成7个文件：orderinfo_V.xml，orderinfo_Ve.xml，orderinfo_Vh.xml，orderinfo_Vs.xml，orderinfo_Vv.xml，orderinfo_Vpg.xml、orderinfo_Vpgop.xml，根文件引用orderinfo_V即可），一个是查询显示页面（用于查删及弹出式菜单操作），另一个是编辑页面（用于数据增改），生成的应用界面不做任何修改在电脑客户端、IE浏览器、手机客户端、手机浏览器显示如下：

电脑客户端(3UCS NISU、3UCS XOne)、IE浏览器页面显示：

查询显示页面分查询条件及操作区域与查询结果显示上下两个部分，系统提供智能查询引擎，上部查询条件区域显示且有填入内容的控件自动作为查询条件提供查询操作使用，提供“初始”菜单返回到初始查询条件显示查询结果，支持模糊查询，可删除或字段不做查询条件（orderinfo_Vs.xml及orderinfo_V中search元素）

编辑页面默认是不带列表框的，但本例中关联了订单行表，即列表框显示的是订单行，并在此开启订单行的编辑管理菜单

IE浏览器访问

手机客户端、浏览器访问

&nbsp;

您应该注意到BizXML Tool工具实际上也是遵循BizXML规范的一个应用，这也更进一步表明BizXML业务应用系统的智能性和功能的强大。

&nbsp;

注意事项：

1.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
鼠标悬停各控件时会有提示信息；

2.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
自增字段应设置为自动，另可设置隐藏以不显示；

3.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
表结构字段先后顺序可调整，对应于界面里控件排序；

4.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
关联它表字段可使用Comobox、TextBox等控件关联，比如图中class；

5.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
列表等可初始化自动载入数据和分页，选择一个或多个参数组合；

6.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
模糊查询中生成的语法参考的是MySQL，其他数据库应作相应修改调整；

7.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
不同数据库的分页操作不相同，也需要做相应的修改和调整；

8.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
所生成的页面代码都遵循BizXML，您也可以自行调整修改布局、数据关系及逻辑控制等，参考BizXML规范；

9.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
生成的语言包可汉化或其他任何语言版本，注意文件格式为UTF-8；

&nbsp;

BizTool目前有发布MySQL、SQLite、MSSQL、Firebird、PostgreSQL等版本，其他数据库可修改这些版本的相关内容获得，主要区别在于SQL语句，可参考\biztools \*cfg.xml文件及\demo\ bt*.xml

&nbsp;

</div>

## 源代码说明
Files & Dirs
#BizTool生成的代码文件
1) 	xx.xpj
- BizTool配置文件，"xx"为对应于数据库表名（若保存时设有新名称则是新的文件名）
- bizxml project files, auto saved by biztool
	
2)	xx.xml, xx_GBDEDIT.xml, xx_GBDV.xml, xx_GBOPE.xml, xx_GBOPV.xml
- 自动生成的单页面文件（页面上部分为编辑，下部分为ListView之类的显示）
- auto generated files use 'x'.xpj by biztool

3)	xx_V.xml(数据显示视图页面view), xx_Ve.xml(数据编辑修改页面Edit), xx_Vpg.xml(显示记录数、分页、页码), xx_Vpgop.xml(翻页操作), xx_Vh.xml(编辑，一般无需修改hide for edit), xx_Vs.xml(查询条件代码search for view), xx_Vv.xml(显示视图代码 listctrl etc, for view)
- 自动生成的双页面代码文件
- auto generated files(2 pages, one for view and one for edit)
	
4)	xx_ops.xml
- 自定义的弹出式菜单代码
	
5)	xbs_??.xml
- 用户根文件
- user root layouts.
	
6)	v??.xml manual 
- 手工编辑的代码文件
- composed files
	
7)	??_V.xml(none of ??_Ve,??_Vh files exist)
- 手工编辑的代码文件
- manual composed files
	
	
8)	??_V?m.xml,??_V?m.xml
- 手工编辑修改的代码文件（原始文件为xx_V?.xml文件）
- manual composed files(modified according to ??_V?.xml)
	
rule/		xlogic files invoked in "3)" files

lan/		language files

install/	install scripts and instructions

install/import_example.zip	Demo data(xyz9g.xls,bom_resource.xls,customer.xls,poQuote.xls,sdQuote.xls) and examples for import

install/orderNoYearMon.sql	sql for OrderNo only with Year and Month

install/costUpgrade	sql for cost upgrade

## 二次开发与个性化定制

## 在线沟通 Discuss
可点击图片与我们在线沟通交流 
Contact us at <a href="http://3ucs.com/xchat/index.php?enterurl=http%3A%2F%2Fgithub.erp.3ucs.com%2F"><img src="http://3ucs.com/images/livechat.png" alt="Chat 在线客服"/></a> if you have feedback, questions or want to chat.

bizfree/biztool

简介

发行版

贡献者

近期动态

bizfree/biztool .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

bizfree/biztool