Çalışma öğesi izleme eklentisini kullanarak iş öğelerini izlemek için nesneleri tanımlama

  • Makale
  • Okumak için 3 dakika

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Önemli

Bu makale, şirket içi XML işlem modelleriyle ilgili proje özelleştirmesi için geçerlidir. İşlem modellerine genel bakış için bkz. iş izleme deneyiminizi özelleştirme.

Çalışma öğelerini izlemek için eklentisini kullanarak, projenin izleme işi için başlangıç nesnelerini tanımlarsınız. Bu nesneler iş öğelerinin, iş öğesi sorgularının, kategorilerin, bağlantı türlerinin ve iş öğelerinin örneklerinin türlerini içerir. Bir proje oluşturduktan sonra, bu nesneleri witadmin komut satırı aracını kullanarak değiştirebilirsiniz.

Eklenti dosyasında, bir veya daha fazla görevi ve bunların bağımlılıklarını belirtirsiniz. Genel olarak, bağlantı türleri, iş öğesi türleri, sorgular ve kategoriler gibi her ana karşıya yükleme etkinliği için bir görev belirlersiniz.

Önemli

Dosyaları karşıya yüklemek ve sorguları belirli bir sırada tanımlamak için görevleri belirtmeniz gerekir: önce bağlantı türleri, sonra iş öğesi türleri ve sonra sorgular. Bu nesneler için her tanım dosyası, önündeki görevlerde belirtilen tanımlara bağlıdır. Genel olarak, özelleştirilirken işlem şablonunda tanımlanan görev dizisini korumanız gerekir. Daha fazla bilgi için bkz. görev grupları ve görevler için bağımlılıkları tanımlama.

Eklenti adı ve konumu

Varsayılan işlem şablonları için dosya, klasör ve eklenti adları aşağıdaki gibidir:

Dosya adı: WorkItems.xml
Klasör adı: WorkItem Tracking klasörü eklenti adı: Microsoft. ProjectCreationWizard. WorkItemTracking

Not

XML dosyasının adını ve klasör adını değiştirebilirsiniz, ancak eklentinin adını değiştiremezsiniz. Sistem, istemci tarafı eklentilerin, ilkelerin ve diğer değişikliklerin dağıtımı için bir mekanizma içermez. Bu tür bir işlevi dağıtmak istiyorsanız, kendi dağıtım ve yükleme programınızı kullanmanız gerekir.

Tanımlayabilmeniz gereken her nesne türü hakkında belirli bilgiler için aşağıdaki konulardan birine bakın:

Çalışma öğesi izleme eklentisi sözdizimi yapısı

Çalışma öğesi izleme için eklenti dosyası, Workıtemyöntembilim. xsd dosyasında tanımlanan şema tanımına uygun olmalıdır ve eklentinin kendi dosyasında belirtilmesi gerekir.

Aşağıdaki sözdizimi, WorkItemTracking eklentisinin üst düzey yapısını gösterir. Her biri bağlantı türleri, iş öğesi türleri, sorgular ve kategoriler için tanımları karşıya yüklemek üzere dört görev belirtilmiştir. Tanımlar çalışma öğesi örnekleri eklemek istiyorsanız, her biri için ek bir görev belirlersiniz.

Her öğenin açıklaması için, bu konunun ilerleyen kısımlarında bulunan öğe başvurusu bölümüne bakın.

<?xml version="1.0" encoding="utf-8"?>  
<tasks>  
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">  
    <taskXml>  
      <LINKTYPES>  
        <LINKTYPE />  
      . . .   
      </LINKTYPES>  
    </taskXml>  
  </task>  
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">  
    <dependencies>  
      <dependency taskId="LinkTypes" />  
    </dependencies>  
    <taskXml>  
      <WORKITEMTYPES>  
        <WORKITEMTYPE />  
      . . .   
      </WORKITEMTYPES>  
    </taskXml>  
  </task>  
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">  
    <dependencies>  
      <dependency taskId="WITs" />  
    </dependencies>  
    <taskXml>  
      <QUERIES>  
        <Permission />  
      . . .   
        <QueryFolder >  
          <Query />  
      . . .   
        </QueryFolder>  
      . . .   
      </QUERIES>  
    </taskXml>  
  </task>  
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">  
    <dependencies>  
      <dependency taskId="WITs" />  
    </dependencies>  
    <taskXml>  
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />  
    </taskXml>  
  </task>  
