Barındırılan XML işlemini özelleştirme

Azure DevOps Services

Azure DevOps Services, web tabanlı bir içeri aktarma işlemi olan bir yönetim deneyimi aracılığıyla işlem eklemeyi ve güncelleştirmeyi destekler. Bir işlem ekledikten sonra, işlemden bir veya daha fazla proje oluşturabilirsiniz. İşlemi, istediğiniz zaman yeniden içeri aktararak güncelleştirebilirsiniz. İşlem şablonunda yapılan değişiklikler, daha sonra işlemi kullanan tüm projelere uygulanır.

Önemli

Barındırılan XML işlem modeliyle, bir işlem şablonunun belirli XML tanım dosyalarını güncelleştirerek iş izlemeyi özelleştirebilirsiniz. Bu özellik yalnızca veriler Team Foundation Server Veritabanı İçeri Aktarma Hizmeti'nin kullanımıyla Azure DevOps Services geçirildiğinde kullanılabilir.

Özelleştirme ve işlem modelleri hakkında daha fazla bilgi edinmek için bkz. İş izlemeyi özelleştirme.

İşlem, birbirine bağlı bir dosya kümesi içeren bir zip dosyasıdır. Bu dosyalar, Azure DevOps Services iş öğesi izleme sisteminin ve diğer alt sistemlerin yapı taşlarını tanımlar. Bazı yapı taşları mevcut projeleri güncelleştirirken diğerleri yalnızca yeni projelere uygulanır. Yapı taşları listesinin tamamı için aşağıdaki tabloya bakın.

İşlemi içeri aktarırken/güncelleştirirken kullanılır

Yeni proje oluştururken kullanılır

Sistem varsayılanlarıyla değiştirildi

Yoksayıldı

İş Öğesi İzleme

Fikir

Kategoriler

İşlem Yapılandırması

Alanlar ve Yinelemeler

Test Yönetimi

İş Öğeleri

İş Öğesi Sorguları

Oluşturma

Laboratuar Yönetimi

Sürüm Denetimi

Microsoft Project Eşlemeleri

Raporlar

Portal (SharePoint Ürünleri)

Azure DevOps Services neleri desteklediğiyle şirket içi Team Foundation Server'ın desteklediği arasında farklar vardır. Bu farklılıkların özeti için bkz . şablon özelleştirme farklarını işleme.

bir işlemi özelleştirme

Bir işlemi özelleştirdiğinizde, iyi tanımlanmış bir işlemle başlamak yeni bir işlem oluşturmaktan daha kolaydır.

Şirket içi Team Foundation Server ile kullandığınız mevcut bir işlemi güncelleştirirseniz, içeri aktarma için şablonlara yerleştirilen kısıtlamalara uydığından emin olun.

Ayarlar>İşlemi'nin açılması

Kuruluş ayarları>İşlem'den işlemler oluşturur, yönetir ve özelleştirmeler yaparsınız.

1. Projeleri açmak için Azure DevOps logosunu seçin. Ardından Kuruluş ayarları'nı seçin.

   

2. Ardından İşlem'i seçin.

   

   Önemli

   İşlem'i görmüyorsanız, TFS-2018 veya önceki bir sürümden çalışıyorsunuz demektir. İşlem sayfası desteklenmez. Şirket içi XML işlem modeli için desteklenen özellikleri kullanmanız gerekir.

İşlemi dışarı ve içeri aktarma

1. İşlemler sekmesinden üç noktayı (...) seçerek dışarı aktarmak istediğiniz Barındırılan XML işleminin kısayol menüsünü açın. Yalnızca Barındırılan XML işlemlerini dışarı aktarabilirsiniz.

   

   Zip dosyasını kaydedin ve dosyadaki tüm dosyaları ayıklayın.

