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