İşlem şablonuna iş öğesi sorguları ekleme
Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Önemli
Bu makale, Şirket içi XML işlem modelleri için proje özelleştirmesi için geçerlidir. İşlem modellerini genel bakış için bkz. İş izleme deneyiminizi özelleştirme.
İşlem şablonunuz için iş öğesi sorguları ekleyerek, bir proje için ilk paylaşılan sorgu kümesi ve sorgu klasörü yapısı tanımlayabilirsiniz. Tüm ekip üyeleri, üzerinde işlem gerçekleştirmeleri gereken hataları, görevleri ve diğer iş öğelerini bulmak için sorguları kullanır.
İş öğesi sorguları, etkin hataların veya kapalı görevlerin listesi gibi iş öğelerinin listesini oluşturma ölçütlerini belirtir. İş öğesi sorgularının dosyaları bir .wiq uzantısına sahip olur ve varsayılan işlem şablonları için WorkItem İzleme klasörünün Sorgular alt klasöründe depolanır.
Önemli
Varsayılan işlem şablonları, Sorgular sayfasındaki Sorgularım birkaç sorgu tanımlar. Artık Paylaşılan Sorguları tanımlamazlar. Paylaşılan sorguları her zaman tanımlayabilir ve bunları özel bir işlem şablonuna eklemek için kullanabilirsiniz. Sorgu tanımları, işlem şablonunda tanımlanan alanlara ve iş öğesi türlerine bağlıdır. Ayrıca Portal eklentisi içinde karşıya yüklenen bazı çalışma kitapları da sorgu tanımlarını kullanır.
WorkItemTracking eklentisi içinde görev olarak karşıya yüklensin sorgu tanımlarını belirtirsiniz. Bir işlem şablonunda bulunan birkaç yapıt bir sorguya bağlı olduğundan bu görev gerekli olabilir. Ayrıca, sorguları karşıya yükleme görevi, iş öğesi türlerini karşıya yüklemek için görevin başarıyla tamamlanmasına bağlıdır. TaskXml öğesi içinde karşıya yüklemek için her sorgu dosyasını belirtirsiniz.
İşlem şablonundan bir proje oluşturulduktan sonra, sorgu ekleme, kaldırma ve değiştirme işlemlerini Sorgu Düzenleyicisi. Daha fazla bilgi için bkz. Sorguları listele ve yönetmek için sorgu düzenleyicisini kullanma.
Gruplara sorgu izinleri atama hakkında bilgi için bkz. İşlevsel alanlara erişimi denetleme. Sorgu klasörleri oluşturma hakkında bilgi için bkz. İş öğelerini izlemek için nesneleri tanımlama.
İş öğesi sorgusu (.wiq) dosyası oluşturma
Her sorgu tanımı, WorkItemQuery üst öğesi kullanılarak .wiq uzantısına sahip kendi dosyasında belirtilmelidir ve wiq.xsd dosyasında tanımlanan şemaya uygun olmalıdır.
Aşağıdaki örnekte, bir iş öğesi sorgusunu tanımlayan üst düzey söz dizimi yapısı gösterir:
<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
<Wiql>
WorkItemQueryLanguage
</Wiql>
</WorkItemQuery>
Bir işlem şablonuna eklemek üzere iş öğesi sorgusu oluşturma hakkında daha fazla bilgi için bkz. İş öğesi sorgusu tanımlama.
Karşıya yüklenilen sorguları belirtme
İş öğesi sorgularını işlem şablonuna dahil etmek için, workitems.xml dosyasında bir veya daha fazla görev oluşturun. Bu görevleri, işlem şablonlarınızı indirdiğiniz klasörde yer alan \WorkItem İzleme klasöründe bulabilirsiniz. İş öğesi sorgusunun dosyasını belirtmek için Query öğesini kullanın. Örneğin, aşağıdaki XML, karşıya yüklenmek ve Etkin Hatalar olarak adlandırılmış ActiveBugs.wiq dosyasında tanımlanan sorguyu belirtir.
<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" /
WorkItemTracking eklentisine görev olarak yüklemek için sorgular kümesi eklersiniz.
Aşağıdaki örnekte, Product Management adlı bir sorgu klasörü oluşturmak ve Tüm Kullanıcı Hikayeleri adlı bir sorguyu bu klasöre yüklemek için bir görevin nasıl belirt adımları anlattır.
<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" /
<dependencies
<dependency taskId="WITs" /
</dependencies
<taskXml
<QUERIES
<QueryFolder name="Product Management"
<Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" /
</QueryFolder
. . .
</QUERIES
</taskXml
</task
Daha fazla bilgi için bkz. İş öğelerini izlemek için nesneleri tanımlama.
QUERY öğeleri
Aşağıdaki söz dizimi, QUERIES öğesinin ve alt öğelerinin yapısını gösterir.
<QUERIES
<Permission /
<QueryFolder
<Query /
</QueryFolder
</QUERIES
Aşağıdaki tabloda, karşıya yüklenilen sorgu klasörü yapısını, izinlerini ve sorgularını belirtmek için kullanabileceğiniz öğeler açık almaktadır. Bu öğeleri WorkItemTracking eklenti dosyasındaki taskXml kapsayıcı öğesi içinde belirtirsiniz.
| Öğe | Açıklama ve söz dizimi |
|---|---|
| İzin | Sorgu öğesinin isteğe bağlı alt öğesi. Paylaşılan sorgulara atanan varsayılan izinleri belirtir. Daha fazla bilgi için bkz. İş öğesi sorguları için izinleri atama.<permission allow="ListOfPermissions" identity="GroupName" /> |
| Sorgu | QUERIES öğesinin gerekli alt öğesi. Karşıya yüklenen bir sorguyu tanımlayan .wiq dosyasının adını ve yolunu belirtir.<Query name="QueryName" fileName="QueryFilePathName" />Aşağıdaki örnekte de olduğu gibi "Etkin Hatalar" etiketli sorguyu karşıya yükleyebilirsiniz. ve , ActiveBugs.wiq dosyasında tanımlanır: <Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" /> |
| Queryfolder | QUERIES öğesinin isteğe bağlı alt öğesi. Sorgu klasörünün adını belirtir. |
| SORGU | 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 kullanır olduğunu belirtir. |