Aracılığıyla paylaş

WorkItems Eklentisini Kullanarak İş Öğelerini İzlemek için Nesneleri Tanımlama ve Özelleştirme

  • Makale

İş öğelerini izlemek için eklentiyi kullanarak, bir ekip projenin ilk iş öğesi izleme nesnelerini, gruplara atanmış sorgulama izinlerini ve ekip sorgu klasörü yapısını tanımlarsınız. Tanımlayabileceğiniz isteğe bağlı öğeler görev kümesi veya her bir takım projesinin belirmesini istediğiniz sorunlar gibi iş öğesi nesnelerini içerir. Bir ekip projesi oluşturduktan sonra, witadmin komut satırı aracını kullanarak iş öğesi izleme nesnelerini değiştirebilirsiniz.

XML dosyasından, bir yada daha fazla görevi ve onların bağımlılıklarını belirtin. Genel olarak, her ana yükleme etkinliği için bir görev belirtin: bağlantı türleri, iş öğesi türleri, sorgular ve kategoriler.

Önemli

Dosyaları yüklemek ve sorguları tanımlamak için görevleri özel bir sırayla belirtmelisiniz: önce bağlantı tipleri, sonra iş öğesi tipleri, sonra sorgular. Bu iş öğesi izleme nesneleri için her tanım dosyası kendilerinden önceki görevlerde belirtilmiş olan açıklamalara dayanır. Genel olarak, özelleştirdiğiniz Microsoft Solutions Framework (MFS) işlem şablonunda tanımlanan görev sırasını korumanız gerekir.

Aşağıdaki tablo eklentinin adına ek olarak MSF işlem şablonları için dosyanın adı ve konumunu özetler.

Dosya adı:

WorkItems.xml

Dosya konumu:

WorkItem Tracking klasörü

Eklenti adı:

Microsoft.ProjectCreationWizard.WorkItemTracking

Not

XML dosyasının adını ve konumunu değiştirebilirsiniz fakat eklentinin adını değiştiremezsiniz. Visual Studio Team Foundation Server, istemci tarafı eklentilerin, tutumların ve diğer değişikliklerin dağıtımı için bir mekanizma içermez. Bu çeşit bir işlevselliği dağıtmak istiyorsanız kendi dağıtım ve yükleme programınızı kullanmanız gerekir.

Bu konuda

  • Karşıya Yüklenecek Bağlantı Türlerini Belirtme

  • Karşıya Yüklenecek Çalışma Öğesi Türlerini Belirtme

  • Sorgu İzinleri Tanımlama

  • Sorgu Klasörleri Oluşturma

  • Karşıya Yüklenecek Kategorileri Belirtme

  • Oluşturulacak Çalışma Öğesi Nesnelerini Belirtme

Karşıya Yüklenecek Bağlantı Türlerini Belirtme

Bir ekip projesi oluşturulduğunda karşıya yüklenecek bağlantı türlerinin tanım dosyalarını tanımlamak için LinkTypes ve LinkType öğelerini kullanın. Proje oluşturulduktan sonra, bağlantı türleri ekleyebilir, değiştirebilir, etkinleştirebilir, devre dışı bırakabilir ve silebilirsiniz. Daha fazla bilgi için bkz. Bağlantı Türlerini Özelleştirme ve Yönetme [witadmin].

LinkType öğesini karşılık gelen kapsayıcı öğe içinde yalıtmanız gerekir: LinkTypes. LinkType öğesi için aşağıdaki sözdizimi yapısını kullanın.

<LINKTYPES>
   <LINKTYPE fileName="PathName\LinkTypeName.xml" />
   . . . 
</LINKTYPES>

Aşağıdaki tablo LinkType öğesinin özniteliğini açıklar.

Öznitelik

Açıklama

fileName

Konumu (PathName) ve karşıya yüklenecek dosyanın adını (LinkTypeName) belirtir.

MSF işlem şablonlarında, bağlantı türleri için tanım dosyaları WorkItem Tracking\LinkTypes klasöründe depolanır.

MSF Çevik Yazılım Geliştirme işlem şablonu için, task SharedStep ve TestedBy tanım dosyalarına karşılık gelen iki bağlantı türünün yüklemesini belirtmek için tanımlanır.

  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
      </LINKTYPES>
    </taskXml>
  </task>

Karşıya Yüklenecek Çalışma Öğesi Türlerini Belirtme

