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

• Exemplo de formulário

• 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

Exemplo de formulário

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-alvo.Por exemplo, você pode especificar um layout para clientes Windows e um layout diferente para Team Web Access.Um layout normalmente consiste em 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 sejam exibidas em 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 campos.

<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 que a coluna atinge a largura total do formulário.Além disso, você deve se aninhar cada Column seção em um Group, mesmo que 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>

De volta 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 mais informações, consulte Criar o layout do formulário de item de trabalho.

De volta ao topo

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

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

<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 com hiperlinks, adicionar hiperlinks a um campo ou exibir o conteúdo da página da Web em um formulário de item de trabalho.Para mais informações, consulte Fornecer texto da Ajuda, diretrizes de 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>

De volta 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 vínculo a 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 as relações de link e Elementos de LinksControlOptions.

De volta ao topo

Consulte também

Conceitos

Criar o layout do formulário de item de trabalho

Criar e personalizar um formulário de item de trabalho

Outros recursos

Índice para definições de elementos XML para tipos de item de trabalho