Usage
Simple project
The simple project is an empty BusinessWorks project.
Create
The command to create a new default empty project:
mvn archetype:generate \ -DarchetypeGroupId= \ fr.fastconnect.factory.tibco.bw.maven \ -DarchetypeArtifactId= \ archetype-bw-default-project
Several parameters must be provided (with -D command line option) :
Parameter | Example Value |
---|---|
groupId | com.company.project |
artifactId | simple-project |
version | 1.0.0 |
bwProjectName | SimpleProject |
rootProjectGroupId | fr.fastconnect.factory.tibco |
rootProjectArtifactId | fc-tibco-factory |
rootProjectVersion | 2.3.5 |
Design
Move to the project directory (the one with the POM):
cd ./simple-project
Launch the TIBCO Designer with the bw:launch-designer goal:
mvn bw:launch-designer
The project can be edited as any other TIBCO BusinessWorks project.
NB: before going on with the package phase, it is mandatory to exit the TIBCO Designer.
Package
The packaging of the application is performed with this command:
mvn package
This will create the TIBCO BusinessWorks EAR archive and the associated configuration files.
Simple Projlib
The simple Projlib is an empty BusinessWorks Projlib.
Create
The command to create a new default empty Projlb project:
mvn archetype:generate \ -DarchetypeGroupId= fr.fastconnect.factory.tibco.bw.maven \ -DarchetypeArtifactId= archetype-bw-default-projlib
Several parameters must be provided (with -D command line option) :
Parameter | Example Value |
---|---|
groupId | com.company.project |
artifactId | simple-project |
version | 1.0.0 |
bwProjectName | SimpleProjlib |
rootProjectGroupId | fr.fastconnect.factory.tibco |
rootProjectArtifactId | fc-tibco-factory |
rootProjectVersion | 2.3.5 |
Design
Move to the project directory (the one with the POM):
cd ./simple-projlib
Launch the TIBCO Designer with the bw:launch-designer goal:
mvn bw:launch-designer
The project can be edited as any other TIBCO BusinessWorks project.
NB: before going on with the package phase, it is mandatory to exit the TIBCO Designer.
Package
The packaging of the application is performed with this command:
mvn package
This will create the TIBCO BusinessWorks Projlib.
NB: to make available this Projlib to other projects, it is mandatory to perform the install phase. The install phase will perform the same goals as the package phase but will also copy the Maven artifact generated in the Maven local repository. This is the command to run:
mvn install
To share the Projlib between different developers, it is better to perform the deploy phase to deploy the artifact on a remote repository with this command:
mvn deploy
Dependency management
With the BWMaven plugin it is possible to define a dependency relation between a TIBCO BusinessWorks project and a Projlib. It is done with the standard Maven dependency mechanism .
Add
The command to add the simple-projlib as a dependency (to run in simple-project folder for instance).
mvn bw:add-dependency
Several parameters must be provided (with -D command line option) :
Parameter | Example Value |
---|---|
dependencyGroupId | com.company.project |
dependencyArtifactId | simple-projlib |
dependencyVersion | 1.0.0 |
dependencyType | simple-projlib |
doIt | true |
The full command line:
mvn bw:add-dependency \ -DdependencyGroupId=com.company.project \ -DdependencyArtifactId=simple-projlib \ -DdependencyVersion=1.0.0 \ -DdependencyType=projlib \ -DdoIt=true
POM
The dependency management commands will update the <dependencies> section of the project’s POM:
<dependencies> <dependency> <groupId>com.company.project</groupId> <artifactId>simple-projlib</artifactId> <version>1.0.0</version> <type>projlib</type> </dependency> </dependencies>
NB: the dependency management is just a convenient method to manipulate the declarative <dependencies> section of a POM. Consequently, the result might be inconsistent if the dependency to add does not exist or is not correct.
Remove
The command to remove the simple-projlib dependency (to run in simple-project folder for instance).
mvn bw:remove-dependency
Several parameters must be provided (with -D command line option) :
Parameter | Example Value |
---|---|
dependencyGroupId | com.company.project |
dependencyArtifactId | simple-projlib |
dependencyVersion | 1.0.0 |
dependencyType | simple-projlib |
doIt | true |
The full command line:
mvn bw:remove-dependency \ -DdependencyGroupId=com.company.project \ -DdependencyArtifactId=simple-projlib \ -DdependencyVersion=1.0.0 \ -DdependencyType=projlib \ -DdoIt=true