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

Azure DevOps Services (Barındırılan XML)

Azure DevOps Services, web tabanlı 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, bu işlemden bir veya daha fazla proje oluşturabilirsiniz. İşlemleri herhangi bir zamanda yeniden içeri aktararak güncelleştirin. İşlem şablonunda yapılan değişiklikler daha sonra işlemi kullanan tüm projelere uygulanır.

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

Şirket içi bulut Azure DevOps Services şirket içi ve şirket içi Team Foundation Server farklılık vardır. Bu farkların özeti için bkz. İşlem şablonu özelleştirmeleri arasındaki farklar.

Bir işlemi özelleştirme

Bir işlemi özelleştirebileceğinizde, iyi tanımlanmış bir işlemle başlayarak yeni bir işlemden daha kolaydır.

Şirket içi kaynaklarla birlikte kullanılan mevcut bir işlemi Team Foundation Server, içeri aktarma için şablonlara yerleştirilen kısıtlamalara uygun olduğundan emin olun.

İşlem Ayarlar > Açma

Kuruluş ayarları İşlem sayfasından işlemler için özelleştirmeler oluşturabilir, yönetebilir ve yapabilirsiniz.

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

   

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

   

   Önemli

   İşlem'i görmüyorsanızTFS-2018 veya önceki bir sürümde çalışıyorsanız. İşlem sayfası desteklenmiyor. Şirket içi XML işlem modeli için desteklenen özellikleri kullan gerekir.

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

1. İşlemler sekmesinde, dışarı aktarmayı istediğiniz Barındırılan XML işleminin kısayol menüsünü açmak için üç noktayı (...) seçin. Yalnızca Barındırılan XML işlemlerini dışarı aktarın.

   

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

2. Kök dizinde bulunan ProcessTemplate.xml dosyasını yeniden adlandırır.

   Mevcut işlemlerden ayırt etmek için işlemi olarak adlar.

   <name>MyCompany Agile Process </name>

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

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

3. Desteklenen özelleştirmeleri uygulama.

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

Sürecinize aşağıdaki özelleştirmeleri uygulayabilirsiniz:

• WIT ekleme, kaldırma veya değiştirme.
• Bir alanı ekleyin veya değiştirin.
• En fazla beş portföy biriktirme listesi ekleyin.
• İşlem yapılandırmanız için kullanabileceğiniz kategorileri ekleyin.
• İşlem yapılandırmasını değiştirme.
• Genel listeler ekleyin.

Aşağıdaki bölümde, sistemin dayatılan sınırlamaları listelemektedir.

Kısıtlamalar

En fazla 32 işlemi Azure DevOps Services. Özel işlemleriniz aşağıdaki özetlenmiş kuralların tamamına uygun olması gerekir. Aksi takdirde, doğrulama hata iletileri içeri aktarma sırasında 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 dizimi ve kurallara uygun olması gerekir. 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 alanlar ve WIT tanımları arasında benzersiz kolay adlar kullanır

Ayrıca, işleminizin aşağıdaki doğrulama denetimlerini geçmesi gerekir:

• İşlem adları benzersizdir ve en fazla 155 Unicode karakter içerir.
  • Mevcut işlemle aynı ad ve sürüm GUID'si olan bir şablon, bu sürecin üzerine yazarak.
  • 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çermiyor. .exe dosyası içeren bir işlemi içeri aktarabilse bile, proje oluşturma başarısız olur.
• İşlemin toplam boyutu en fazla 2 GB 'dir. Aksi takdirde, proje oluşturma başarısız olur.

İşlem yapılandırması

ProcessConfiguration.xml tanım dosyası, ProcessConfiguration XML öğesi başvurusundaaçıklanan sözdizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşullara uyması gerekir:

• Tüm TypeFields öğelerini belirtir
• Beş portföy biriktirme listesi ile sınırlıdır
• Yalnızca bir tane üst öğe olmayan portföy biriktirme listesi içerir
• Her bir alt portföy kapsamı için yalnızca bir üst portföy biriktirme listesi belirtir
• Gerekli iş akışı durumundan metastate eşlemelerini içerir ve desteklenmeyen meta durumlara başvurmaz

Kategoriler

Categories.xml tanım dosyası, CATEGORIES XML öğe başvurusundaaçıklanan sözdizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşullara uyması gerekir:

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

İş öğesi türleri

WITD öğesi ve onun alt öğeleri WITD XML öğe başvurusu' nda açıklanan sözdizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşullara uyması gerekir:

• Tüm WıT 'lerde tek bir WıT ve 512 alanları içinde en fazla 512 alan vardır.
• WıT 'e atanan kolay ad ve gerekli refname özniteliği WIT tanım dosyaları kümesi içinde benzersizdir.
• Gerekli refname özniteliği değeri izin verilmeyen karakterler içeremez veya izin verilmeyen ad alanları sistemini kullanamaz. Ad ve Microsoft. Ad.
• Başvuru adlarında en az bir nokta (.) ve diğer tüm karakterler boşluk içermeyen harflerdir.
• WITD öğesi, Weblayout ve denetim öğelerindebelirtilen sözdizimine uyan bir Weblayout öğesini tanımlayan bir form öğesi içerir.

