Riferimento a tutti gli elementi XML FORM

È possibile utilizzare le informazioni fornite in questo argomento come riferimento rapido relativo a tutti gli elementi e gli attributi principali che controllano il form per un tipo di elemento di lavoro.Questi elementi vengono specificati nel contenitore dell'elemento FORM, la terza e ultima sezione principale della definizione del tipo di elemento di lavoro.Molti elementi sono annidati all'interno di altri per formare gruppi, sezioni o schede in un form elemento di lavoro.Per ulteriori informazioni su come raggruppare questi elementi, vedere Progettare il layout del form elemento di lavoro.

In questo argomento

• Esempio di FORM

• Sintassi per gli elementi FORM

• Attributi specificati dagli elementi FORM

• Elementi che specificano etichette autonome, collegamenti ipertestuali, pagine Web o contenuto HTML

• Elementi che filtrano e visualizzano relazioni di collegamento

Esempio di FORM

Nell'esempio seguente viene mostrata la struttura generale dell'elemento FORM.Specificare il layout di un form utilizzando l'elemento Layout.È possibile specificare layout diversi destinati a client diversi.Ad esempio, è possibile specificare un layout per client Windows e un layout diverso per Team Web Access.Un layout è costituito in genere dalla parte superiore del form e quindi da un gruppo di schede.La sequenza nella quale si definiscono gli elementi all'interno del layout determina la sequenza nella quale gli elementi vengono visualizzati sul form.

Raggruppare gli elementi per la visualizzazione all'interno delle colonne tramite gli elementi Group e Column.Si utilizza un elemento Control per definire ogni campo che si desidera visualizzare nel form.L'elemento Tab viene utilizzato per supportare aree funzionali diverse dei gruppi del 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>

Elementi form

È possibile specificare il modo in cui le informazioni e i campi degli elementi di lavoro sono raggruppati e visualizzati in un form di elemento di lavoro utilizzando gli elementi descritti nella tabella che segue.

[!NOTA]

Per ottenere risultati migliori, occorre annidare gli elementi Control in un oggetto Group e annidare gli elementi Group in un oggetto Column, anche se la larghezza della colonna è uguale alla larghezza del form.Inoltre, occorre annidare ciascuna sezione Column in un elemento Group, anche se il gruppo non dispone di etichette o limiti visibili.

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

Torna all'inizio

Attributi utilizzati per formattare elementi FORM

È possibile controllare la spaziatura e la dimensione di molti elementi su un form elemento di lavoro specificando gli attributi descritti nella seguente tabella.Per ulteriori informazioni, vedere Progettare il layout del form elemento di lavoro.

Torna all'inizio

Elementi che specificano etichette autonome, collegamenti ipertestuali, pagine Web o contenuto HTML

L'elemento WebpageControlOptions e gli elementi figlio dispongono della struttura della sintassi seguente:

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

Gli elementi descritti nella tabella seguente possono essere utilizzati per definire etichette in testo normale o con collegamento ipertestuale, aggiungere collegamenti ipertestuali a un campo o visualizzare il contenuto di una pagina Web in un form dell'elemento di lavoro.Per ulteriori informazioni, vedere Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

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

Torna all'inizio

Elementi che filtrano e visualizzano relazioni di collegamento

Si utilizza l'elemento LinksControlOptions per definire le opzioni per controllare quali collegamenti è possibile aggiungere a un elemento di lavoro e le colonne predefinite che si desidera visualizzare per l'elenco di collegamenti in un elemento di lavoro.Quando si aggiunge il controllo collegamento a un form dell'elemento di lavoro, è possibile specificare dei filtri che limitino i tipi di collegamenti che gli utenti possono creare e i tipi di elementi di lavoro tra i quali gli utenti possono creare dei collegamenti.L'elemento LinksControlOptions e gli elementi figlio dispongono della seguente struttura:

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

In particolare, si utilizzano gli elementi riepilogati nella tabella seguente.Per ulteriori informazioni su come utilizzare questi elementi, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento e Elementi LinksControlOptions.

Torna all'inizio

Vedere anche

Concetti

Progettare il layout del form elemento di lavoro

Progettare e personalizzare un form elemento di lavoro

Altre risorse

Indice delle definizioni degli elementi XML per tipi di elementi di lavoro