Предоставление текста справки, гиперссылок или веб-содержимого в форму рабочего элемента

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

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

Изменить форму рабочего элемента можно путем изменения определения типа рабочего элемента. Вы можете использовать средство командной строки witadmin. См. раздел Импорт и экспорт типов рабочих элементов и управление ими [witadmin] или редактор процессов.

Редактор процессов является надстройкой многофункционального инструмента для Visual Studio, которую можно загрузить и установить. Расположенный в меню "Сервис", редактор процессов предоставляет графический пользовательский интерфейс для настройки объектов, используемых для отслеживания рабочих элементов в Team Foundation Server. Это средство можно использовать для импорта и экспорта типов рабочих элементов и изменения их определений. Дополнительные сведения см. на следующих страницах веб-сайта Майкрософт: Team Foundation Server Power Tools.

Предоставление текста справки или всплывающей подсказки

Можно представить текст Справки одним из двух способов. Первый способ заключается в добавлении элемента HELPTEXT в качестве дочернего элемента для элемента FIELD в разделе FIELDS определения типа. С помощью HELPTEXT создается подсказка для поля. Для этого метода действует ограничение в 255 символов.

<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>

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

<Control FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left"> 
   <LabelText>
      <Text>Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:
         <Link OpenInNewWindow="true" UrlRoot=http://ACE.ImpactStatement.aspx />
      </Text>
   </LabelText>
</Control>

Добавление отдельных меток полей текста и гиперссылки

Можно добавить текст к форме рабочего элемента без связи с каким-либо полем рабочего элемента, используя атрибут Type, вариант LabelControl элемента Control. Текст может быть обычным или в виде гиперссылки. Также можно присоединить гиперссылку к добавленной метке поля, используя вариант FieldControl.

Пример. Метка в виде обычного текста

В следующем примере добавляется простой текст «Введите детальную информацию об ошибке здесь. Необязательные поля рекомендуется заполнить» в поле рабочего элемента.

<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

Пример. Метка поля в виде гиперссылки

В следующем примере иллюстрируется добавление гиперссылки в метку поля.

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
            Title 2
      </Text>
   </LabelText>
</Control>

Примечание

Для клиентов Team Foundation, которые не обновились до последней версии, появится текст атрибута Label.Для клиентов Visual Studio 2012 тег Текст будет отображен в качестве гиперссылки, в которой URL определен тегом Link.

Пример. Метка поля, часть текста которой представляет собой гиперссылку

В следующем примере иллюстрируется добавление гиперссылки в часть метки поля. В данном примере URL определен значениями, которые назначены элементам Param на основе особого рабочего элемента.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">
            <Param Index="0" vValue"System.WorkItemType"/>         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Пример. Текстовая метка в виде гиперссылки

Текстовая метка в виде гиперссылки

В следующем примере иллюстрируется добавление гиперссылки в отображенный текст в форме рабочего элемента.

<Group>
   <Column PercentWidth="100">
      <!-- Standalone label control 2 -->
      <Control Type="LabelControl" Label="How do I use this work item?">
         <Link UrlRoot="http://www.live.com"></Link>
      </Control>
   </Column>
</Group>

Пример. Объединение текста и гиперссылок в одну метку

Объединение текста и гиперссылок в одну метку

В следующем примере иллюстрируется добавление двух гиперссылок в части меток в форме рабочего элемента.

<Group>
   <Column PercentWidth="100">
   <!-- Standalone label control 3 -->
      <Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
         <LabelText>
            <Text>Click here for </Text>
            <Text>
               <Link UrlRoot="https://www.msn.com"></Link>
               work item guidance</Text>
            <Text> or here for </Text>
            <Text>
               <Link UrlRoot="http://www.msdn.com"></Link>
               process guidance
            </Text>
         </LabelText>
      </Control>
   </Column>
</Group>

Пример. Созданная параметром метка поля гиперссылки

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

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" Value="System.State" Type ="Original"/>
   </Link>
</Control>

Отображение веб-содержимого

Можно использовать атрибут Type варианта WebpageControl для отображения веб-содержимого в форме рабочего элемента в качестве элемента управления вместо соединения его с отдельной веб-страницей. Данное отображение может быть полезным для предоставления метрик, которые поддерживают члены команды при просмотре содержимого отчета, панели или другого HTML содержимого. Можно предоставить ссылку на содержимое или на вложенное необработанное HTML содержимое в теге CDATA.

Пример. Отображение содержимого, на которое указывает универсальный код ресурса (URI)

В следующем примере показано вложение содержимого из веб-страницы путем представления URL страницы с помощью элементов WebpageControlOptions и Link.

<Tab Label="Web">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" >
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Пример. Отображение содержимого, представленного в теге CDATA

В следующем примере показано добавление HTML-содержимого в форму рабочего элемента, содержащегося в теге CDATA.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
      <![CDATA[Place HTML Formatted Content Here ]]
   </Content>
   </WebpageControlOptions >
</Control>

Внедрение руководства по процессам

Чтобы сделать доступным руководство по процессу в форме рабочего элемента, можно добавить вкладку, которая содержит информацию о рабочем процессе и использовании типа рабочего элемента. Это можно выполнить с помощью атрибута Type варианта WebpageControl Этот вариант предоставляет поддержку для встраивания формата обогащенного текста и изображений в форму с использованием дочерних элементов WebpageControlOptions и Content.

<FORM>
. . .
<TabGroup>
. . . 
   <Tab Label="Process Guidance">
      <Group>
         <Column PercentWidth="100">
            <Control Type="WebpageControl">
            <WebpageControlOptions >
            <Content>
               <![CDATA[Place HTML Formatted Process Guidance Content Here ]]>
            </Content>
            </WebpageControlOptions>
            </Control>
         </Column>
      </Group>
   </Tab>
. . .
</TabGroup>
. . .
</FORM>

См. также

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

Разработка формы рабочего элемента

Настройка объектов отслеживания работ для поддержки командных процессов