本文节选自《疯狂Workflow讲义（第2版）》

DMN的XML规范

        DMN规范的官方网址为：http://www.omg.org/spec/DMN/，在官方网站上可以获取到DMN的规范文档、DMN的XML Schema文档和样例文档。笔者已经将以上三份文档下载，并保存到代码目录，以下为这三份文档的代码路径：

• 规范文档：codes\15\15.2\DMN规范.pdf
• XML Schema：codes\15\15.2\dmn.xsd
• 样例文档：codes\15\15.2\example.xml

决策

        在DMN规范中，根节点为definitions，该节点下可以出现import、itemDefinition、drgElement等元素，其中drgElement是一个抽象元素，decision元素继承于drgElement。一个decision表示一次决策，可以为它设置name、id、label属性，按照DMN规范，name属性是必需的，而其他属性则是可选的，但作为decision的唯一标识，建议id也需要设置。一个definitions下可以定义0个或多个decision。代码清单15-2定义了一个decision元素。

        代码清单15-2：codes\15\15.2\decision.dmn

<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/DMN/20151130" 	id="simple" name="Simple" namespace="http://activiti.org/dmn"> 	<decision id="decision1" name="Simple decision"> 	</decision> </definitions>

        一个decision元素由question、allowedAnswers、expression等元素组成，其中expression元素表示决策逻辑，expression是一个抽象元素，DMN规范中，decision元素下的expression可出现0次或1次。

决策表

        一个decisionTable元素表示一个决策表，decisionTable继承于expression元素，因此在decision元素下，decisionTable只允许出现0次或1次，这是DMN定义的规范，在Activiti的实现中，decision元素下如果不提供decisionTable，会报出异常。代码清单15-3定义了一个decisionTable元素以及它的几个子元素。

        代码清单15-3：codes\15\15.2\decisionTable.dmn

<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/DMN/20151130" 	id="simple" name="Simple" namespace="http://activiti.org/dmn"> 	<decision id="decision1" name="Simple decision"> 		<decisionTable id="decisionTable"> 			<input/> 			<output/> 			<rule></rule> 		</decisionTable> 	</decision> </definitions> 

        根据 DMN规范，一个decision下最多只有一个decisionTable，虽然规范中定义可以出现0次，但这样做就失去了意义，如果不提供decisionTable，Activiti的规则引擎会报出异常，信息为：java.lang.IllegalArgumentException: no decision table present in decision。

        决策表元素有四个属性：hitPolicy、aggregation、preferredOrientation和outputLabel，其中hitPolicy属性用于定义规则冲突策略。

        元素decisionTable下的input、output和rule子元素，可以出现多次，其中规范中定义了output元素最少出现一次，也就是意味在规范中，一次业务决策必须产出一个结果。在Activiti的初步实现中，decisionTalbe元素下，input、output和rule三个子元素都必须出现一次。

输入参数

        在decisionTable元素下，可以添加多个input元素来声明输入参数，为input元素增加inputExpression元素来声明输入参数的类型以及名称等信息，代码清单15-4中定义了输出参数。

        代码清单15-4：codes\15\15.2\input.dmn

<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/DMN/20151130" 	id="simple" name="Simple" namespace="http://activiti.org/dmn"> 	<decision id="decision1" name="Simple decision"> 		<decisionTable id="decisionTable"> 			<input id="inputId"> 				<inputExpression id="inputExpressionId" typeRef="string"> 					<text>personName</text> 				</inputExpression> 			</input> 			<output/> 			<rule></rule> 		</decisionTable> 	</decision> </definitions> 

        代码清单15-4定义了一个参数名称为“personName”的输入参数，类型字符串。需要注意的，参数名是persionName，而不是inputId。

输出结果

        每个决策表至少有一个输出结果，使用output元素定义输出参数的名称以及数据类型。代码清单15-5定义了输出结果。

        代码清单15-5：codes\15\15.2\output.dmn

<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/DMN/20151130" 	id="simple" name="Simple" namespace="http://activiti.org/dmn"> 	<decision id="decision1" name="Simple decision"> 		<decisionTable id="decisionTable"> 			<input id="inputId"> 				<inputExpression id="inputExpressionId" typeRef="string"> 					<text>personName</text> 				</inputExpression> 			</input> 			<output id="resultId" label="Output 1" name="resultName" typeRef="string" /> 			<rule></rule> 		</decisionTable> 	</decision> </definitions> 

        代码清单15-5的粗体字代码，定义了一个名称为“resultName”的输出结果，类型为字符串类型。需要注意的是，获取结果时，要根据name属性来获取，而不是id属性。

规则

        在决策表元素下可以定义多个rule元素，rule元素下可以添加inputEntry与outputEntry元素，其中inputEntry元素下支持使用MVEL表达式来实现业务规则的判断逻辑，而outputEntry元素则表示规则结果的输出，一个rule下可以出现0个或多个inputEntry，而outputEntry最少出现1次。代码清单15-6中定义两个rule。

        代码清章15-6：codes\15\15.2\rule.dmn

<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/DMN/20151130" 	id="simple" name="Simple" namespace="http://activiti.org/dmn"> 	<decision id="decision1" name="Simple decision"> 		<decisionTable id="decisionTable" hitPolicy="UNIQUE"> 			<input id="input1"> 				<inputExpression id="inputExpression1" typeRef="number"> 					<text>personAge</text> 				</inputExpression> 			</input> 			<input id="input2"> 				<inputExpression id="inputExpression2" typeRef="string"> 					<text>personName</text> 				</inputExpression> 			</input> 			<output id="outputId" label="Output 1" name="myResult" typeRef="string" /> 			<rule> 				<inputEntry id="inputEntry2"> 					<text><![CDATA[ > 18 ]]></text> 				</inputEntry> 				<inputEntry id="inputEntry2_2"> 					<text><![CDATA[ .equals('Angus') ]]></text> 				</inputEntry> 				<outputEntry id="outputEntry2"> 					<text>'Man Angus'</text> 				</outputEntry> 			</rule> 			<rule> 				<inputEntry id="inputEntry1"> 					<text><![CDATA[ <= 18 ]]></text> 				</inputEntry> 				<outputEntry id="outputEntry1"> 					<text>'Child'</text> 				</outputEntry> 			</rule> 		</decisionTable> 	</decision> </definitions> 

        代码清单15-6中，定义了两个两个输入参数、一个输出结果以及两个规则，第一规则触发条件为第1个参数值大于18、第2个参数值等于“Angus”，两个条件都符合时，返回 “Man Angus”字符串。第二个规则触发条件则是参数1的值小于等于18。

        目前Activiti还没有完全实现DMN规范，只是有一个大概的轮廓，本书的主要内容为Activiti，下面将开始介绍Activiti关于DMN规范的API。

本文节选自《疯狂Workflow讲义（第2版）》

本书代码目录：https://gitee.com/yangenxiong/CrazyActiviti