Использование веб-частей Outlook Web App
Область применения: Exchange Server 2013 г.
Веб-части Microsoft Office Outlook 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, требующую проверки подлинности, необходимо передать сведения о проверке подлинности вместе с запросом веб-части. Один из способов сделать это — настроить виртуальный каталог Outlook Web App для использования встроенного проверка подлинности Windows. Интегрированная проверка подлинности Windows позволяет пользователям, которые уже вошли в систему с помощью учетной записи Active Directory, использовать Outlook Web App без необходимости повторно вводить свои учетные данные.
Синтаксис веб-частей 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. Во всех примерах данной статьи используются параметры с кодировкой.
В следующей таблице приведены параметры веб-части и примеры их использования.
Примечание.
Exchange 2016, Exchange 2019 и Exchange Online больше не поддерживают веб-части.
Параметры веб-части и способы их использования
| Параметр 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" они отсутствуют. Этот параметр предназначен только для почтовых ящиков Microsoft 365 и Office 365. |
https://<server name>/owa/?cmd=contents&exsvurl=1 |
| fpath (необязательно) | Возможно, для этой части URL-адреса потребуется использовать URL-кодировку, чтобы он не блокировался брандмауэрами. При использовании URL-кодировки пробелы заменяются сочетанием %20, а разделители пути "/" сочетанием %2f. Иерархия папок должна начинаться с корня почтового ящика. Путь к папке может вести к обычной папке или папке поиска. |
Чтобы открыть вложенную папку "Projects" папки "Входящие", введите следующий URL-адрес:https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects |
| module (необязательно) | Этот параметр можно использовать для указания любой из папок по умолчанию без ввода ее локализованного имени. | Значения для параметра module не чувствительны к регистру и включают следующие значения:
Чтобы открыть календарь почтового ящика вне зависимости от его локализации, введите следующий URL-адрес: |
| view (необязательно) | Этот параметр определяет представление папки. Если этот параметр не указан, по умолчанию используются следующие представления:
Примечание. Строки для представлений по умолчанию автоматически кодируются по URL-адресу. |
Доступные представления зависят от типа папки. Представления для календаря:
Представления для сообщений:
|
| 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://<server name>/owa/?cmd=contents&folderlist=1 |
Ввод пути к веб-частям Outlook Web App вручную
Путь к веб-частям 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