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

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

Можно использовать Microsoft Office Outlook Web App веб-частей для указания почтовых ящиков, чтобы открыть папку в этот почтовый ящик, чтобы открыть и представления контента для использования.You can use Microsoft Office Outlook Web App Web Parts to specify the mailbox to open, the folder within that mailbox to open, and the content view to use.

Веб-части Outlook Web App предоставляют доступ к содержимому Outlook Web App напрямую через URL-адрес. URL-адрес можно вводить в веб-браузере или внедрять в приложение. Как правило, создать веб-части вручную невозможно. Они создаются программным способом на основе вариантов, выбранных в пользовательском интерфейсе, или встраиваются непосредственно в приложение, например на страницу SharePoint Server. Затем код пользовательского интерфейса генерирует URL-адрес. Один из вариантов использования веб-частей Outlook Web App — отображение данных из папки "Входящие" или календаря пользователя на странице SharePoint.Outlook Web App Web Parts let you access Outlook Web App content directly from a URL. The URL can be entered into a Web browser or embedded in an application. Generally, Web Parts aren't created manually. Instead, they're created programmatically based on selections made in a user interface (UI), or they're embedded directly in an application, such as a SharePoint Server page. The code behind the UI then creates the URL. One use for Outlook Web App Web Parts is to display a user's Inbox or Calendar on a SharePoint page.

Примечание

Для использования веб-частей Outlook Web App почтовый ящик пользователя и почтовый ящик, открываемый с помощью веб-части, должны находиться в одном лесу Active Directory.To use Outlook Web App Web Parts, both the user's mailbox and the mailbox being opened through a Web Part must be located in the same Active Directory forest.

Разрешения для использования веб-частей Outlook Web AccessPermissions for Using Outlook Web Access Web Parts

Для использования веб-частей Outlook Web App необходимо делегированное разрешение на доступ к открываемому содержимому (по крайней мере "Читатель"). Если в приложение внедрена веб-часть Outlook Web App, для которой требуется проверка подлинности, необходимо передать сведения для проверки подлинности с запросом о веб-части. Это можно сделать несколькими способами. Один из них — настроить виртуальный каталог Outlook Web App для использования встроенной проверки подлинности Windows. Встроенная проверка подлинности Windows позволяет пользователям, которые уже выполнили вход с помощью учетной записи Active Directory, использовать Outlook Web App без повторного ввода учетных данных.To use Outlook Web App Web Parts, you must, at a minimum, be delegated "Reviewer" access to the content that you're opening. If you've embedded an Outlook Web App Web Part that requires authentication into an application, you must pass authentication information through together with the request for the Web Part. One way to do this is by configuring the Outlook Web App virtual directory to use Integrated Windows authentication. Integrated Windows authentication lets users who've already logged on by using their Active Directory account use Outlook Web App without having to enter their credentials again.

Синтаксис веб-частей Outlook Web AppOutlook Web App Web Parts Syntax

В случае Outlook Web App в Exchange 2013 используется формат URL-адреса для запросов о виртуальном каталоге /owa. Чтобы выполнить такой запрос, URL-адрес можно ввести напрямую в веб-браузере или внедрить в веб-приложение, например на страницу SharePoint Server.Outlook Web App in Exchange 2013 has a URL format to use for requests to the /owa virtual directory. These requests can be made by typing a URL directly into a Web browser or by embedding the URL in a Web application, such as a SharePoint Server page.

Веб-части Outlook Web App можно использовать для создания URL-адресов различной сложности. Простой URL-адрес веб-части можно использовать для открытия папки "Входящие" любого почтового ящика. С помощью более сложного URL-адреса веб-части можно определить, какой почтовый ящик (или папку в нем) нужно открыть, а также какое представление содержимого необходимо использовать.Outlook Web App Web Parts can be used to create URLs of varying complexity. A simple Web Part URL can be used to open the Inbox of any mailbox. A more complex Web Part URL could be used to specify the mailbox to open, the folder within that mailbox to open, and the content view to use.

В зависимости от мер безопасности, используемых в сети, может потребоваться настройка кодировки для URL-адреса веб-частей. Когда вы настроите кодировку, вспомогательный код пользовательского интерфейса создаст URL-адрес, используя параметры с URL-кодировкой. В параметрах с URL-кодировкой пробелы заменяются сочетанием %20, а разделители пути "/" — сочетанием %2f. Во всех примерах данной статьи используются параметры с кодировкой.Depending on the security measures that have been applied to your network, you may have to configure encoding for the Web Parts URL. After you configure the encoding, the code behind the UI will create the URL by using the URL-encoded parameters. URL-encoded parameters use %20 in place of spaces and %2f in place of the path delimiter "/". All examples in this topic use encoded parameters.

В следующей таблице приведены параметры веб-части и примеры их использования.The following table lists the parameters of a Web Part and examples of how they're used.

