/nextreports-server

NextReports Server

Primary LanguageJavaApache License 2.0Apache-2.0

Current build status: Build Status

For more information about NextReports Server see the product page link.

How to build

Requirements:

  • Git
  • JDK 7 (test with java -version)
  • Apache Ant (test with ant -version)

Steps:

  • create a local clone of this repository (with git clone https://github.com/nextreports/nextreports-server.git)
  • go to project's folder (with cd nextreports-server)
  • build the artifacts (with ant clean release)

After above steps a folder artifacts is created and all goodies are in that folder.

How to run

It's very simple to run the nextreports-server. First, you must build the project using above steps. After building process go to dist folder and replace some variables:

  • @httpPort@ in ./etc/jetty.xml (for example you can replace this variable with 8081)
  • @reportsHome@ in ./contexts/reports.xml (for example you can replace this variable with reports)

Execute the script:

  • run.bat (for windows)
  • run.sh (for linux/unix)

Start an internet browser immediately after the server starts (it displays in command prompt something like "Started SelectChannelConnector@0.0.0.0:8081") and type http://localhost:@httpPort@/nextreports-server (for example http://localhost:8081/nextreports-server). In login page enter the default username and password: admin as username and 1 as password.

Using Maven

NextReports Server comes with some web services that allows other applications to interact with the server using a simple API on following levels:

  • storage level: list reports, charts, folders, data sources; create folders; publish reports, charts and data sources; download reports and charts (these methods are also used by NextReports Designer)
  • process level: run reports on the server from your proprietary applications with your specific parameters values

In your pom.xml you must define the dependencies to nextreports-server-clients artifacts with:

<dependency>
    <groupId>ro.nextreports</groupId>
    <artifactId>nextreports-server-client</artifactId>
    <version>${nextreports-server-client.version}</version>
</dependency>

where ${nextreports-server-client.version} is the last nextreports-server-client version.

You may want to check for the latest released version using Maven Search