Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo
Al personalizar el formulario de elemento de trabajo, puede que desee proporcionar información o vínculos a contenido que ayude al equipo a definir los campos del formulario. Si incrusta información en el formulario o hace que esté disponible fácilmente, los miembros del equipo podrán realizar el seguimiento de datos útiles más fácilmente.
Mediante los controles de formulario que se describen en este tema, puede agregar texto de información sobre herramientas para campos individuales, texto independiente o hipervínculos a páginas web o incrustar contenido HTML o contenido web en el formulario.
Para modificar el formulario de elemento de trabajo, modifique la definición del tipo de elemento de trabajo. Puede usar la herramienta de línea de comandos witadmin (vea Importar, exportar y administrar tipos de elementos de trabajo [witadmin]) o el Editor de procesos.
El Editor de procesos es un complemento de herramienta avanzada para Visual Studio que puede descargar e instalar. Situado en el menú Herramientas, el Editor de procesos proporciona una interfaz gráfica de usuario para personalizar objetos que se usan para realizar el seguimiento de elementos de trabajo en Team Foundation Server. Puede usar esta herramienta para importar y exportar tipos de elementos de trabajo y modificar sus definiciones. Para más información, vea la siguiente página del sitio web de Microsoft: Herramientas avanzadas de Team Foundation Server.
Proporcionar texto de ayuda o texto de información sobre herramientas
Puede proporcionar el texto de ayuda de dos maneras. En el primer método, deberá agregar el elemento HELPTEXT como elemento secundario del elemento FIELD en la sección FIELDS de la definición de tipos. Mediante HELPTEXT, cree la información sobre herramientas para el campo. Está limitado a 255 caracteres con este método.
<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>
En el segundo método, especifique texto independiente mediante los elementos secundarios LabelText y Text. En este método, puede agregar tanta información como desee y después el texto siempre estará presente en el formulario. No es necesaria ninguna acción por parte del usuario. También puede agregar un vínculo opcional con el elemento Link para más información, como se muestra en el ejemplo siguiente.
<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>
Agregar etiquetas independientes de campo de texto y de hipervínculo
Puede agregar texto a un formulario de elemento de trabajo que no esté asociado a ningún campo de elemento de trabajo mediante el uso de la opción Type del atributo LabelControl del elemento Control. El texto puede ser sin formato o un hipervínculo. Además, puede adjuntar un hipervínculo a una etiqueta de campo agregada mediante el uso de la opción FieldControl.
Ejemplo: etiqueta de texto sin formato
En el ejemplo siguiente se agrega el texto sin formato "Rellene los detalles del error aquí. Se recomienda rellenar los campos que no sean necesarios." al campo de elemento de trabajo.
<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />
Ejemplo: etiqueta de campo con hipervínculo
En el ejemplo siguiente se muestra cómo agregar un hipervínculo a una etiqueta de campo.
<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
<LabelText>
<Text>
<Link UrlRoot="http://www.live.com/" />
Title 2
</Text>
</LabelText>
</Control>
Nota
Para los clientes de Team Foundation que no se actualizaron a la versión más reciente, aparece el texto de atributo Label.Para los clientes de Visual Studio 2012, la etiqueta Texto se muestra como un hipervínculo en el que se define la dirección URL mediante la etiqueta Link.
Ejemplo: etiqueta de campo con hipervínculo para la parte del texto
En el ejemplo siguiente se muestra cómo agregar un hipervínculo a una parte de una etiqueta de campo. En este ejemplo, la dirección URL está determinada por los valores que se asignan a los elementos Param basándose en el elemento de trabajo específico.
<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>
Ejemplo: etiqueta de texto con hipervínculo
Etiqueta de texto con hipervínculo
.png "Ejemplo de hipervínculo aplicado a una etiqueta independiente")
En el ejemplo siguiente se muestra cómo agregar un hipervínculo al texto mostrado en un formulario de elemento de trabajo.
<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>
Ejemplo: combinar texto e hipervínculos en una etiqueta única
Combinar texto e hipervínculos en una etiqueta única
.png "Ejemplo de dos hipervínculos aplicados a texto")
En el ejemplo siguiente se muestra cómo agregar dos hipervínculos a partes de una etiqueta en un formulario de elemento de trabajo.
<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>
Ejemplo: etiqueta de campo con hipervínculo generada por parámetros
En el ejemplo siguiente se muestra cómo agregar un hipervínculo a una etiqueta de campo que se genera a partir de los valores de parámetros que se evalúan para el elemento de trabajo abierto.
<Control Type="FieldControl" FieldName="System.State" Label="&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>
Mostrar contenido web
Puede usar la opción Type del atributo WebpageControl para mostrar contenido web en el formulario de elemento de trabajo como un control, en lugar de vincular a una página web independiente. Esta pantalla puede ser útil para proporcionar las métricas que admiten los miembros del equipo para ver el contenido de un informe, panel u otro contenido basado en HTML. Puede proporcionar un vínculo al contenido o incrustar el contenido HTML sin formato en una etiqueta de CDATA.
Ejemplo: mostrar contenido proporcionado por un URI
En el ejemplo siguiente se muestra cómo se puede incrustar el contenido de una página web proporcionando la dirección URL a la página mediante el uso de elementos WebpageControlOptions y 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>
Ejemplo: mostrar contenido proporcionado en una etiqueta CDATA
En el ejemplo siguiente se muestra cómo agregar contenido HTML a un formulario de elemento de trabajo que se encuentra en una etiqueta CDATA.
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Place HTML Formatted Content Here ]]
</Content>
</WebpageControlOptions >
</Control>
Incrustar la guía de procesos
Para que haya una guía de procesos disponible en el formulario de elemento de trabajo, puede que desee agregar una pestaña que contenga información sobre el flujo de trabajo y el uso del tipo de elemento de trabajo. Puede hacerlo mediante la opción Type del atributo WebpageControl. Esta opción proporciona compatibilidad con la incrustación de texto con formato enriquecido e imágenes en el formulario mediante el uso de los elementos secundarios WebpageControlOptions y 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>
Vea también
Conceptos
Diseñar el formulario de elemento de trabajo
Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo