Bağlantı ve Parametre XML Öğeleri Başvurusu

Link öğesini kullanarak bir iş öğesi formunda bir alana veya tek başına bir etikete köprü ekleyebilirsiniz. Link öğesini aşağıdaki örneklerde kullanırsınız:

• Alan etiketine köprü eklemek için

• Tek başına duran bir etikete veya bilgilendirici metnin bazı kısımlarına köprü eklemek için

• Bir iş öğesi formu içerisinden görüntülenecek içerik için URL belirtmek üzere

Link öğesi ya Control öğesinin bir alt öğesidir veya WebpageControlTarget veya WebpageControlOptions öğelerinin bir alt öğesidir. Bu öğeler hakkında daha fazla bilgi için, bkz. Denetim XML Öğesi Başvurusu ve WebpageControlOptions XML Öğeleri Başvurusu.

Şema Hiyerarşisi

WITD

   WORKITEMTYPE

       FORM

           Düzen

               Group

               Sütun

               Sekme

                     Denetim

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/>
</Link>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Alt Öğeler ve Öznitelikler

Öge	Öznitelik	Tanımlama
Link		Seçime bağlı Control öğesi type="FieldControl" olduğunda. İsteğe bağlı LabelText öğesi. İsteğe bağlı Text öğesi. İsteğe bağlı WebpageControlOptions öğesi. Bir köprü veya URL tanımlamak için kapsayıcı öğe. Öğe türü karmaşık türdür: HyperLinkType.
	UrlRoot	Gerekli Link özniteliği. Etiketin bağlandığı URL'in sunucu adını ve protokolünü belirtir. Desteklenen protokoller HTTP, HTTPS ve MAILTO'dur. Belirtilen sunucu adını sabit kodlayabilir veya aşağıdaki makrolardan birini kullanabilir ve isteğe bağlı olarak ek adres bilgilerini bir makroya ekleyebilirsiniz: Not Her makro bağlantı tanımlandığı URL ile bağlantılıdır ve Link öğesinin tanımlanmış olduğu iş öğesi formunun ekip projesi için etkinleştirilmiştir.Kaynakların herhangi biri sağlanmadıysa veya etkin takım projesi için etkinleştirilmediyse bir "sayfa bulunamadı" hatası görüntülenecektir. @PortalPage: Geçerli ekip projesi için SharePoint sitesinin URL'si (örneğin, http://serverName/sites/collectionName/TeamProjectName). @ProcessGuidance: Bir ekip projesindeki işlem kılavuzu için SharePoint sitesinin URL'si. @ReportManagerUrl: Güncel takım projesi için Rapor Yöneticisini barındıran sunucunun URL'si. Bu, raporlar için dosya görünümüne bir bağlantı sağlar (örneğin, http://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/teamProjectName). @ReportServiceSiteUrl: Geçerli ekip projesi ile ekip projesine ilişkin temel yol için SQL Server Raporlama Servislerini barındıran sunucunun URL'si (örneğin, http://serverName/Reports/Pages/reportservice.asmx?Itempath = /collectionName/teamProjectName). İlk iki makro için sabit kodlu değeri belirlemek üzere takım projesi için proje portalı ayarlarını açabilirsiniz. Daha fazla bilgi için bkz. Takım Projesi Portalı veya İşlem Kılavuzuna Erişim. Öznitelik türü basit türdür:NonBlankString.
	UrlPath	İsteğe bağlı Link özniteliği. Köprü için bir URL yolu belirtir. Bu özniteliği çalışma zamanında belirlenen değişken parametreleri belirlemek üzere kullanırsınız. Öznitelik türü basit türdür:NonBlankString.
Param		İsteğe bağlı Link öğesi. UrlPath belirtildiğinde gereklidir. UrlPath belirtildiğinde köprünün URL'ini belirlemek için kullanılacak bir değeri belirtir. Öğe türü karmaşık türdür: HyperLinkParamType.
	Index	Gerekli Param özniteliği. Değerin URL dizesine biçimlenmesi gereken yerde parametrenin diznini belirtir. Dizin değerlerini ardışık olarak sıralamak gerekli değildir; bununla birlikte, onlar URLPath dizesindeki dizin numarasıyla eşleşmelidir. Öznitelik türü PositiveInteger'dir. İlk dizin numarası 0 olmalıdır.
	Value	Gerekli Param özniteliği. Köprü URL yolu için olan değerle ilişkilendirilmiş sayıyı belirtir. URLPath dizesine biçimlendirilmesi gereken bir değer belirtir. Değerler, iş öğesi türü tanımında kullanılan alanların geçerli başvuru adları olmalıdır. @Me değişkeni desteklenir. İş öğesi formunu görüntüleyen takım üyesinin adıyla değiştirilir. Değer girişleri büyük/küçük harf duyarlılığına sahip değildir. Öznitelik türü xs:string'dir.
	Type	İsteğe Bağlı Param özniteliği. Alanın asıl değerinin parametre için kullanılması gerektiğini belirtir. Öznitelik türü asit türdür:HyperLinkParamValueKind. Geçerli değerler aşağıdaki gibidir: Original: URL yolunu belirlemek üzere asıl parametreyi kullanmayı belirler. Current: URL yolunu belirlemek üzere güncel parametreyi kullanmayı belirler. Bu öznitelik belirtilmemişse, alanın güncel değeri parametre olarak kullanılır

Üst Öğeler

Öge	Tanımlama
Denetim	Gerekli. İş öğesi formunda görünecek bir alan, metin, köprü veya diğer bir denetim öğesi tanımlar.
LabelText	İsteğe bağlı Control ögesi. İş öğesi formunda gözükecek olan bir etiket için kapsayıcı öğe.
Text	İsteğe bağlı LabelText öğesi. İş öğesi formunda gözükecek olan bilgi veya etiket için kapsayıcı öğe.
WebpageControlOptions	İsteğe bağlı Control ögesi. Web sayfası denetimi için seçenekleri belirten kapsayıcı öğe. Daha fazla bilgi için bkz. Displaying Web Content within a Work Item Form.

Notlar

Link öğesinin varsayılan davranışı iş öğesi formunda veya Web sayfasında köprüyü açmaktır. Köprü yeni bir pencerede açılmak üzere yazılmışsa (target="_blank") dış tarayıcı açılır.

Çoklu Text öğelerini LabelText öğesinde ekleyerek düz ve köprülenmiş metinleri birleştirebilirsiniz.

LabelText öğesi sadece Ekip Gezgini'ın son sürümünü çalıştıran istemciler tarafından ayırt edilebilir. Bundan dolayı, alt Link öğesi belirttiğinizde Label özniteliğini bir Control öğesi içinde belirtmelisiniz. Ekip Gezgini'ın son sürümünü çalıştıran istemciler için, bir LabelText öğesi tarafından sağlanan metin iş öğesi formunda görünür. Ekip Gezgini'ın daha önceki sürümlerini çalıştıran istemciler için, Control öğesi Label özniteliği tarafından belirlenen metin iş öğesi formunda görünür.

Örnek: Parametrelerle Köprü Belirleme

Tanımlama

Aşağıdaki örnek Yineleme konusu için işlem kılavuzuna bağlanan bir köprüyü nasıl tanımlayabileceğinizi gösterir:

http://serverName/sites/collectionName/projectName/render.aspx?wit=bug&topic=Iteration

Projenin adı System.Project alanına atanmış olan değerden türetilir.

Kod

<Link UrlRoot="http://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&amp;topic=Iteration">
   <Param Index="0" Value="System.Project" />
</Link>

Örnek: Tek Başına Bir Etikete Köprü Ekleme

Tanımlama

Aşağıdaki örnek bir iş öğesi formunda "iş öğesi kılavuzu" metnine nasıl köprü atayabileceğinizi gösterir.

Kod

<Control type="LabelControl">
   <LabelText> 
      <Text>
         <Link UrlRoot="https://www.msn.com" />
      work item guidance
      </Text>
   </LabelText> 
</Control>

Örnek: Bir Alana Köprü Ekleme

Tanımlama

Aşağıdaki örnek bir iş öğesi formundaki alan etiketine nasıl köprü ekleyebileceğinizi gösterir.

Kod

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
         This text comes from the inner Label Text
      </Text>
   </LabelText>
</Control>

Şema Tanımları

• HyperLinkType

• NonBlankString

• HyperLinkParamType

• HyperLinkParamValueKind

Karmaşık Tür: HyperLinkType

<xs:complexType name="HyperLinkType" >
   <xs:sequence>
      <xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
   <xs:attribute name="UrlRoot"  type="NonBlankString" use="required" />
   <xs:attribute name="UrlPath"  type="NonBlankString" use="optional" />
</xs:complexType>

HyperLinkParamType

<xs:complexType name="HyperLinkParamType" >
   <xs:attribute name="Index"     type="PositiveInteger" use="required" />
   <xs:attribute name="Value"     type="xs:string" use="required" />
   <xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

HyperLinkParamValueKind

<xs:simpleType name="HyperLinkParamValueKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="Original"/>
   <xs:enumeration value="Current"/>
   </xs:restriction>
</xs:simpleType>   

Öğe Bilgisi

Ad uzayı	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Şema Adı	İş Öğesi Türü Tanımı
Dosya Doğrulama	WorkItemTypeDefinition.xsd
Öğe türü	HyperLinkType, HyperLinkParamType
Boş olabilir	Yok

Ayrıca bkz.

Kavramlar

Çalışma Öğesi Form Denetimlerini Belirtme

Çalışma Öğesi Formu Tasarlama ve Özelleştirme

Diğer Kaynaklar

Elements (Work Item Type Definition Schema)