2. kök dizinde bulunan ProcessTemplate.xml dosyasının içindeki işlemi yeniden adlandırın.

   Mevcut işlemlerden ayırt etmek için işlemi adlandırın.

   <name>MyCompany Agile Process </name>

   Sürüm türünü değiştirin ve ana ve ikincil sayıları değiştirin. Bu örnekte olduğu gibi tür için ayrı bir GUID sağlayın:

   <version type="F50EFC58-C2FC-4C66-9814-E395D90778A3" major="1" minor="1"/>

3. Desteklenen özelleştirmeleri uygulayın.

4. Kök dizindeki tüm dosya ve klasörlerin zip dosyasını oluşturun.

5. Özel işleminizin zip dosyasını içeri aktarın.

Desteklenen özelleştirmeler

İşleminize aşağıdaki özelleştirmeleri uygulayabilirsiniz:

• WIT ekleyin, kaldırın veya değiştirin.
• Alan ekleme veya değiştirme.
• En fazla beş portföy kapsamı ekleyin.
• İşlem yapılandırmanızda kullanacağınız kategorileri ekleyin.
• İşlem yapılandırmasını değiştirin.
• Genel listeler ekleyin.

Aşağıdaki bölümde, sistemin uyguladığı sınırlamalar listelenir.

Kısıtlamalar

En fazla 32 işlemi Azure DevOps Services içeri aktarabilirsiniz. Özel işlemleriniz aşağıdaki tüm özetlenmiş kurallara uygun olmalıdır. Aksi takdirde, içeri aktarma işleminde doğrulama hata iletileri görünebilir.

• İşleme
  • İşlem yapılandırması
  • Kategoriler
  • İş öğesi türleri
    • Alanlar
      • Sınırlar
      • Gerekli alanlar
      • Kural kısıtlamaları
      • Tutarlı adlar ve öznitelikler
      • Kimlik alanları
      • Workflow
      • Genel listeler
    • Workflow
    • Form düzeni

İşlem şablonu

ProcessTemplate.xml dosyanız , ProcessTemplate XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uygun olmalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• Tanımlanan WIT sayısını 64 ile sınırlar
• Yalnızca bir Categories.xml tanım dosyası içerir
• Yalnızca bir ProcessConfiguration.xml tanım dosyası içerir
• Tüm alanlarda ve WIT tanımlarında benzersiz kolay adlar kullanır

Ayrıca, işleminiz aşağıdaki doğrulama denetimlerini geçmelidir:

• İşlem adları benzersizdir ve en fazla 155 Unicode karakter içerir.
  • Var olan bir işlemle aynı ada ve sürüm GUID'sine sahip bir şablon bu işlemin üzerine yazar.
  • Aynı ada ancak farklı bir sürüm GUID'sine sahip bir şablon hata oluşturur.
  • İşlem adları şu özel karakterleri içeremez: . , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } < >.
    Ek kısıtlamalar için bkz . Adlandırma kısıtlamaları.
• İşlem klasörleri .exe dosya içermez. .exe dosyası içeren bir işlemi içeri aktarabiliyor olsanız bile proje oluşturma işlemi başarısız olur.
• İşlemin toplam boyutu en fazla 2 GB'tır. Aksi takdirde proje oluşturma işlemi başarısız olur.

İşlem yapılandırması

ProcessConfiguration.xml tanım dosyası , ProcessConfiguration XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uygun olmalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• Tüm TypeFields öğelerini belirtir
• Beş portföy kapsamıyla sınırlıdır
• Tek bir ayrılmamış portföy kapsamı içerir
• Her bir alt portföy kapsamı için yalnızca bir üst portföy kapsamı belirtir
• Gerekli iş akışı durumundan meta duruma eşlemelerini içerir ve desteklenmeyen meta durumlara başvurmaz

Kategoriler

Categories.xml tanım dosyası , Kategoriler XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uygun olmalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• 32 kategori ile sınırlıdır
• ProcessConfiguration.xml dosyasında başvuruda bulunılan tüm kategorileri tanımlar

