Adlandırma kısıtlamaları ve kuralları
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure DevOps'taki çoğu bileşenin adlandırma kısıtlamalarına ve kurallarına uyması gerekir. Kısıtlamalar tutarlı bir kullanıcı deneyimi sağlamaya ve diğer uygulamalarla uyumluluk sağlamaya yardımcı olur.
Yaygın kısıtlamalar arasında bir adın karakter uzunluğunu aşmama, özel karakterler içermeme ve bir nesne kümesindeki adların benzersizliğini koruma sayılabilir.
Önemli
API'yi kullanırken, kullanıcı arabirimi (UI) yerine, API doğrudan kullanıcı arabiriminde kısıtlanmış olabilecek karakterleri içeren bir ad belirtmenize olanak tanır.
En iyi yöntemler:
- Tutarlılığı korumak ve istenmeyen sorunları önlemek için kullanıcı arabirimi kısıtlamalarını izleyin.
- Adları program aracılığıyla doğrulayın ve özel karakterleri uygun şekilde işleyebilir.
Dikkat edilmesi gereken temel noktalar
Bu makaledeki uzunluk kısıtlamaları izin verilen Unicode karakter sayısıyla ölçülür. Vekil karakterler, uzunluk kısıtlamasına karşı iki karakter olarak sayılan iki Unicode karakterden oluşur. Daha fazla bilgi için bkz . Unicode ve Karakter Kümeleri Hakkında.
Diğer işletim sistemi dosyalarında olduğu gibi, ASCII denetim karakterlerine (ASCII 1-31) ve vekil birleşimlere de izin verilmez. Dosya adlarına uygulanan işletim sistemi kısıtlamaları hakkında genel bilgi için bkz . Dosyaları, Yolları ve Ad Alanlarını Adlandırma.
Not
- Tanımlayabileceğiniz öğe sayısıyla ilgili sınırlar için bkz . İş izleme, işlem ve proje sınırları.
Sistem ayrılmış adları
Aşağıdaki örnekler gibi sistem ayrılmış adlarını kullanmaktan kaçının:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web veya WEB
Ayrılmış adlar hakkında daha fazla bilgi için bkz . Dosya adları, yollar ve ad alanları.
Azure Artifacts
Evrensel paketler aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Paket adı | - Küçük harfle yazılmalıdır. - Harf veya sayılarla başlayıp bitmelidir. - Yalnızca harf, sayı ve kısa çizgi, alt çizgi veya nokta içermelidir. |
| Paket sürümü | Derleme meta verileri olmadan küçük harfle yazılmalıdır. |
Azure Boards
Yazılım geliştirme projelerinizi planlamak ve izlemek için bilgileri yakalamak için iş öğelerini kullanırsınız. İş öğeleriyle, yapılacak işi açıklayabilir, işi atayabilir, durumu izleyebilir ve ekibinizin içindeki çalışmaları koordine edebilirsiniz. Kullanıcı hikayeleri, görevler, hatalar ve sorunlar gibi farklı iş öğesi türleri farklı bilgi türlerini izler. Daha fazla bilgi için bkz . Azure Boards belgeleri.
Tüm iş öğesi izleme nesneleri bir veya daha fazla adla ilişkilendirilir. Başvuru adlarıyla ilişkili iş öğesi türleri ve genel listeler dışında çoğu kolay görünen adlara sahiptir. Kolay ad, bir alan için benzersiz, kullanıcı tarafından görünen bir tanımlayıcıdır. Kolay adların kullanılması, proje koleksiyonundaki projeler ve iş öğesi türleri arasında tutarlılık sağlar. Sistem, başvuru adını dahili olarak kullanır ve tanımlandıktan sonra değiştiremezsiniz.
Başvuru ve kolay adlar, alan adları ve ek boyutu gibi iş öğeleriyle ilişkili çeşitli öğelerle ilgili kısıtlamalar vardır.
Alan ve yineleme yolları
Alan Yolu ve Yineleme Yolu olmak üzere iki iş öğesi alanı, gruplandırma çalışması için bir ağaç yapısı hiyerarşisi sağlar. Alan yolları, iş öğelerini ürün, işlevsel veya özellik alanına göre gruplandırmaktadır. Yineleme yolları, bu iş öğelerini ele almak için iş öğelerini sprint'ler, kilometre taşları veya zaman aralıkları halinde gruplandırıyor.
Bu çok düğümlü alanlar, ağaç yapısı içindeki düğüm hiyerarşisini belirtmek için ters eğik çizgi \ karakterlerini kullanır.
Bu alanlara alt düğümlere atadığınız adlar aşağıdaki kısıtlamalara uygun olmalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Düğüm uzunluğu | 255'ten fazla karakter içermemelidir. |
| Ayrılmış adlar | - Yalnızca bir veya iki dönemden . ..oluşmamalıdır.- PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON veya AUX gibi sistem tarafından ayrılmış bir ad olmamalıdır. Ayrılmış adlar hakkında daha fazla bilgi için bkz . Dosya Adları, Yollar ve Ad Alanları. |
| Düğümler için özel karakterler | - Unicode denetim karakterleri içermemelidir. - Şu karakterlerden herhangi birini içermemelidir: \ / : * ? " < > | # $ & * +.- Yerel dosya sistemi tarafından yasaklanmış karakterler içermemelidir. Windows karakter kısıtlamaları hakkında daha fazla bilgi için bkz . Adlandırma Dosyaları, Yollar ve Ad Alanları. |
| Yol uzunluğu | 4.000'den fazla Unicode karakter içermemelidir. |
| Yol hiyerarşisi derinliği | 14 düzeyden daha az derin olmalıdır. |
Ekler
İş öğelerine eklenen dosyaların aşağıdaki kısıtlamalara uyması gerekir.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Dosya boyutu | Boyut üst sınırını aşmamalıdır: - Varsayılan maksimum boyut: 4.096 kilobayt. - Mutlak maksimum boyut: 2 gigabayt. |
| Kısıtlama türü | Kısıtlama |
|---|---|
| Dosya boyutu | Boyut üst sınırını aşmamalıdır: - Varsayılan maksimum boyut: 4.096 kilobayt. - Mutlak maksimum boyut: 2 gigabayt. Daha fazla bilgi için bkz . İş öğeleri için en büyük ek boyutunu değiştirme. |
Pano sütunu ve kulvar adları
Panonuz, kapsamınızı etkileşimli bir tabelaya dönüştürerek görsel bir iş akışı sağlar. Çalışma, fikirden tamamlanmaya kadar ilerledikçe, panodaki öğeleri güncelleştirirsiniz. Her sütun bir çalışma aşamasını, her kart ise işin bu aşamasında bir kullanıcı hikayesini (mavi kartlar) veya bir hatayı (kırmızı kartlar) temsil eder.
Sütunları ve kulvarları ekleyerek, kaldırarak veya yeniden adlandırarak panonuzu özelleştirin. Sütunlar, panodaki iş akışını destekler. Kulvarlar, farklı iş sınıflarını panoda yatay şeritler olarak yönetmenize olanak sağlar.
Sütun ve kulvar adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 256'dan fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Sütun adları, panodaki diğer sütun adlarında olduğu gibi olmamalıdır. - Kulvar adları, tahtadaki diğer kulvar adlarında olduğu gibi olmamalıdır. |
| Özel karakterler | Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. |
Alan adları
Her iş öğesi türü bir veya daha fazla iş öğesi alanı içerir. Bu alanlar, iş öğesi türüne göre iş öğeleri için depolanan bilgileri tanımlar. Her iş öğesi alanının ilişkili bir alan başvuru adı vardır. Alan başvuru adı her alanı benzersiz olarak tanımlar ve atandıktan sonra değiştirilemez. hazır iş öğesi alanları hakkında daha fazla bilgi için bkz . İş öğesi alan dizini.
İş öğesi alan adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 128'den fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Alan adları en az bir alfabetik karakter içermelidir. - Şu karakterlerden herhangi birini içermemelidir: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Baştaki veya sondaki boşlukları içermemelidir. - Ardışık iki veya daha fazla boşluk içermemelidir. |
| Özel karakterler | Kuruluş veya proje koleksiyonu içinde benzersiz olmalıdır. İş öğesi alan adlarının kapsamı proje koleksiyonuna göre belirlenmiş. Bir alan adını yeniden adlandırırsanız, bunu koleksiyondaki tüm projelerde tanımlanan tüm iş öğeleri ve WIT'ler için değiştirirsiniz. |
Alan başvuru adları ve taşınabilirliği
İş öğesi türü tanım dili, alan başvuru adı kavramını içerir. Alan başvuru adları, Team Foundation proje koleksiyonları arasında bağlantı noktası tanımları oluşturmanıza ve ayrıca Microsoft dışı tümleştirmelerin belirli alanları bulmasına ve bunlara başvurmasına olanak tanımanıza yardımcı olabilir. Bu adlar, .NET Framework uygulamasındaki bir ad alanının genel olarak benzersiz olması gibi genel olarak benzersizdir.
Sistem ad alanı yalnızca Team Foundation sistem işlevleri için zorunlu olan tüm çekirdek sistem alanlarını tanımlamak için kullanılır. İşlevselliği engelleyebileceğinden kendi System.X alanınızı oluşturamazsınız.
Microsoft ad alanı, iş öğesi izleme alanlarını tanımlamak için kullanılır. Bu alanlar, işlem şablonlarının iş öğesi türü tanımında tanımlanır.
Müşteriler ve iş ortakları, özel iş öğesi türleri için kendi alan ad alanlarını oluşturabilir. Varsayılan işlem şablonlarında tanımlanan sistem alanlarının ve alanların açıklamaları için bkz . İş öğesi alanlarının dizini.
Önemli
- Alan başvuru adları yeniden adlandırılamaz. Örneğin, "Başlık" alan adını "Üst Bilgi" olarak değiştirdiyseniz, bu alanın alan başvuru adı aynı kalır. Tümleştirmeler ve alanların iç gösterimleri, alan adının kendisine bağlı olarak yerine alan başvuru adını kullanmalıdır.
- Kendi Microsoft.X alanınızı oluşturabilmenize rağmen, işlevselliği veya Özellikleri Yapılandırma sihirbazının yükseltmeden sonra projeyi başarıyla güncelleştirme olanağını engelleyebileceği için bunu yapmanızı önermeyiz.
Alan başvurusu adları örnekleri
Aşağıdaki örneklerde, çeşitli ad alanlarında geçerli alan başvuru adları gösterilmektedir. Müşteriler ve iş ortakları özel iş öğesi türlerini desteklemek için kendi ad alanlarını da tanımlayabilir.
| Sistem ad alanı örnekleri | Microsoft ad alanı örnekleri | Diğer ad alanı örnekleri |
|---|---|---|
| System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason | Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType | Fabrikam Fiber kurgusal şirketi aşağıdaki özel iş öğesi alanlarını tanımlayabilir: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution Kurgusal yazılım şirketi Contoso Corporation aşağıdaki iş öğesi alanlarını tanımlayabilir: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Alan yardım metni
Sistem, kullanıcıların alana ne gireceklerini bilmelerine yardımcı olmak için çalışma zamanında yardım metnini görüntüler. Yardım metninin kapsamı belirli bir projedeki belirli bir iş öğesi türüyle belirlenmiştir.
Devralma işlemi için, Alanı düzenle iletişim kutusu, Tanım sekmesi, Açıklama aracılığıyla bir alan için yardım metni belirtirsiniz. Bkz. İş öğesi türüne özel alan ekleme. Şirket içi XML işlemi için öğesini kullanarak HELPTEXT yardım metni belirtirsiniz. bkz. İş izleme için alan ekleme veya değiştirme.
Eklediğiniz yardım metninin aşağıdaki kısıtlamalara uyması gerekir.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 255'ten fazla Unicode karakter içermemelidir. |
Genel listeler
Genel liste, şirket içi Azure DevOps Server örneği içindeki tüm proje koleksiyonlarında genel olarak kullanabileceğiniz bir liste öğesi değerleri kümesidir. İş öğesi türlerini tanımlarken, bazı iş öğesi alanlarının aynı izin verilen veya önerilen değer kümesini paylaştığını fark edebilirsiniz. Genel listeler, bu değerleri bir kez tanımlamanıza ve birden çok iş öğesi türü ve projesinde paylaşmanıza olanak tanır. Ayrıntılar için bkz . Genel listeleri tanımlama.
öğesi kullanılarak GLOBALLIST tanımlanan genel liste, öğesi kullanılarak LISTITEM belirtilen bir veya daha fazla liste öğesi içerir.
LISTITEM adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | - 254'ten fazla Unicode karakter içermemelidir. - Boş olmamalıdır. |
| Özel karakterler | - Baştaki veya sondaki boşlukları içermemelidir. - Ardışık iki boşluk içermemelidir. - Ters eğik çizgi \ karakterleri içermemelidir. |
| Kapsam | Genel listeler tüm projeler arasında kullanılabildiğinden, proje düzeyinde tanımlanmış öğeler (projeye özgü grup hesabı tanımları gibi) içermemelidir. |
Genel listeler aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Madde sayısı | Boş olamaz. Genel liste en az bir LISTITEM öğe içermelidir. |
| Benzersizlik | Boş olamaz. Genel liste en az bir LISTITEM öğe içermelidir. |
Bağlantı türü ve kategori başvuru adları
Bağlantı türünü veya kategoriyi her eklediğinizde veya oluşturduğunuzda bir başvuru adı tanımlayın. Tüm başvuru adları en fazla 70 Unicode karakter uzunluğunda olabilir.
Alfasayısal karakterler, alt çizgi karakterleri ve kısa çizgi karakterleri kullanarak bir başvuru adı tanımlayın. Her başvuru adının en az bir nokta .içermesi gerekir, ancak adın başında veya sonunda hiçbir nokta görünemez. Başvuru adı bir sayı veya alt çizgiyle başlamamalıdır ve gibi --ardışık birden çok kısa çizgi içeremez.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 70'ten fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Proje koleksiyonundaki başka bir alan başvuru adıyla aynı olmamalıdır. - Tüm dönemleri . alt çizgilerle _değiştirmek için bu adlar bilgisayar tarafından işlendikten sonra başka hiçbir alan başvuru adıyla aynı olmamalıdır. Örneğin, alan başvurusu adları My.*Field* ve My.Field her ikisi de aynı adla işlenir: My__Field |
| Özel karakterler | - Kısa çizgi -içermemelidir.- En az bir dönem .içermelidir.- Nokta .ile başlamamalı veya bitmemelidir.- Bir sayı ile başlamamalıdırAyrı çizgiyle _başlamamalıdır. |
İş öğesi etiketleri
İş öğesi etiketleri, kapsamlar, panolar ve sorgular gibi iş izleme araçlarını filtrelemek veya sorguları tanımlamak için bir veya iki anahtar sözcük tümceciğine karşılık gelir. Daha fazla bilgi için bkz . Listeleri ve panoları kategorilere ayırmak ve filtrelemek için iş öğesi etiketleri ekleme.
Etiket adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | - 400'den fazla Unicode karakter içermemelidir. - Null veya boş olmamalıdır. |
| Özel karakterler | - Ayırıcı karakterler içermemelidir: , veya ;.- Satır beslemesi, paragraf ayırıcısı, satır başı veya diğer eşleşmeyen vekil karakterler gibi Unicode denetimi veya biçim karakterleri içermemelidir. |
| Kapsam | Genel listeler tüm projeler arasında kullanılabildiğinden, proje düzeyinde tanımlanmış öğeler (projeye özgü grup hesabı tanımları gibi) içermemelidir. |
Azure Pipelines
Azure Pipeline tanımları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| İş adı | - Yalnızca ve alfasayısal karakterler '_'içermelidir.- Bir sayı ile başlamamalıdır. - Benzersiz bir ada sahip olmalıdır. - Anahtar sözcükler içermemelidir, örneğin: "dağıtım." |
| Aşama adı | - Yalnızca ve alfasayısal karakterler '_'içermelidir.- Bir sayı ile başlamamalıdır. - Anahtar sözcükler içermemelidir, örneğin: "dağıtım." |
| İfadeler | veya ile a-Z başlamalıdır ve ardından a-Z, 0-9veya __ANDolmalıdır. |
Daha fazla bilgi için bkz . Azure Pipelines belgeleri.
Azure Depoları (Git)
Her Azure DevOps projesi birden çok Git deposu içerebilir. Git depolarına atadığınız adlar aşağıdaki kısıtlamalara uymalıdır. Daha fazla bilgi için bkz . Azure Repos Git belgeleri. Dallar ve etiketler gibi diğer Git öğelerinin adlandırma kısıtlamaları hakkında daha fazla bilgi için bkz . git check-ref-format.
Önemli
Depo adlarının içine boşluklar ekleyebilirsiniz ancak bunu yapmanızı önermeyiz.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Benzersizlik | Projedeki diğer Git deposu adıyla aynı olmamalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Alt çizgi _ile başlamamalıdır.- Nokta .ile başlamamalı veya bitmemelidir.- Sistem ayrılmış adı olmamalıdır. |
Azure Repos (TFVC)
Team Foundation sürüm denetimi (TFVC), bir ekip genelinde bu dosyaları yönetmek için gereken dosyalar ve komutlar için merkezi bir depo sağlar. Ayrıca özelleştirilebilir iade ilkeleri, dallanma, birleştirme, raf ve diğer birçok özellik sağlar. Daha fazla bilgi için bkz . Azure Repos TFVC belgeleri
Sürüm denetimi yolları aşağıdaki kısıtlamalara uymalıdır. Ayrıca bkz. Çalışma alanınızı iyileştirme.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Sunucu kaynak denetimi klasör yolu uzunluğu | - Tek bir klasör veya dosya adı için 259'dan fazla Unicode karakter içermemelidir. - Dizin için 388'den fazla Unicode karakter içermemelidir. - Birleştirilmiş dizin ve dosya adı için 399'dan fazla Unicode karakter içermemelidir. |
| Yerel klasör yolu uzunluğu | - Dizin için 248'den fazla Unicode karakter içermemelidir. - Birleştirilmiş dizin ve dosya adı için 260'tan fazla Unicode karakter içermemelidir. |
| Web portalı ve REST'e özgü uzunluk kısıtlamaları | Birleştirilmiş proje adı, dizin ve dosya adı için 215'ten fazla Unicode karakter içermemelidir. |
Web portalında ve REST API'de, bazı işlemlerin yol uzunluğu Visual Studio ve TF.exe istemcilerinden daha kısıtlayıcıdır. Bu işlemler Düzenleme, Yeniden Adlandırma ve Silme işlemlerini içerir ve web portalı/REST değişiklikleri beklerken eşzamanlılık için rastgele oluşturulmuş bir çalışma alanı kullandığından gerçekleşir.
TFVC dosyaları
Sürüm denetim sistemi birçok farklı dosya türünü depolar. Geliştirme makinenizde Team Foundation sürüm denetimini ayarlama, mevcut Visual Studio projelerini veya çözümlerini ekleme hakkında ayrıntılı bilgi sağlar.
Team Foundation sürüm denetimine eklediğiniz dosya ve klasörler aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Dosyalar ve klasörler | - Adlar şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ;.- Klasörler, etkin çalışma alanı için eşlenmiş dizinin dışında olmamalıdır. |
| Dosya adları | - ile $başlamamalıdır.- Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; |. |
TFVC etiketleri
Team Foundation sürüm denetiminde (TFVC), etiket belirli bir düzeltme kümesine uygulanan bir addır. Sürüm denetiminde, dosyaları almanıza veya grup olarak işlem yapmanıza olanak tanıyan ilişkisiz dosyalar kümesine etiket ekleyebilirsiniz. Aşağıdaki tabloda etiket adlarına getirilen kısıtlamalar açıklanmaktadır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Özel karakterler | - Boşluk veya nokta .ile ( ) bitemez.- Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; @ |. |
TFVC Raf Kümeleri
Raf kümeleri, bekleyen değişikliklerden oluşan bir toplu işlemi geçici olarak ayırmanızı ve ardından seçenek olarak bekleyen değişiklikleri çalışma alanınızdan kaldırmanızı sağlar. Daha sonra raf kümesindeki değişiklikleri çalışma alanınıza geri yükleyebilir veya başka bir kullanıcının çalışma alanına yerleştirebilirsiniz.
Raf kümesi adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Özel karakterler | Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > & ; |. |
TFVC çalışma alanları
Çalışma alanı, Team Foundation sürüm denetimindeki (TFVC) dosya ve klasörlerin istemci tarafı kopyasıdır. Birden çok çalışma alanı oluşturduğunuzda, istemci bilgisayarda aynı sürüm denetim klasörünün farklı sürümlerine sahip olabilirsiniz. Çalışma alanları oluşturma ve çalışma, daha fazla ayrıntı sağlar.
Çalışma alanı adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Özel karakterler | - Boşlukla ( )bitmemelidir.- Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; |. |
Bilgisayar adları
Azure DevOps'u yüklediğiniz bilgisayar adı, sunucunun adıyla ilişkilendirilir. Hem işletim sistemi hem de Active Directory, şu makalelerde açıklandığı gibi bilgisayar adlarına belirli kısıtlamalar getirir:
Kuruluş adları
Önemli
Bir kuruluş adı oluştururken aşağıdaki yönergelere uyun.
- Yalnızca İngilizce alfabedeki harfleri kullan
- Kuruluşunuzun adını bir harf veya numarayla başlatma
- İlk karakterden sonra harf, sayı veya kısa çizgi kullanma
- Kuruluşunuzun 50 Unicode karakteri aşmadığından emin olun
- Harf veya sayı ile sonlandırma
İzin verilmeyen karakterlerden birini kullanırsanız şu hata iletisini alırsınız: VS850015: Belirtilen adın kullanılmasına izin verilmiyor: {Kuruluş adı}.
İşlem ve işlem şablonları
İşlem, bir projeye bağlandıktan sonra erişiminiz olan iş öğesi izleme sisteminin ve diğer alt sistemlerin yapı taşlarını tanımlar.
Not
Terminoloji: Hem "işlem" hem de "işlem şablonu", proje oluşturmak için kullanılan birbirine bağlı bir dosya kümesine başvurur. Daha fazla bilgi için, kullanabileceğiniz üç varsayılan işlem arasındaki farkları açıklayan İşlemler ve işlem şablonları hakkında bölümüne bakın.
Tanımladığınız veya özelleştirdiğiniz işlemler aşağıdaki kısıtlamalara uygun olmalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 256'dan fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Azure DevOps genelinde benzersiz olmalıdır. - Mevcut bir şablonla aynı ada sahip bir şablonu karşıya yüklerseniz, var olan şablonun üzerine yazılır. |
| İşlem şablonu dosya boyutu | 2 GB'ı (gigabayt) aşmamalıdır. |
Proje koleksiyonları
Proje koleksiyonu, bir proje grubunu ve bu projelerle ilişkili kaynakları tanımlar. Azure DevOps Server için tanımlanan bir proje grubunu tanımlamak ve denetlemek için kullanabileceğiniz bir düzenleme yapısı sağlar.
Ayrıca koleksiyon adı, ekip üyelerini projelere bağlamak için kullanılan bağlantı dizesi bir parçasıdır. Atanan varsayılan değer DefaultCollection'a karşılık gelir. Proje koleksiyonlarını yönetme daha fazla bilgi sağlar.
Proje koleksiyonlarına atadığınız adlar aşağıdaki kısıtlamalara uygun olmalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Şirket içi dağıtımınızdaki diğer koleksiyon adlarıyla aynı olmamalıdır. - Dağıtımınız SharePoint Ürünleri veya SQL Server Reporting Services içeriyorsa, bunlar mevcut bir SharePoint sitesinin, rapor sunucusunun veya Reporting Services web sitesinin adı ve tam yolu ile aynı olamaz. |
| Ayrılmış adlar | Sistem ayrılmış adı olmamalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Üç nokta ... veya çift nokta ..içermemelidir.- Alt çizgi _ile başlamamalıdır.- Nokta .ile başlamamalı veya bitmemelidir. |
Proje adları
Proje, kaynak kodu için bir depo ve ekiplerin ilerleme durumunu planlaması, izlemesi ve işbirliği yapacağı bir yer oluşturur. Projenin adı, ekip üyelerini projelere bağlamak için kullanılan bağlantı dizesi bir parçasıdır.
Oluşturduğunuz projelere atadığınız adların aşağıdaki kısıtlamalara uyması gerekir.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Benzersizlik | Proje koleksiyonundaki başka bir adla, koleksiyonu destekleyen SharePoint Web uygulamasıyla veya koleksiyonu destekleyen SQL Server Reporting Services örneğiyle aynı olmamalıdır. |
| Adları ayırır | - Sistem ayrılmış adı olmamalıdır. - App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bölme veya web.config gibi IIS isteği filtrelemesi için kullanılan gizli kesimlerden biri olmamalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Alt çizgi _ile başlamamalıdır.- Nokta .ile başlamamalı veya bitmemelidir. |
Güvenlik grupları
Azure DevOps güvenlik gruplarıyla, bir kullanıcı grubuna belirli hakları veya izinleri uygulayabilirsiniz.
Şirket içi gruplar Active Directory grup hesaplarından, Azure DevOps güvenlik gruplarından, Windows kullanıcı hesaplarından, Windows grup hesaplarından veya bu türlerin herhangi bir karışımından oluşabilir. Daha fazla bilgi için bkz . Active Directory / Microsoft Entra kullanıcılarını veya gruplarını yerleşik bir güvenlik grubuna ekleme.
Güvenlik gruplarının aşağıdaki kısıtlamalara uyması gerekir.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Güvenlik grubu hesap adı uzunluğu | 256'dan fazla Unicode karakter içermemelidir. |
| Benzersizlik | - Proje düzeyi grup hesapları aynı projedeki diğer grup adlarından biriyle eşleşmemelidir. - Koleksiyon düzeyi grup hesapları, proje koleksiyonundaki bir grup hesabının başka bir adıyla eşleşmemelidir. |
| Ayrılmış grup adları | Proje veya sunucu düzeyinde bir $NAMESPACE ile adlandırılmamalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: / \ [ ] : < > + = ; ? * |. - ASCII değer aralığında 1-31 arasında yazdırılamayan karakterler içermemelidir. - Bir süre .içinde bitmemelidir.- Virgül ,içermemelidir. |
Team Foundation Derlemesi
Team Foundation Derlemesi, derleme işleminin tüm yönlerini tek bir bilgisayarda yönetmenize olanak tanır. Team Foundation Derlemesi'ni kullanarak kaynakları eşitleyebilir, uygulamayı derleyebilir, ilişkili birim testleri çalıştırabilir, kod analizi gerçekleştirebilir, derlemeleri bir dosya sunucusunda yayınlayabilir ve derleme raporlarını yayımlayabilirsiniz.
Bilgisayar derleme
Team Foundation Derlemesi, Azure DevOps Server uygulama katmanından, veri katmanından veya Visual Studio istemcisinden ayrı bir yüklemedir. Ayrı bir bilgisayar seçebilirsiniz. Aksi takdirde, derlemeyi istemci bilgisayara veya sunuculara yan yana yükleyebilirsiniz.
Şirket içi derleme bilgisayarınızın aşağıdaki kısıtlamalara uyması gerekir.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Disk alanı | Derleme için yeterli alan içermelidir (yetersiz alan başarısız derlemelere yol açar). |
| Dizin oluşturma | Yerel bir yol olmalıdır (örneğin, C:\BuildDirectory). |
| Konum dizinini bırakma | UNC yolu olmalıdır (örneğin, \server\share). |
| Konum izinlerini bırakma | Oluşturulan her derleme, bırakma klasörüne yeni bir dizine konur. - Team Foundation Server Hizmeti hesabının (örneğin, Domain\TFSSERVICE) UNC bırakma konumuna Tam Denetim izni erişimi olmalıdır.- UNC bırakma konumu paylaşılan bir klasör olmalıdır. |
| Team Foundation Derleme Hizmeti hesabı | İlk yüklemeden sonra TFS Hizmeti hesabını değiştirirseniz, aşağıdaki koşulların doğru olduğundan emin olmanız gerekir: - Hesap, Derleme Hizmetleri grubunun bir üyesidir. - Hesabın geçici klasörler ve ASP.NET geçici klasör için okuma/yazma izinleri vardır. - Hesabın derleme dizini ve bırakma konumu için Tam Denetim izni vardır. |
| Güvenlik duvarı sorunları | Derleme bilgisayarı güvenlik duvarı etkinse, tfsbuildservice programının özel durumlar listesinde olduğundan emin olun. |
Derleme türleri
Derleme türleri, projedeki tek bir çözümün veya çözüm kümesinin oluşturulduğu koşulları yapılandırır. Derlemeyi yürütmek için yeni bir derleme türü oluşturmanız veya mevcut bir derleme türünü kullanmanız gerekir.
Derleme türü adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Benzersizlik | Projedeki diğer derleme türü adıyla aynı olmamalıdır. |
| Özel karakterler | Şu yazdırılabilir karakteri içermemelidir: $. |
Derleme kalitesi
Derleme kalitesi, tamamlanmış bir derlemeye kalite düzeyi veya tamamlanma durumu eklemenize olanak tanır. Team Foundation Derlemesi, derleme kalite türü için yeni değerler oluşturmanıza da olanak tanır. Varsayılan derleme kalitesi değerlerinin listesi için bkz . Tamamlanmış derlemenin kalitesini derecelendirme.
Derleme kalitesi adları aşağıdaki kısıtlamalara uygun olmalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 256'dan fazla Unicode karakter içermemelidir. |
| Benzersizlik | Team Foundation Derleme bilgisayarındaki diğer Derleme Kalitesi adıyla aynı olmamalıdır. |
Ekip adları
Ekip adları, bir projede birlikte ekip olarak birlikte çalışan bir grup birey veya grubu tanımlar. Ekip üyeleri bu adı, takıma bağlanmak veya bir ekip için tanımlanan üyeleri sorgulamak için kullanır.
Ekip adları, geçerli bir URL'nin parçası olarak işlenmelerine izin veren kurallara uymalıdır. Her ekip adı tek bir proje içinde benzersiz olmalıdır. Ancak, bir proje koleksiyonundaki farklı projelerde aynı ekip adını kullanma konusunda herhangi bir kısıtlama yoktur. Daha fazla bilgi için bkz . Başka bir ekip veya ekip hiyerarşisi ekleme.
Ekip adları aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Length | 64'ten fazla Unicode karakter içermemelidir. |
| Benzersizlik | Projedeki başka bir adla aynı olmamalıdır. |
| Ayrılmış adlar | Sistem ayrılmış adı olmamalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Üç nokta ... veya çift nokta ..içermemelidir.- Alt çizgi _ile başlamamalıdır.- Nokta .ile başlamamalı veya bitmemelidir. |
Kullanıcı hesabı adları
Kullanıcı hesapları, bir projeye veya proje koleksiyonuna eklenen kişileri tanımlar. Kullanıcı hesapları Active Directory, Microsoft Entra Id, Windows sunucu grubundaki girişlere karşılık gelebilir.
Bir kuruluşa veya koleksiyona eklediğiniz kullanıcı hesaplarının aşağıdaki kısıtlamalara uyması gerekir. Projeye kullanıcı hesapları eklemek için bkz . Projeye veya takıma kullanıcı ekleme.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Hesap adı uzunluğu | 256'dan fazla Unicode karakter içermemelidir. |
| Benzersizlik | Proje koleksiyonuna eklenen diğer kullanıcı hesaplarıyla eşleşmemelidir. |
| Ayrılmış grup adları | Proje veya sunucu düzeyinde ile $NAMESPACE adlandırılmamalıdır. |
| Özel karakterler | - Şu yazdırılabilir karakterleri içermemelidir: "/ \ [ ] : < > + = ; ? * |.- ASCII değer aralığında 1-31 arasında yazdırılamayan karakterler içermemelidir. - Bir dönem . veya dolar işareti $ile bitmemelidir.- Virgül ,içermemelidir.- Şu Unicode kategorilerini içermemelidir: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Wiki sayfası ve dosya adları
Her wiki sayfası, wiki Git deposundaki bir dosyaya karşılık gelir. Wiki sayfası başlığına atadığınız adlar aşağıdaki kısıtlamalara uymalıdır.
| Kısıtlama türü | Kısıtlama |
|---|---|
| Dosya adı | Tam sayfa yolu 235 karakteri aşmamalıdır. |
| Benzersizlik | Sayfa başlıkları büyük/küçük harfe duyarlıdır ve wiki hiyerarşisinde benzersiz olmalıdır. |
| Özel karakterler | - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir. - Şu yazdırılabilir karakterleri içermemelidir: / \ #.- Nokta .ile başlamamalı veya bitmemelidir. |
| Dosya boyutu | En fazşa 18 MB’ı aşmamalıdır. |
| Ek dosyası boyutu | En fazla 19 MB’ı aşmamalıdır. |
Wiki sayfası başlıklarında özel karakterler
Bu özel karakterlerden : < > * ? | -birini veya daha fazlasını içeren sayfa başlıklarını belirtebilirsiniz. Örneğin, Markdown dosyasını "SSS" veya "Kurulum kılavuzu" olarak adlandırabilirsiniz. Karakterler aşağıdaki URI ile kodlanmış dizelere sahiptir:
| Karakter | Kodlanmış dize |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2B |
" |
%22 |