Package pro.taskana.monitor.api.reports

Interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Type Parameters:

B - the true Builder behind this Interface.

I - the AgeQueryItem which will be inserted into the Report.

H - the column Header

All Superinterfaces:

Report.Builder<I,H>

All Known Subinterfaces:

ClassificationCategoryReport.Builder, ClassificationReport.Builder, TaskCustomFieldValueReport.Builder, TimestampReport.Builder, WorkbasketReport.Builder

All Known Implementing Classes:

ClassificationCategoryReportBuilderImpl, ClassificationReportBuilderImpl, TaskCustomFieldValueReportBuilderImpl, TimestampReportBuilderImpl, WorkbasketReportBuilderImpl

public interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>
extends Report.Builder<I,H>

"Super" Interface for all TimeIntervalReportBuilders.

Method Summary

Modifier and Type	Method	Description
Report<I,H>	buildReport(TaskTimestamp timestamp)	Builds the given report.
B	classificationCategoryIn(List<String> classificationCategory)	Adds a list of classificationCategories to the builder.
B	classificationIdIn(List<String> classificationIds)	Adds a list of classificationIds to the builder.
B	customAttributeFilterIn(Map<TaskCustomField,String> customAttributeFilter)	Adds a map of custom attributes and custom attribute values to the builder.
B	domainIn(List<String> domains)	Adds a list of domains to the builder.
B	excludedClassificationIdIn(List<String> excludedClassificationIds)	Adds a list of excludedClassificationIds to the builder.
B	inWorkingDays()	If this filter is used, the days of the report are counted in working days.
List<String>	listCustomAttributeValuesForCustomAttributeName(TaskCustomField taskCustomField)	Returns a list of all values of an entered custom field that are in the report.
List<String>	listTaskIdsForSelectedItems(List<SelectedItem> selectedItems, TaskTimestamp timestamp)	Returns a list of all taskIds of the report that are in the list of selected items.
B	stateIn(List<TaskState> states)	Adds a list of states to the builder.
B	withColumnHeaders(List<H> columnHeaders)	Adds a list TimeIntervalColumnHeaders to the builder to subdivide the report into clusters.
B	workbasketIdIn(List<String> workbasketIds)	Adds a list of workbasket ids to the builder.

Methods inherited from interface pro.taskana.monitor.api.reports.Report.Builder

buildReport

Method Detail

withColumnHeaders

B withColumnHeaders(List<H> columnHeaders)

Adds a list TimeIntervalColumnHeaders to the builder to subdivide the report into clusters.

Parameters:

columnHeaders - the column headers the report should consist of.

Returns:

the TimeIntervalReportBuilder

inWorkingDays

B inWorkingDays()

If this filter is used, the days of the report are counted in working days.

Returns:

the TimeIntervalReportBuilder

workbasketIdIn

B workbasketIdIn(List<String> workbasketIds)

Adds a list of workbasket ids to the builder. The created report contains only tasks with a workbasket id in this list.

Parameters:

workbasketIds - a list of workbasket ids

Returns:

the TimeIntervalReportBuilder

stateIn

B stateIn(List<TaskState> states)

Adds a list of states to the builder. The created report contains only tasks with a state in this list.

Parameters:

states - a list of states

Returns:

the TimeIntervalReportBuilder

classificationCategoryIn

B classificationCategoryIn(List<String> classificationCategory)

Adds a list of classificationCategories to the builder. The created report contains only tasks with a category in this list.

Parameters:

classificationCategory - a list of classificationCategories

Returns:

the TimeIntervalReportBuilder

classificationIdIn

B classificationIdIn(List<String> classificationIds)

Adds a list of classificationIds to the builder. The created report contains only tasks with a classificationId in this list.

Parameters:

classificationIds - a list of classificationIds

Returns:

the TimeIntervalReportBuilder

excludedClassificationIdIn

B excludedClassificationIdIn(List<String> excludedClassificationIds)

Adds a list of excludedClassificationIds to the builder. The created report contains only tasks with a classificationId NOT in this list.

Parameters:

excludedClassificationIds - a list of excludedClassificationIds

Returns:

the TimeIntervalReportBuilder

domainIn

B domainIn(List<String> domains)

Adds a list of domains to the builder. The created report contains only tasks with a domain in this list.

Parameters:

domains - a list of domains

Returns:

the TimeIntervalReportBuilder

customAttributeFilterIn

B customAttributeFilterIn(Map<TaskCustomField,String> customAttributeFilter)

Adds a map of custom attributes and custom attribute values to the builder. The created report contains only tasks with a custom attribute value in this list.

Parameters:

customAttributeFilter - a map of custom attributes and custom attribute value

Returns:

the TimeIntervalReportBuilder

listTaskIdsForSelectedItems

List<String> listTaskIdsForSelectedItems(List<SelectedItem> selectedItems,
                                         TaskTimestamp timestamp)
                                  throws NotAuthorizedException,
                                         InvalidArgumentException

Returns a list of all taskIds of the report that are in the list of selected items.

Parameters:

selectedItems - a list of selectedItems

timestamp - the task timestamp of interest

Returns:

the list of all taskIds

Throws:

InvalidArgumentException - if the column headers are not initialized

NotAuthorizedException - if the user has no rights to access the monitor

listCustomAttributeValuesForCustomAttributeName

List<String> listCustomAttributeValuesForCustomAttributeName(TaskCustomField taskCustomField)
                                                      throws NotAuthorizedException

Returns a list of all values of an entered custom field that are in the report.

Parameters:

taskCustomField - the customField whose values should appear in the list

Returns:

the list of all custom attribute values

Throws:

NotAuthorizedException - if the user has no rights to access the monitor

buildReport

Report<I,H> buildReport(TaskTimestamp timestamp)
                       throws NotAuthorizedException,
                              InvalidArgumentException

Builds the given report.

Parameters:

timestamp - The task timestamp of interest

Returns:

The build report

Throws:

NotAuthorizedException - if the user has no rights to access the monitor

InvalidArgumentException - when an error occurs