Package pro.taskana.monitor.internal.reports

Class WorkbasketReportBuilderImpl

java.lang.Object

pro.taskana.monitor.internal.reports.WorkbasketReportBuilderImpl

All Implemented Interfaces:

Report.Builder<MonitorQueryItem,TimeIntervalColumnHeader>, TimeIntervalReportBuilder<WorkbasketReport.Builder,MonitorQueryItem,TimeIntervalColumnHeader>, WorkbasketReport.Builder

public class WorkbasketReportBuilderImpl
extends Object
implements WorkbasketReport.Builder

Field Summary

Fields

Modifier and Type	Field	Description
protected String[]	classificationCategories
protected String[]	classificationIds
protected List<TimeIntervalColumnHeader>	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
WorkbasketReportBuilderImpl(InternalTaskanaEngine taskanaEngine, MonitorMapper monitorMapper)

Method Summary

Modifier and Type	Method	Description
protected WorkbasketReport.Builder	_this()
WorkbasketReport	buildReport()
WorkbasketReport	buildReport(TaskTimestamp timestamp)	Builds the Report for the specified TaskTimestamp.
WorkbasketReport.Builder	classificationCategoryIn(List<String> classificationCategories)	Adds a list of classificationCategories to the builder.
WorkbasketReport.Builder	classificationIdIn(List<String> classificationIds)	Adds a list of classificationIds to the builder.
WorkbasketReport.Builder	combinedClassificationFilterIn(List<CombinedClassificationFilter> combinedClassificationFilter)	Adds a list of CombinedClassificationFilter to the builder.
WorkbasketReport.Builder	customAttributeIn(TaskCustomField customField, String... strings)	Adds the values of a certain TaskCustomField for exact matching to the builder.
WorkbasketReport.Builder	customAttributeLike(TaskCustomField customField, String... strings)	Adds the values of a certain TaskCustomField for pattern matching to the builder.
WorkbasketReport.Builder	customAttributeNotIn(TaskCustomField customField, String... strings)	Excludes the values of a certain TaskCustomField to the builder.
WorkbasketReport.Builder	customIntAttributeIn(TaskCustomIntField customIntField, Integer... values)	Adds the values of a certain TaskCustomIntField for exact matching to the builder.
WorkbasketReport.Builder	customIntAttributeNotIn(TaskCustomIntField customIntField, Integer... values)	Excludes the values of a certain TaskCustomIntField to the builder.
WorkbasketReport.Builder	customIntAttributeNotWithin(TaskCustomIntField customIntField, IntInterval... values)	Exclude ranges of TaskCustomIntField for matching to the builder.
WorkbasketReport.Builder	customIntAttributeWithin(TaskCustomIntField customIntField, IntInterval... values)	Adds ranges of TaskCustomIntField for matching to the TimeIntervalReportBuilder.
protected String	determineGroupedBy()
WorkbasketReport.Builder	domainIn(List<String> domains)	Adds a list of domains to the builder.
WorkbasketReport.Builder	excludedClassificationIdIn(List<String> excludedClassificationIds)	Adds a list of excludedClassificationIds to the builder.
protected List<CombinedClassificationFilter>	getCombinedClassificationFilter()
WorkbasketReport.Builder	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.
WorkbasketReport.Builder	stateIn(List<TaskState> states)	Adds a list of states to the builder.
WorkbasketReport.Builder	withColumnHeaders(List<TimeIntervalColumnHeader> columnHeaders)	Adds a list TimeIntervalColumnHeaders to the Builder to subdivide the Report into clusters.
WorkbasketReport.Builder	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, listTaskIdsForSelectedItems, stateIn, withColumnHeaders, workbasketIdIn

Field Details

taskanaEngine

protected InternalTaskanaEngine taskanaEngine

monitorMapper

protected MonitorMapper monitorMapper

columnHeaders

protected List<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 Details

WorkbasketReportBuilderImpl

public WorkbasketReportBuilderImpl(InternalTaskanaEngine taskanaEngine,
 MonitorMapper monitorMapper)

Method Details

buildReport

public WorkbasketReport buildReport()
                             throws InvalidArgumentException,
NotAuthorizedException

Specified by:

buildReport in interface Report.Builder<MonitorQueryItem,TimeIntervalColumnHeader>

Specified by:

buildReport in interface WorkbasketReport.Builder

Throws:

InvalidArgumentException

NotAuthorizedException

buildReport

public WorkbasketReport buildReport(TaskTimestamp timestamp)
                             throws InvalidArgumentException,
NotAuthorizedException

Description copied from interface: TimeIntervalReportBuilder

Builds the Report for the specified TaskTimestamp.

Specified by:

buildReport in interface TimeIntervalReportBuilder<WorkbasketReport.Builder,MonitorQueryItem,TimeIntervalColumnHeader>

Specified by:

buildReport in interface WorkbasketReport.Builder

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

combinedClassificationFilterIn

public WorkbasketReport.Builder combinedClassificationFilterIn(List<CombinedClassificationFilter> combinedClassificationFilter)

Description copied from interface: WorkbasketReport.Builder

Adds a list of CombinedClassificationFilter to the builder. The created report contains only tasks with a pair of a classificationId for a task and a classificationId for the corresponding attachment in this list.

Specified by:

combinedClassificationFilterIn in interface WorkbasketReport.Builder

Parameters:

combinedClassificationFilter - a list of combinedClassificationFilter

Returns:

the WorkbasketReportBuilder

_this

protected WorkbasketReport.Builder _this()

determineGroupedBy

protected String determineGroupedBy()

getCombinedClassificationFilter

protected List<CombinedClassificationFilter> getCombinedClassificationFilter()

withColumnHeaders

public WorkbasketReport.Builder withColumnHeaders(List<TimeIntervalColumnHeader> 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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

stateIn

public WorkbasketReport.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<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

states - a list of states

Returns:

the TimeIntervalReportBuilder

classificationCategoryIn

public WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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 WorkbasketReport.Builder 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

listTaskIdsForSelectedItems

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

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<B extends TimeIntervalReportBuilder<B,I,H>,I extends AgeQueryItem,H extends TimeIntervalColumnHeader>

Parameters:

selectedItems - a list of selectedItems

timestamp - the TaskTimestamp of interest

Returns:

the list of all taskIds

Throws:

InvalidArgumentException - if the column headers are not initialized

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

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