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.

İşlem, birbirine bağlı bir dizi dosya içeren bir zip dosyasıdır. Bu dosyalar, Azure DevOps Services'teki 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.

Azure DevOps Services'in desteklediği ve şirket içi Team Foundation Server tarafından desteklenenler arasında farklılıklar 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 uygun olduğundan emin olun.

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

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

1. Projeler'i 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ındaki işlemi yeniden adlandırın.

   Mevcut işlemlerden ayırmak 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 ekleyin veya değiştirin.
• Beş adede kadar 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 özetlenmiş kuralların tümüne uygun olmalıdır. Aksi takdirde, içeri aktarma işleminde doğrulama hata iletileri görünebilir.

• Barındırılan XML işlemini özelleştirme
  • bir işlemi özelleştirme
    • İşlemi dışarı ve içeri aktarma
  • Desteklenen özelleştirmeler
  • Kısıtlamalar
    • İşlem şablonu
    • İşlem yapılandırması
    • Kategoriler
    • İş öğesi türleri
    • İş öğesi alanları
      • Sınırlama kısıtlamaları
      • Gerekli alanlar
      • Kural kısıtlamaları
      • Tutarlı adlar ve öznitelikler
      • Kimlik alanları
        • Özel kimlik alanı ekleme
        • Kimlik alanlarında kural kısıtlamaları
        • Doğru örnek
        • Yanlış örnek
    • Workflow
    • Genel listeler
    • Form düzeni
  • İlgili makaleler

İş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ımlı 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 dosyası 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 alt portföy kapsamı için yalnızca bir üst portföy kapsamı belirtir
• Gerekli iş akışı durumundan meta durum eşlemelerine sahip 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 kategoriyle 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 uygun olmalı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.
• Bir 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'i kullanır.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, WebLayout ve Denetim öğelerinde belirtilen söz dizimine uyan bir WebLayout öğesini tanımlayan bir FORM öğesi içerir.

İş öğesi alanları

FIELDS öğesi ve alt öğeleri FIELD 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:

• Bir 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'i kullanır.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 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 şunu 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ğil için belirtemez.
• ALAN öğeleri CANNOTLOSEVALUE, NOTSAMEAS, MATCH ve PROHIBITEDVALUES alt kural öğelerini içeremez.
• Aşağıdaki alanlar dışında, Sistem için ALAN 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 REQUIRED, 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şlem veya proje koleksiyonu içinde, FIELD öğesinin tanımladığı ad, tür ve 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çeren alanlara karşılık gelir. Aşağıdaki çekirdek 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 bir 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
• Nonidentity 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şlemin güncelleştirdiğini projelerde grubu oluşturduğunuzdan emin olun.

Yanlış örnek

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

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

    <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 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 durumlara 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 aktarmaya yerleştirilir:

• En fazla 64 genel liste vardır.
• Liste başına en fazla 1.024 öğ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