/bonita-connector-archetype

This project contains a maven archetype which help creating a new Bonita connector project.

Primary LanguageGroovyGNU General Public License v2.0GPL-2.0

Actions Status GitHub release Maven Central License: GPL v2

Bonita Connector Archetype

This project contains a maven archetype, which allow to easily setup a Bonita connector project.
You can find the complete documentation of this archetype with a detailed example on our documentation website

Setup a connector project using the archetype

⚠️ Java 11 is required for Bonita 7.13+

You can setup a Bonita connector project using the following command, from a terminal:

Make sure that you do not launch the command from an existing maven project.

mvn archetype:generate -DarchetypeGroupId=org.bonitasoft.archetypes -DarchetypeArtifactId=bonita-connector-archetype
  • archetypeGroupId: the group id of the connector archetype.
  • archetypeArtifactId: the artifact id of the connector archetype.
  • archetypeVersion: the version of the connector archetype.

You'll then have to specify interactively the properties of your project:

  • groupId: the group id of your connector.
  • artifactId: the artifact id of your connector
    • Must match the following regex: ^[a-zA-Z0-9\-]+$
  • version: the version of your connector (default value: 1.0-SNAPSHOT)
  • package the package in which the connector source files will be created (default value: the group id of the connector)
  • bonitaVersion: the targeted Bonita version
  • className: the class name of your connector
    • Must match the following regex: ^[a-zA-Z_$][a-zA-Z\d_$]+$ (A Java classname valid identifier)
    • Example: MyConnector1
  • language: the language used in the connector project. Available values:
    • java
    • groovy
    • kotlin
  • wrapper (optional): install a maven wrapper. Available values:
    • true (default)
    • false

A folder named [your artifact id] is created, with your Bonita connector project, ready to use.

⚠️ You can avoid the interactive mode by specifying all properties of your project directly in the command line, but by doing that you'll bypass the validation performed on the properties content.

Building the archetype

The archetype can be installed in your local maven repository.

  1. Clone this project
  2. From a terminal, enter the following command at the root of the cloned project:
./mvnw clean install

The archetype is now installed on your local maven repository, and is ready to be used.

Contributing

Please sign the contributor license agreement and read our contribution guidelines before to open a pull request.

CLA assistant

Release this project

A github action is used to perform release :

Actions Status

  • This action is triggered when a push is performed on a branch 'release-xxx'
  • It generates the changelog since the last release, creates the github tag and release with the changelog as description, and push the release on our nexus repository.

So, to release a new version of the project, you have to:

  • Create a branch release-[version] on your local git repository
  • Update the version in the pom.xml (remove the -SNAPSHOT)
  • Push the branch

⚠️ Make sure that the release branch is final before to push it. If you have to update something on the release branch after the push, then you must first:

  • Delete the tag and the release on github
  • Remove the artifact from our nexus repository