Aracılığıyla paylaş


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

Kullanarak bir alan veya tek başına bir etikete bir iş öğesi formundaki bir köprü ekleyebilirsiniz Link öğesi.Kullandığınız Link öğesi için aşağıdaki durumlarda:

  • Köprü eklemek için bir alan etiketi

  • Tek başına bir etikete veya bilgilendirici metin kısımlarını bir köprü ekleyin

  • Bir iş öğesi formu içinde görüntülenecek içerik URL'sini belirtin

Öğeleri bir forma eklemek için bir iş öğesi türü için tanım değiştirin.Bkz. Özel iş öğesi türünü değiştirme veya ekleme (WIT).

Link Öğesi, bir alt öğesi olan Control öğesi veya bir alt öğesi WebpageControlTarget veya WebpageControlOptions öğeleri.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

               Grup

               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 öğeler aşağıdaki bölümlerde açıklanmaktadır.

Alt öğeleri ve öznitelikleri

Öğe

Öznitelik

Açıklama

Link

 

İsteğe bağlı Control öğe olduğunda type="FieldControl".

İsteğe bağlı LabelText öğesi.

İsteğe bağlı Text öğesi.

İsteğe bağlı WebpageControlOptions öğesi.

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.

Protokol ve URL'sine sunucu adını belirtir etiket bağlantılar.Desteklenen protokoller, HTTP ve HTTPS MAILTO mevcuttur.

Belirtilen sunucu adı ya da hardcode olabilir veya aşağıdaki makro birini kullanın ve isteğe bağlı olarak bir makro ek adres bilgisi Ekle:

[!NOT]

Tanımlanan ve iş öğesi formu takım projesi için etkinleştirildiği URL'yi her makro bağlantı Link öğesi tanımlanır.Herhangi bir kaynağa sağlanmadıysa veya takım projesi için etkin, bir "Sayfa bulunamadı" hatası görünür.

  • @PortalPage: Geçerli takım projesi için SharePoint sitesi URL'si (örneğin, https://serverName/sites/collectionName/TeamProjectName).

  • @ProcessGuidance: Bir takım projesi için işlem kılavuzu için SharePoint sitesi URL'si.

  • @ReportManagerUrl: Geçerli takım projesi için Report Manager barındıran sunucunun URL'si.Bu raporlar için klasör görünümü bir bağlantı verir (örneğin, https://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/teamProjectName).

  • @ReportServiceSiteUrl: Barındıran sunucunun URL'sini SQL Server Raporlama Hizmetleri için geçerli ekip projesi ile takım projesi için temel yolu (örneğin, https://serverName/Reports/Pages/reportservice.asmx?ItemPath = /collectionName/teamProjectName).

İlk iki makro kodlanmış değeri belirlemek için bir takım projesi için proje portalı ayarlarını açabilirsiniz.Daha fazla bilgi için bkz. İşlem kılavuzunu yapılandırma veya yeniden yönlendirme.

Ö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 öznitelik, çalışma zamanında belirlenen değişken parametreleri belirtmek için kullanın.Öznitelik türü basit türdür: NonBlankString.

Param

 

İsteğe bağlı Link öğesi.Ne zaman gerekli UrlPath belirtilir.

Köprü URL'sini belirlemek için kullanılacak bir değer belirtir olduğunda UrlPath belirtilir.

Öğe türü karmaşık türdür: HyperLinkParamType.

 

Index

Gerekli Param özniteliği.

Parametre değeri URL dizesine nerede biçimlendirilmelidir dizinini belirtir.Dizin değerlerini ardışık olarak sıralamak için gerekli değildir; Ancak, dizinde sayısı eşleşmelidir URLPath dize.

Öznitelik türü PositiveInteger.İlk dizin numarası 0 olmalıdır.

 

Value

Gerekli Param özniteliği.

Köprü için bir URL yolu değeri ile ilişkili sayısını belirtir.

İçine biçimlendirilmelidir bir değer belirtir URLPath dize.İş öğesi türü tanımında kullanılan alanlarla geçerli bir başvuru adları değerleri olmalıdır.

@Me Değişkeni desteklenir.Bu iş öğesi formunu görüntüleyen geçerli takım üyesinin adı ile değiştirilir.Değer girişleri büyük/küçük harfe duyarlı değildir.

Öznitelik türü xs:string.

 

Type

İsteğe bağlı Param özniteliği.

Alanın özgün değeri parametresi için kullanılması gereken belirtir.Öznitelik türü basit 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 için geçerli parametre değeri kullanılacağını belirtir.

Bu öznitelik belirtilmezse, alanın değeri geçerli bir parametre olarak kullanılır

Üst Öğeler

Öğe

Açıklama

Denetim

Gerekli.Bir alan, metin, köprü veya diğer denetim öğesi iş öğesi formunda görünmesini tanımlar.

LabelText

İsteğe bağlı Control öğesi.

İş öğesi formunda görünmesi bir etiket için kapsayıcı öğe.

Metin

İsteğe bağlı LabelText öğesi.

Bilgi veya iş öğesi formunda görünmesini etiket için kapsayıcı öğe.

WebpageControlOptions

İsteğe bağlı Control öğesi.

Web sayfası denetimi yönelik seçenekleri belirten kapsayıcı öğe.

Daha fazla bilgi için bkz. Displaying Web Content within a Work Item Form.

Notlar

Varsayılan davranışını Link iş öğesi formu veya Web sayfasında köprüyü açmak için öğedir.Köprüyü yeni bir pencerede açmak için hazırlanmış, (target = "_blank"), bir dış tarayıcı açılır.

Birden çok ekleyerek düz ve köprü metni birleştirebilirsiniz Textöğelerin bir LabelText öğesi.

LabelText Öğesi yalnızca en son sürümünü çalıştıran istemciler tarafından tanınan Ekip Gezgini.Bu nedenle, belirtmelisiniz Label özniteliğini bir Control öğesi bir alt belirttiğinizde Link öğesi.En son sürümünü çalıştıran istemciler için Ekip Gezgini, tarafından sağlanan metin bir LabelText öğesi iş öğesi formunda görünür.Önceki sürümlerini çalıştıran istemciler için Ekip Gezgini, tarafından belirtilen metin Control öğesi Label özniteliği iş öğesi formunda görünür.

Örnek: bir köprüyü parametrelerle belirtme

Açıklama

Aşağıdaki örnek, bir köprü bağlantılı yineleme konusu için işlem kılavuzuna nasıl tanımlayabilirsiniz gösterir:

https://serverName/sites/collectionName/projectName/render.aspx?wit=bug & amp; konu yineleme =

Proje adı System.Project alanına atanan değer türetilir.

Kod

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

Örnek: için tek başına bir etikete köprü ekleme

Açıklama

Aşağıdaki örnek, bir köprü metni "iş öğesi Kılavuzu" iş öğesi formundaki nasıl atayabilirsiniz gösterir.

Kod

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

Örnek: bir alana bir köprü ekleme

Açıklama

Aşağıdaki örnek, bir iş öğesi formundaki bir alan etiketi için bir köprü nasıl 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 Alanı

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.

Uygulanamaz

Ayrıca bkz.

Kavramlar

İş öğesi formu denetimlerini belirtme

İş öğesi formunu tasarlama