Bir ekip projesi oluşturulduğunda karşıya yüklenecek iş öğesi türlerinin tanım dosyalarını tanımlamak için WorkItemTypes ve WorkItemType öğelerini kullanın. Proje oluşturulduktan sonra, iş öğesi türleri ekleyebilir, değiştirebilir, etkinleştirebilir ve silebilirsiniz. Daha fazla bilgi için bkz. İş Öğesi Türlerini Özelleştirme ve Yönetme [witadmin].

WorkItemType öğesini karşılık gelen kapsayıcı öğe içinde yalıtmanız gerekir: WorkItemTypes. WorkItemType öğesi için aşağıdaki sözdizimi yapısını kullanın.

<WORKITEMTYPES>
   <WORKITEMTYPE fileName="PathName\WorkItemTypeName.xml" />
   . . . 
</WORKITEMTYPES>

Aşağıdaki tablo WorkItemType öğesinin özniteliğini açıklar.

Öznitelik

Açıklama

fileName

Konumu (PathName) ve karşıya yüklenecek dosyanın adını (WorkItemTypeName) belirtir.

MSF işlem şablonlarında, iş öğesi türleri için tanım dosyaları WorkItem Tracking\TypeDefinitions klasöründe depolanır.

MSF çevik yazılım geliştirme işlem şablonu için, task Bug, Issue, SharedStep, Task, TestCase ve UserStory tanım dosyalarına karşılık gelen altı tür iş öğesinin yüklemesini belirtmek için tanımlanır. Daha fazla bilgi için bkz. İşlem Şablonuna Bir İş Öğesi Görevi Ekleyin.

  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
      </WORKITEMTYPES>
    </taskXml>
  </task>

Sorgu İzinleri Tanımlama

Gruplara izinler atamak için işlevsel permission öğesini kullanın. İzinleri belirleyerek, hangi eylemlerin, güvenlik gruplarının ve bireylerin bir proje için Ekip Sorguları düğümüne eklenen sorgular ve klasörler yürütebildiğini tanımlarsınız. Daha fazla bilgi için bkz. İşlevsel Alanlara Erişimi Denetleme.

MSF Çevik Yazılım Geliştirme işlem şablonu için, task ilk ekip sorgularını yapılandırmak için kullanılır.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="[SERVER]\$$PROJECTCOLLECTIONADMINGROUP$$" />
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="[$$PROJECTNAME$$]\$$PROJECTADMINGROUP$$" />
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="$$CREATOR_OWNER$$" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Readers" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Contributors" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Builders" />
   . . . 
</QUERIES>

Sorgu Klasörleri Tanımlama

Bir ekip projesinin Ekip Sorguları düğümü altında görünen sorguları ve klasörleri tanımlamak için Queries, QueryFolder ve Query öğesini kullanın. Proje oluşturulduktan sonra klasör ve sorgu ekleyebilir, değiştirebilir ve silebilirsiniz, ayrıca klasör ve sorgular üzerindeki izinleri de ayarlayabilirsiniz. Daha fazla bilgi için bkz. Çalışma Öğesi Sorgularının İzinlerini Ayarlamak ve Düzenlemek.

QueryFolder öğesini karşılık gelen kapsayıcı öğe içinde yalıtmanız gerekir: Queries. QueryFolder öğesi için aşağıdaki sözdizimi yapısını kullanın.

<QUERIES>
   <QueryFolder name="FolderName">
   . . . 
   </QueryFolder>
   . . . 
</QUERIES>

Aşağıdaki tablo QueryFolder öğesinin özniteliklerini açıklar.

Öznitelik

Açıklama

FolderName

Sorgu klasörünün adını belirtir.

Ayrıca aşağıdaki sözdizimi yapısını kullanarak, alt klasörleri klasörlerde iç içe yerleştirebilirsiniz.

<QUERIES>
   . . . 
   <QueryFolder name="FolderName">
   . . . 
      <QueryFolder name="SubfolderName">
      . . . 
      </QueryFolder>
   . . . 
   </QueryFolder>
   . . . 
</QUERIES>

Aşağıdaki örnek "Yineleme 1" olarak etiketlenen ve Etkin Hatalar, Etkin Görevler ve Yineleme Biriktirme Listesi olmak üzere üç sorgu içeren bir klasörü gösterir. Sorgunuzu .wiq dosyası olarak kaydetme hakkında daha fazla bilgi için bkz. İşlem Şablonuna Bir İş Öğesi Görevi Ekleyin.

<QueryFolder name="Iteration 1">
          <Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />
          <Query name="Active Tasks" fileName="WorkItem Tracking\Queries\ActiveTasks.wiq" />
          <Query name="Iteration Backlog" fileName="WorkItem Tracking\Queries\Iteration1Backlog.wiq" />
   . . . 
   </QueryFolder>

