Référence de tous les éléments XML FORM

Vous pouvez utiliser les informations de cette rubrique comme une référence rapide à tous les éléments et aux principaux attributs qui contrôlent le formulaire d'un type d'élément de travail. Vous spécifiez ces éléments dans le conteneur d'éléments FORM, la troisième et dernière section de la définition d'un type d'élément de travail. De nombreux éléments sont imbriqués les uns dans les autres pour former des groupes, des sections ou des onglets dans un formulaire d'élément de travail. Pour plus d'informations sur le regroupement de ces éléments, consultez Concevoir le formulaire d'élément de travail.

Dans cette rubrique

• Exemple FORM

• Syntaxe pour les éléments FORM

• Attributs spécifiés par les éléments FORM

• Éléments qui spécifient des étiquettes, des liens hypertexte, des pages Web ou du contenu HTML autonomes

• Éléments qui filtrent et affichent des relations de liens

Exemple FORM

L'exemple suivant illustre la structure globale de l'élément FORM. Vous spécifiez la disposition d'un formulaire à l'aide de l'élément Layout. Vous pouvez spécifier différentes dispositions qui ciblent différents clients. Par exemple, vous pouvez spécifier une disposition pour les clients Windows et une disposition différente pour Team Web Access. Une disposition se compose généralement du haut du formulaire, puis d'un groupe d'onglets. L'ordre dans lequel vous définissez les éléments dans la disposition détermine l'ordre dans lequel les éléments s'affichent sur le formulaire.

Vous regroupez les éléments pour qu'ils s'affichent dans des colonnes à l'aide des éléments Group et Column. Vous utilisez un élément Control pour définir chaque champ que vous souhaitez faire apparaître sur le formulaire. Vous utilisez l'élément Tab pour prendre en charge différentes zones fonctionnelles de groupes de champ.

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

Éléments Form

Vous pouvez spécifier le mode de regroupement et d'affichage des informations et des champs d'élément de travail dans un formulaire d'élément de travail à l'aide des éléments décrits dans le tableau suivant.

<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" 
Padding="(top, bottom, left, right)" 
Margin="( top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

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

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

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

Splitter />

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

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

Attributs utilisés pour mettre en forme des éléments FORM

Vous pouvez contrôler l'espacement et la taille de nombreux éléments dans un formulaire d'élément de travail en spécifiant les attributs décrits dans le tableau suivant. Pour plus d'informations, consultez Concevoir le formulaire d'élément de travail.

Éléments qui spécifient des étiquettes, des liens hypertexte, des pages Web ou du contenu HTML autonomes

L'élément WebpageControlOptions et ses éléments enfants ont la structure de syntaxe suivante :

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

Utilisez les éléments décrits dans le tableau suivant pour définir des étiquettes en texte brut ou hypertextes, ajouter des liens hypertexte à un champ ou afficher le contenu d'une page Web dans un formulaire d'élément de travail. Pour plus d'informations, consultez Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail.

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

Éléments qui filtrent et affichent des relations de liens

Utilisez l'élément LinksControlOptions pour définir des options pour contrôler les liens pouvant être ajoutés à un élément de travail et les colonnes par défaut à afficher dans la liste de liens d'un élément de travail. Lorsque vous ajoutez le contrôle de lien à un formulaire d'élément de travail, vous pouvez spécifier des filtres qui restreignent les types de liens que les utilisateurs peuvent créer et les types d'éléments de travail entre lesquels les utilisateurs peuvent créer des liens. L'élément LinksControlOptions et ses éléments enfants ont la structure suivante :

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

Plus particulièrement, vous utilisez les éléments résumés dans le tableau suivant. Pour plus d'informations sur l'utilisation de ces éléments, consultez Définir des contrôles de liens pour restreindre les relations de liens et Éléments LinksControlOptions.

Voir aussi

Concepts

Concevoir le formulaire d'élément de travail

Autres ressources

Suivi des éléments de travail : index des définitions d'éléments XML