Для доступа к любой из Папок, содержащих данные Календаря или Задания, может использоваться следующие URL:
- http://servername:port/CalDAV/mailboxName
- https://servername:port/CalDAV/mailboxName
где
port является одним из номеров портов модуля
HTTP User (по умолчанию 8100 и 9100).
Если mailboxName заканчивается расширением имени файла
ics, то Сервер удаляет это расширение.
Если mailboxName отсутствует, то Сервер использует имя Календаря По Умолчанию.
Все запросы данных CalDAV должны быть аутентифицированными: пользователь должен ввести своё имя и пароль. У Пользователь и в Домене должна быть включена услуга WebCal.
Если Имя Домена пользователя или Псевдоним имени домена - mail.company.com, номер порта HTTP User - 80, а имя Папки -
Calendar, то, в таком случае, для доступа будет использоваться следующий URL:
- http://mail.company.com/CalDAV/Calendar
или
- http://mail.company.com/CalDAV/Calendar.ics
Таким образом может осуществляться доступ к любой Папке, имеющей тип Календарь или Задания. Для доступа к Папке другого Пользователя должно быть указано полное имя Папки:
- http://mail.company.com/CalDAV/~username/Calendar
Аутентифицированный пользователь должен иметь соответствующие
права доступа на чтение и/или изменение данных в Папках, принадлежащих другим пользователям.
В HTTP User модуле CommuniGate Pro реализован также старый, применявшийся до CalDAV, метод работы с данными в Папках Календарь и Задания.
Модуль позволяет клиентским приложениям получать данные используя формат iCalendar. Эта операция часто называется подписывание на данные Календаря.
Модуль также позволяет клиентским приложениям перезаписывать содержимое Папки в формате iCalendar (публиковать данные Календаря).
Для получения доступа к данным Календаря используется следующий URL:
- http://servername:port/CalendarData/mailboxName
- https://servername:port/CalendarData/mailboxName
где
port является одним из номеров портов модуля HTTP User (по умолчанию 8100 и 9100).
Если mailboxName заканчивается расширением имени файла
ics, то сервер удаляет это расширение.
Если mailboxName отсутствует, то Сервер использует имя Календаря По Умолчанию.
Все запросы данных Календаря должны быть аутентифицированным: пользователь должен ввести своё имя и пароль. У Пользователь и в Домене должна быть включена услуга WebCal.
Если Имя Домена пользователя или Псевдоним имени домена - mail.company.com, номер порта HTTP User - 80, а имя папки -
Calendar, то, в таком случае, для доступа будет использоваться следующий URL:
- http://mail.company.com/CalendarData/Calendar
или
- http://mail.company.com/CalendarData/Calendar.ics
Таким образом может осуществляться доступ к любой Папке, имеющей тип Календарь или Задания. Для доступа к Папке другого Пользователя должно быть указано полное имя Папки:
- http://mail.company.com/CalendarData/~username/Calendar.ics
Аутентифицированный пользователь должен иметь соответствующие
права доступа на чтение и/или изменение данных в Папках, принадлежащих другим пользователям.
HTTP модуль поддерживает следующие HTTP операции для области /CalendarData/:
- GET/HEAD: Папка разбирается и все элементы данных, в которых содержится информация в формате iCalendar, возвращаются в виде объекта VCALENDAR, имеющего элементы VEVENT и VTODO. Если папка является чужой, то аутентифицированный пользователь должен иметь право доступа Входить для этой Папки.
- DELETE: Папка разбирается и все элементы данных, в которых содержится информация в формате iCalendar, удаляются. Если Папка является чужой, то аутентифицированный пользователь должен иметь права доступа Удалить для этой Папки.
- PUT: тело HTTP запроса разбирается как объект VCALENDAR. Все обнаруженные элементы VEVENT и VTODO добавляются в Папку как отдельные элементы. Если разбор какого-либо элемента закончился неудачно, то никаких элементов не добавляется. Если Папка является чужой, то аутентифицированный пользователь должен иметь права доступа Добавить для этой папки.
Некоторыми приложениями не поддерживается метод DELETE. Такие приложения предполагают, что операция PUT удаляет всю существовавшую ранее информацию в Папке Календарь.
Для того, что бы обеспечить совместимость с такими приложениями, используйте область CalendarDataDel вместо области CalendarData или включите в URL параметр DeleteAll="1".
В этом случае, каждой операции PUT будет предшествовать виртуальная операция DELETE, удаляющая все существующие элементы iCalendar из папки.
Руководство CommuniGate® Pro. Copyright © 1998-2009, Stalker Software, Inc.