Package pro.taskana.monitor.internal.reports

Class TimestampReportBuilderImpl

java.lang.Object

pro.taskana.monitor.internal.reports.TimestampReportBuilderImpl

All Implemented Interfaces:

Report.Builder<TimestampQueryItem,TimeIntervalColumnHeader>, TimeIntervalReportBuilder<TimestampReport.Builder,TimestampQueryItem,TimeIntervalColumnHeader>, TimestampReport.Builder

public class TimestampReportBuilderImpl
extends Object
implements TimestampReport.Builder

The implementation of TimestampReport.Builder.

Field Summary

Fields

Modifier and Type	Field	Description
protected String[]	classificationCategories
protected String[]	classificationIds
protected List<H>	columnHeaders
protected String[]	domains
protected String[]	excludedClassificationIds
protected boolean	inWorkingDays
protected MonitorMapper	monitorMapper
protected TaskState[]	states
protected InternalTaskanaEngine	taskanaEngine
protected String[]	workbasketIds
protected WorkingTimeCalculator	workingTimeCalculator

Constructor Summary

Constructors

Constructor	Description
TimestampReportBuilderImpl(InternalTaskanaEngine taskanaEngine, MonitorMapper monitorMapper)

Method Summary

Modifier and Type	Method	Description
protected TimestampReport.Builder	_this()
TimestampReport	buildReport()
Report<TimestampQueryItem,TimeIntervalColumnHeader>	buildReport(TaskTimestamp timestamp)	Builds the Report for the specified TaskTimestamp.
B	classificationCategoryIn(List<String> classificationCategories)	Adds a list of classificationCategories to the builder.
B	classificationIdIn(List<String> classificationIds)	Adds a list of classificationIds to the builder.
B	customAttributeIn(TaskCustomField customField, String... strings)	Adds the values of a certain TaskCustomField for exact matching to the builder.
B	customAttributeLike(TaskCustomField customField, String... strings)	Adds the values of a certain TaskCustomField for pattern matching to the builder.
B	customAttributeNotIn(TaskCustomField customField, String... strings)	Excludes the values of a certain TaskCustomField to the builder.
B	customIntAttributeIn(TaskCustomIntField customIntField, Integer... values)	Adds the values of a certain TaskCustomIntField for exact matching to the builder.
B	customIntAttributeNotIn(TaskCustomIntField customIntField, Integer... values)	Excludes the values of a certain TaskCustomIntField to the builder.
B	customIntAttributeNotWithin(TaskCustomIntField customIntField, IntInterval... values)	Exclude ranges of TaskCustomIntField for matching to the builder.
B	customIntAttributeWithin(TaskCustomIntField customIntField, IntInterval... values)	Adds ranges of TaskCustomIntField for matching to the TimeIntervalReportBuilder.
protected String	determineGroupedBy()
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.
protected List<CombinedClassificationFilter>	getCombinedClassificationFilter()
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.
TimestampReport.Builder	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.
TimestampReport.Builder	withTimestamps(List<TaskTimestamp> taskTimestamps)
B	workbasketIdIn(List<String> workbasketIds)	Adds a list of workbasket ids to the builder.

Methods inherited from class java.lang.Object

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

Methods inherited from interface pro.taskana.monitor.api.reports.TimeIntervalReportBuilder

classificationCategoryIn, classificationIdIn, customAttributeIn, customAttributeLike, customAttributeNotIn, customIntAttributeIn, customIntAttributeNotIn, customIntAttributeNotWithin, customIntAttributeWithin, domainIn, excludedClassificationIdIn, inWorkingDays, listCustomAttributeValuesForCustomAttributeName, withColumnHeaders, workbasketIdIn

Field Detail

taskanaEngine

protected InternalTaskanaEngine taskanaEngine

monitorMapper

protected MonitorMapper monitorMapper

columnHeaders

protected List<H extends TimeIntervalColumnHeader> columnHeaders

inWorkingDays

protected boolean inWorkingDays

workbasketIds

protected String[] workbasketIds

states

protected TaskState[] states

classificationCategories

protected String[] classificationCategories

domains

protected String[] domains

classificationIds

protected String[] classificationIds

excludedClassificationIds

protected String[] excludedClassificationIds

workingTimeCalculator

protected WorkingTimeCalculator workingTimeCalculator

Constructor Detail

TimestampReportBuilderImpl

