Calendars

When working with customers, resource planning and scheduling can be a complex task. Appointments enable you to meet your customers where and whenever needed.

OTRS supports this requirement with calendars. Calendars allow management of appointments and resources inside the ticket system. You can connect your tickets to scheduled tasks and make them available to all users to see. This feature adds transparency to show your teams workload and prevent users from promising resources which are not available.

Use this screen to manage calendars in the system. A fresh OTRS installation contains no calendars by default. The calendar management screen is available in the Calendars module of the Administration group.

Calendar Management Screen

Calendar Management Screen

Manage Calendars

To add a new calendar:

  1. Click on the Add Calendar button in the left sidebar.
  2. Fill in the required fields.
  3. Click on the Save button.
Add New Calendar Screen

Add New Calendar Screen

Warning

Calendars can not be deleted from the system. They can only be deactivated by setting the Validity option to invalid or invalid-temporarily.

To edit a calendar:

  1. Click on a calendar in the list of calendars.
  2. Modify the fields.
  3. Click on the Save or Save and finish button.
Edit Calendar Screen

Edit Calendar Screen

To export a calendar:

  1. Click on the export icon in the list of calendars.
  2. Choose a location in your computer to save the Export_Calendar_CalendarName.yml file.

To import calendars:

  1. Click on the Browse… button in the left sidebar.
  2. Select a previously exported .yml file.
  3. Click on the Overwrite existing entities checkbox, if you would like to overwrite the existing calendars.
  4. Click on the Import Calendar button.

Note

If several calendars are added to the system, use the filter box to find a particular calendar by just typing the name to filter.

Calendar Settings

The following settings are available when adding or editing this resource. The fields marked with an asterisk are mandatory.

General Calendar Settings

Calendar name *
The name of this resource. Any type of characters can be entered to this field including uppercase letters and spaces. The name will be displayed in the overview table.
Color *

The calendar color that will be displayed in the calendar overview screens.

To change the calendar color, just select a new color from the color palette. You can chose from the pre-selected colors or define other colors by choosing it from the color selector or typing the hexadecimal value.

Permission group *

Select which Groups can access the calendar.

Depending on the group field, the system will allow users the access to the calendar according to their permission level.

  • Read only: users can see and export all appointments in the calendar.
  • Move into: users can modify appointments in the calendar, but without changing the calendar selection.
  • Create: users can create and delete appointments in the calendar.
  • Read/write: users can manage the calendar itself.
Validity *
Set the validity of this resource. Each resource can be used in OTRS only, if this field is set to valid. Setting this field to invalid or invalid-temporarily will disable the use of the resource.

Calendar Ticket Appointments

Define rules for creating automatic appointments in this calendar based on ticket data. To add a new rule, click on the Add Rule button.

Calendar Settings - Ticket Appointments

Calendar Settings - Ticket Appointments

Start date
Select a start date for the ticket appointment.
End date
Select the end date for the ticket appointment.
Queues *
Select one or more queues to narrow down for which tickets appointments will be automatically created.
Search attributes
Additional search attributes can be added for further filtering by selecting an attribute and clicking on the ⊞ button.

Import Appointments

If at least one calendar have been added to the system, it is possible to import some appointments into the calendar.

To import some appointments:

  1. Click on the Import Appointments button in the left sidebar.
  2. Upload an iCal file and select a calendar.
  3. Click on the Import appointments button.
Import Appointments Screen

Import Appointments Screen

Upload *
Click on the Browse… button, and select a valid iCal (.ics) file to upload.
Calendar *

Select an available calendar.

Note

If desired calendar is not listed here, please make sure that you have at least create permissions.

Update existing appointments?
If checked, all existing appointments in the calendar with same UniqueID will be overwritten.