Karşıya Yüklenecek Kategorileri Belirtme

Bir ekip projesi oluşturulduğunda karşıya yüklenecek kategorileri tanımlamak için Categories öğesini kullanın. Proje oluşturulduktan sonra, kategori ekleyebilirsiniz. Daha fazla bilgi için bkz. İş Öğesi Türleri için Kategorileri Özelleştirme [witadmin].

Categories öğesini karşılık gelen kapsayıcı öğe içinde yalıtmanız gerekir: taskXml. Categories öğesi için aşağıdaki sözdizimi yapısını kullanın.

<taskXml>
   <CATEGORIES fileName="PathName\CategoriesFileName.xml " />
   . . . 
</taskXml>

Aşağıdaki tablo Categories öğesinin özniteliğini açıklar.

Öznitelik

Açıklama

fileName

Yüklenecek konumu (PathName) ve dosya adını (CategoriesFileName) belirtir.

MSF işlem şablonlarında, kategoriler için tanım dosyası WorkItem Tracking klasöründedir. Dosya adı Categories.xml'dir.

MSF Çevik Yazılım Geliştirme işlem şablonu için, task Categories.xml dosyasının yüklemesini belirtmek için tanımlanır.

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

Oluşturulacak Çalışma Öğesi Nesnelerini Belirtme

Ekip projesi oluşturulduğunda oluşturulacak iş öğesi nesnelerini tanımlamak için WorkItems, WI ve Field öğelerini kullanın. HyperLink öğesini kullanarak isteğe bağlı olarak iş öğesi nesnesinde yer almak üzere bir URL belirtebilirsiniz.

WI öğesini karşılık gelen kapsayıcı öğe içinde yalıtmanız gerekir: WorkItems. WI öğesi için aşağıdaki sözdizimi yapısını kullanın.

<WORKITEMS>
   <WI type="WorkItemTypeName" />
      <FIELD refname="FieldReferenceName" value="Value" />
   . . . 
      <HYPERLINK URL="URL" relativePath="true | false" />
   </WI>
   . . . 
</WORKITEMS>

Aşağıdaki tablo WI, Field ve HyperLink öğeleri için olan özniteliklerini açıklar.

Öğe

Öznitelik

Açıklama

WI

type

Bir çalışma öğesi türünün başvuru adını belirtir. İş öğesi türü önceden workitems eklenti dosyasında tanımlanmalıdır.

Field

refname

Çalışma öğesi türü için tanımlanan bir alanın başvuru adını belirtir.

Field

value

Çalışma öğesi nesnesi oluşturulduğunda alana atanacak değeri belirtir.

HyperLink

URL

İş öğesi olgusuna dahil edilecek URL.

HyperLink

relativePath

Köprünün göreli yol olup olmadığını gösterir. false varsayılan değerdir.

MSF işlem şablonlarında tanımlanmış bir çalışma öğesi nesnesi yok. Aşağıdaki örnekte, tek bir görev çalışma öğesi eklemek ve Başlık, Yineleme Yolunu, Durum, Neden ve Açıklama alanları değerlerini belirtmek için sözdizimini gösterir. Daha fazla bilgi için bkz. İşlem Şablonuna Bir İş Öğesi Görevi Veya Örneği Ekleyin.

<task id="WIT_Instances" name="Work Item tasks definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item instances created"> 
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
       <WORKITEMS>
       <WI type="Task">
          <FIELD refname="System.Title" value="Setup: Set Permissions" />
          <FIELD refname="System.IterationPath" value="$$PROJECTNAME$$\Iteration 1" />
          <FIELD refname="System.State" value="Active" />
          <FIELD refname="System.Reason" value="New" />
          <FIELD refname="System.Description" value="Using the admin UI in Visual Studio adds users to one of the 3 groups: Project administrators, Contributors, or Readers." />
         </WI>
      </WORKITEMS>

Ayrıca bkz.

Görevler

İş Öğe Tür Tanım Değişikliklerini Doğrulama

Kavramlar

Adım Adım Özelleştirme İşlemi

Proje İzleme Verilerini, Formlarını, İş Akışını ve Diğer Nesneleri Özelleştirme

İşlem Şablonu Dosyalarıyla Çalışma

İşlem Şablonu İçinde İşlevsel Alan Özelleştirme

Diğer Kaynaklar

Öğeler (İş Öğesi Türü Tanım Şeması)

Öğeler (İş Öğesi Metodoloji Şablonu)

İşlem Şablonlarını Özelleştirme