public TimestampReportBuilderImpl(InternalTaskanaEngine taskanaEngine,
                                  MonitorMapper monitorMapper)

Method Detail

stateIn

public TimestampReport.Builder stateIn(List<TaskState> states)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

stateIn in interface TimeIntervalReportBuilder<TimestampReport.Builder,TimestampQueryItem,TimeIntervalColumnHeader>

Parameters:

states - a list of states

Returns:

the TimeIntervalReportBuilder

listTaskIdsForSelectedItems

public List<String> listTaskIdsForSelectedItems(List<SelectedItem> selectedItems,
                                                TaskTimestamp timestamp)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

listTaskIdsForSelectedItems in interface TimeIntervalReportBuilder<TimestampReport.Builder,TimestampQueryItem,TimeIntervalColumnHeader>

Parameters:

selectedItems - a list of selectedItems

timestamp - the TaskTimestamp of interest

Returns:

the list of all taskIds

withTimestamps

public TimestampReport.Builder withTimestamps(List<TaskTimestamp> taskTimestamps)

Specified by:

withTimestamps in interface TimestampReport.Builder

buildReport

public Report<TimestampQueryItem,TimeIntervalColumnHeader> buildReport(TaskTimestamp timestamp)
                                                                      throws InvalidArgumentException,
                                                                             NotAuthorizedException

Description copied from interface: TimeIntervalReportBuilder

Builds the Report for the specified TaskTimestamp.

Specified by:

buildReport in interface TimeIntervalReportBuilder<TimestampReport.Builder,TimestampQueryItem,TimeIntervalColumnHeader>

Parameters:

timestamp - The TaskTimestamp of interest

Returns:

The build Report

Throws:

InvalidArgumentException - if an error occurs

NotAuthorizedException - if the current user is not member of TaskanaRole.MONITOR or TaskanaRole.ADMIN

buildReport

public TimestampReport buildReport()
                            throws InvalidArgumentException,
                                   NotAuthorizedException

Specified by:

buildReport in interface Report.Builder<TimestampQueryItem,TimeIntervalColumnHeader>

Specified by:

buildReport in interface TimestampReport.Builder

Throws:

InvalidArgumentException

NotAuthorizedException

_this

protected TimestampReport.Builder _this()

determineGroupedBy

protected String determineGroupedBy()

withColumnHeaders

public B withColumnHeaders(List<H> columnHeaders)

Description copied from interface: TimeIntervalReportBuilder

Adds a list TimeIntervalColumnHeaders to the Builder to subdivide the Report into clusters.

Specified by:

withColumnHeaders in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

columnHeaders - the column headers the Report should consist of.

Returns:

the TimeIntervalReportBuilder

inWorkingDays

public B inWorkingDays()

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

inWorkingDays in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Returns:

the TimeIntervalReportBuilder

workbasketIdIn

public B workbasketIdIn(List<String> workbasketIds)

Description copied from interface: TimeIntervalReportBuilder

Adds a list of workbasket ids to the builder. The created Report contains only Tasks with a workbasketId in this list.

Specified by:

workbasketIdIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

workbasketIds - a list of workbasket ids

Returns:

the TimeIntervalReportBuilder

classificationCategoryIn

public B classificationCategoryIn(List<String> classificationCategories)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

classificationCategoryIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

classificationCategories - a list of classificationCategories

Returns:

the TimeIntervalReportBuilder

classificationIdIn

public B classificationIdIn(List<String> classificationIds)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

classificationIdIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

classificationIds - a list of classificationIds

Returns:

the TimeIntervalReportBuilder

excludedClassificationIdIn

public B excludedClassificationIdIn(List<String> excludedClassificationIds)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

excludedClassificationIdIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

excludedClassificationIds - a list of excludedClassificationIds

Returns:

the TimeIntervalReportBuilder

domainIn

public B domainIn(List<String> domains)

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

domainIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

domains - a list of domains

Returns:

the TimeIntervalReportBuilder

customAttributeIn

public B customAttributeIn(TaskCustomField customField,
                           String... strings)
                    throws InvalidArgumentException

Description copied from interface: TimeIntervalReportBuilder

Adds the values of a certain TaskCustomField for exact matching to the builder.

The created Report contains only Tasks with a custom attribute value exactly matching one of the items in the List.

Specified by:

customAttributeIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customField - the specified TaskCustomField

strings - the values the specified custom attribute should match

Returns:

the modified TimeIntervalReportBuilder

Throws:

InvalidArgumentException - if filter values are not given

