org.imixs.workflow.engine

Class ReportService

java.lang.Object

org.imixs.workflow.engine.ReportService

@DeclareRoles(value={"org.imixs.ACCESSLEVEL.NOACCESS","org.imixs.ACCESSLEVEL.READERACCESS","org.imixs.ACCESSLEVEL.AUTHORACCESS","org.imixs.ACCESSLEVEL.EDITORACCESS","org.imixs.ACCESSLEVEL.MANAGERACCESS"})
 @RolesAllowed(value={"org.imixs.ACCESSLEVEL.NOACCESS","org.imixs.ACCESSLEVEL.READERACCESS","org.imixs.ACCESSLEVEL.AUTHORACCESS","org.imixs.ACCESSLEVEL.EDITORACCESS","org.imixs.ACCESSLEVEL.MANAGERACCESS"})
public class ReportService
extends Object

The ReportService supports methods to create, process and find report instances. A Report Entity is identified by its name represented by the attribute 'name' So a ReportService Implementation should ensure that name is a unique key for the report entity. Also each report entity holds a EQL Query in the attribute "txtquery". this eql statement will be processed by the processQuery method and should return a collection of entities defined by the query.

Author:

Ralph Soika

Constructor Summary

Constructors

Constructor and Description
ReportService()

Method Summary

Modifier and Type	Method and Description
static Calendar	computeDynamicDate(String xmlDate) This method parses a xml tag and computes a dynamic date by parsing the attributes: DAY_OF_MONTH DAY_OF_YEAR MONTH YEAR ADD (FIELD,OFFSET) e.g.
static String	customNumberFormat(String pattern, String locale, double value) This method converts a double value into a custom number format including an optional locale. "###,###.###", "en_UK", 123456.789 "EUR #,###,##0.00", "de_DE", 1456.781
List<ItemCollection>	executeReport(String reportName, int pageSize, int pageIndex, String sortBy, boolean sortReverse, Map<String,String> params) This method executes the JQPL statement of a Report Entity.
ItemCollection	getReport(String aReportName) Returns a Report Entity identified by the attribute name
List<ItemCollection>	getReportList() This method returns a all reports (ItemCollection) sorted by name.
static String	replaceDateString(String content) This method replaces all occurrences of tags with the corresponding dynamic date.
void	updateReport(ItemCollection aReport) updates a Entity Report Object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReportService

public ReportService()

Method Detail

getReport

public ItemCollection getReport(String aReportName)

Returns a Report Entity identified by the attribute name

Parameters:

aReportName - - name of the report

Returns:

ItemCollection representing the Report

Throws:

Exception

getReportList

public List<ItemCollection> getReportList()

This method returns a all reports (ItemCollection) sorted by name. The method returns only ItemCollections the call has sufficient read access for.

updateReport

public void updateReport(ItemCollection aReport)
                  throws AccessDeniedException

updates a Entity Report Object. The Entity representing a report must have at least the attributes : txtQuery, numMaxCount, numStartPost, txtName. txtName is the unique key to be use to get a query. The method checks if a report with the same key allready exists. If so this report will be updated. If no report exists the new report will be created

Parameters:

report -

Throws:

InvalidItemValueException

AccessDeniedException

executeReport

public List<ItemCollection> executeReport(String reportName,
                                          int pageSize,
                                          int pageIndex,
                                          String sortBy,
                                          boolean sortReverse,
                                          Map<String,String> params)
                                   throws QueryException

This method executes the JQPL statement of a Report Entity. The values of the returned entities will be cloned and formated in case a itemList is provided. issue #144 The method parses the attribute txtname for a formating expression to format the item value. E.g.: datDateyy-dd-mm

Parameters:

reportName - - name of the report to be executed

startPos - - optional start position to query entities

maxcount - - optional max count of entities to query

params - - optional parameter list to be mapped to the JQPL statement

itemList - - optional attribute list of items to be returned

Returns:

collection of entities

Throws:

QueryException

computeDynamicDate

public static Calendar computeDynamicDate(String xmlDate)

This method parses a xml tag and computes a dynamic date by parsing the attributes: DAY_OF_MONTH DAY_OF_YEAR MONTH YEAR ADD (FIELD,OFFSET) e.g. results in 1. February of the current year results in 30.November of current year

Parameters:

xmlDate -

Returns:

replaceDateString

public static String replaceDateString(String content)

This method replaces all occurrences of tags with the corresponding dynamic date. See computeDynamicdate.

Parameters:

content -

Returns:

customNumberFormat

public static String customNumberFormat(String pattern,
                                        String locale,
                                        double value)

This method converts a double value into a custom number format including an optional locale. "###,###.###", "en_UK", 123456.789 "EUR #,###,##0.00", "de_DE", 1456.781

Parameters:

pattern -

value -

Returns: