Boomi Flow Reporting
This application gives you the ability to process reporting data created by your Boomi Flow states, and store it in your internal systems. It currently supports storing events, states and state values.
You will need to run your own instance of the application, but it's easy to spin up if you follow these instructions:
If you choose to store your reporting data in a database, you will find example schemas for the supported databases in
src/main/sql folder. Currently, only PostgreSQL is supported.
The available configuration settings for the application are:
- database.type: Currently supported values are
- database.url: A JDBC connection string, e.g.
If you choose to configure the application at runtime, by using environment variables, you will need to run the application like so:
$ DATABASE_TYPE=postgres DATABASE_URL=jdbc:postgresql://localhost/reporting DATABASE_USERNAME=postgres DATABASE_PASSWORD=password java -jar target/reporting-*.jar
docker-compose.yml manifest is supplied, with some example configuration settings. Feel free to modify it to suit
your requirements, and start it using:
$ docker-compose up
More documentation on using Docker Compose can be found here.
If you are running the application on Heroku along with one of their relational database
addons, no further configuration is necessary as the provided
JDBC_DATABASE_URL has all the needed information and is
You can perform a one-click deploy of the application here:
If you choose to configure the application using a properties file, you will need to have Apache Ant installed, then
you can generate a configuration file by running the provided
$ ant -Ddatabase.type=postgres -Ddatabase.url=jdbc:postgresql://localhost/reporting -Ddatabase.username=postgres -Ddatabase.password=password
To build the service, you will need to have Maven 3 and a Java 8 implementation installed (OpenJDK and Oracle Java SE are both supported).
Now you can build the runnable shaded JAR:
$ mvn clean package
The application is a Jersey JAX-RS application, that by default is run under the Grizzly2 server on port 8080 (if you use the packaged JAR).
Running the following command will start the service listening on
$ java -jar target/reporting-*.jar
You can specify a custom port to run the application on by passing the
server.port property when running the JAR. The
following command will start the service listening on port 9090 (
$ java -Dserver.port=9090 -jar target/reporting-*.jar
Contributions are welcome to the project - whether they are feature requests, improvements or bug fixes! Refer to CONTRIBUTING.md for our contribution requirements.
This service is released under the MIT License.