customAttributeNotIn

public B customAttributeNotIn(TaskCustomField customField,
                              String... strings)
                       throws InvalidArgumentException

Description copied from interface: TimeIntervalReportBuilder

Excludes the values of a certain TaskCustomField to the builder.

The created Report contains only Tasks with a custom attribute value not matching one of the items in the List.

Specified by:

customAttributeNotIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customField - the specified TaskCustomField

strings - the values the specified custom attribute should not match

Returns:

the modified TimeIntervalReportBuilder

Throws:

InvalidArgumentException - if filter values are not given

customIntAttributeIn

public B customIntAttributeIn(TaskCustomIntField customIntField,
                              Integer... values)
                       throws InvalidArgumentException

Description copied from interface: TimeIntervalReportBuilder

Adds the values of a certain TaskCustomIntField for exact matching to the builder.

The created Report contains only Tasks with a custom attribute value exactly matching one of the items in the List.

Specified by:

customIntAttributeIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customIntField - the specified TaskCustomIntField

values - the values the specified customIntField should match

Returns:

the modified TimeIntervalReportBuilder

Throws:

InvalidArgumentException - if filter values are not given

customIntAttributeNotIn

public B customIntAttributeNotIn(TaskCustomIntField customIntField,
                                 Integer... values)
                          throws InvalidArgumentException

Description copied from interface: TimeIntervalReportBuilder

Excludes the values of a certain TaskCustomIntField to the builder.

The created Report contains only Tasks with a custom attribute value not matching one of the items in the List.

Specified by:

customIntAttributeNotIn in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customIntField - the specified TaskCustomIntField

values - the values the specified customIntFields should not match

Returns:

the modified TimeIntervalReportBuilder

Throws:

InvalidArgumentException - if filter values are not given

customIntAttributeWithin

public B customIntAttributeWithin(TaskCustomIntField customIntField,
                                  IntInterval... values)
                           throws IllegalArgumentException

Description copied from interface: TimeIntervalReportBuilder

Adds ranges of TaskCustomIntField for matching to the TimeIntervalReportBuilder.

The created Report contains only Tasks with a customIntField value being inside the range of one of the items in the list.

Specified by:

customIntAttributeWithin in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customIntField - the specified TaskCustomIntField

values - the values the specified customIntField should match

Returns:

the modified TimeIntervalReportBuilder

Throws:

IllegalArgumentException

customIntAttributeNotWithin

public B customIntAttributeNotWithin(TaskCustomIntField customIntField,
                                     IntInterval... values)
                              throws IllegalArgumentException

Description copied from interface: TimeIntervalReportBuilder

Exclude ranges of TaskCustomIntField for matching to the builder.

The created report contains only Tasks with a customIntField value being not inside the range of one of the items in the list.

Specified by:

customIntAttributeNotWithin in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customIntField - the specified TaskCustomIntField

values - the values the specified customIntField should match

Returns:

the modified TimeIntervalReportBuilder

Throws:

IllegalArgumentException

customAttributeLike

public B customAttributeLike(TaskCustomField customField,
                             String... strings)
                      throws InvalidArgumentException

Description copied from interface: TimeIntervalReportBuilder

Adds the values of a certain TaskCustomField for pattern matching to the builder.

The created Report contains only Tasks with a custom attribute value pattern-matching one of the items in the list. They will be compared in SQL with the LIKE operator. You may use a wildcard like % to specify the pattern. If you specify multiple arguments they are combined with the OR keyword.

Specified by:

customAttributeLike in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

customField - the specified TaskCustomField

strings - the values the specified custom attribute should match

Returns:

the modified TimeIntervalReportBuilder

Throws:

InvalidArgumentException - if filter values are not given

listCustomAttributeValuesForCustomAttributeName

public List<String> listCustomAttributeValuesForCustomAttributeName(TaskCustomField taskCustomField)
                                                             throws NotAuthorizedException

Description copied from interface: TimeIntervalReportBuilder

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

Specified by:

listCustomAttributeValuesForCustomAttributeName in interface TimeIntervalReportBuilder<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

taskCustomField - the TaskCustomField whose values should appear in the list

Returns:

the list of all custom attribute values

Throws:

NotAuthorizedException - if the current user is not member of TaskanaRole.MONITOR or TaskanaRole.ADMIN

getCombinedClassificationFilter

protected List<CombinedClassificationFilter> getCombinedClassificationFilter()