İş öğesi türleri

WITD öğesi ve alt öğeleri WITD XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• Tek bir WIT içinde en fazla 512 alan ve tüm WIT'lerde 512 alan vardır.
• Wit'ye atanan kolay ad ve gerekli refname özniteliği, WIT tanım dosyaları kümesinde benzersizdir.
• Gerekli refname öznitelik değeri izin verilmeyen karakterler içermez veya izin verilmeyen ad alanlarını sistem olarak kullanmaz. Ad ve Microsoft. Adı.
• Başvuru adları en az bir nokta (.) içerir ve diğer tüm karakterler boşluk içermeyen harflerdir.
• WITD öğesi, WebLayoutve Control öğelerinde belirtilen söz dizimine uyan bir WebLayout öğesini tanımlayan bir FORM öğesi içerir.

İş öğesi alanları

FIELDS öğesi ve onun alt öğeleri FIELD XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• Wit'ye atanan kolay ad ve gerekli refname özniteliği, WIT tanım dosyaları kümesinde benzersizdir.
• Gerekli refname öznitelik değeri izin verilmeyen karakterler içermez veya izin verilmeyen ad alanlarını sistem olarak kullanmaz. Ad ve Microsoft. Adı.
• Başvuru adları en az bir nokta (.) içerir ve diğer tüm karakterler boşluk içermeyen harflerdir.

FIELD öğesi ve onun alt öğeleri GLOBALLIST öğesi içerebilir.

Sınırlama kısıtlamaları

• FIELDS öğesi 512 alanla sınırlıdır.
• İş öğesi türü 64 kişi adı alanıyla sınırlıdır. Kişi adı alanı, özniteliğine ve değerine syncnamechanges=truesahip bir alandır.
• ALLOWEDVALUES veya SUGGESTEDVALUES öğesi 512 LISTITEM öğesiyle sınırlıdır.
• Bir alan 1.024 kuralla sınırlıdır.

Gerekli alanlar

ProcessConfiguration.xml dosyasında aşağıdaki alanlar belirtilir:

• İşlem yapılandırması kapsamı tanımlayan bir kategorideki tüm WIT'ler için öznitelikler ve değerler type=Team ve için kullanılan alanları belirtin.type=Order
• Normal kapsam veya portföy kapsamı tanımlayan bir kategorideki tüm WIT'ler için, için type=Effortkullanılan alanı belirtin.
• TaskBacklog öğesini tanımlayan kategorideki tüm WIT'ler için şunları belirtin:
  • için type=RemainingWorkkullanılan alan.
  • için type=Activitykullanılan alan.
  • için type=Activitykullanılan alanın ALLOWEDVALUES kuralı.

Kural kısıtlamaları

Standart alan kuralı kısıtlamalarına ek olarak aşağıdaki kısıtlamalar uygulanır:

• Alan kuralı öğeleri öznitelikleri değiliçin belirtemez.
• ALAN öğeleri CANNOTLOSEVALUE, NOTSAMEAS, MATCH ve PROHIBITEDVALUES alt kural öğelerini içeremez.
• Aşağıdaki alanlar dışında, Sistem için FIELD tanımları. Ad alanları alan kuralları içeremez.
  • System.Title , REQUIRED ve DEFAULT kurallarını içerebilir.
  • System.Description , REQUIRED ve DEFAULT kurallarını içerebilir.
  • System.AssignedTo gerekli, DEFAULT, ALLOWEXISTINGVALUE ve VALIDUSER kurallarını içerebilir.
  • System.ChangedBy REQUIRED, DEFAULT, ALLOWEXISTINGVALUE ve VALIDUSER kurallarını içerebilir.

Tutarlı adlar ve öznitelikler

Bir işlemde veya proje koleksiyonunda, ad, tür ve field öğesinin tanımladığı diğer öznitelikler tüm WIT tanımlarında aynı olmalıdır.

