Todas as referências de elementos do formulário XML

Você pode usar as informações neste tópico, como uma referência rápida para todos os elementos e atributos principais que controlam o formulário para um tipo de item de trabalho. Esses elementos em você especifica o FORM contêiner do elemento, a terceira e última seção principal da definição de um tipo de item de trabalho. Muitos elementos são aninhados dentro de outras pessoas para formar grupos, seções ou guias em um formulário de item de trabalho. Para obter mais informações sobre como agrupar esses elementos, consulte Criar o Layout do formulário de Item de trabalho.

Neste tópico

• FORM Example

• Sintaxe dos elementos de formulário

• Atributos que especificam a elementos de formulário

• Elementos que especificam os rótulos autônomos, hiperlinks, páginas da Web ou conteúdo HTML

• Elementos que filtrar e exibem relacionamentos de Link

FORM Example

O exemplo a seguir mostra a estrutura geral do FORM elemento. Você especifica o layout de um formulário usando o Layout elemento. Você pode especificar diferentes layouts diferentes clientes de destino. Por exemplo, você pode especificar um layout para clientes Windows e um layout diferente para Team Web Access. Um layout geralmente consiste na parte superior do formulário e, em seguida, um grupo de guias. A seqüência na qual você define os elementos no layout determina a seqüência na qual os elementos aparecem no formulário.

Agrupar elementos apareçam nas colunas usando o Group e Column elementos. Você pode usar um Control elemento para definir cada campo que você deseja que apareça no formulário. Você pode usar o Tab elemento para oferecer suporte a diferentes áreas funcionais de grupos de campo.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Elementos de formulário

Você pode especificar como os campos de item de trabalho e as informações são agrupados e aparecem em um formulário de item de trabalho usando os elementos que estão descritos na tabela a seguir.

Observação
Para obter melhores resultados, você deve se aninhar Control elementos em um Group, e você deve se aninhar Group elementos em um Column, mesmo se a coluna atinge a largura total do formulário. Além disso, você deve se aninhar cada Column seção em um Group, mesmo se o grupo não tem rótulo visível ou limite.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

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

<Group Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Column> . . . </Column>
</Group >

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</LAYOUT>

Splitter Dock="Left" />

<TAB Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</TAB>

<TabGroup Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Tab> . . . </Tab>
</TabGroup>

Voltar ao topo

Atributos que são usados para formatar elementos de formulário

Você pode controlar o espaçamento e o tamanho dos muitos elementos em um formulário de item de trabalho, especificando os atributos que a tabela a seguir descreve. Para obter mais informações, consulte Criar o Layout do formulário de Item de trabalho.

Voltar ao topo

Elementos que especificam os rótulos autônomos, hiperlinks, páginas da Web ou conteúdo HTML

O WebpageControlOptions elemento e seus elementos filho tem a seguinte estrutura de sintaxe:

<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>

Você usar os elementos que estão descritos na tabela a seguir para definir o texto sem formatação ou rótulos de hiperlink, adicionar hiperlinks a um campo ou exibir o conteúdo da página da Web em um formulário de item de trabalho. Para obter mais informações, consulte Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Voltar ao topo

Elementos que filtrar e exibem relacionamentos de Link

Você pode usar o LinksControlOptions elemento para definir as opções para controlar quais links pode ser adicionado a um item de trabalho e as colunas padrão que você deseja que apareça para a lista de links em um item de trabalho. Quando você adiciona um controle de link para um formulário de item de trabalho, você pode especificar filtros restringem os tipos de links que os usuários podem criar e os tipos de itens de trabalho entre os quais usuários podem criar vínculos. O LinksControlOptions elemento e seus elementos filho tem a seguinte estrutura:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

Especificamente, você pode usar os elementos que estão resumidos na tabela a seguir. Para obter mais informações sobre como usar esses elementos, consulte Definir controles de Link para restringir os relacionamentos de Link e Elementos de LinksControlOptions.

Voltar ao topo

Consulte também

Conceitos

Criar o Layout do formulário de Item de trabalho

Criando e personalizando um formulário de Item de trabalho

Outros recursos

Índice de definições de elemento XML para tipos de itens de trabalho

Histórico de alterações