如何用jxTMS开发一个功能（五）

本文是讲解如何用jxTMS来开发jxTMS示例之故障排查的系列文章中的一篇。整个系列的文章请查看：如何用jxTMS开发一个功能

提取为知识

由于大部分内容前面都已经讲过了，所以主要讲前面没讲过的内容。

1、入口

提取为知识情的入口和之前讲解过的入口有两点不同：

• 该界面是显示到一个对话框中的

• 该入口有一个显示条件

显示到对话框中是非常简单的：

json.set('dispInDialog',True)

对话框和主界面的不同点的有三：

• 每个主界面都是一个新的capa，而对话框和主界面是同一个capa

• 宽度是600像素

• 对话框没有工具条，即对话框不能再打开对话框进行套娃

入口的显示条件主要用来控制用户在当前能否操作该入口。role是控制有哪些用户有权限访问本入口，而显示条件是在有权操作时，还要满足什么样的业务条件才可以访问。

如何设置显示条件，请参考jxTMS在线编程手册中的入口显示规则。

提取为知识的入口定义是：

@biz.Demand('disp','addKNFromCase')
@biz.OPDescr
def op(json):
    json.setA().text('提取为知识'.decode('utf-8'))
    json.set('dispInDialog',True)
    json.dispCondition('field.State==已修复 且 field.Tag!=已提取'.decode('utf-8'))

其显示条件是：故障已经修复且标记字段不能是已提取。

然后将提取为知识链接给故障的查看详情界面：

@biz.OPDescr
def oplink(json):
    #将【提取为知识】链接给【查看故障详情】
    json.setBtnList('disp.dispCase', 'disp.addKNFromCase')

这样在查看故障详情的时候，如果条件满足【故障已经修复且标记字段不能是已提取】，用户就会看到提取为知识，这里考虑到示例的便利没有设置权限，所有任何用户都能执行提取为知识，如果要限制只有特定用户才能执行，只要再用role为提取为知识指定一个执行角色即可，如：技术经理。

2、web界面设计

提取为知识的界面定义如下：

web addKNFromCase type div okBtn='addKNFromCaseBtn';
web addKNFromCaset1 parent addKNFromCase type table title='知识详情',width=600,alone=true;
with addKNFromCaset1 row 0 col c0 web n type text text="名称：",width=100;
with addKNFromCaset1 row 0 col c1 web n bind knName type input width=500,placeholder="请输入名称中应有的关键字...";
with addKNFromCaset1 row 1 col c0 web n type text text="属性：",width=100;
with addKNFromCaset1 row 1 col c1 web n bind knAttr type tag width=500;
with addKNFromCaset1 row 2 col c0 web n type text text="说明：",width=100;
with addKNFromCaset1 row 2 col c1 web n bind knDescr type textarea width=500;

with addKNFromCaset1 row 3 col c0 web n type text text="内容：",width=100;
with addKNFromCaset1 row 3 col c1 web n bind knContent type codeEditor width=500,height=600;

web addKNFromCaseBtn parent addKNFromCase type a width=80,text='添加',
    motion=cmd,demand=addKNFromCase,hide=true;

提取为知识是一个对话框，而对话框自身有两个按钮：确定、取消。而一般的操作界面也都会有确定按钮，这就会出现一个歧义：用户点哪个按钮呢？！

所以对话框界面有一个独特的属性：okBtn。jxTMS会用该属性所指定的a控件来取代对话框的确定按钮，同时在定义这个a控件时，为避免出现两个确定按钮，还应将a控件定位为不可见：hide=true。

3、数据

知识管理属于jxTMS内部的管理，所以相应的数据应遵从知识管理的要求。我们在下面讲解业务逻辑时一起进行讲解。

4、业务逻辑

提取为知识的业务逻辑包括三部分：

a：根据知识管理的要求创建知识并写入相关数据

kt = '文本说明'.decode('utf-8')
kn = self.getInputString('knName')
#知识的流水号，这里是直接用自己的模板
kc = self.getSerialNumber(db,'knowledge','ST-{MM}{DD}-{SND3}/{YYYY}')
k = knowledge.create(db,kt,kn)
#因为知识管理模块有自己的语义转换，所以要用知识管理模块的语义转换来保存自己所给出的知识信息
self.execCapaFunc('knowledge.main','setFieldWithNameTrans',db,k,'knSN',kc)
self.execCapaFunc('knowledge.main','setFieldFromVar',db,k,'knDescr')
#从上下文中获取用户的简称
ko = ctx.getCaller().abbreviation()
self.execCapaFunc('knowledge.main','setFieldWithNameTrans',db,k,'knOwner',ko)
self.execCapaFunc('knowledge.main','setFieldWithNameTrans',db,k,'knState','使用中'.decode('utf-8'))

知识管理目前也只有一种知识类型：文本说明。知识管理用knowledge来保存知识的数据。这里有了一个大家从没见过的函数：execCapaFunc。

execCapaFunc(capaname,funcname,ps):
参数：
	capaname：功能点名
	funcname：函数名
	ps：变参，对象数组
返回值：
	funcname名的函数的返回值
说明：
	调用其它capa的内部函数，目前只允许调用：setFieldWithNameTrans、setFieldFromVar、dispVarFromField这三个语义转换函数

所以大家只要理解了四个execCapaFunc其实就相当于是按知识管理中的语义要求，来设置知识流水号、描述、管理人和状态就好了。

b：打标记。为便于对知识分类，所以知识都会打标记。而打标记则是常规的处理：

#knAttr的类型是tag，其值是用英文逗号连接的一组标记短语
ts = self.getInputString('knAttr')
if not utils.isNull(ts):
    ss = ts.split(',')
    for t in ss:
        #将所有标记提取后逐一打标记
        k.tag(db,t)
        
#在查看时，如果想知道打了哪些标记，就需要查一次数据库，如果是在列表时想知道知识的标记
#那就每显示一行就需要差一次数据库，所以将知识标记保存到知识中，以减少列表查询时数据库开销
k.Info = jxJson.getObjectNode()
k.Info.set('knAttr',ts)
#数据类的对象保存到数据库时非常简单，就是一个update命令即可
db.update(k,'Info')

c：知识管理对知识的处理是有版本的概念，即知识的实际内容是保存在当前版本中的

#知识是有版本的，实际内容是保存到相应的版本中的
kv = k.newVer(db,ctx.getCaller().id())
kv.Info = jxJson.getObjectNode()
c = self.getInputString('knContent')
kv.Info.set('content',c)
db.update(kv,'Info')

大家如果看过自己下载的capa.py文件，会发现后面还有几行注释：

#调用不同类型的知识【参考jxTMS的跨capa协作的框架法
#（https://zhuanlan.zhihu.com/p/482457242）】，其所注册类型的相应处理
#文本说明型知识，其在addKN时的处理，就是上面的5行代码，所以二选一即可
#self.doOtherCapaDual(db,ctx,k,'knActive',kt,'addKN')

也就是说，我们完全可以不使用上面的那5行代码来保存实际的文本说明型知识内容，而是用doOtherCapaDual来注册到系统中用来对文本说明型知识保存实际内容的函数。即：

self.doOtherCapaDual(db,ctx,k,'knActive',kt,'addKN')

该函数的语义就是调用注册用来管理kt【此时是：文本说明】类型的知识capa，通知其需要对k做knActive+addKN的操作。

具体说明，请翻阅：jxTMS的跨capa协作的框架法。