Параметры веб-части и способы их использованияWeb Part parameters and how they're used

Параметр URL-адресаURL parameter ОписаниеDescription Значения и примерыValues and examples

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

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

Это может быть тот же URL-адрес, который используется для входа в Outlook Web App, например:This may be the same URL that users use to sign in to Outlook Web App, for example:

https://<имя сервера>/OWAhttps://<server name>/owa

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

Любой SMTP-адрес, сопоставленный с открываемым почтовым ящиком.Any SMTP address that's associated with the mailbox to be opened.

Если этот раздел URL-адреса не указан, открывается почтовый ящик по умолчанию для пользователя, прошедшего проверку подлинности.If this section of the URL is missing, the default mailbox of the authenticated user is opened.

Если дополнительные параметры не заданы, по умолчанию открывается папка "Входящие".If no additional parameters are specified, the default behavior is to open the Inbox.

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

https://<имя сервера>/owa/ tsmith@fourthcoffee.comhttps://<server name>/owa/tsmith@fourthcoffee.com

cmd (требуется при указании любых параметров, отличных от идентификатора почтового ящика для явного входа)cmd (required if you're specifying any parameter other than the explicit logon mailbox identification)

При использовании "?cmd=contents" отображается веб-часть Outlook Web App, заданная параметрами, а не весь пользовательский интерфейс Outlook Web App.?cmd=contents displays the Outlook Web App Web Part that's specified by the parameters instead of the full Outlook Web App user interface.

Если почтовый ящик не задан, то параметр cmd указывается после адреса входа:If no mailbox is specified, the cmd parameter comes after the sign-in address, as follows:

https://<имя сервера>/owa/?cmd = содержимоеhttps://<server name>/owa/?cmd=contents

Если почтовый ящик задан, то параметр cmd указывается после идентификатора почтового ящика для явного входа:If a mailbox is specified, the cmd parameter comes after the explicit mailbox identification, as follows:

https://<имя сервера>/owa/<SMTP-адрес>/?cmd = содержимоеhttps://<server name>/owa/<SMTP address>/?cmd=contents

Если дополнительные параметры не заданы, по умолчанию открывается папка "Входящие".If no additional parameters are specified, the default behavior is to open the Inbox.

exsvurlexsvurl

Этот параметр нужно включить при использовании проверки подлинности с помощью LiveID.This parameter must be included when using LiveID authentication

Все параметры будут потеряны во время проверки подлинности LiveID, если "exsvurl = 1" не установлена. Этот параметр не только почтовых ящиков Office 365.All parameters will be discarded during LiveID authentication if "exsvurl=1" is not present. This parameter is for Office 365 mailboxes only.

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

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

Возможно, для этой части URL-адреса потребуется использовать URL-кодировку, чтобы он не блокировался брандмауэрами.THis part of the URL may have to be written by using URL encoding so that it can pass through firewalls.

При использовании URL-кодировки пробелы заменяются сочетанием %20, а разделители пути "/" — сочетанием %2f.When you use URL encoding, a space becomes %20, and a path delimiter (/) becomes %2f.

Иерархия папок должна начинаться с корня почтового ящика.The folder hierarchy should start from the mailbox root.

Путь к папке может вести к обычной папке или папке поиска.This folder path can point to ordinary folders or search folders.

Чтобы открыть вложенную папку "Projects" папки "Входящие", введите следующий URL-адрес:To open the subfolder Projects in the Inbox, use the following URL:

https://<имя сервера>/owa/?cmd = содержимое&fpath = 2fprojects % папки "Входящие"https://<server name>/owa/?cmd=contents&fpath= inbox%2fprojects

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

Этот параметр можно использовать для указания любой из папок по умолчанию без ввода ее локализованного имени.This parameter can be used to specify any of the default folders without knowing the localized name.

Значения параметра module вводятся без учета регистра и включают следующее:Values for the module parameter aren't case sensitive, and include the following:

  • Inbox;Inbox

  • Calendar;Calendar

  • Teammailbox.Teammailbox

Чтобы открыть календарь почтового ящика вне зависимости от его локализации, введите следующий URL-адрес:To open the calendar of a mailbox regardless of localization, use the following URL:

https://<имя сервера>/owa/?cmd = содержимое&модуль = календаряhttps://<server name>/owa/?cmd=contents&module=calendar

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

Этот параметр определяет представление папки.This parameter specifies the view to be displayed for the folder.

Если этот параметр не указан, по умолчанию используются следующие представления:The default views when this parameter is not present are as follows:

  • Ежедневно календаряCalendar Daily

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

Примечание

Строки для представлений по умолчанию автоматически получают URL-кодировку.The strings for the default views are automatically URL encoded.

Сортировка по умолчанию для представления — это сортировка папки при ее открытии в клиенте Outlook Web App.The default sort for a view is the way the folder would be sorted if it was opened in the Outlook Web App client.

Строки, определяющие представления, не локализуются и вводятся без учета регистра.The strings identifying the views aren't localized and are not case sensitive.

Доступные представления зависят от типа папки.The views available vary according to the folder type.

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

  • Ежедневно Ежедневное представление "Календарь"Daily The daily calendar view

  • Еженедельно еженедельно представление "Календарь"Weekly The weekly calendar view

  • Ежемесячно ежемесячный представление "Календарь"Monthly The monthly calendar view

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

  • Представление сообщений сообщений, с сортировки по умолчаниюMessages Message view, with default sort

  • % 20Sender сообщение представлении упорядочиваются из с именами отправителя, который начинается с "" верхней части окнаBy%20Sender Message view sorted by From with sender names that begin with "a" on top

  • Путем просмотра сообщений 20Subject %, отсортированные по темам с тем, который начинается с "" верхней части окнаBy%20Subject Message view sorted by Subject with subjects that begin with "a" on top

  • С % 20Conversation % 20Topic беседы просмотра, не доступны в облегченную версию Outlook Web AppBy%20Conversation%20Topic Conversation View, not available in the light version of Outlook Web App

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

Определяют, за какую дату необходимо отобразить данные календаря. Эти параметры можно вводить в любом порядке, вместе или по отдельности.Specifies the date for which the calendar should be displayed. These parameters can be entered in any order and can be used singly or together.

Если какие-либо из этих параметров не указан, значения по умолчанию — текущие значения день, месяц и год. Например, если текущий день является 3 мая 2016 и укажите значение месяца "9" за сентябрь, отображаются дата будет 3 сентября 2016.If any of these parameters aren't specified, the default values are the current day, month, and year values. For example, if the current day is May 3, 2016 and you specify a month value of "9" for September, the date displayed will be September 3, 2016.

Допустимы следующие значения:The valid values for the data parameters are as follows:

d=[1-31]d=[1-31]

m=[1-12]m=[1-12]

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

Чтобы открыть календарь до текущей даты 3 мая 2016, используйте следующий URL-адрес: https://<имя сервера>/owa/?cmd = содержимое&fpath = календаря&представление = ежедневно&d = 3&m = 5&y = 2016To open a calendar to the date May 3, 2016, you would use the following URL: https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016

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

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

При использовании веб-частей для доступа к содержимому Outlook Web App будет отображаться не весь пользовательский интерфейс Outlook Web App. Параметр part еще более уменьшает выводимый пользовательский интерфейс. Следующий пример URL-адреса отображает список задач в формате самой маленькой веб-части: When you use Web Parts to access Outlook Web App content, the UI that is displayed will be smaller than the full Outlook Web App UI. The part parameter reduces the UI further. The following example URL shows the Tasks list in the smallest Web Part format:

https://<имя сервера>/owa/?cmd = содержимое&часть = 1https://<server name>/owa/?cmd=contents&part=1

Параметр part не применяется к модулю календаря.The part parameter doesn't apply to the calendar module.

FolderListFolderList

Этот параметр части включает элемент управления списком папок и позволяет пользователям переходить между вложенными папками. Применяется только к папкам электронной почты.This part parameter includes the folder list control for users to switch between subfolders. This only applies to email folders.

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

Ввод пути к веб-частям Outlook Web App вручнуюEnter Outlook Web App Web Parts manually

Путь к веб-частям Outlook Web App можно также вводить вручную в веб-браузере. Например, пользователь может использовать URL-адрес веб-части Outlook Web App, чтобы открыть календарь другого пользователя.Outlook Web App Web Parts can be also be entered manually in a Web browser. For example, a user can use an Outlook Web App Web Part URL to open another user's calendar.

Приведенные ниже примеры показывают, как получать непосредственный доступ к распространенным представлениям Outlook Web App:The following examples show how to directly access common Outlook Web App views:

  • Папки "Входящие": https://<имя сервера>/owa/?cmd = содержимое&модуль = папки "Входящие"Inbox: https://<server name>/owa/?cmd=contents&module=inbox

  • Календаря (сегодня): https://<имя сервера>/owa/?cmd = содержимое&модуль = календаря&exsvurl = 1Calendar (today): https://<server name>/owa/?cmd=contents&module=calendar&exsvurl=1

  • Календаря (еженедельно): https://<имя сервера>/owa/?cmd = содержимое&модуль = календаря&представление еженедельно =&exsvurl = 1Calendar (weekly): https://<server name>/owa/?cmd=contents&module=calendar&view=weekly&exsvurl=1

  • Календаря (ежемесячно): https://<имя сервера>/owa/?cmd = содержимое&модуль = календаря&представление = ежемесячно&exsvurl = 1Calendar (monthly): https://<server name>/owa/?cmd=contents&module=calendar&view=monthly&exsvurl=1

Дополнительные сведенияFor More Information