Kimlik alanları

Kimlik alanları hesap, kullanıcı veya grup adlarını içermek için kullanılan alanlara karşılık gelir. Aşağıdaki temel sistem alanları kimlik alanları olarak sabit kodlanmıştır:

• Atanan (System.AssignedTo)
• Yetkili Olarak (System.AuthorizedAs)
• Değiştiren (System.ChangedBy)
• Oluşturan (System.CreatedBy)
• Etkinleştiren (Microsoft.VSTS.Common.ActivatedBy)
• Kapatan (Microsoft.VSTS.Common.ClosedBy)
• Çözümleyen (Microsoft.VSTS.Common.ResolvedBy)

Özel kimlik alanı ekleme

Syncnamechanges özniteliğini True olarak belirttiğinizde dize alanı kimlik alanı olarak kabul edilir.

Kimlik alanlarında kural kısıtlamaları

İşlem içeri aktarma işleminin geçerli sürümü için FIELD tanımı içinde aşağıdaki kurallardan hiçbirini belirtmeyin.

• SUGGESTEDVALUES
• Kimliksizlik değerleri içeren kurallar.

Doğru örnek

Bir kimlik alanında geçerli olan hesap adlarını sınırlamak için, öğesini bir grup adı özniteliğiyle belirtin VALIDUSER .

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <VALIDUSER group="[PROJECT]\Program Manager Group" />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

İşlemi içeri aktarmadan önce, işlemi güncelleştiren projelerde grubu oluşturduğunuzdan emin olun.

Yanlış örnek

Aşağıdaki örnek, şunu belirttiğinden geçerli değildir:

• Bir ALLOWEDVALUES öğe.
• DEFAULT nonidentity dizesini value="Not Assigned"belirten bir öğesi.

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <ALLOWEDVALUES>
          <LISTITEM value="[PROJECT]\Program Manager Group" />
          <LISTITEM value="Not Assigned" />
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="Not Assigned" />
        <VALIDUSER />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

İş akışı

Bir WORKFLOW öğesi ve onun alt öğeleri WORKFLOW XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uygun olmalıdır. Ayrıca, aşağıdaki koşulları karşılaması gerekir:

• Her WIT'yi 16 iş akışı durumuyla sınırlar
• ProcessConfiguration tanım dosyasındaki meta durumlarla eşlenen tüm iş akışı durumlarını tanımlar
• "Önerilen" durum kategorisine eşlenen tüm iş akışı durumları ile "InProgress" durum kategorisine eşlenen iş akışı durumları arasında bir geçiş tanımlar
• "InProgress" durum kategorisine eşlenen tüm iş akışı durumları ile "Complete" durum kategorisine eşlenen iş akışı durumları arasında bir geçiş tanımlar.

Durum kategorisi ve eşlemelerinin açıklaması için bkz . İş akışı durumları ve durum kategorileri.

Genel listeler

Barındırılan XML işlem modeli için aşağıdaki sınırlar genel liste içeri aktarma işlemine yerleştirilir:

• En fazla 64 genel liste vardır.
• Liste başına en fazla 512 öğe vardır.
• Tüm WIT'ler arasında belirtilen tüm genel listeler arasında toplamda yaklaşık 10.000 öğe tanımlanabilir.

Form düzeni

Form öğesi ve alt öğeleri, FORM XML öğesi başvurusunda açıklanan söz dizimine ve kurallara uymalıdır.

Control öğesi özel denetim belirtemez. Özel denetimler desteklenmez.

İlgili makaleler:

• Barındırılan XML işlemini içeri ve dışarı aktarma
• Kurallar ve kural değerlendirmesi
• Bir projeyi Barındırılan XML'den devralınan bir işleme değiştirme
• Barındırılan XML işlemini Devralma işlemine kopyalama
• Barındırılan XML’den Devralınmış işleme geçiş yaparken desteklenen işlemler