This is an automated email from the ASF dual-hosted git repository.
rikkola pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-kie-website.git
The following commit(s) were added to refs/heads/main by this push:
new 6c1f063 Migrate jbpm.org to kie-website #1943
6c1f063 is described below
commit 6c1f063f091f9ae13d9d9c7d66a2dcba750c114b
Author: rikkola <[email protected]>
AuthorDate: Wed Apr 30 12:44:17 2025 +0300
Migrate jbpm.org to kie-website #1943
Update docs/components/jbpm/jbpm.md
Co-authored-by: Copilot <[email protected]>
---
.../jbpm/efficient_business_process_management.png | Bin 0 -> 43253 bytes
.../jbpm/getting_started/getting_started.md | 97 +++++++++++++++++++++
docs/components/jbpm/jbpm.md | 66 +++++++++++++-
docs/components/jbpm/jbpm5_developer_guide.png | Bin 0 -> 36514 bytes
docs/components/jbpm/jbpm6_developer_guide.png | Bin 0 -> 36704 bytes
docs/components/jbpm/mastering_jbpm6.png | Bin 0 -> 36772 bytes
6 files changed, 162 insertions(+), 1 deletion(-)
diff --git a/docs/components/jbpm/efficient_business_process_management.png
b/docs/components/jbpm/efficient_business_process_management.png
new file mode 100644
index 0000000..d0387bd
Binary files /dev/null and
b/docs/components/jbpm/efficient_business_process_management.png differ
diff --git a/docs/components/jbpm/getting_started/getting_started.md
b/docs/components/jbpm/getting_started/getting_started.md
new file mode 100644
index 0000000..0d57c8c
--- /dev/null
+++ b/docs/components/jbpm/getting_started/getting_started.md
@@ -0,0 +1,97 @@
+---
+id: jbpm_getting_started
+title: Getting Started
+sidebar_position: 0
+---
+
+# Business Applications - Getting Started
+## Overview
+
+Business application can be defined as an automated solution, built with
selected frameworks and capabilities that implements business functions and/or
business problems. Capabilities can be (among others):
+
+* persistence
+* messaging
+* transactions
+* business processes, business rules
+* planning solutions
+
+Business application is more of a logical grouping of individual services that
represent certain business capabilities. Usually they are deployed separately
and can also be versioned individually. Overall goal is that the complete
business application will allow particular domain to achieve their business
goals e.g. order management, accommodation management, etc.
+Business application is
+
+* Build on any runtime
+* Deployable to cloud with just single command
+* UI agnostic (doesn’t enforce any UI frameworks and let users to make their
own choice)
+* Configurable database profiles
+* Generated
+
+Business application consists of (though are not restricted to have only one
of each project types)
+
+* data model project - shared data model between business assets and service
+* business assets (kjar) project - easily importable into workbench
+* service project - actual service with various capabilities
+
+**Service project** is the one that is deployable but will in most of the
cases include business assets and data model projects.
+
+**Data model project** represents the common data structures that will be
shared between service implementation and business assets. That enables proper
encapsulation and promotes reuse and at the same time reduces shortcuts to make
data model classes something more than they are - include too much of
implementation into data models.
+
+**Business assets project** represents your business logic as processes,
cases, rules, decision tables and more.
+
+Following are the maven archetype commands need to be used to generate
different types of projects:
+
+* Data model archetype
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-model-archetype -DarchetypeVersion=7.74.1.Final
-DgroupId=com.company -DartifactId=business-application-model
-Dversion=1.0-SNAPSHOT -Dpackage=com.company.model
+ ```
+This command creates a project which generates
business-application-model-1.0-SNAPSHOT.jar
+
+* Business assets project archetype
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-kjar-archetype -DarchetypeVersion=7.74.1.Final
-DgroupId=com.company -DartifactId=business-application-kjar
-Dversion=1.0-SNAPSHOT -Dpackage=com.company
+ ```
+This command creates a project which generates
business-application-kjar-1.0-SNAPSHOT.jar
+
+* Dynamic assets project archetype
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-kjar-archetype -DarchetypeVersion=7.74.1.Final
-DcaseProject=true -DgroupId=com.company -DartifactId=business-application-kjar
-Dversion=1.0-SNAPSHOT -Dpackage=com.company
+ ```
+This command creates a project which generates
business-application-kjar-1.0-SNAPSHOT.jar
+
+Service project archetype can be used based on the capabilities that are
needed in the project. Capabilities essentially define the features that your
business application will be equipped with. Available options are:
+
+* Business automation(bpm) covers features for process management, case
management, decision management and optimization. These will be by default
configured in the service project of your business application. Although you
can turn them off via configuration.
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-service-spring-boot-archetype
-DarchetypeVersion=7.74.1.Final -DgroupId=com.company
-DartifactId=business-application-service -Dversion=1.0-SNAPSHOT
-Dpackage=com.company.service -DappType=bpm
+ ```
+* Decision management(brm) covers mainly decision and rules related features
(backed by Drools project)
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-service-spring-boot-archetype
-DarchetypeVersion=7.74.1.Final -DgroupId=com.company
-DartifactId=business-application-service -Dversion=1.0-SNAPSHOT
-Dpackage=com.company.service -DappType=brm
+ ```
+* Business optimization(planner) covers planning problems and solutions
related features (backed by OptaPlanner project)
+
+ ```
+ mvn archetype:generate -B -DarchetypeGroupId=org.kie
-DarchetypeArtifactId=kie-service-spring-boot-archetype
-DarchetypeVersion=7.74.1.Final -DgroupId=com.company
-DartifactId=business-application-service -Dversion=1.0-SNAPSHOT
-Dpackage=com.company.service -DappType=planner
+ ```
+These commands create a project which generates
business-application-service-1.0-SNAPSHOT.jar
+
+## Build your first Business Application
+
+To build your first business application,use the above mentioned maven
archetype commands to generate a Data project,Business assets project and a
Service project with desired capabilities.
+
+It is recommended to generate all the three types of projects Data Model,
Business assets and Service projects using the archetypes in same directory on
your computer.
+
+Once you have the application on your computer just follow these steps to have
it up and running
+
+* go to directory suffixed with -service
+* execute ```./launch.sh clean install``` for unix or ```launch.bat clean
install``` for windows
+* once the boot has finished go to http://localhost:8090
+
+## More examples
+[Go to examples repository](https://github.com/business-applications)
+
+
+
diff --git a/docs/components/jbpm/jbpm.md b/docs/components/jbpm/jbpm.md
index 32fb560..f697416 100644
--- a/docs/components/jbpm/jbpm.md
+++ b/docs/components/jbpm/jbpm.md
@@ -6,4 +6,68 @@ sidebar_position: 0
# jBPM
-This section is work-in-progress. Please refer to
[Documentation](https://kie.apache.org/docs/documentation/) for the latest
documentation.
\ No newline at end of file
+
+
+## What is jBPM?
+
+jBPM is a toolkit for building business applications to help automate business
processes and decisions.
+
+jBPM originates from BPM (Business Process Management) but it has evolved to
enable users to pick their own path in business automation. It provides various
capabilities that simplify and externalize business logic into reusable assets
such as cases, processes, decision tables and more.
+
+* business processes (BPMN2)
+* case management (BPMN2 and CMMN)
+* decision management (DMN)
+* business rules (DRL)
+* business optimisation (Solver)
+
+jBPM can be used as standalone service or embedded in custom service. It does
not mandate any of the frameworks to be used, it can be successfully used in
+
+* traditional JEE applications - war/ear deployments
+* SpringBoot or Thorntail (formerly known as WildFly Swarm) - uberjar
deployments
+* standalone Java programs
+
+jBPM is typically used to build business applications. A business application
could be defined as a domain-specific solution (built with selected frameworks
and capabilities) that solves a particular business problem. To implement the
business logic it leverages capabilities from various frameworks like business
processes, business rules and planning constraints, but also persistence,
messaging, transactions, etc.
+
+jBPM is open source software, released under the Apache License 2.0. It is
written in 100% pure Java™, runs on any JVM and is available in the Maven
Central repository too.
+
+## Cloud-native?
+
+Looking for a pure cloud-native process automation solution, specifically
targeted towards creating intelligent business applications in the cloud? Take
a look at [Kogito](/docs/components/kogito), based on jBPM.
+
+
+## What does jBPM do?
+
+A business process allows you to model your business goals by describing the
steps that need to be executed to achieve that goal and the order, using a flow
chart. This greatly improves the visibility and agility of your business logic,
results in higher-level and domain-specific representations that can be
understood by business users and is easier to monitor.
+
+The core of jBPM is a light-weight, extensible workflow engine written in pure
Java that allows you to execute business processes using the latest BPMN 2.0
specification. It can run in any Java environment, embedded in your application
or as a service.
+
+On top of the core engine, a lot of features and tools are offered to support
business processes throughout their entire life cycle:
+
+* Eclipse-based and web-based editor to support the graphical creation of your
business processes and case definitions (drag & drop).
+* Pluggable persistence and transactions based on JPA / JTA.
+* Pluggable human task service based on WS-HumanTask for including tasks that
need to be performed by human actors.
+* Management console supporting process instance management, task lists and
task form management, and reporting.
+* Optional process repository to deploy your process (and other related
knowledge).
+* History logging (for querying / monitoring / analysis).
+* Integration with various frameworks such as CDI/EJB, Spring(Boot), OSGi, etc.
+
+BPM makes the bridge between business analysts, developers and end users, by
offering process management features and tools in a way that both business
users and developers like it. Domain-specific nodes can be plugged into the
palette, making the processes more easily understood by business users.
+
+jBPM supports adaptive and dynamic processes that require flexibility to model
complex, real-life situations that cannot easily be described using a rigid
process. We bring control back to the end users by allowing them to control
which parts of the process should be executed, to dynamically deviate from the
process, etc.
+
+jBPM is also not just an isolated process engine. Complex business logic can
be modeled as a combination of business processes with business rules and
complex event processing. jBPM can be combined with the Drools project to
support one unified environment that integrates these paradigms where you model
your business logic as a combination of processes, rules and events.
+
+## Documentation
+Please refer to [Documentation](https://kie.apache.org/docs/documentation/)
for the latest features.
+
+## Slides
+These slides are viewable in your browser:
+
+[Show the jBPM
presentations](http://www.slideshare.net/krisverlaenen/presentations)
+
+
+## Books
+[](http://kverlaen.blogspot.be/2015/07/book-mastering-jbpm6.html)
+[](http://kverlaen.blogspot.be/2014/09/jbpm6-developer-guide.html)
+[](http://kverlaen.blogspot.be/2012/12/book-jbpm5-developer-guide.html)
+[](http://www.schabell.org/2018/03/book-launced-effective-business-process-management-with-jboss-bpm.html)
diff --git a/docs/components/jbpm/jbpm5_developer_guide.png
b/docs/components/jbpm/jbpm5_developer_guide.png
new file mode 100644
index 0000000..513def3
Binary files /dev/null and b/docs/components/jbpm/jbpm5_developer_guide.png
differ
diff --git a/docs/components/jbpm/jbpm6_developer_guide.png
b/docs/components/jbpm/jbpm6_developer_guide.png
new file mode 100644
index 0000000..c040aef
Binary files /dev/null and b/docs/components/jbpm/jbpm6_developer_guide.png
differ
diff --git a/docs/components/jbpm/mastering_jbpm6.png
b/docs/components/jbpm/mastering_jbpm6.png
new file mode 100644
index 0000000..5542a32
Binary files /dev/null and b/docs/components/jbpm/mastering_jbpm6.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
