Добавление веб-содержимого в форму рабочего элемента

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

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

• URL-адрес веб-страницы

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

• HTML-содержимое

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

Содержание раздела

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

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

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

Необходимые разрешения

Для выполнения этой процедуры необходимо быть членом группы Администраторы Team Foundation или участником группы Администраторы проекта для проекта. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

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

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

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

  При изменении типа рабочего элемента для отдельного проекта:

  1. Выполните witadmin exportwitd для повторного экспорта XML-файла для типа рабочего элемента, который необходимо изменить. Дополнительные сведения см. в разделе Экспорт и импорт типов рабочих элементов из существующего проекта.

  2. В Visual Studio в меню Файл выберите команду Открыть, а затем выберите пункт Файл.

     Откроется диалоговое окно Открытие файла.

  3. В списке Искать в перейдите к папке, в которую был экспортирован файл.

  При изменении типа рабочего элемента для настройки шаблона процесса:

  1. Найдите папку, в которую был загружен шаблон процесса.

  2. Выберите XML-файл типа рабочего элемента, который нужно обновить, и нажмите кнопку Открыть. При выводе запроса об окончаниях строк нажмите кнопку Нет.

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

Добавление веб-содержимого в форму рабочего элемента

1. Найдите раздел <TabGroup> XML-файла. Обратите внимание, что для таких элементов, как "Links" (ссылки) и "File Attachments" (файловые вложения) имеются отдельные элементы <Tab>, и каждый из элементов <Tab> содержит элемент <Control>, который отвечает за прорисовку соответствующего элемента управления.

   <Tab Label="Links">
     <Control Type="LinksControl" />
   </Tab>
   <Tab Label="File Attachments">
     <Control Type="AttachmentsControl" />
   </Tab>
   

2. Добавьте новый элемент <Tab>, который будет содержать веб- или HTML-содержимое для отображения в форме рабочего элемента. Скопируйте следующий код в раздел <TabGroup> файла в зависимости от способа определения веб-содержимого.

   • Задание URL-адреса веб-страницы

     <Tab Label="Tab Label">
        <Group>
           <Column PercentWidth="100">
              <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" Dock="Fill">
                 <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" Dock="Fill">
                 <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-содержимое информацией, которая должна отображаться на форме рабочего элемента.

     Примечание

     Для получения наилучших результатов каждый элемент управления или группа должны отображаться в столбце, даже если столбец занимает всю ширину формы.Каждый столбец, в свою очередь, должен отображаться в группе, даже если группа не имеет отображаемой метки или границы.

3. Чтобы сохранить изменения в XML-файле, нажмите на панели инструментов кнопку Сохранить.

4. Сведения об импорте нового типа рабочего элемента в отдельный проект см. в разделе Экспорт и импорт типов рабочих элементов из существующего проекта. Чтобы добавить тип рабочего элемента в шаблон процесса, см. раздел Добавление определений типов рабочих элементов в шаблон процесса.

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

Проверка изменений, внесенных в форму рабочего элемента

1. В Сред. Командный обозреватель щелкните правой кнопки мыши узел командного проекта, который содержит измененное вами определение типа рабочего элемента, и выберите команду Обновить.

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

2. Создайте рабочий элемент, используя измененный вами тип рабочего элемента, для чего щелкните правой кнопкой мыши узел Рабочие элементы, укажите пункт Добавить рабочий элемент, а затем щелкните тип рабочего элемента.

   Рабочий элемент создается на основе измененного типа рабочего элемента.

   Убедитесь, что веб-страница или HTML-содержимое отображаются на добавленной вами новой вкладке.

3. Чтобы закрыть новый рабочий элемент, нажмите кнопку Закрыть. При выводе запроса на сохранение рабочего элемента нажмите кнопку Нет.

См. также

Задачи

Добавление и настройка типа рабочего элемента

Ссылки

Справка по XML-элементам WebpageControlOptions

Справка по XML-элементам Link и Param

Настройка типов рабочих элементов и управление ими [witadmin]

Основные понятия

Указание элементов управления на форме рабочего элемента

Проектирование и настройка формы рабочего элемента