r6 - 11 Sep 2007 - 02:48:53 - ZacSim?You are here: TWiki >  Main Web  >  ElixirRepertoireServer > API7

Server API

The key concept in REST is the idea that each resource should have a unique global identifier and that operations can be applied to the resource through a set of well-defined operations (GET,POST,PUT and DELETE). In Elixir Repertoire, this means that each repository file and folder, user, group, report,datasource, target, even log, all have distinct identifiers - URLs - that allow direct interaction. For example, creating a new user called bill can be done through the Web Interface with your browser, as described previously, but can just as easily be done by sending a PUT request to the URL /user/bill.Similarly, accessing a server log is as simple as sending a GET request to /log/file/server.log. You can integrate that log into a portal if you choose, or maybe write a utility to scan the log for specific tasks you are monitoring.

Here's a few examples of accessing resources on a Repertoire Server.

To render a report template ( CustomerListing? ) to output PDF.
- http://localhost:8080/report/ElixirSamples/Report/CustomerListing.rml?mime-type=application/pdf
To render a report template ( CustomerListing? ) to Ms Excel
- http://localhost:8080/report/ElixirSamples/Report/CustomerListing.rml?mime-type=application/vnd.ms-excel

To render a datasource
- http://localhost:8080/data/ElixirSamples/DataSource/ChartData.ds

Client API

Elixir Repertoire server provides a set of Java standalone client APIs for connection to the server. This API allows you to trigger all the report-related or ETL functionalities. Access to the functionality is controlled by the Server license. The report-related functionality allows listing of reports deployed on the server repository, extracting dynamic parameters in the report and generating reports. The ETL functionality allow you to access data generation and DataStore? functions.

This client library may be deployed as part of a J2EE solution.

The detailed version of the Java API documentation is shipped with the server.

Version 7.1

Version 7.0.1

  • Repertoire Client for Java 5 and above Environment

The JAR files is located at Repertoire-Server-7.0.1\RepertoireServer\clients\lib

Known Issues

Version 7.1.0

  • ERSClient does not allow large JSON parameter to be passed.
Download the latest RepertoireClient support for Java 1.5 and Java 1.4 from the respective Client API sections shown in this page.

Version 7.0.1

  • A renderReport() API Call followed by a getParameter() API call will cause the server to remember the previous parameter name and subsequent getParameter Calls will not be able to work correctly. The server remembers the parameters already passed in, so it doesn't ask for any more
  • IJobInfo.JOB_RECEIVED - The correct value is not returned
  • IJobInfo.JOB_STARTED - The correct value is not returned

-- IrwinTan - 25 Aug 2007

toggleopenShow attachmentstogglecloseHide attachments
Topic attachments
I Attachment Action Size Date Who Comment
zipzip ERSClient14.zip manage 893.2 K 29 Aug 2007 - 02:53 IrwinTan Elixir Repertoire Server - Client API for Java 1.4
Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r6 < r5 < r4 < r3 < r2 | More topic actions
 
Powered by TWiki
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback