Elementos WebLayout y Control

Elemento secundario opcional para un grupo dentrode WebLayout. Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo.

<Control FieldName="FieldName" Type="DateTimeControl | ExtensionsControl |  
FieldControl | HtmlFieldControl | LabelControl | WebpageControl"  
Label="LabelText" EmptyText="TextString" 
ReadOnly="True | False" Name="InstanceName" />

Vea Control element attributes and control type (Atributos de elemento de control y tipo de control)para obtener información sobre cada atributo.

Elemento secundario opcional de Group dentro de WebLayout que se usa para especificar una extensión de elemento de trabajo de nivel de campo para que aparezca en el formulario.

<ControlContribution Id="ContributionId" Label="Name">  
<Inputs>  
<Input Id="FieldName" Value="Value" />  
</Inputs>  
</ControlContribution>  

El valor de ContributionId que especifique debe instalarse en la colección de cuentas o proyectos. Los archivos de definición de WIT que exporte contienen una lista de contribuciones instaladas.

Elemento secundario requerido para Extensions. Use para especificar un identificador de extensión de una extensión de control de elemento de trabajo que se mostrará en el formulario de elemento de trabajo. Debe especificar cada extensión que se usa en el diseño para un elemento ControlContribution, GroupContributiono PageContribution.

<Extension Id="ExtensionId" />  

El valor de ExtensionId que especifique debe instalarse en la colección de cuentas o proyectos. Los archivos de definición de WIT que exporte contienen una lista de extensiones instaladas.

Elemento secundario contenedor opcional de WebLayout que se usa para admitir la especificación de uno o varios elementos Extension. Si se usan extensiones en el formulario, es especificarlas antes de un elemento Page.

<WebLayout >  
<Extensions >  
<Extension Id="ExtensionId" />  
. . .   
</Extensions>   
. . .
</WebLayout>  

Elemento secundario requerido de WITD que se usa para especificar el diseño y los controles que aparecen en el formulario de elemento de trabajo. Elemento primario para los elementos Layout (diseño de formulario de cliente) y WebLayout (diseño de formulario web).

<FORM>  
<Layout> . . . </Layout>  
<WebLayout> . . . </WebLayout>  
</FORM>  

Elemento secundario requerido de Section. Proporciona una agrupación visual de elementos dentro de una sección que puede etiquetar.

<Group Label="LabelText"   
<Control> . . . </Control>  
</Group>  

Elemento secundario opcional de Section en WebLayout que se usa para especificar una extensión de elemento de trabajo de nivel de grupo para que aparezca en el formulario. La extensión aparecerá como un grupo dentro del formulario.

<GroupContribution Id="ContributionId" Label="Name" />  

El valor de ContributionId que especifique debe instalarse en la colección de cuentas o proyectos. Los archivos de definición de WIT que exporte contienen una lista de contribuciones instaladas.

Elemento secundario requerido para inputs que especifica los datos de entrada de una extensión.

<Input Id="FieldName" Value="Value" />  

Elemento secundario contenedor opcional para ControlContribution que se usa para admitir la especificación de datos de entrada para una extensión.

<Inputs>
<Input Id="FieldName" Value="Value" />  
</Inputs>

Elemento secundario requerido de WebLayout. Define el diseño de una página dentro del formulario web.
Especifique el nombre de la página y el diseño que se usará.

<Page Label="PageName" LayoutMode="FirstColumnWide | EqualColumns ">  
<Section>    
<Group> . . .   
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  

Elemento secundario opcional de WebLayout que se usa para especificar una extensión de elemento de trabajo de nivel de página para que aparezca en el formulario. La extensión aparecerá como una página dentro del formulario.

<PageContribution Id="ContributionId" Label="Name"  />  

El valor de ContributionId que especifique debe instalarse en la colección de cuentas o proyectos. Los archivos de definición de WIT que exporte contienen una lista de contribuciones instaladas.

Elemento secundario requerido de Page. Define el diseño de una sección dentro de una página del formulario web. Las secciones forman grupos que admiten el tamaño variable. Se puede definir un límite de cuatro secciones dentro de una página.

<Page>  
<Section>    
<Group> . . .   
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  

Elemento secundario requerido para WebLayout. Define las etiquetas y los valores de texto vacíos para los controles presentes en el encabezado del formulario web . Esto también incluye las etiquetas de las páginas Historial,Vínculosy Datos adjuntos.

<SystemControls>    
<Control Type="FieldControl" FieldName="System.Title" EmptyText="Enter title" />   
<Control Label="Assi&gned To" Type="FieldControl" FieldName="System.AssignedTo" />  
<Control Label="Stat&e" Type="FieldControl" FieldName="System.State" />  
<Control Label="Reason" Type="FieldControl" FieldName="System.Reason" />  
<Control Label="&Area" Type="WorkItemClassificationControl" FieldName="System.AreaPath" />  
<Control Label="Ite&ration" Type="WorkItemClassificationControl" FieldName="System.IterationPath" />  
<Control Label="History" Type="WorkItemLogControl" FieldName="System.History" />  
<Control Label="Links" Type="LinksControl" Name="Links" />  
<Control Label="Attachments" Type="AttachmentsControl" Name="Attachments" />  
</SystemControls>  

Elemento secundario requerido de FORM. Define el diseño del formulario de elemento de trabajo que se muestra en el portal web. Incluye uno o varios elementos Page.

