Добавление веб-содержимого в форму рабочего элемента с помощью изменения определения WIT

Статья
06/10/2015

Веб- или HTML-содержимое можно добавить в форму рабочего элемента путем экспорта XML-файла определения типа и добавления WebpageControl в раздел FORM. После изменения и импорта XML-файла можно проверить отображение веб-содержимого в обновленном типе рабочего элемента.

Отображаемое веб-содержимое можно задать одним из следующих способов.

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

Сведения о синтаксической структуре элементов, используемых для добавления веб-содержимого в тип рабочего элемента (WIT), см. в разделах Справка по XML-элементам WebpageControlOptions и Справка по XML-элементам Link и Param.

Требования

Нужно быть членом группы Администраторы проекта командного проекта. См. раздел Добавление пользователей в командные проекты.

Экспорт и открытие файла определения типа рабочего элемента

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

При изменении типа рабочего элемента для отдельного проекта:
1. Выполните witadmin exportwitd для повторного экспорта XML-файла для типа рабочего элемента, который необходимо изменить. Для получения дополнительной информации см. Импорт и экспорт типов рабочих элементов и управление ими [witadmin].
2. В Visual Studio последовательно щелкните Файл, Открыть, Файл.
3. В списке Искать в перейдите к папке, в которую был экспортирован файл.
При изменении типа рабочего элемента для настройки шаблона процесса:
1. Найдите папку, в которую был загружен шаблон процесса.
2. Выберите XML-файл типа рабочего элемента, который нужно обновить, и нажмите кнопку Открыть. При выводе запроса об окончаниях строк нажмите кнопку Нет.

Добавление веб-содержимого в раздел FORM файла определения

Найдите раздел <TabGroup> XML-файла. Обратите внимание, что для таких элементов, как "Ссылки" и "Вложения файлов" имеются отдельные элементы <Tab>, и каждый из элементов <Tab> содержит элемент <Control>, который отвечает за отображение соответствующего элемента управления.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```
Добавьте новый элемент <Tab>, который будет содержать веб- или HTML-содержимое для отображения в форме рабочего элемента. Скопируйте следующий код в раздел <TabGroup> файла в зависимости от способа определения веб-содержимого.
- Задание URL-адреса веб-страницы
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>
```
  Замените Название вкладки и URL Веб-страницы информацией, которая должна отображаться в форме рабочего элемента.
- Задание динамического URL-адреса, определяемого во время выполнения
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>
```
  Замените Подпись вкладки, URL веб-страницы, URL путь с настройками и Значение параметра 1, 2, и 3 информацией, которая должна отображаться в форме рабочего элемента.
- Задание HTML-содержимого
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
  Замените Подпись вкладки и Содержимое HTML информацией, которая должна отображаться в форме рабочего элемента.
  
  Примечание
  
  Для получения наилучших результатов каждый элемент управления или группа должны отображаться в колонке, даже если колонка занимает всю ширину формы.Каждый столбец, в свою очередь, должен отображаться в группе, даже если группа не имеет отображаемой метки или границы.
Сохраните изменения в XML-файле.
Используйте witadmin importwitd для импорта нового типа рабочего элемента в отдельный проект. Чтобы добавить тип рабочего элемента в шаблон процесса, см. раздел Добавление определений типов рабочих элементов в шаблон процесса.

Проверка отображения веб-страницы или HTML-содержимого в форме

В Team Explorer откройте рабочие элементы для командного проекта, который содержит измененное вами определение типа рабочего элемента, и щелкните Обновить.

С сервера будут загружены последние обновления, включая только что импортированные изменения. Подождите несколько секунд, пока не обновится узел Рабочие элементы. Узлы, находящиеся в процессе загрузки, помечаются словом работает.
Создайте рабочий элемент с помощью измененного типа рабочего элемента.

Убедитесь, что веб-страница или HTML-содержимое отображаются в форме ожидаемым образом.
Нажмите кнопку Закрыть, чтобы закрыть новый рабочий элемент.