Çalışma öğesi alanları

Bir FIELDS öğesi ve onun alt öğeleri, alan XML öğesi başvurusundaaçıklanan sözdizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşullara uyması gerekir:

• WıT 'e atanan kolay ad ve gerekli refname özniteliği WIT tanım dosyaları kümesi içinde benzersizdir.
• Gerekli refname özniteliği değeri izin verilmeyen karakterler içeremez veya izin verilmeyen ad alanları sistemini kullanamaz. Ad ve Microsoft. Ad.
• Başvuru adlarında en az bir nokta (.) ve diğer tüm karakterler boşluk içermeyen harflerdir.

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

Sınır kısıtlamaları

• Fields öğesi 512 alanlarla sınırlıdır.
• Bir iş öğesi türü 64 kişi adı alanı ile sınırlıdır. Kişi adı alanı özniteliği ve değeri olan bir alandır syncnamechanges=true .
• ALLOWEDVALUES veya SUGGESTEDVALUES öğesi 512 ListItem öğeleriyle 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 belirtilmiştir:

• İşlem yapılandırma biriktirme listesini tanımlayan bir kategorideki tüm WTS 'ler için, öznitelikler ve değerler için kullanılan alanları ve değerlerini belirtin type=Teamtype=Order .
• Düzenli bir biriktirme listesi veya portföy biriktirme listesi tanımlayan bir kategorideki tüm WTS 'ler için, için kullanılan alanı belirtin type=Effort .
• Taskbacklog öğesini tanımlayan kategoride bulunan tüm WTS 'ler için şunu belirtin:
  • İçin kullanılan alan type=RemainingWork .
  • İçin kullanılan alan type=Activity .
  • İçin kullanılan alan için ALLOWEDVALUES kuralı .

Kural kısıtlamaları

Standart alan kuralı kısıtlamalarınaek olarak, aşağıdaki kısıtlamalar uygulanır:

• Alan kuralı öğeleri for ve Not özniteliklerini belirtemez.
• FIELD öğeleri CANNOTLOSEVALUE, NOTSAMEAS, Matchve PROHIBITEDVALUESalt kural öğelerini içeremez.
• Aşağıdaki alanlar haricinde, sistem için alan tanımları. Ad alanları alan kuralları içeremez.
  • System. title gerekli ve varsayılankuralları içerebilir.
  • System. Description, gerekli ve varsayılankuralları içerebilir.
  • System. AssignedTo, gerekliolan, varsayılan, Allowexistingvalueve ValidUserkurallarını içerebilir.
  • System. ChangedBy, gerekliolan kuralları, varsayılan, Allowexistingvalueve ValidUseriçerebilir.

Tutarlı adlar ve öznitelikler

Bir işlem veya bir proje koleksiyonu içinde, bir alan öğesi tarafından tanımlanan ad, türve 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çermesi için kullanılan alanlara karşılık gelir. Aşağıdaki çekirdek sistem alanları, kimlik alanları olarak sabit kodludur:

• Atanan (System. AssignedTo)
• Yetkilendirme (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ı Ekle

Syncnamechanges özniteliğini doğru olarak belirttiğinizde bir dize alanı bir kimlik alanı olarak tanınır.

Kimlik alanları üzerinde kural kısıtlamaları

İşlem alma işleminin geçerli sürümü için, bir alan tanımı içinde aşağıdaki kuralların hiçbirini belirtmeyin.

• SUGGESTEDVALUES
• Kimlik olmayan değerler içeren kurallar.

Doğru örnek

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

    <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ği projelerde grubu oluşturduğunuzdan emin olun.

Yanlış örnek

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

• Bir ALLOWEDVALUES öğesi.
• DEFAULTKimlik olmayan dizeyi belirten bir öğe value="Not Assigned" .

    <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 Iş akışı öğesi ve onun alt öğeleri, iş akışı xml öğesi başvurusundaaçıklanan sözdizimine ve kurallara uymalıdır. Ayrıca, aşağıdaki koşullara uyması gerekir:

• Her WıT 'yi 16 iş akışı durumuna sınırlar
• ProcessConfiguration tanım dosyasında meta durumlarıyla eşlenen tüm iş akışı durumlarını tanımlar
• "Önerilen" durum kategorisi ve "sürüyor" durum kategorisiyle eşlenen iş akışı durumlarıyla eşlenen tüm iş akışı durumları arasında geçiş tanımlar
• "Sürüyor" durum kategorisine eşlenen tüm iş akışı durumları ve "tamamlanmış" durum kategorisiyle eşlenen iş akışı durumları arasında bir geçiş tanımlar.

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

Genel listeler

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

• En fazla 64 genel liste vardır.
• Liste başına en fazla 512 öğe vardır.
• Yaklaşık 10.000 öğe, tüm WTS 'lerde belirtilen tüm genel listeler arasında toplam olarak tanımlanabilir.

Form düzeni

Form öğesi ve onun alt öğeleri, Form XML öğesi başvurusu' nda açıklanan sözdizimine ve kurallara uymalıdır.

Denetim öğesi özel bir 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 sürecine kopyalama
• Barındırılan XML’den Devralınmış işleme geçiş yaparken desteklenen işlemler