Skip to content

Commit ecca80f

Browse files
committed
BXMSDOC-6656 RN update DTAnalysis wired plugin (Kie7 RN)
1 parent 2778fa8 commit ecca80f

File tree

9 files changed

+206
-49
lines changed

9 files changed

+206
-49
lines changed

assemblies/assembly-dmn-models.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ endif::DROOLS[]
6161

6262
include::{drools-dir}/DMN/dmn-properties-ref.adoc[leveloffset=+2]
6363

64+
include::{drools-dir}/DMN/dmn-validation-con.adoc[leveloffset=+2]
65+
6466
include::{drools-dir}/DMN/dmn-model-creating-proc.adoc[leveloffset=+1]
6567

6668
include::{drools-dir}/DMN/dmn-logic-defining-proc.adoc[leveloffset=+2]

doc-content/drools-docs/src/main/asciidoc/DMN-chapter.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@ endif::DROOLS[]
4747

4848
include::DMN/dmn-properties-ref.adoc[leveloffset=+2]
4949

50+
include::DMN/dmn-validation-con.adoc[leveloffset=+2]
51+
5052
include::DMN/dmn-model-creating-proc.adoc[leveloffset=+1]
5153

5254
include::DMN/dmn-logic-defining-proc.adoc[leveloffset=+2]
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
[id='dmn-validation-con_{context}']
2+
= Configurable DMN validation in {PRODUCT}
3+
4+
By default, the `kie-maven-plugin` component in the `pom.xml` file of your {PRODUCT} project uses the following `<validateDMN>` configurations to perform pre-compilation validation of DMN model assets and to perform DMN decision table static analysis:
5+
6+
* `VALIDATE_SCHEMA`: DMN model files are verified against the DMN specification XSD schema to ensure that the files are valid XML and compliant with the specification.
7+
* `VALIDATE_MODEL`: The pre-compilation analysis is performed for the DMN model to ensure that the basic semantic is aligned with the DMN specification.
8+
* `ANALYZE_DECISION_TABLE`: DMN decision tables are statically analyzed for gaps or overlaps and to ensure that the semantic of the decision table follows best practices.
9+
10+
You can modify the default DMN validation and DMN decision table analysis behavior to perform only a specified validation during the project build, or you can disable this default behavior completely, as shown in the following examples:
11+
12+
.Default configuration for DMN validation and decision table analysis
13+
[source,xml]
14+
----
15+
<plugin>
16+
<groupId>org.kie</groupId>
17+
<artifactId>kie-maven-plugin</artifactId>
18+
<extensions>true</extensions>
19+
<configuration>
20+
<validateDMN>VALIDATE_SCHEMA,VALIDATE_MODEL,ANALYZE_DECISION_TABLE</validateDMN>
21+
</configuration>
22+
</plugin>
23+
----
24+
25+
.Configuration to perform only the DMN decision table static analysis
26+
[source,xml]
27+
----
28+
<plugin>
29+
<groupId>org.kie</groupId>
30+
<artifactId>kie-maven-plugin</artifactId>
31+
<extensions>true</extensions>
32+
<configuration>
33+
<validateDMN>ANALYZE_DECISION_TABLE</validateDMN>
34+
</configuration>
35+
</plugin>
36+
----
37+
38+
.Configuration to perform only the XSD schema validation
39+
[source,xml]
40+
----
41+
<plugin>
42+
<groupId>org.kie</groupId>
43+
<artifactId>kie-maven-plugin</artifactId>
44+
<extensions>true</extensions>
45+
<configuration>
46+
<validateDMN>VALIDATE_SCHEMA</validateDMN>
47+
</configuration>
48+
</plugin>
49+
----
50+
51+
.Configuration to perform only the DMN model validation
52+
[source,xml]
53+
----
54+
<plugin>
55+
<groupId>org.kie</groupId>
56+
<artifactId>kie-maven-plugin</artifactId>
57+
<extensions>true</extensions>
58+
<configuration>
59+
<validateDMN>VALIDATE_MODEL</validateDMN>
60+
</configuration>
61+
</plugin>
62+
----
63+
64+
.Configuration to disable all DMN validation
65+
[source,xml]
66+
----
67+
<plugin>
68+
<groupId>org.kie</groupId>
69+
<artifactId>kie-maven-plugin</artifactId>
70+
<extensions>true</extensions>
71+
<configuration>
72+
<validateDMN>disable</validateDMN>
73+
</configuration>
74+
</plugin>
75+
----
76+
77+
NOTE: If you enter an unrecognized `<validateDMN>` configuration flag, all pre-compilation validation is disabled and the Maven plugin emits related log messages.

doc-content/drools-docs/src/main/asciidoc/ReleaseNotes-chapter.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
//include::ReleaseNotes/ReleaseNotesDrools.7.24.0.Final/ReleaseNotesDrools.7.24.0.Final-section.adoc[leveloffset=+1]
77
//include::{shared-dir}/Workbench/ReleaseNotes/ReleaseNotesWorkbench.7.24.0.Final/ReleaseNotesWorkbench.7.24.0.Final-section.adoc[leveloffset=+1]
88

9+
include::ReleaseNotes/ReleaseNotesDrools.7.45.0.Final/ReleaseNotesDrools.7.45.0.Final-section.adoc[leveloffset=+1]
910

1011
include::{shared-dir}/Workbench/ReleaseNotes/ReleaseNotesWorkbench.7.44.0.Final/ReleaseNotesWorkbench.7.44.0.Final-section.adoc[leveloffset=+1]
1112

doc-content/drools-docs/src/main/asciidoc/ReleaseNotes/ReleaseNotesDrools.7.34.0.Final/ReleaseNotesDrools.7.34.0.Final-section.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33
= New and Noteworthy in Drools 7.34.0
44

