Skip to content

Commit

Permalink
review and fixing issues
Browse files Browse the repository at this point in the history
  • Loading branch information
justlmills committed Jun 12, 2024
1 parent 3019640 commit 1c139fc
Showing 1 changed file with 15 additions and 14 deletions.
29 changes: 15 additions & 14 deletions getting-started/project-setup.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,15 @@
include::../partials/attributes.adoc[]

//tag::maven-setup[]
First step: Install Apache Maven.
You can find instructions for doing so at https://maven.apache.org/install.html[the Apache Maven website].
== Requirements
Set up your Maven environment, following these instructions for doing so xref:../installation/gav-mapping-rules.adoc[Configuring Maven with BAMOE binaries].

== Project Setup Options
With the migration of the BAMOE product to Quarkus 3 the instructions on how to generate a new Maven project have changee. Currently, there are a number of options:
With the migration of the BAMOE product to Quarkus 3 the instructions on how to generate a new Maven project have changed. You now have these options:

* Create a project manually
* xref:../installation/configure-maven.adoc[Use BAMOE Canvas] to create a new project using the {CANVAS} accelerator functionality.

* xref:../editing/creating-new-projects.adoc[Use BAMOE Canvas] to create a new project using Canvas' accelerator features..
* **Create Project Manually**

== Creating a BAMOE Project Manually
Typically, Maven projects are created either using plugins or archetypes. You can use a simple Maven archetype to generate a basic Maven project, for example:
Expand All @@ -19,7 +20,7 @@ Typically, Maven projects are created either using plugins or archetypes. You c
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-simple -DarchetypeVersion=1.4 -DinteractiveMode=false
----

then update the project's `pom.xml` with content from one of the followin templates:
then update the `pom.xml` for the project with content from one of the following templates:

xref:../partials/rules-sample-pom.adoc[Sample Rules/Decision Application POM Template] a sample POM that describes a typical rules/decisions project dependencies and plugins.

Expand All @@ -34,8 +35,8 @@ mvn clean package
== Editing within VS Code

. Open the project in VS Code.
From here we can see the workspace's contents, and if we expand the contents of `/src/main` you will see the creation of several artifacts.
Within `java` you will have a `GreetingResource.java` and within `resources` you will have an `application.properties` and `pricing.dmn` file.
From here we can see the workspace contents, and if we expand the contents of `/src/main` you can see the creation of several artifacts.
Within `java` you have a `GreetingResource.java` and within `resources` you have an `application.properties` and `pricing.dmn` file.
These are sample files that can be later modified or deleted.
+
image::workspace-layout.png[VSCode Workspace Layout]
Expand All @@ -53,16 +54,16 @@ image::bamoe-vscode-marketplace.png[{VS_CODE_BUNDLE} within the marketplace]
image::automatic-layout.png[Automatic Layout]

. When the diagram opens you will see something similar to below, and you can start exploring it.
The DMN is made up of two inputs: *Age* and *Previous incidents?*, which are used to make the decision, *Base price*.
The DMN consists of two inputs: *Age* and *Previous incidents?*, which are used to make the decision, *Base price*.
+
image::dmn-first-view.png[DMN First view]

. If you click the *Age* input data node and then click the *Properties* icon on the right, you will open a pane for the input.
+
image::properties-open.png[DMN Properties]

. Within this pane, you can see information about the input *Age*, which includes that it is a number and what the input name is.
More can be changed around this object, including the color of the node, font size, etc.
. Within this pane, you can see information about the input *Age*, namely that it is a number and its input name.
Other changes can be made to the object, including the color of the node, font size, etc.
+
image::properties-expanded.png[DMN Properties Expanded]

Expand All @@ -72,11 +73,11 @@ image::open-decision.png[Edit DMN Decision]

. From here you will see the Decision Table that is associated with the Base Price decision.
From here you will see two (*2*) input columns (`Age` and `Previous Incidents`), as well as one output column (`Base price`) all with their types below them.
These types are controlled from the properties panel similarly to how they were opened when looking at `Age` a few steps ago.
These types are controlled from the properties panel similarly to how they were opened when we previously looked at `Age`.
This decision has 4 different rows that could fire, with a Hit Policy of `UNIQUE` signified by the **U** in the top left corner of the table.
A decision writer could make any comments they want to the table and have them saved towards the decision here.
A decision writer could make any comments they want to the table and have them saved with the decision here.
+
image::dt-stable.png[Viewing DMN Decision]

== Source Control
This is a Java based project, and any tools regularly used for storing Java based source code into a source repository would be applicable here.
This is a Java based project, and any tools regularly used for storing Java based source code in a source repository are applicable here.

0 comments on commit 1c139fc

Please sign in to comment.