Package ch.ivyteam.ivy.application.calendar

Interface IBusinessCalendarSettings

public interface IBusinessCalendarSettings

Reads, writes, creates and deletes IBusinessCalendarConfigurations

Each IApplication has its own IBusinessCalendarSettings (see IApplication.getBusinessCalendarSettings()).

API:

This is a public API.

Method Summary

Modifier and Type	Method	Description
IBusinessCalendarConfiguration	createBusinessCalendarConfiguration(String name)	Creates a new IBusinessCalendarConfiguration identified by the name.
void	deleteBusinessCalendarConfiguration(IBusinessCalendarConfiguration businessCalendarConfiguration)	Deletes the IBusinessCalendarConfiguration businessCalendarConfiguration.
IBusinessCalendarConfiguration	findBusinessCalendarConfiguration(String name)	Finds the IBusinessCalendarConfiguration identified by the name.
Tree	getAllBusinessCalendarConfigurations()	Returns an Tree containing all IBusinessCalendarConfigurations
List<IBusinessCalendarConfiguration>	getAllBusinessCalendarConfigurationsAsList()	Returns an List containing all IBusinessCalendarConfigurations
IBusinessCalendarConfiguration	getRootBusinessCalendarConfiguration()	Returns the default IBusinessCalendarConfiguration for this application.
void	saveBusinessCalendarConfiguration(IBusinessCalendarConfiguration businessCalendarConfiguration)	Persists changes in the IBusinessCalendarConfiguration businessCalendarConfiguration.

Method Details

findBusinessCalendarConfiguration

IBusinessCalendarConfiguration findBusinessCalendarConfiguration(String name)

Finds the IBusinessCalendarConfiguration identified by the name. If no IBusinessCalendarConfiguration is stored under that name, null is returned.

Parameters:

name - the unique name of the desired IBusinessCalendarConfiguration. Must not be empty and shorter than 200 characters.

Returns:

the IBusinessCalendarConfiguration identified by the name. Null if none is found.

Throws:

IllegalArgumentException - if name is null or too long.

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

createBusinessCalendarConfiguration

IBusinessCalendarConfiguration createBusinessCalendarConfiguration(String name)

Creates a new IBusinessCalendarConfiguration identified by the name. The new IBusinessCalendarConfiguration has the default calendar as parent. Use IBusinessCalendarConfiguration.setParent(IBusinessCalendarConfiguration) to change the parent.

Parameters:

name - the unique name of the desired IBusinessCalendarConfiguration. Must not be empty and shorter than 200 characters.

Returns:

the new IBusinessCalendarConfiguration identified by the name. Never null.

Throws:

IllegalArgumentException - if name is null or too long.

IllegalStateException - if a calendar with the name already exists

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

getRootBusinessCalendarConfiguration

IBusinessCalendarConfiguration getRootBusinessCalendarConfiguration()

Returns the default IBusinessCalendarConfiguration for this application. This is the root IBusinessCalendarConfiguration from which all other IBusinessCalendarConfigurations of this application inherit.

Returns:

the default IBusinessCalendarConfiguration for this application. Never null.

Throws:

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

getAllBusinessCalendarConfigurations

Tree getAllBusinessCalendarConfigurations()

Returns an Tree containing all IBusinessCalendarConfigurations

Returns:

Tree of IBusinessCalendarConfigurations. Never null.

Throws:

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

getAllBusinessCalendarConfigurationsAsList

List<IBusinessCalendarConfiguration> getAllBusinessCalendarConfigurationsAsList()

Returns an List containing all IBusinessCalendarConfigurations

Returns:

List of IBusinessCalendarConfigurations. Never null.

Throws:

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

saveBusinessCalendarConfiguration

void saveBusinessCalendarConfiguration(IBusinessCalendarConfiguration businessCalendarConfiguration)

Persists changes in the IBusinessCalendarConfiguration businessCalendarConfiguration.

To create or change a IBusinessCalendarConfiguration, first create the IBusinessCalendarConfiguration using createBusinessCalendarConfiguration(String) or load it using findBusinessCalendarConfiguration(String).

Example:

    IBusinessCalendarConfiguration calendarConfiguration = application.getBusinessCalendarConfiguration("ZugSpecialHolidays");
    calendarConfiguration.getFreeDaysOfYear().add(new FreeDayOfYear(12,8)));
    application.saveBusinessCalendarConfiguration(calendarConfiguration);
 

Parameters:

businessCalendarConfiguration - the businessCalendarConfiguration to persist

Throws:

IllegalArgumentException - if calendarConfiguration is null

PersistencyException - if the persistency system access failed.

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.

deleteBusinessCalendarConfiguration

void deleteBusinessCalendarConfiguration(IBusinessCalendarConfiguration businessCalendarConfiguration)

Deletes the IBusinessCalendarConfiguration businessCalendarConfiguration. If the configuration is not persisted yet, nothing happens.

Example:
IBusinessCalendarConfiguration configurationToDelete = application.getBusinessCalendarConfiguration(x); application.deleteBusinessCalendarConfiguration(configurationToDelete);

Parameters:

businessCalendarConfiguration - the IBusinessCalendarConfiguration to delete

Throws:

IllegalArgumentException - if calendarConfiguration is null

PersistencyException - if the persistency system access failed.

ch.ivyteam.util.IvyRuntimeException - if the businessCalendarConfiguration is the default IBusinessCalendarConfiguration (see getRootBusinessCalendarConfiguration())

API:

This public API is available in IvyScript and Java. It has the visibility EXPERT.