В этом разделе описываются веб-части Microsoft Office Outlook Web Access и рассказывается о том, как использовать их для открытия определенных папок. Веб-части Outlook Web Access можно использовать для определения почтового ящика, который требуется открыть, открываемой папки этого почтового ящика, а также используемого представления содержимого.
Веб-части Outlook Web Access позволяют получать доступ к содержимому Outlook Web Access напрямую через URL-адрес. URL-адрес можно вводить в веб-обозревателе или внедрять в приложение. Обычно веб-части не создаются вручную. Вместо этого они создаются программным путем на основе параметров, выбранных в пользовательском интерфейсе, или внедряются напрямую в приложение, например на страницу Microsoft Office SharePoint Server 2007. После этого код, связанный с пользовательским интерфейсом, создает URL-адрес. Одним из примеров использования веб-частей Outlook Web Access является отображение папки «Входящие» или календаря пользователя на странице Office SharePoint Server 2007.
 Примечание. |
|---|
| Для использования веб-частей Outlook Web Access как почтовый ящик пользователя, так и почтовый ящик, открываемый с помощью веб-части, должны находиться в одном лесу Active Directory. |
Разрешения для использования
веб-частей Outlook Web Access
Для работы с веб-частями Outlook Web Access используемой учетной записи необходимо делегировать как минимум доступ с правами «Читатель» к открываемому содержимому. Если в приложение внедрена веб-часть Outlook Web Access, для которой требуется проверка подлинности, необходимо передать сведения для проверки подлинности с запросом веб-части. Один из возможных способов — настроить виртуальный каталог Outlook Web Access для использования встроенной проверки подлинности Windows. Встроенная проверка подлинности Windows позволяет пользователям, которые уже вошли в систему с учетной записью Active Directory, использовать Outlook Web Access без повторного ввода учетных данных.
Синтаксис веб-части веб-клиента
Outlook
Exchange 2007 Outlook Web Access имеет новый формат URL-адреса для запросов виртуального каталога /owa. Чтобы выполнить запрос, можно ввести URL-адрес напрямую в веб-обозревателе или внедрить его в веб-приложение, например на страницу Office SharePoint Server.
Веб-части Outlook Web Access можно использовать для создания URL-адресов различной сложности. Простой URL-адрес веб-части можно использовать для открытия папки «Входящие» любого почтового ящика. Более сложный URL-адрес веб-части можно использовать для определения почтового ящика, который требуется открыть, открываемой папки этого почтового ящика, а также используемого представления содержимого.
Например, простой URL-адрес веб-части https://<имя_сервера>/owa/?cmd=contents открывает папку «Входящие» почтового ящика активного пользователя. Более сложный URL-адрес веб-части https://<имя_сервера>/owa/<SMTP-адрес>/?cmd=contents&f=inbox%2fProjects&view=by%20subject открывает вложенную папку Projects в почтовом ящике, определяемом SMTP-адресом, с сортировкой по теме.
В зависимости от мер безопасности, используемых в сети, может потребоваться настройка кодировки для URL-адреса веб-частей. После настройки кодировки код, связанный с пользовательским интерфейсом, создает URL-адрес, используя параметры с URL-кодировкой. В параметрах с URL-кодировкой пробелы заменяются сочетанием %20, а разделители пути «/» — сочетанием %2f. Во всех примерах в данном разделе используются параметры с кодировкой.
Поддерживаемые веб-части Microsoft Exchange 2000 и Exchange 2003 автоматически преобразуются в веб-части Exchange 2007.
В таблице 1 приведены параметры веб-части и примеры их использования.
Таблица 1. Параметры веб-части и их использование
| Параметр URL-адреса | Описание | Значения и примеры | ||
|---|---|---|---|---|
|
Имя сервера и каталог (обязательно) |
URL-адрес виртуального каталога Outlook Web Access. |
Можно использовать тот же URL-который, который используется для подключения к Outlook Web Access, например: https://<имя_сервера>/owa |
||
|
Идентификатор почтового ящика для явного входа в Exchange 2007 (необязательно) |
Любой SMTP-адрес, сопоставленный с открываемым почтовым ящиком. Если в этом разделе не указан URL-адрес, открывается почтовый ящик по умолчанию для пользователя, прошедшего проверку подлинности. Если дополнительные параметры не заданы, по умолчанию открывается папка «Входящие». |
Чтобы открыть почтовый ящик со SMTP-адресом tsmith@fourthcoffee.com, введите: https://<имя_сервера>/owa/tsmith@fourthcoffee.com |
||
|
cmd (требуется при указании любых параметров, кроме идентификатора почтового ящик для явного входа) |
При использовании параметра ?cmd=contents выводится веб-часть Outlook Web Access, заданная параметрами, а не весь пользовательский интерфейс Outlook Web Access. |
Если почтовый ящик не задан, этот параметр указывается после каталога сервера: https://<имя_сервера>/owa/?cmd=contents Если почтовый ящик задан, параметр указывается после идентификатора почтового ящика для явного входа: https://<имя_сервера>/owa/<SMTP-адрес>/?cmd=contents Если дополнительные параметры не заданы, по умолчанию открывается папка «Входящие». |
||
|
id (необязательно) |
ИД папки, содержимое которой должно отображаться в веб-части. ИД можно получить с помощью веб-служб и использовать в приложениях для динамического выбора открываемой папки. |
ИД папки — это свойство папки PR_ENTRY_ID в кодировке Base64: https://<имя_сервера>/owa/?cmd=contents&id=<PR_ENTRY_ID> |
||
|
f (необязательно) |
Строка, определяющая папку почтового ящика, которая должна отображаться в веб-части. Возможно, для URL-адреса веб-части потребуется использовать URL-кодировку, чтобы он не блокировался брандмауэрами. При использовании URL-кодировки пробелы заменяются сочетанием %20, а разделители пути «/» — сочетанием %2f. Иерархия папок должна начинаться с корня почтового ящика. Путь к папке может указывать на обычную папку или папку поиска. |
Чтобы открыть вложенную папку Projects папки «Входящие», введите: https://<имя_сервера>/owa/?cmd=contents&f= inbox%2fprojects |
||
|
module (необязательно) |
Этот параметр можно использовать для указания любой из четырех папок по умолчанию без ввода ее локализованного имени. |
Значения параметра module вводятся без учета регистра:
Чтобы открыть календарь почтового ящика вне зависимости от его локализации, введите: https://<имя_сервера>/owa/?cmd=contents&module=calendar |
||
|
view (необязательно) |
Этот параметр определяет представление папки. Если этот параметр не указан, по умолчанию используются следующие представления:
Сортировка по умолчанию для представления — это сортировка папки при ее открытии в клиенте Outlook Web Access. В Exchange 2007 не поддерживаются следующие представления веб-частей Exchange 2003:
Строки, определяющие представления, не локализуются и не учитывают регистр. |
Доступные представления зависят от типа папки. Представления для календаря:
Представления для сообщений:
Представления для папки «Контакты»:
Представления для задач:
При вводе URL-адреса https://<имя_сервера>/owa/?cmd=contents&f=Calendar&view=Weekly будет отображен требуемый календарь в представлении еженедельника. |
||
|
d, m, y (необязательно) |
Определяют дату, для которой необходимо отобразить календарь. Эти параметры можно вводить в любом порядке вместе или по отдельности. Если любой из этих параметров не указан, по умолчанию используется текущий день, месяц или год. Например, если текущий день — 3 мая 2007 г. и указано значение месяца «9» (сентябрь), будет использоваться дата 3 сентября 2007 г. |
Допустимы следующие значения: d=[1—31] m=[1—12] y=[четыре цифры года] Чтобы открыть календарь для 3 мая 2007 г., введите https://<имя_сервера>/owa/?cmd=content&f=calendar&view=daily&d=3&m=5&y=2007 |
||
|
part (необязательно) |
Указание на то, что необходимо открыть более мелкую веб-часть Outlook Web Access. |
При использовании веб-частей для доступа к содержимому Outlook Web Access будет отображаться не весь пользовательский интерфейс Outlook Web Access. Параметр part еще более уменьшает выводимый пользовательский интерфейс. В этом примере показано отображение списка задач в формате самой маленькой веб-части: https://<имя_сервера>/owa/?cmd=contents&f=tasks&part=1 На рис. 1 и 2 показан пользовательский интерфейс Outlook Web Access при применении параметра part=1 к веб-части «Задачи» и без его применения. |
На рис. 1 показана веб-часть «Задачи» Outlook Web Access без параметра part=1.
На рис. 2 показана веб-часть «Задачи» Outlook Web Access с параметром part=1.
Можно использовать несколько параметров, чтобы определить отображаемую папку и ее формат. Если используется несколько параметров папки, они задаются в порядке id, f и module. Если ни один из этих параметров не задан, по умолчанию будет отображаться папка «Входящие».
| Примечание. |
|---|
| Если какая-либо возможность отключена с помощью сегментации, она не будет доступна в качестве веб-части. Например, если отключен календарь Outlook Web Access, нельзя получить доступ к календарям с помощью веб-частей Outlook Web Access. |
Ввод веб-частей Outlook Web
Access вручную
Веб-части Outlook Web Access можно также вручную вводить в веб-обозревателе. Например, пользователь может использовать URL-адрес веб-части Outlook Web Access, чтобы открыть календарь другого пользователя.
Чтобы открыть отдельный календарь в представлении еженедельника, выполните указанные ниже действия.
- Откройте окно веб-обозревателя.
- Введите URL-адрес Outlook Web Access и добавьте
в его конец следующие строки:
<SMTP-адрес_почтового_ящика>/?cmd=contents&f=calendar&view=weekly.
- При запросе введите учетные данные для входа.
Например, если URL-адрес Outlook Web Access — https://email.fourthcoffee.com/owa, при вводе URL-адреса https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents&f=calendar&view=weekly откроется календарь пользователя tsmith в представлении еженедельника.
Дополнительные сведения
Дополнительные сведения о веб-частях и планировании веб-страниц см. в следующих статьях:
Дополнительные сведения о проверке подлинности Outlook Web Access см. в следующих разделах: