Súgószöveg, hivatkozások vagy webes tartalom megadása munkaeleműrlapon

  • Cikk

Azure DevOps Server 2022 – Azure DevOps Server 2019

A munkaelem-űrlap testreszabásakor célszerű lehet olyan információkat vagy tartalomra mutató hivatkozásokat megadni, amelyek segítenek a csapatnak az űrlap mezőinek meghatározásában. Ha adatokat ágyaz be az űrlapba, vagy könnyen elérhetővé teszi őket, a csapattagok jobban nyomon követhetik a hasznos adatokat.

A jelen témakörben ismertetett űrlapvezérlők használatával elemleírás-szöveget adhat hozzá az egyes mezőkhöz, önálló szöveghez vagy weblapokra mutató hivatkozásokhoz, illetve HTML-tartalmat vagy webes tartalmat ágyazhat be az űrlapba.

Meglévő WIT módosításához módosítsa a WIT XML-definíciós fájlját, majd importálja a projektbe a használt folyamatmodell alapján.

Tipp.

A witadminnal definíciós fájlokat importálhat és exportálhat. Egyéb használható eszközök: a Folyamatszerkesztő (ehhez telepítenie kell a Visual Studio egy verzióját). Telepítse a Folyamatsablon szerkesztőt a Visual Studio Marketplace-ről.

Súgószöveg vagy elemleírás megadása

Kétféleképpen adhat meg súgószöveget. Az első metódusban gyermekként adja hozzá az HELPTEXT elemet a FIELDFIELDS típusdefiníció szakaszának eleméhez. A használatával HELPTEXTlétrehozza a mező elemleírását. Ezzel a módszerrel legfeljebb 255 karaktert használhat.

<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >  
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>  
</FIELD>

A második módszerben különálló szöveget ad meg a gyermekelemek és Text a LabelText gyermekelemek használatával. Ebben a módszerben annyi információt adhat hozzá, amennyit csak szeretne, és a szöveg mindig jelen van az űrlapon. Nincs szükség felhasználói beavatkozásra. Az elem használatával Link további információkhoz is hozzáadhat egy opcionális hivatkozást, ahogyan az az alábbi példában is látható.

<Control FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left">   
      <LabelText>  
      <Text>Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:  
         <Link OpenInNewWindow="true" UrlRoot=http://ACE.ImpactStatement.aspx />  
      </Text>  
      </LabelText>  
</Control>

Önálló szöveg- és hivatkozásmezőfeliratok hozzáadása

Az elem attribútumbeállításával LabelControlControl szöveget adhat hozzá egy olyan munkaeleműrlaphoz, amely nincs munkaelemmezőhöz Type társítva. A szöveg lehet egyszerű vagy hivatkozás. A lehetőséggel FieldControl hivatkozást is csatolhat egy hozzáadott mezőcímkéhez.

Példa: egyszerű szöveges címke

Az alábbi példa a következő egyszerű szöveget adja hozzá: "Töltse ki a hiba részleteit itt. A nem kötelező mezőket ajánlott kitölteni." a munkaelemmezőbe.

<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

Az alábbi példa bemutatja, hogyan adhat hozzá hivatkozást egy mezőfelirathoz.

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"  
      <LabelText>  
      <Text>  
         <Link UrlRoot="http://www.live.com/" />  
               Title 2  
      </Text>  
      </LabelText>  
</Control>

Feljegyzés

Azoknak a Team Foundation-ügyfeleknek, akik nem frissítettek a legújabb verzióra, megjelenik az Label attribútum szövege. A Visual Studio 2012-ügyfeleknél a Szöveg címke hivatkozásként jelenik meg, amelyben az URL-címet a Link címke határozza meg.

Példa: mezőfelirat a szöveg egy részére mutató hivatkozással

Az alábbi példa bemutatja, hogyan adhat hozzá hivatkozást egy mezőfelirat egy részéhez. Ebben a példában az URL-címet az adott munkaelem alapján az Param elemekhez rendelt értékek határozzák meg.

<Control Type="FieldControl" FieldName="System.IterationPath">  
      <LabelText LabelPosition="Left">  
      <Text>  
         <Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">  
               <Param Index="0" vValue"System.WorkItemType"/>         </Link>  
               Iteration Path  
      </Text>  
      <Text> (must be 3 levels deep)</Text>  
      </LabelText>  
</Control>

Példa: hivatkozás szövegfelirata

Példa önálló címkére alkalmazott hivatkozásra
Hivatkozás szövegfelirata

Az alábbi példa bemutatja, hogyan adhat hozzá hivatkozást a megjelenített szöveghez egy munkaeleműrlapon.

<Group>  
      <Column PercentWidth="100">  
      <!-- Standalone label control 2 -->  
      <Control Type="LabelControl" Label="How do I use this work item?">  
         <Link UrlRoot="http://www.live.com"></Link>  
      </Control>  
      </Column>  
</Group>

Példa: szöveg és hivatkozások egyesítése egyetlen címkében

Példa szövegre alkalmazott két hivatkozásra

Szöveg és hivatkozások egyesítése egyetlen címkében

Az alábbi példa bemutatja, hogyan adhat hozzá két hivatkozást egy címke részeihez egy munkaeleműrlapon.

<Group>  
      <Column PercentWidth="100">  
      <!-- Standalone label control 3 -->  
      <Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">  
         <LabelText>  
               <Text>Click here for </Text>  
               <Text>  
               <Link UrlRoot="http://www.msn.com"></Link>  
               work item guidance</Text>  
               <Text> or here for </Text>  
               <Text>  
               <Link UrlRoot="http://www.msdn.com"></Link>  
               process guidance  
               </Text>  
         </LabelText>  
      </Control>  
      </Column>  
</Group>

Az alábbi példa bemutatja, hogyan adhat hozzá hivatkozást egy mezőfelirathoz, amely a megnyitott munkaelemhez kiértékelt paraméterértékekből jön létre.

<Control Type="FieldControl" FieldName="System.State" Label="&State:" LabelPosition="Left">  
      <Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" Value="System.State" Type ="Original"/>  
      </Link>  
</Control>

Webes tartalom megjelenítése

Az attribútumbeállítással TypeWebpageControl webes tartalmat jeleníthet meg a munkaeleműrlapon vezérlőelemként, ahelyett, hogy külön weblapra hivatkozik. Ez a megjelenítés hasznos lehet olyan metrikák biztosításához, amelyek támogatják a csapattagokat egy jelentés, irányítópult vagy más HTML-alapú tartalom tartalmának megtekintésében. Megadhatja a tartalomra mutató hivatkozást, vagy beágyazhatja a nyers HTML-tartalmat egy CDATA-címkébe.

Példa: URI által biztosított tartalom megjelenítése

Az alábbi példa bemutatja, hogyan ágyazhatja be a tartalmat egy weblapról úgy, hogy megadja a lap URL-címét az elemek és Link az WebpageControlOptions elemek használatával.

      <Group>  
      <Column PercentWidth="100">  
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" >  
               <WebpageControlOptions AllowScript="true">  
               <Link UrlRoot="http://www.msdn.com" />  
               </WebpageControlOptions>  
         </Control>  
      </Column>  
      </Group>

Példa: CDATA-címkében megadott tartalom megjelenítése

Az alábbi példa bemutatja, hogyan adhat hozzá HTML-tartalmat egy címkében CDATA található munkaelem-űrlaphoz.

<Control Type="WebpageControl">  
      <WebpageControlOptions>  
      <Content>
        <![CDATA[Place HTML Formatted Content Here ]]>
          </Content>
      </WebpageControlOptions>
</Control>