Skip to content

Commit fba8d4e

Browse files
michelehaglundChristyWatkins
authored andcommitted
Merge pull request #12 from michelehaglund/BXMSDOC-2032-master (#593)
BXMSDOC-2032 (for in-fork master-final): New US-based GSG Decision Services for DM 7.0 GA
1 parent 7eadae8 commit fba8d4e

File tree

68 files changed

+822
-211
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

68 files changed

+822
-211
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
build
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<productname>{PRODUCT}</productname>
2+
<productnumber>{PRODUCT_VERSION}</productnumber>
3+
<subtitle>
4+
For {PRODUCT} {PRODUCT_VERSION}
5+
6+
</subtitle>
7+
<abstract>
8+
<para>This topic describes how to design a decision service using guided decision tables in {PRODUCT} {PRODUCT_VERSION}.</para>
9+
</abstract>
10+
<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
2+
:BA:
3+
4+
include::topics/main.adoc[]
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
build
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<productname>{PRODUCT}</productname>
2+
<productnumber>{PRODUCT_VERSION}</productnumber>
3+
<subtitle>
4+
For {PRODUCT} {PRODUCT_VERSION}
5+
6+
</subtitle>
7+
<abstract>
8+
<para>In this tutorial, you will create and test a driver's license suspension scenario.</para>
9+
</abstract>
10+
<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
2+
:DM:
3+
4+
include::topics/main.adoc[]
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
[id='assembly_decision-services-getting-started']
2+
3+
include::product-shared-docs/document-attributes.adoc[]
4+
5+
= Getting started with decision services
6+
// Context attribute is assembly specific and enables module reuse between assemblies.
7+
:imagesdir: topics/product-shared-docs/images
8+
:context: decision-services-getting-started
9+
include::product-shared-docs/author-group.adoc[]
10+
11+
// Purpose statement for the assembly
12+
As a business analyst or rules developer, you can use {CENTRAL} in {PRODUCT} to design a variety of decision services. In this tutorial, you will create and test a driver's license suspension scenario.
13+
//by creating data objects with data fields, such as Violation Date, Fine Amount, and so on.
14+
15+
.Prerequisites
16+
* Installed {EAP_LONG} 7.1.0. For details, see https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.1/html-single/installation_guide/[_Red Hat JBoss EAP 7.1.0 Installation Guide_].
17+
* Installed {PRODUCT}. For more information, see the Installing Decision Manager on premise guide.
18+
* {PRODUCT} is running and you can log in to {CENTRAL} with the `admin` role. For more information, see the Installing Decision Manager on premise guide.
19+
20+
// Modules - concepts, procedures, refs, etc.
21+
22+
include::product-getting-started-guide/new-project-proc.adoc[leveloffset=+1]
23+
24+
include::product-user-guide/data-objects-con.adoc[leveloffset=+1]
25+
26+
The following illustration shows the `Violation` and `Driver` data objects that you will create in this tutorial.
27+
28+
.Driver department traffic violations data objects
29+
image::data-model.png[]
30+
31+
include::product-getting-started-guide/data-object-violation-create-proc.adoc[leveloffset=+2]
32+
33+
include::product-getting-started-guide/data-object-violation-fields-proc.adoc[leveloffset=+3]
34+
35+
include::product-getting-started-guide/data-object-driver-create-proc.adoc[leveloffset=+2]
36+
37+
include::product-getting-started-guide/data-object-driver-fields-proc.adoc[leveloffset=+3]
38+
39+
include::product-getting-started-guide/guided-traffic-rules-con.adoc[leveloffset=+1]
40+
41+
include::product-getting-started-guide/business-rules-create-proc.adoc[leveloffset=+2]
42+
43+
include::product-getting-started-guide/business-rules-conditions-proc.adoc[leveloffset=+2]
44+
45+
include::product-getting-started-guide/business-rules-actions-proc.adoc[leveloffset=+2]
46+
47+
include::product-user-guide/guided-decision-tables-con.adoc[leveloffset=+1]
48+
49+
include::product-getting-started-guide/decision-table-create-proc.adoc[leveloffset=+2]
50+
51+
include::product-getting-started-guide/decision-table-violation-columns-proc.adoc[leveloffset=+3]
52+
53+
include::product-getting-started-guide/decision-table-penalty-columns-proc.adoc[leveloffset=+3]
54+
55+
include::product-getting-started-guide/decision-table-rows-proc.adoc[leveloffset=+3]
56+
57+
include::product-getting-started-guide/test-speed-scenarios-con.adoc[leveloffset=+1]
58+
59+
include::product-getting-started-guide/test-speed-proc.adoc[leveloffset=+2]
60+
61+
include::product-getting-started-guide/test-suspend-proc.adoc[leveloffset=+2]
62+
63+
include::product-getting-started-guide/test-violation-based-proc.adoc[leveloffset=+2]
64+
65+
// Versioning info
66+
include::product-shared-docs/versioning-information.adoc[]
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
[id='guided-suspension-rule-actions-proc']
2+
= Setting the Suspension rule actions
3+
4+
The `Suspension` rule actions determine a driver's resulting penalties including points and fine amounts based on the `Suspension` rule conditions.
5+
6+
.Prerequisite
7+
You have created set the Suspension rule conditions
8+
9+
.Procedure
10+
. Click *(show options…​)*.
11+
+
12+
13+
.show options selection
14+
image::show_options.png[]
15+
. Click image:6176.png[] next to the *THEN* label and select *Change field values of driver*, then click *Ok*.
16+
. Click the *Set value of Driver [driver]* field and select *state* from the *Add field* pull-down menu.
17+
. Click image:6191.png[] next to *state* in the *Set value of Driver [driver]* section to open the *Field value* window.
18+
. Click *Literal value* and enter `suspend` in the new field.
19+
+
20+
21+
.New field
22+
image::suspend_entry.png[]
23+
. Click image:6176.png[] next to the *(options)* label below the *Set value of Driver [driver]* section.
24+
. From the *Add an option to the rule* window, select the *ruleflow-group* option from the *Attribute* pull-down menu.
25+
. Enter `trafficViolation` in to the *ruleflow-group* field.
26+
. Click *Save*, then click *Save* to confirm your changes.
27+
+
28+
29+
.Suspension rule actions
30+
image::rulepanel.png[]
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
[id='guided-suspension-rule-conditions-proc']
2+
= Setting the Suspension rule conditions
3+
4+
The `Suspension` rule contains conditions that are used to determine the driver's violation.
5+
6+
.Prerequisite
7+
You have created the Driver License Suspension rule
8+
9+
.Procedure
10+
. Click image:6176.png[] next to the *WHEN* label to open the *Add a condition to the rule* window. . . Select *Driver* and click *Ok*.
11+
+
12+
13+
.Create new Guided Rule window
14+
image::add-condition.png[]
15+
. Click the *There is a Driver* label to open the *Modify constraints for Driver* window.
16+
. Enter `driver` in the *Variable name* field and click *Set*.
17+
. Click the *There is a Driver[driver]* and click *Expression editor*.
18+
. Click *[not bound]* to open the *Expression editor*.
19+
. In the *Bind the Expression to a new variable* field, enter: `previousPts` and click *Set*.
20+
. From the *Choose* menu, select *totalPoints*.
21+
. Click image:6176.png[] next to line 1 (the *previousPts* label) to open the *Add a condition to the rule* window.
22+
. Select *From Accumulate* and click *Ok*.
23+
. Click *click to add pattern* above the *From Accumulate* label and select *Number* from the *choose fact type* pull-down menu.
24+
. Click *There is a number* label to open the *Modify contraints for Driver* window.
25+
. Click *Expression editor* and select *intValue()* from the
26+
*[not bound]:* *Choose* menu.
27+
. Click *[not bound]* to open the *Expression editor*.
28+
. In the *Bind the Expression to a new variable* field, enter: `totalNewPoints` and click *Set*.
29+
. Click *click to add pattern* and select *Violation* from the *choose fact type* pull-down menu.
30+
. Click *All Violation with:* to open the *Modify contraints for Violation* window and select *points* from the *Add a restriction on a field* pull-down menu.
31+
. Click *please choose* next to the *points* label and select *greater than*.
32+
. Click image:6191.png[], then click *Literal value*.
33+
. Click the *points* label to open the *Add a field* window and enter `vPoints` and click *Set*.
34+
. In the *Function* field, enter `sum(vPoints)`.
35+
. Select *greater than or equal to* from the *totalNewPoints* -> *please choose* pull-down menu.
36+
. Click image:6191.png[], click *New formula*, and enter `20-previousPts` in the new field.
37+
. Click *Save*, then click *Save* to confirm your changes.
38+
39+
.Suspension Rule conditions
40+
image::rule-conditions.png[]
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
[id='guided-rule-licence-suspension-create-proc']
2+
= Creating the Driver License Suspension rule
3+
4+
The `Driver license suspension` rule is created using the Guided Rule wizard and is comprised of various conditions and their resulting actions.
5+
6+
.Prerequisite
7+
8+
Created both the `Violation` and `Driver` data objects.
9+
10+
.Procedure
11+
. Log in to {CENTRAL}. Click *Menu* -> *Design* -> *Projects*, then *Driver department traffic violations*.
12+
. Click *Create New Asset* -> *Guided Rule*, then enter:
13+
14+
* *Guided Rule*: `DriverLicenseSuspensionRule`
15+
* *Package*: `com.myteam.driverdepartmenttrafficviolations`
16+
+
17+
18+
. Click *Ok* to open the *Guided Rule designer*.
19+
+
20+
21+
.Create new Guided Rule window
22+
image::guided-rule.png[]