<WebLayout>  
<Page>  
<Section>  
<Group> . . . 
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  
. . .
</WebLayout>

Descripción

Opcional. Especifica el campo de elemento de trabajo al que está asociado el control. Especifique el nombre de referencia del campo que debe tener entre 1 y 70 caracteres.

Obligatorio. Especifica el tipo de datos del control. Especifique una cadena de uno de estos tipos integrados:

• DateTimeControl:se usa para mostrar campos de fecha con formato con un tipo de campo dateTime.
• FieldControl:se usa para mostrar valores booleanos, texto sin formato, campos numéricos, campos de nombre de persona y listas de selección. Admite campos con un tipo de datos booleano, Double, Identity, Integer,PlainTextm y String.
  
  

Disponibilidad de características: El campo Tipo de datos booleano es compatible con TFS 2017 y versiones posteriores.

• HtmlFieldControl:se usa para mostrar el formato de texto enriquecido de varias líneas de campos con un tipo de campo HTML.
• LabelControl:se usa para mostrar texto que no está asociado a un campo. El texto puede ser sin formato o hipervinculado. Puede especificar controles adicionales mediante los elementos LabelText, Linky Text.
• WebpageControl:se usa para mostrar contenido basado en HTML definido por un URI o insertado dentro de una etiqueta CDATA. Este control no tiene asociado ningún campo o tipo de campo. Especifique el contenido y los vínculos que se mostrarán mediante el elemento WebpageControlOptions.

Opcional. Especifica una cadena de texto que contiene entre 1 y 255 caracteres y que aparece cuando un campo está vacío.

Opcional. Especifica el texto visible en el formulario que identifica el control. Escriba una cadena que no supere los 80 caracteres. Si no se especifica, se usa el nombre descriptivo FieldName de .

Opcional. Especifica que el campo es de solo lectura:

• True:el campo de control es de solo lectura.
• False:el campo de control no es de solo lectura.

Opcional. Identifica un control de forma exclusiva. El nombre es importante si hay más de un control en el formulario asociado al mismo campo de elemento de trabajo.

Opcional. Especifique Visible="false" cuándo desea ocultar un campo que normalmente se incluye dentro del área de encabezado. Solo puede especificar este atributo junto con los campos System.Reason, System.AreaPath o System.IterationPath. Si especifica este atributo, no puede Replaces especificarlo.

Opcional. Especifique FieldName="ReplacementFieldRefName" Replaces="FieldRefName" cuándo desea reemplazar un campo dentro del área de encabezado por otro campo. Solo puede especificar este atributo junto con los campos System.Reason, System.AreaPath o System.IterationPath. Si especifica este atributo, no puede Visible especificarlo. Además, debe quitar la entrada del campo que va a reemplazar desde dentro de la sección .

Descripción

Use para mostrar campos de fecha con formato con un tipo de datos de DateTime . Use FieldControl para proporcionar un campo de texto para la entrada o la presentación de un campo DateTime.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" 
Label="Start Date" LabelPosition="Left" />

Use DateTimeControl para proporcionar un selector de calendario para seleccionar una fecha para un campo, como se muestra en la ilustración siguiente.

<Control Type="DateTimeControl" FieldName="FabrikamFiber.Schedule.SubmittedDate" 
Label="Submitted Date:" LabelPosition="Left"  Format="Short" />

Use para mostrar campos con un tipo de datos booleano, cadena, identidad, entero, doble y texto sin formato. Por ejemplo:

<Control Type="FieldControl" FieldName="FabrikamFiber.Milestone" 
Label="Milestone" Name="Milestone" LabelPosition="Left" />

Disponibilidad de características: El campo Tipo de datos booleano solo es compatible con TFS 2017 y versiones posteriores. Dentro de un formulario de elemento de trabajo de cliente, como Visual Studio o Eclipse, se mostrará un valor de True o False.

Un campo booleano se muestra como una casilla dentro del formulario de elemento de trabajo web.

Use para mostrar el control con formato de texto enriquecido de varias líneas. Especifique este tipo de control para los campos de Type=HTML .

Por ejemplo:

<Control Type="HtmlFieldControl" FieldName="FabrikamFiber.ReleaseNotes" 
Label="Release Notes" Dock="Fill" />

Use para mostrar texto que no está asociado a un campo. El texto puede ser sin formato o hipervinculado. Puede especificar controles adicionales mediante los elementos LabelText, Linky Text. Vea LabelText y Text XML elements reference (Referencia de elementos XML LabelText y Text) y Link and Param XML elements reference (Referenciade elementos XML de vínculo y param).

Use para mostrar contenido basado en HTML definido por un URI o insertado dentro de una etiqueta CDATA. Este control no tiene asociado ningún campo o tipo de campo. Especifique el contenido y los vínculos que se mostrarán mediante el elemento WebpageControlOptions.

El elemento WebpageControlOptions y sus elementos secundarios tienen la siguiente estructura de sintaxis:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >  
<Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters" >  
<Param index="IndexValue" value="ParamValue" type ="Original | Current">  
</Link>  
<Content>  
<![CDATA[Contents of HTML]]/>  
<Content/>  
<WebpageControlOptions/>

Use los elementos Content, LabelTexty Link para definir texto sin formato o etiquetas con hipervínculos, agregar hipervínculos a un campo o mostrar el contenido de la página web en un formulario de elemento de trabajo. Consulte Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo para obtener más información sobre la sintaxis.

Descripción