Source string Read only

type: Content of: <section><section><title>
17/170
Context English State
CREATE
The related agent can create new appointments.
RW
The related agent is able to delete appointments.
The validity field indicates if a calendar is valid. Invalid calendars won't show up in the different overviews, even if agents have access to it.
Exporting calendars and/or appointments
To export a complete calendar structure to the YAML format, the calendar list in the calendar management screen can be used. By clicking on the related link within column <emphasis>Export</emphasis>, a YAML structure named <filename>Export_Calendar_CalendarName.yml</filename>, including the calendar meta-data (calendar name, color, permission group, validity state) can be downloaded. The structure also includes all calendar appointments. This functionality can be used to simply backup a certain calendar and/or transfer it to a foreign OTRS instance.
To export just the calendar appointments in ICS format, the link within column <emphasis>Download</emphasis> can be used. After clicking on the related link, an ICS file named <filename>CalendarName.ics</filename> can be downloaded, including all appointments of the related calendar. This file can be used to backup just the appointments of a certain calendar and/or transfer it to either an existing calendar on a foreign OTRS instance or any other calendar tool, which supports the ICS standard, to display the appointments.
Importing calendars and/or appointments
As an equivalent to the export function, it is possible to either import a complete calendar structure including related appointments in the YAML format, or just a set of appointments to an already existing calendar in the ICS format.
To import a complete calendar structure, the related <emphasis>Calendar Import</emphasis> widget on the left side of the calendar management screen can be used. Within this widget, a YML file can be selected and uploaded to import the calendar. The checkbox <emphasis>Overwrite existing entities</emphasis> indicates if a calendar with the same name as the imported one should be overwritten. If a calendar with the same name exists, but the checkbox is empty during the upload, a related error message will be displayed.
To import a set of appointments to an already existing calendar, the <emphasis>Import Appointments</emphasis> button can be clicked to access the appointment import screen.
Appointment import in calendar management overview
<graphic fileref="screenshots/appointment-calendar/calendarmanage-appointmentimport.png" scalefit="1" width="100%" contentdepth="100%"></graphic>
Here it's needed to select an ICS file to be used for the import. Right after that, a calendar needs to be selected from the related list to import the new appointments in. The checkbox <emphasis>Update existing appointments</emphasis> indicates, if already existing appointments with the same UniqueID shall be overwritten or not. Appointments with the same UniqueID but already existing in the related calendar won't be omitted during the import process. They will be inserted again and will be available multiple times in case of doubt, if the option to overwrite appointments is not enabled.
Calendar Overview
Within the calendar overview, an agent is able to display, create, edit and/or delete appointments of different calendars, depending on their permission level to the related calendars, as described above.
Calendar overview screen
<graphic fileref="screenshots/appointment-calendar/calendaroverview.png" scalefit="1" width="100%" contentdepth="100%"></graphic>
As visible in the following screenshot, the calendar overview contains the management tools for the calendars and appointments on the left side and the calendar view on the right side. With the buttons in the <emphasis>Actions</emphasis> widget it's possible to either access the calendar management directly or add a new appointment (if the agent has the permission).
Sidebar in calendar overview screen
<graphic fileref="screenshots/appointment-calendar/calendaroverview-sidebar.png" scalefit="1" width="100%" contentdepth="100%"></graphic>
The <emphasis>Calendars</emphasis> widget contains all calendars accessible by the agent. The checkboxes are used to enable or disable the view of certain calendars, like it's the case in many foreign calendar tools.
Since all appointments of any active calendar for every agent will be provided by the server (and not stored or cached on the client), it can result in heavy load on the server if too many calendars are active at the same time. Therefore a system configuration option <literal>AppointmentCalendar::CalendarLimitOverview</literal> limits the maximum number of active calendars per agent. If the limit is reached by an agent, a related error message will be displayed, indicating there are too many active calendars.
The URL column provides an external link to the calendar, which is used to subscribe. This functionality is described later in this document.
To have a good overview of available appointments within different calendars and the related dates the appointments start or end, we provide different view modes to be used by the agents.
View modes in calendar overview screen
<graphic fileref="screenshots/appointment-calendar/calendaroverview-viewmodes.png" scalefit="1" width="100%" contentdepth="100%"></graphic>
They are separated in timeline modes and non-timeline modes with different time ranges, to have the best view on different appointments for the related situations. On most of the view modes, a red line indicates the current time of the current day.
The information in the middle of the top-bar shows the current time range the agent is in, for the current view. Within the timeline views, the current calendar week will be displayed in light gray, when possible. Within the non-timeline views, the current calendar week is displayed as a single column on the left side, if possible.
Enclosed a screenshot of the non-timeline weekly view:
ComponentTranslation
This translation Translated OTRS 6/Administration Manual Calendar Overview
The following string has the same context and source.
Translated OTRS 6/((OTRS)) Community Edition Calendar Overview

Loading…

User avatar None

New source string

OTRS 6 / Administration ManualEnglish

New source string a year ago
Browse all component changes

Glossary

English English
No related strings found in the glossary.

Source information

Source string comment
type: Content of: <section><section><title>
Flags
read-only
Source string location
en/content/appointment-calendar/usage.xml:168
String age
a year ago
Source string age
a year ago
Translation file
i18n/doc-admin.pot, string 2971