</tasks>

Öğe başvurusu

Aşağıdaki tabloda, çalışma öğesi izleme nesnelerini karşıya yüklemek için kullandığınız öğeler açıklanmaktadır. Bu öğeleri, WorkItemTracking eklenti dosyasındaki bir taskXml kapsayıcı öğesi içinde belirtirsiniz. Görev, bağımlılık ve taskXml öğeleri hakkında daha fazla bilgi için bkz. bir eklentiyi işlemek için görevleri tanımlama.

Öğe Syntax Description
KATEGORISINE <CATEGORIES fileName="CategoriesFilePathName" /> WorkItemTracking eklentisi için taskXml öğesinin isteğe bağlı alt öğesi.

WorkItemTracking eklentisi görevi işlendiğinde karşıya yüklenecek kategori tanımlarını içeren dosyanın yolunu ve adını belirtir.
ALANLA <FIELD refname="FieldReferenceName" value="Value" /> WI'nin gerekli alt öğesi.

İş öğesi örneğindeki bir alan için bir değer tanımlar.
BAĞLANAN <HYPERLINK URL="URL" relativePath="false" /> WI'nin isteğe bağlı alt öğesi.

İş öğesi örneği için bir köprü tanımlar.
TANıMLARıNı <LINKTYPE fileName="LinkTypeFilePathName" /> LinkTypesöğesinin gerekli alt öğesi.

Karşıya yüklenecek bağlantı türü tanımını içeren bir dosyanın yolunu ve adını belirtir.
LINKTYPES <LINKTYPES> <LINKTYPE /> . . . </LINKTYPES> WorkItemTracking eklentisi için taskXml öğesinin isteğe bağlı alt öğesi.

Her biri karşıya yüklenecek tanım dosyasını belirten bir LINKTYPE öğeleri koleksiyonu içerir.
İzin <permission allow="ListOfPermissions" identity="GroupName" /> Sorgununisteğe bağlı alt öğesi.

Takım Sorgularına atanan varsayılan izinleri belirtir. Daha fazla bilgi için bkz. iş öğesi sorguları için Izin atama.
Sorgu <Query name="QueryName" fileName="QueryFilePathName" /> Sorgularıngerekli alt öğesi.

Karşıya yüklenecek bir sorguyu tanımlayan. wiq dosyasının adını ve yolunu belirtir.
QueryFolder <QueryFolder name=" FolderName "> Sorgularınisteğe bağlı alt öğesi.

Bir sorgu klasörünün adını belirtir.
LARDıR <QUERIES> . . . </QUERIES> WorkItemTracking eklentisi için taskXml öğesinin isteğe bağlı alt öğesi.

Varsayılan sorguları oluşturmak için hangi sorgu tanım dosyalarının kullanılacağını belirtir.
WI <WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> WORKITEMSöğesinin gerekli alt öğesi.

Oluşturulacak çalışma öğesi türünü ve belirli alanlara atanacak değerleri tanımlar.
Ise WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS > WorkItemTracking eklentisi için taskXml öğesinin isteğe bağlı alt öğesi.

Her biri bir iş öğesi örneğini tanımlayan bir WI öğeleri koleksiyonu içerir.
WORKıTEMTYPE <WORKITEMTYPE fileName="WITFilePathName" /> WORKITEMTYPESöğesinin gerekli alt öğesi.

Karşıya yüklenecek bir tür tanımı içeren dosyanın yolunu ve adını belirtir.
WORKıTEMTYPES <WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES> WorkItemTracking eklentisinin gerekli alt öğesi.

Her birinde karşıya yüklenecek bir tanım dosyası belirten WORKITEMTYPE öğelerinin bir koleksiyonunu içerir.