XML-Elementreferenz für FORM

Die im vorliegenden Thema enthaltenen Informationen können als Kurzübersicht für alle Elemente und Hauptattribute genutzt werden, die das Formular für einen Typ von Arbeitsaufgabe steuern. Sie geben diese Elemente im FORM-Elementcontainer an, dem dritten und abschließenden Hauptabschnitt der Definition eines Arbeitsaufgabentyps. Viele Elemente werden in andere Elemente geschachtelt, sodass Gruppen, Abschnitte und Registerkarten in einem Arbeitsaufgabenformular gebildet werden. Weitere Informationen zum Gruppieren dieser Elemente finden Sie unter Entwerfen des Layouts des Arbeitsaufgabenformulars.

In diesem Thema

• Beispiel für FORM

• Syntax für FORM-Elemente

• Attribute, die FORM-Elemente angeben

• Elemente, die eigenständige Bezeichnungen, Links, Webseiten oder HTML-Inhalte angeben

• Elemente, die Linkbeziehungen filtern und anzeigen

Beispiel für FORM

Im folgenden Beispiel wird die Gesamtstruktur des FORM-Elements veranschaulicht. Mit dem Layout-Element wird das Layout eines Formulars angegeben. Sie können unterschiedliche Layouts für verschiedene Clients festlegen. Beispielsweise können Sie ein Layout für Windows-Clients und ein anderes Layout für Team Web Access angeben. Ein Layout besteht in der Regel aus dem oberen Bereich des Formulars und einer Gruppe von Registerkarten. Die Reihenfolge, in der Sie die Elemente innerhalb des Layouts definieren, bestimmt die Reihenfolge, in der die Elemente im Formular angezeigt werden.

Mit dem Group-Element und dem Column-Element gruppieren Sie Elemente für die Anzeige in Spalten. Mithilfe des Control-Elements definieren Sie die einzelnen Felder, die im Formular dargestellt werden sollen. Sie verwenden das Tab-Element, um andere Funktionsbereiche von Feldgruppen zu unterstützen.

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

Formularelemente

Mit den in der folgenden Tabelle aufgeführten Elementen können Sie angeben, wie Informationen und Arbeitsaufgabenfelder gruppiert und in einem Arbeitsaufgabenformular angezeigt werden.

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

Zurück nach oben

Attribute zum Formatieren von FORM-Elementen

Sie können Abstand und Größe vieler Elemente eines Arbeitsaufgabenformulars festlegen, indem Sie die in der folgenden Tabelle beschriebenen Attribute angeben. Weitere Informationen finden Sie unter Entwerfen des Layouts des Arbeitsaufgabenformulars.

Zurück nach oben

Elemente, die eigenständige Bezeichnungen, Links, Webseiten oder HTML-Inhalte angeben

Das WebpageControlOptions-Element und seine untergeordneten Elemente verfügen über die folgende Syntaxstruktur:

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

Mit den in der folgenden Tabelle beschriebenen Elementen können Sie Nur-Text- oder mit Links versehene Bezeichnungen definieren, einem Feld Links hinzufügen oder Webseiteninhalte in einem Arbeitsaufgabenformular anzeigen. Weitere Informationen finden Sie unter Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular.

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

Zurück nach oben

Elemente, die Linkbeziehungen filtern und anzeigen

Mithilfe des LinksControlOptions-Elements definieren Sie die Optionen, mit denen festgelegt wird, welche Links einer Arbeitsaufgabe hinzugefügt werden können, sowie die Standardspalten, die für die Liste der Links in einer Arbeitsaufgabe angezeigt werden sollen. Wenn Sie einem Arbeitsaufgabenformular die Linksteuerung hinzufügen, können Sie Filter angeben, mit denen die von Benutzern erstellten Linktypen sowie die Arbeitsaufgabentypen eingeschränkt werden, zwischen denen Benutzer Links erstellen können. Das LinksControlOptions-Element und seine untergeordneten Elemente verfügen über die folgende Syntaxstruktur:

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

Dabei verwenden Sie die in der folgenden Tabelle zusammengefassten Elemente. Weitere Informationen zum Verwenden dieser Elemente finden Sie unter Definieren von Link-Steuerelementen zum Einschränken der Link-Beziehungen und LinksControlOptions-Elemente.

Zurück nach oben

Siehe auch

Konzepte

Entwerfen des Layouts des Arbeitsaufgabenformulars

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

Weitere Ressourcen

Index für XML-Elementdefinitionen für Arbeitsaufgabentypen

Änderungsprotokoll