Использование веб-частей Outlook Web App

Exchange 2013
 

Применимо к:Exchange Server 2013

Последнее изменение раздела:2015-07-31

Веб-части МайкрософтOfficeOutlook Web App позволяют определить, какой почтовый ящик (или папку в нем) нужно открыть, а также какое представление содержимого необходимо использовать.

Веб-части Outlook Web App предоставляют доступ к содержимому Outlook Web App напрямую через URL-адрес. URL-адрес можно вводить в веб-браузере или внедрять в приложение. Как правило, создать веб-части вручную невозможно. Они создаются программным способом на основе вариантов, выбранных в пользовательском интерфейсе, или встраиваются непосредственно в приложение, например на страницу SharePoint Server. Затем код пользовательского интерфейса генерирует URL-адрес. Один из вариантов использования веб-частей Outlook Web App — отображение данных из папки "Входящие" или календаря пользователя на странице SharePoint.

ПримечаниеПримечание.
Для использования веб-частей Outlook Web App почтовый ящик пользователя и почтовый ящик, открываемый с помощью веб-части, должны находиться в одном лесу Active Directory.

Для использования веб-частей Outlook Web App необходимо делегированное разрешение на доступ к открываемому содержимому (по крайней мере "Читатель"). Если в приложение внедрена веб-часть Outlook Web App, для которой требуется проверка подлинности, необходимо передать сведения для проверки подлинности с запросом о веб-части. Это можно сделать несколькими способами. Один из них — настроить виртуальный каталог Outlook Web App для использования встроенной проверки подлинности Windows. Встроенная проверка подлинности Windows позволяет пользователям, которые уже выполнили вход с помощью учетной записи Active Directory, использовать Outlook Web App без повторного ввода учетных данных.

В случае Outlook Web App в Exchange 2013 используется формат URL-адреса для запросов о виртуальном каталоге /owa. Чтобы выполнить такой запрос, URL-адрес можно ввести напрямую в веб-браузере или внедрить в веб-приложение, например на страницу SharePoint Server.

Веб-части Outlook Web App можно использовать для создания URL-адресов различной сложности. Простой URL-адрес веб-части можно использовать для открытия папки "Входящие" любого почтового ящика. С помощью более сложного URL-адреса веб-части можно определить, какой почтовый ящик (или папку в нем) нужно открыть, а также какое представление содержимого необходимо использовать.

В зависимости от мер безопасности, используемых в сети, может потребоваться настройка кодировки для URL-адреса веб-частей. Когда вы настроите кодировку, вспомогательный код пользовательского интерфейса создаст URL-адрес, используя параметры с URL-кодировкой. В параметрах с URL-кодировкой пробелы заменяются сочетанием %20, а разделители пути "/" — сочетанием %2f. Во всех примерах данной статьи используются параметры с кодировкой.

В следующей таблице приведены параметры веб-части и примеры их использования.

Параметры веб-части и способы их использования

Параметр URL-адреса Описание Значения и примеры

Имя сервера и каталог (обязательно)

URL-адрес виртуального каталога Outlook Web App.

Это может быть тот же URL-адрес, который используется для входа в Outlook Web App, например:

https://<server name>/owa

Идентификатор почтового ящика для явного входа в Exchange 2013 (необязательно)

Любой SMTP-адрес, сопоставленный с открываемым почтовым ящиком.

Если этот раздел URL-адреса не указан, открывается почтовый ящик по умолчанию для пользователя, прошедшего проверку подлинности.

Если дополнительные параметры не заданы, по умолчанию открывается папка "Входящие".

Чтобы открыть почтовый ящик с SMTP-адресом tsmith@fourthcoffee.com, введите следующий URL-адрес:

https://<server name>/owa/tsmith@fourthcoffee.com

cmd (требуется при указании любых параметров, отличных от идентификатора почтового ящика для явного входа)

При использовании "?cmd=contents" отображается веб-часть Outlook Web App, заданная параметрами, а не весь пользовательский интерфейс Outlook Web App.

Если почтовый ящик не задан, то параметр cmd указывается после адреса входа:

https://<server name>/owa/?cmd=contents

Если почтовый ящик задан, то параметр cmd указывается после идентификатора почтового ящика для явного входа:

https://<server name>/owa/<SMTP address>/?cmd=contents

Если дополнительные параметры не заданы, по умолчанию открывается папка "Входящие".

exsvurl

