Calendars are global objects in ProcMan, which means that they are not defined in clients or other objects.
Calendars in ProcMan are dedicated to specify free days (Saturdays, Sundays, New Year’s Day, etc.). They are used for selection and checking of process entry date, time and timestamp values, which are foreseen to contain only values referring to working days.
Calendars are in ProcMan organized hierarchically. Any calendar can be a root calendar (with no parent calendar) or a child calendar of another calendar. Any calendar can have an arbitrary count of children calendars. The hierarchy of calendars can be arbitrarily deep. If a calendar has a parent calendar it inherits free day definitions from all its ancestor calendars.
By clicking on the Calendars menu item the calendar administration dialog is being started.
After the dialog has been started, the list of already defined calendars is displayed (see picture below). If there are no calendars a message informing about this fact is displayed instead.
This dialog can be left by clicking the Cancel button. It can also be left at any time, even in the calendar definition forms for new and edited calendars, by selecting another function from the ProcMan menu. If this happens in the forms the last changes done in the forms are discarded.
A new calendar can be defined by clicking the New button in the calendars list form. After that a form with the calendar definition fields appears (see picture below).
After filling the fields in this form and clicking the OK button the new calendar is created and appears in the calendars list. By clicking the Cancel button the dialog returns to the calendars list without creating a new calendar.
The field Name has to be filled with the name of the new calendar. The name of the calendar can contain simple alphanumerical characters (ä, š, ô, etc. are not allowed), underscores, dots and spaces. Spaces at the beginning and the end are ignored. After submitting the form the name is converted into uppercase.
In the field Parent the parent calendar of the new calendar has to be selected or it can be left empty.
The field Description can be filled with a textual description of the new calendar. It is a free text, which can contain any printable characters. It also can be left empty.
In the field Regular free days the days which are considered to be free days every week can be selected. By checking check-boxes in the Free day column can be specified which week days shall be handled as free days. By checking check-boxes in the Allow selection column can be specified which free days shall be handled as work days (ProcMan allows a special handling of such week days, e.g. to show a warning in the case that such day has been selected).
The Merge with parent regular free days check-box appears only in the case that the new calendar has a parent calendar specified. If the check-box is checked the fee days settings inherited from the ancestor calendars and shown in the additional columns Free day from Parent and Allow selection from Parent are used in the new calendar without a need to do them for the new calendar again. However there can be selected further days in addition to the inherited days in the field Regular free days in the new calendar. If the check-box is not checked only days selected in the field Regular free days will be used by the new calendar.
In the table Other free days you can define days which are considered as free days and associated to a special date. If the new calendar has specified a parent calendar the free days inherited from the ancestor calendars are displayed at the beginning of the table as read-only rows. The date to which the free day is associated has to be filled in the Date column. The filled value has to contain at least the day and the month, optionally also the year. If the year is required but not specified the current system year is filled in by ProcMan.
The date field accepts different date formats e.g. YYYY-MM-DD, DD.MM.YYYY or MM/DD/YYYY. For the date selection the picker (button with question mark) right of the date-edit field can be used. In the field in the column Description a description of the free day can be typed. If the check-box in the Every year column is checked it means that the entered date made of the day and the month is a free day every year. In this case the year needs not to be specified in the date field as it is ignored anyway. If the specified free day is/was an every year free day only in some period, the years when it started to be a free day and/or the year when it finished to be a free day can be specified by selecting the years in the Since year and Until year columns. The check-box in the Allow selection column specifies when checked that the date can be used as a working day even though it is a free day. The buttons New and Delete below the table can be used to create new rows in the table or delete rows selected by checking the check-box at the beginning of the table rows.
A calendar definition can be edited by selecting it in the calendars list form (checking the check-box at the beginning of the table row) and clicking the Edit button in the calendars list form. Alternatively a calendar definition can be edited also by clicking on the calendar name in the table of the calendars list form. After that a form with the calendar definition fields appears. This form is the same like the form for a new calendar.
One or more calendars can be deleted by selecting them in the calendars list form (checking the check-box at the beginning of the table rows) and clicking the Delete button in the calendars list form. Beware that with the calendars also all descendant calendars are deleted.
Select one or more calendars from the calendars list form (checking the check-button at the beginning of the table rows) and click the Into Transfer Case button in the calendars list form. After the selected calendars have been added into the Transfer Case you can add another calendars or another objects into the Transfer Case or continue with other administration work. For more information about the Transfer Case see the description of the Transfer Case tool in this document.