55
include::support-for-multisheet-decisiontables.adoc[leveloffset=+1]
6-
include::kie-dmn-validation-in-maven-plugin.adoc[leveloffset=+1]
6+
include::kie-dmn-validation-in-maven-plugin-con.adoc[leveloffset=+1]
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
[id='kie-dmn-validation-in-maven-plugin-con']
2+
3+
= KIE DMN validation in Maven plugin
4+
5+
The `kie-maven-plugin` component now performs default pre-compilation validation of DMN model assets. The `kie-maven-plugin` component includes the following enhancements:
6+
7+
* DMN model files are verified against the DMN specification XSD schema to ensure that the files are valid XML and compliant with the specification.
8+
* The pre-compilation analysis is performed for the DMN model to ensure that the basic semantic is aligned with the DMN specification.
9+
10+
You can modify the default DMN validation behavior to perform only a specified validation during the project build, or you can disable this default behavior completely, as shown in the following examples:
11+
12+
.Default configuration for DMN validation
13+
[source,xml]
14+
----
15+
<plugin>
16+
<groupId>org.kie</groupId>
17+
<artifactId>kie-maven-plugin</artifactId>
18+
<extensions>true</extensions>
19+
<configuration>
20+
<validateDMN>VALIDATE_SCHEMA,VALIDATE_MODEL</validateDMN>
21+
</configuration>
22+
</plugin>
23+
----
24+
25+
.Configuration to perform only the XSD schema validation
26+
[source,xml]
27+
----
28+
<plugin>
29+
<groupId>org.kie</groupId>
30+
<artifactId>kie-maven-plugin</artifactId>
31+
<extensions>true</extensions>
32+
<configuration>
33+
<validateDMN>VALIDATE_SCHEMA</validateDMN>
34+
</configuration>
35+
</plugin>
36+
----
37+
38+
.Configuration to disable all DMN validation
39+
[source,xml]
40+
----
41+
<plugin>
42+
<groupId>org.kie</groupId>
43+
<artifactId>kie-maven-plugin</artifactId>
44+
<extensions>true</extensions>
45+
<configuration>
46+
<validateDMN>disable</validateDMN>
47+
</configuration>
48+
</plugin>
49+
----
50+
51+
NOTE: If you enter an unrecognized `<validateDMN>` configuration flag, all pre-compilation validation is disabled and the Maven plugin emits related log messages.

doc-content/drools-docs/src/main/asciidoc/ReleaseNotes/ReleaseNotesDrools.7.34.0.Final/kie-dmn-validation-in-maven-plugin.adoc

Lines changed: 0 additions & 48 deletions
This file was deleted.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
[id='drools.releasenotesdrools.7.45.0']
2+
3+
= New and Noteworthy in Drools 7.45.0
4+
5+
include::kie-dmn-validation-in-maven-plugin-dtanalysis-con.adoc[leveloffset=+1]
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
[id='kie-dmn-validation-in-maven-plugin-dtanalysis-con']
2+
3+
= KIE DMN validation in Maven plugin
4+
5+
The `kie-maven-plugin` component now performs DMN decision table static analysis, in addition to pre-compilation validation of DMN model assets.
6+
7+
With this enhancement, the `kie-maven-plugin` component now includes the following features for pre-compilation and DMN decision table static analysis:
8+
9+
* DMN model files are verified against the DMN specification XSD schema to ensure that the files are valid XML and compliant with the specification.
10+
* The pre-compilation analysis is performed for the DMN model to ensure that the basic semantic is aligned with the DMN specification.
11+
* DMN decision tables are statically analyzed for gaps or overlaps and to ensure that the semantic of the decision table follows best practices.
12+
13+
You can modify the default DMN validation and DMN decision table analysis behavior to perform only a specified validation during the project build, or you can disable this default behavior completely, as shown in the following examples:
14+
15+
.Default configuration for DMN validation and decision table analysis
16+
[source,xml]
17+
----
18+
<plugin>
19+
<groupId>org.kie</groupId>
20+
<artifactId>kie-maven-plugin</artifactId>
21+
<extensions>true</extensions>
22+
<configuration>
23+
<validateDMN>VALIDATE_SCHEMA,VALIDATE_MODEL,ANALYZE_DECISION_TABLE</validateDMN>
24+
</configuration>
25+
</plugin>
26+
----
27+
28+
.Configuration to perform only the DMN decision table static analysis
29+
[source,xml]
30+
----
31+
<plugin>
32+
<groupId>org.kie</groupId>
33+
<artifactId>kie-maven-plugin</artifactId>
34+
<extensions>true</extensions>
35+
<configuration>
36+
<validateDMN>ANALYZE_DECISION_TABLE</validateDMN>
37+
</configuration>
38+
</plugin>
39+
----
40+
41+
.Configuration to perform only the XSD schema validation
42+
[source,xml]
43+
----
44+
<plugin>
45+
<groupId>org.kie</groupId>
46+
<artifactId>kie-maven-plugin</artifactId>
47+
<extensions>true</extensions>
48+
<configuration>
49+
<validateDMN>VALIDATE_SCHEMA</validateDMN>
50+
</configuration>
51+
</plugin>
52+
----
53+
54+
.Configuration to disable all DMN validation
55+
[source,xml]
56+
----
57+
<plugin>
58+
<groupId>org.kie</groupId>
59+
<artifactId>kie-maven-plugin</artifactId>
60+
<extensions>true</extensions>
61+
<configuration>
62+
<validateDMN>disable</validateDMN>
63+
</configuration>
64+
</plugin>
65+
----
66+
67+
NOTE: If you enter an unrecognized `<validateDMN>` configuration flag, all pre-compilation validation is disabled and the Maven plugin emits related log messages.

0 commit comments

Comments
 (0)