docs/product-getting-started-guide/src/main/asciidoc/concept_prerequisites-target-users.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@
77
= Target Users
88

99
The following chapters are targeted at:
10+
* <MH> Should I mention the actual "personas" as detailed in https://drive.google.com/drive/u/1/folders/0B6cY6hNQRMMTSzJsVENXR0N4TFU </MH>
1011

1112
* Business analysts
1213
* IT Developers
13-
ifdef::DM[* Associate process manager]
14+
ifdef::DM[* Associate process manager]
Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
1+
[id='data-objects-create-proc']
2+
= Creating the data objects
3+
4+
The following chapter instructs you how to create the Violation and Driver data objects.
5+
6+
//a traffic violation data model in {PRODUCT}. Data models are models of data objects. A data object is a custom complex data type (for example, a Violation data object containing data fields Violation Date, Fine Amount, and Speed Limit).
7+
8+
[float]
9+
== Prerequisites
10+
11+
You have created the Driver department traffic violations project.
12+
13+
.Procedure
14+
. Log in to {CENTRAL}. Click *Menu* -> *Design* -> *Projects*, then *Driver department traffic violations*.
15+
. Click *Create New Asset* -> *Data Object*.
16+
. In the *Create new Data Object* wizard, enter the following values:
17+
.. *Data Object*: `Violation`.
18+
.. *Package*: select `org.jboss.example.traffic_violations`.
19+
. Click *Ok*.
20+
+
21+
22+
.Create new Data Object window
23+
image:data-object.png[]
24+
25+
=== Adding the Violation data object data fields
26+
27+
. In the `'Violation (Violation)'- general properties` section, locate the *Label* property and enter: *Violation*.
28+
+
29+
30+
.General properties
31+
image:gen-props.png[]
32+
. Click *+ add field*.
33+
. Enter the following values:
34+
+
35+
* *Id*: `code`
36+
* *Label*: `Code`
37+
* *Type*: `String`
38+
39+
. Click *Create and continue*, then enter the following values:
40+
+
41+
* *Id*: `points`
42+
* *Label*: `Points`
43+
* *Type*: `Integer`
44+
45+
. Click *Create and continue*, then enter the following values:
46+
+
47+
* *Id*: `violationDate`
48+
* *Label*: `Violation Date`
49+
* *Type*: `Date`
50+
51+
. Click *Create and continue*, then enter the following values:
52+
+
53+
* *Id*: `type`
54+
* *Label*: `Type`
55+
* *Type*: `String`
56+
57+
. Click *Create and continue*, then enter the following values:
58+
+
59+
* *Id*: `fineAmount`
60+
* *Label*: `Fine Amount`
61+
* *Type*: `Double`
62+
63+
. Click *Create and continue*, then enter the following values:
64+
+
65+
* *Id*: `speedLimit`
66+
* *Label*: `Speed Limit`
67+
* *Type*: `Integer`
68+
69+
. Click *Create and continue*, then enter the following values:
70+
+
71+
* *Id*: `actualSpeed`
72+
* *Label*: `Actual Speed`
73+
* *Type*: `Integer`
74+
75+
. Click *Create*.
76+
. Click *Save*, then click *Save* to confirm your changes.
77+
. Click the *Driver department traffic violations* label to return to the *Assets* view of the project.
78+
79+
== Creating the Driver data object
80+
81+
. Log in to {CENTRAL}. Click *Menu* -> *Design* -> *Projects*, then *Driver department traffic violations*.
82+
. Click *Create New Asset* -> *Data Object*.
83+
. In the *Create new Data Object* wizard, enter the following values:
84+
.. *Data Object*: `Driver`.
85+
.. *Package*: select `com.myteam.driverdepartmenttrafficviolations`.
86+
. Click *Ok*.
87+
+
88+
89+
.Create new Data Object window
90+
image:data-object2.png[]
91+
92+
=== Adding the Driver data object data fields
93+
94+
. In the `'Driver (Driver)'- general properties` section, locate the *Label* property and enter: *Driver*.
95+
+
96+
97+
.General properties
98+
image:gen-props2.png[]
99+
. Click *+ add field*.
100+
. Enter the following values:
101+
+
102+
* *Id*: `name`
103+
* *Label*: `Full Name`
104+
* *Type*: `String`
105+
106+
. Click *Create and continue*, then enter the following values:
107+
+
108+
* *Id*: `age`
109+
* *Label*: `Age`
110+
* *Type*: `Integer`
111+
112+
. Click *Create and continue*, then enter the following values:
113+
+
114+
* *Id*: `state`
115+
* *Label*: `State`
116+
* *Type*: `String`
117+
118+
. Click *Create and continue*, then enter the following values:
119+
+
120+
* *Id*: `city`
121+
* *Label*: `City`
122+
* *Type*: `String`
123+
124+
. Click *Create and continue*, then enter the following values:
125+
+
126+
* *Id*: `violations`
127+
* *Label*: `Violations`
128+
* *Type*: `Violation(org.jboss.example.traffic_violations.Violation)`
129+
* *List*: Mark this check box to enable the field to hold multiple items for the specified type.
130+
131+
. Click *Create and continue*, then enter the following values:
132+
+
133+
* *Id*: `fineAmount`
134+
* *Label*: `Fine Amount`
135+
* *Type*: `Double`
136+
137+
. Click *Create and continue*, then enter the following values:
138+
+
139+
* *Id*: `totalPoints`
140+
* *Label*: `Total Points`
141+
* *Type*: `Integer`
142+
143+
. Click *Create and continue*, then enter the following values:
144+
+
145+
* *Id*: `reason`
146+
* *Label*: `Reason`
147+
* *Type*: `String`
148+
149+
. Click *Create*.
150+
. Click *Save*, then click *Save* to confirm your changes.
151+
. Click the *Driver department traffic violations* label to return to the *Assets* view of the project.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
[id='data-object-driver-proc']
2+
= Creating the Driver data object
3+
4+
The `Driver` data object contains data fields based on driver details, such as `Name`, `Age`, and `Total Points`.
5+
6+
.Prerequisites
7+
8+
You have created the `Driver department traffic violations` project.
9+
10+
.Procedure
11+
. Log in to {CENTRAL}. Click *Menu* -> *Design* -> *Projects*, then *Driver department traffic violations*.
12+
. Click *Create New Asset* -> *Data Object*.
13+
. In the *Create new Data Object* wizard, enter the following values:
14+
* *Data Object*: `Driver`.
15+
* *Package*: select `com.myteam.driverdepartmenttrafficviolations`.
16+
. Click *Ok*.
17+
+
18+
19+
.Create new Data Object window
20+
image::data-object2.png[]

0 commit comments

Comments
 (0)