Шаг 5 (необязательный). Создание области формы Outlook (OFS-файл) и манифеста области формы (файл FormRegionManifest.xml)

Статья
09/18/2014

Файл области формы Microsoft Outlook содержит макет для несопоставленных свойств (полей) из внешнего источника данных. Этот файл области формы связан с файлом манифеста области формы, который содержит сведения, необходимые Outlook для загрузки области формы.

Дата последнего изменения: 22 августа 2011 г.

Применимо к: SharePoint Server 2010

Для простых решений службы Microsoft Business Connectivity Services (BCS) по умолчанию создают область формы для отображения дополнительных несопоставленных полей из внешнего источника данных. Эти поля отображаются как расширенные свойства Business Connectivity Services в прилегающей области формы инспектора Outlook, если количество таких полей не превышает пяти, и в отдельной области формы в противном случае. В промежуточном декларативном решении Outlook в файле манифеста области формы можно указать, где будут отображаться несопоставленные поля. В таблице 1 описаны различные места в Outlook, где может отображаться область формы Outlook, содержащая несопоставленные поля.

Таблица 1. Расположения области формы Outlook

Расположение области формы	Описание
Разделить	Добавляет область формы в качестве новой страницы на форме Outlook.
Присоединение	Прикрепляет область формы к нижней части страницы по умолчанию формы Outlook.
Замена	Заменяет страницу формы по умолчанию на указанный файл хранилища форм Outlook (OFS-файл).
Заменить все	Заменяет форму на указанный файл хранилища форм Outlook (OFS-файл).

Если в промежуточном декларативном решении Outlook требуется настраиваемая область формы, создайте файл хранилища форм Outlook (OFS-файл), содержащий макет для несопоставленных свойств (полей) из внешнего источника данных. При этом также потребуется создать файл манифеста области формы. Этот файл содержит сведения, необходимые Outlook для загрузки области формы. Для получения дополнительных сведений об XML-схемах для областей форм загрузите документ Справочник по Office 2010: XML-схема пользовательского интерфейса Office Fluent (Возможно, на английском языке) и перейдите к разделам "Манифест области формы" и "Манифест локализации области формы".

Создание области формы в Outlook

В меню Файл приложения Outlook выберите пункт Параметры, выберите пункт Настройка ленты и в разделе Основные вкладки установите флажок Разработчик. На ленте появится вкладка Разработчик.
На вкладке Разработчик в группе Настраиваемые формы нажмите кнопку Создать форму. Затем выберите конструктор форм в зависимости от типа элемента Outlook (в данном случае контакт). В группе Конструктор нажмите кнопку Создать область формы.
В группе Сервис нажмите кнопку Панель элементов управления.
Перетащите необходимые элементы управления из окна Панель элементов на область формы (в данном примере начните с элемента управления TextBox).
Щелкните элемент управления правой кнопкой мыши, а затем выберите пункт Свойства.
В диалоговом окне Свойства на вкладке Значение нажмите кнопку Создать, расположенную рядом со списком Выбрать поле.
В диалоговом окне Новый столбец введите в поле Имя имя атрибута PropertyName в поле OfficeItemProperty манифеста решения (OIR.config), а затем выберите соответствующий тип, например Целое число или Дата и время. Чтобы закрыть диалоговое окно, нажмите кнопку ОК.
Чтобы закрыть диалоговое окно Свойства, нажмите кнопку ОК.
Добавьте аналогичным образом все остальные свойства.
Добавьте или измените надписи или структуру формы необходимым образом.
В группе Конструктор нажмите кнопку Область формы, а затем выберите команду Сохранить область формы как. Присвойте области формы имя formRegionCustomer.ofs и сохраните файл в папку Solution Artifacts.
Затем создайте файл манифеста области формы. Для создания файла манифеста области формы на основе модели подключения к бизнес-данным можно воспользоваться средством создания артефактов BCS (Возможно, на английском языке).

Либо создать манифест области формы можно вручную следующим образом.
1. Скопируйте файл шаблона из пакета SDK SharePoint 2010 (см. статью Шаблон: FormRegionManifest.xml) и сохраните его в папку Solution Artifacts под именем formRegionCustomer.manifest.xml.
2. Откройте файл formRegionManifest.xml в XML-редакторе. При открытии XML-файла в Visual Studio присоедините схему FormManifest. Это позволит использовать возможности технологии IntelliSense при создании записей.
3. Замените значения, отмеченные EnterX в XML-коде, на допустимые значения. В следующем примере XML-кода показано, как файл может выглядеть после редактирования.
```
<?xml version="1.0" encoding="utf-8"?>
<FormRegion xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
            xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            xmlns="https://schemas.microsoft.com/office/outlook/12/formregion.xsd">
  <icons>
    <page>addin</page>
  </icons>
  <name>CustomerForm</name>
  <formRegionType>adjoining</formRegionType>
  <exactMessageClass>false</exactMessageClass>
  <layoutFile>formRegionCustomer.ofs</layoutFile>
  <title>Customer Details</title>
</FormRegion>
```
4. Сохраните и закройте файл.
Теперь можно обновить файл OIR.config с использованием сведений о настраиваемой области формы. Помните, что этот файл будет использоваться в клиентской среде BCS для определения компонентов, входящих в декларативное решение. Найдите элемент <FormRegions> и замените его на следующий код.
```
<FormRegions xsl:type="Declarative:DeclarativeFormRegions">
  <FormRegion Name="Customer" InternalName="CustomerForm" 
              FormFileName="formRegionCustomer.ofs" 
              ManifestFileName="formRegionCustomer.manifest.xml" />
</FormRegions>
```
Сохраните и закройте файл.

Вы успешно создали настраиваемую область формы и файл манифеста области формы, предназначенные для расширения возможностей промежуточного декларативного решения Outlook и также обновили файл OIR.config на основе этих сведений. Теперь необходимо заново упаковать решение, развернуть его в Outlook и протестировать, чтобы убедиться в его исправности.

Следующие действия

Шаг 6 (необязательный). Создание настраиваемых определений представлений Outlook (OVD-файлов)

Поделиться через

Шаг 5 (необязательный). Создание области формы Outlook (OFS-файл) и манифеста области формы (файл FormRegionManifest.xml)

Создание области формы в Outlook

Следующие действия

Дополнительные ресурсы