Этот параметр нужно включить при использовании проверки подлинности с помощью LiveID.

Все параметры будут удалены при проверке подлинности с помощью LiveID, если отсутствует "exsvurl=1". Этот параметр предназначен только для почтовых ящиков Office 365.

https://<имя сервера>/owa/?cmd=contents&exsvurl=1

fpath (необязательно)

Возможно, для этой части URL-адреса потребуется использовать URL-кодировку, чтобы он не блокировался брандмауэрами.

При использовании URL-кодировки пробелы заменяются сочетанием %20, а разделители пути "/" — сочетанием %2f.

Иерархия папок должна начинаться с корня почтового ящика.

Путь к папке может вести к обычной папке или папке поиска.

Чтобы открыть вложенную папку "Projects" папки "Входящие", введите следующий URL-адрес:

https://<server name>/owa/?cmd=contents&fpath= inbox%2fprojects

module (необязательно)

Этот параметр можно использовать для указания любой из папок по умолчанию без ввода ее локализованного имени.

Значения параметра module вводятся без учета регистра и включают следующее:

  • Inbox;

  • Calendar;

  • Teammailbox.

Чтобы открыть календарь почтового ящика вне зависимости от его локализации, введите следующий URL-адрес:

https://<server name>/owa/?cmd=contents&module=calendar

view (необязательно)

Этот параметр определяет представление папки.

Если этот параметр не указан, по умолчанию используются следующие представления:

  • Для календаря: Daily.

  • Для сообщений: Messages.

ПримечаниеПримечание.
Строки для представлений по умолчанию автоматически получают URL-кодировку.

Сортировка по умолчанию для представления — это сортировка папки при ее открытии в клиенте Outlook Web App.

Строки, определяющие представления, не локализуются и вводятся без учета регистра.

Доступные представления зависят от типа папки.

Представления для календаря:

  • Daily — представление данных по дням.

  • Weekly — представление данных по неделям.

  • Monthly — представление данных по месяцам.

Представления для сообщений:

  • Messages — представление сообщений с сортировкой по умолчанию.

  • By%20Sender — представление сообщений с сортировкой по отправителю (от А до Я).

  • By%20Subject — представление сообщений с сортировкой по теме (от А до Я).

  • By%20Conversation%20Topic — представление беседы, недоступно в облегченной версии Outlook Web App.

d, m, y (необязательно)

Определяют, за какую дату необходимо отобразить данные календаря. Эти параметры можно вводить в любом порядке, вместе или по отдельности.

Если значение для какого-либо из этих параметров не указано, по умолчанию используется текущий день, месяц или год. Например, если указано значение месяца "9" (сентябрь), а текущий день — 03.05.16, то будет использоваться дата 03.09.16.

Допустимы следующие значения:

d=[1–31]

m=[1–12]

y=[четыре цифры года]

Чтобы открыть данные календаря за 3 мая 2016 г., введите такой URL-адрес: https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016

part (необязательно)

Указывает, что необходимо открыть более мелкую веб-часть Outlook Web App.

При использовании веб-частей для доступа к содержимому Outlook Web App будет отображаться не весь пользовательский интерфейс Outlook Web App. Параметр part еще более уменьшает выводимый пользовательский интерфейс. Следующий пример URL-адреса отображает список задач в формате самой маленькой веб-части:

https://<server name>/owa/?cmd=contents&part=1

Параметр part не применяется к модулю календаря.

FolderList

Этот параметр части включает элемент управления списком папок и позволяет пользователям переходить между вложенными папками. Применяется только к папкам электронной почты.

https://<имя сервера>/owa/?cmd=contents&folderlist=1

Путь к веб-частям Outlook Web App можно также вводить вручную в веб-браузере. Например, пользователь может использовать URL-адрес веб-части Outlook Web App, чтобы открыть календарь другого пользователя.

Приведенные ниже примеры показывают, как получать непосредственный доступ к распространенным представлениям Outlook Web App:

  • Папка "Входящие": https://<server name>/owa/?cmd=contents&module=inbox

  • Календарь (данные за текущую дату):https://<server name>/owa/?cmd=contents&module=calendar&exsvurl=1

  • Календарь (данные за неделю): https://<server name>/owa/?cmd=contents&module=calendar&view=weekly&exsvurl=1

  • Календарь (данные за месяц): https://<server name>/owa/?cmd=contents&module=calendar&view=monthly&exsvurl=1

 
Показ: