Aracılığıyla paylaş

Tüm FIELD XML öğeleri başvurusu

  • Makale

Bu konu sözdizimi aramak için kullanın FIELD öğesi veya alt öğelerinden biri.

Bu öğeleri belirtin FIELD (tanım) öğesi kapsayıcı.Belirterek bir alan için bir iş öğesi türü (WIT) eklediğiniz bir FIELD (tanım) öğesi içinde FIELDS (tanım) öğesi.Bu öğeleri tanımındaki bir WIT veya genel iş akışının bir parçası olarak belirtebilirsiniz.

Alt öğelerinin bir alanın davranışını belirtmek için varsayılan değerleri tanımlamak veya değerlerin seçim listesini tanımlamak ekleyebilirsiniz.Alan kural öğelerini birbirleri ile birlikte kullanabilirsiniz.Bir veya daha fazla kullanıcı veya gruplara uygulamak için veya bir veya daha fazla kullanıcı ya da gruplar için yoksayılacak çoğu kuralları kapsamını belirleyebilirsiniz.

ALAN (tanımlama) kapsayıcı öğesi

İş öğesi türü için veri alanlarını tanımlamak için aşağıdaki sözdizimini kullanın.Bu örnek biçimi gösterir FIELD (tanım) öğesini ve tüm isteğe bağlı bir alt öğeler.Daha fazla bilgi için bkz. FIELD (Tanım) öğesi başvurusu.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

ALAN alt öğelerinin

Hangi verilerin alana girilebilir çeşitli sınırlamalar için alt öğelerinin kullanın.Seçim listesi (açılan menüyü) için değerler belirten, varsayılan değerleri ayarlamak, girişleri kaldırın veya değişiklik kısıtlamak.Aşağıdaki tablo her alt öğe için sözdizimi yapısı sağlar.

Bu öğeleri kullanılacak öğrenmek için bkz: İş öğesi alanına kural uygulama.Çoğu kuralları sistem alanları uygulama üzerinde kısıtlamalar var.Tüm alt öğeler isteğe bağlıdır.

Öğe

Açıklama ve sözdizimi

ALLOWEDVALUES

Bir listesini kullanıcıların iş öğesi formlarının alan listesinde ve sorgu düzenleyicisinde belirten değerleri tanımlar.Kullanıcılar, listeye değerlerden birini belirtmeniz gerekir.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Daha fazla bilgi için bkz. Seçim listeleri tanımlama.

ALLOWEXISTINGVALUE

Artık bir seçim listesindeki olsa bile, bir alan varolan bir değeri saklayabilir olduğunu belirtir.Tüm yeni alan değerlerini listede olması gerekir.

<ALLOWEXISTINGVALUE />

Daha fazla bilgi için bkz. Seçim listeleri tanımlama.

CANNOTLOSEVALUE

Bir değer belirlendikten sonra kullanıcılar tüm değerlerin bir alanı temizleyin olduğunu belirtir.Alan bir değer içerir sonra alan her zaman NULL olmayan bir değer içermesi gerekir.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Daha fazla bilgi için alan kuralın.

COPY

Bir kullanıcı oluşturur veya iş öğesini belirtilen bir değeri bir alana kopyalar.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Daha fazla bilgi için bkz. Varsayılan değer tanımlama veya değeri bir alana kopyalama.

DEFAULT

Bir kullanıcı oluşturur veya bir iş öğesi değiştirir boş bir alan için bir değer belirtir.Bir alan bir değer varsa, varsayılan kural yoksayılır.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Daha fazla bilgi için bkz. Varsayılan değer tanımlama veya değeri bir alana kopyalama.

EMPTY

Alanın içerdiği herhangi bir değer temizler.EMPTY Kural salt okunur bir alan ayrıca yapar ve, kullanmamalısınız ile READONLY kural.

Alan değeri iş öğesi bir kullanıcının kaydeder ve hiçbir değer belirtemezsiniz kaldırılır.Bu kural, durum geçişi sırasında öğenin geçtiği duruma uygulamak alanları temizlemek için öncelikle kullanılır.

<EMPTY for="userGroupName" not=" userGroupName" />

Daha fazla bilgi için alan kuralın.

FROZEN

Değişiklikler uygulandıktan sonra bu alanı boş olmayan bir değere değiştiremezsiniz belirtir.Bu alanda bir değere sahip bir kullanıcı iş öğesi kaydeder alınmaz değeri artık değiştirilebilir.

<FROZEN for="userGroupName" not="userGroupName" />

Daha fazla bilgi için alan kuralın.

HELPTEXT

Bir kullanıcı işaret ettiğinde iş öğesi formu alanında görüntülenecek metni tanımlar.

tooltipText: 1 ila 255 karakter arasında içeren bir metin dizesi.

<HELPTEXT>tooltipText </HELPTEXT>

Daha fazla bilgi için alan kuralın.

MATCH

Dize türü alanlarının değerlerini eşleşmesi gereken bir desen tanımlar.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Daha fazla bilgi için bkz. Dize alanıyla eşleşen kalıbı uygulama.

NOTSAMEAS

Bir alan için başka bir belirtilen alanın atanan aynı değeri atanmış olmaması belirtir.Değeri field öznitelik geçerli bir başvuru adı alan olması gerekir.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Daha fazla bilgi için alan kuralın.

PROHIBITEDVALUES

Bir alan içeremez değerler listesini tanımlar.Alan izin verilmeyen bir değer içeriyorsa, kullanıcılar bir iş öğesi kaydedemiyor.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Daha fazla bilgi için bkz. Seçim listeleri tanımlama.

READONLY

Alan atanan değer değiştiremezsiniz belirtir.

<READONLY for="userGroupName" not="userGroupName" />

[!NOT]

Bu öğe ile birlikte kullanmayın EMPTY öğesi çünkü EMPTY de bir alan salt okunur yapar.Bu öğeleri birleştirmek, sonuçlar tutarsız olacaktır.

Daha fazla bilgi için alan kuralın.

REQUIRED

Kullanıcıların alan için bir değer belirtmesi gerektiğini belirtir.Gerekli alanlar boş olamaz.Değerleri için gerekli tüm alanları atadığınız kadar kullanıcılar bir iş öğesi kaydedemiyor.

<REQUIRED for="userGroupName" not="userGroupName" />

Daha fazla bilgi için alan kuralın.

SERVERDEFAULT

Bir kullanıcı bir iş öğesi kaydeder belirtilen sunucu değerini bir alana kopyalar.Bu alanlar genellikle formda salt okunur olarak görünür.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Daha fazla bilgi için bkz. Varsayılan değer tanımlama veya değeri bir alana kopyalama.

SUGGESTEDVALUES

Önerilen listesini kullanıcıların iş öğesi formlarının alan listesinde ve sorgu düzenleyicisinde belirten değerleri tanımlar.Kullanıcılar, Öner dışındaki değerler belirtebilir.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Daha fazla bilgi için bkz. Seçim listeleri tanımlama.

VALIDUSER

İş öğeleri belirlediğiniz grubunda kullanıcılar tarafından değiştirilmiştir kısıtlar.Varsayılan Grup Team Foundation Geçerli Kullanıcıları grubu.

Tüm öznitelikleri isteğe bağlıdır.Tüm öznitelikleri 1 ila 255 karakter arasında içeren bir metin dizesi oluşması gerekir.Belirteç grupları belirlemek için kullanabilirsiniz.

< VALIDUSER group="groupName" for="userName" not="userName" />

Daha fazla bilgi için alan kuralın.

WHEN

Başka bir alan belirli bir değere sahip olduğunda mevcut alana uygulanacak bir veya daha fazla kural belirtir.Üst FIELD öğesi güncel alanı tanımlar.

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

Daha fazla bilgi için, Koşula dayalı değerler ve kurallar atama

WHENNOT

Başka bir alanın belirli bir değere sahip olmadığında mevcut alana uygulanacak bir veya daha fazla kural belirtir.Üst FIELD öğesi güncel alanı tanımlar.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Daha fazla bilgi için bkz. Koşula dayalı değerler ve kurallar atama.

WHENCHANGED

Çalışma öğesinin düzeltilmesi sırasında başka bir alanı değiştiğinde mevcut alana uygulanacak bir veya daha fazla kural belirtir.Üst FIELD öğesi güncel alanı tanımlar.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Daha fazla bilgi için bkz. Koşula dayalı değerler ve kurallar atama.

WHENNOTCHANGED

Çalışma öğesinin düzeltilmesi sırasında başka bir alan değiştirilmez, geçerli alana uygulamak için bir veya daha fazla kural belirtir.Üst öğe geçerli alanı tanımlar.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Daha fazla bilgi için bkz. Koşula dayalı değerler ve kurallar atama.

GLOBALLIST ve LISTITEM alt öğeleri

Belirttiğiniz GLOBALLIST ve LISTITEM öğeleri alt öğelerinin olarak ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES öğeler.Görüntülenen değerler listesini Numaralandırılacak bu öğeleri kullanabilirsiniz.Kullanıcılar bir seçim listesi veya bir açılır menüyü değerleri seçin.Daha fazla bilgi için bkz. Genel listeleri tanımlama.

Öğe

Açıklama

GLOBALIST

Kümesini tanımlayan LISTITEM için bir takım depolanan öğeleri proje koleksiyonu ve tüm ekip projelerinin koleksiyonundaki kullanabilirsiniz.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

globalListName: 1 ila 255 karakter arasında içeren bir metin dizesi.

GLOBALLISTgerekli alt öğesidir GLOBALLISTS öğesini ve isteğe bağlı bir alt öğesi ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES öğeler.Bir iş öğesi tanımını, genel liste tanımını veya genel bir iş akışı içinde genel bir liste tanımlayabilirsiniz.

LISTITEM

Geçerli bir liste değeri tanımlar.

<LISTITEM value="listName" />

LISTITEMgerekli alt öğesidir GLOBALLIST ve isteğe bağlı bir alt öğesi ALLOWEDVALUES, SUGGESTEDVALUES, ve PROHIBITEDVALUES öğeler.

ALAN alt öğeleri tarafından belirtilen öznitelikler

En uygun bulma FIELD grupları veya kullanıcıları kümesine ekleyerek geçerli değil veya uygulamak için kurallar for veya not öznitelikleri.Daha fazla bilgi için alan kuralın.

Öznitelik

Sözdizimi

Açıklama

expanditems

expanditems = "true | false"

İsteğe bağlı.Belirten bir grup olup, LISTITEM tanımlayan öğe listede bağlı grupları içermek üzere genişletilmesini.Bu özniteliğin varsayılan değeri: true.

filteritems

filteritems = "excludegroups"

İsteğe bağlı.Gruplar ve grup adlarını değil yalnızca üyeleri listede bulunduğunu belirtir.İzin verilen tek değer bu öznitelik için excludegroups.

for

for = "userGroupName"

İsteğe bağlı.Bir kullanıcı veya grubu adını belirtir Team Foundation kuralın uygulandığı için.Geçerli değerler 1 ila 255 karakter arasında içeren bir metin dizesi oluşur.

not

yok = "userGroupName"

İsteğe bağlı.Bir kullanıcı veya grubu adını belirtir Team Foundation için kim kural uygulanmaz.Geçerli değerler 1 ila 255 karakter arasında içeren bir metin dizesi oluşur.

from

FROM = "değer | alan | saat | CurrentUser"

Gerekli.Bir değer kopyalamak veya varsayılan bir değer belirtmek değerin kaynağını belirtir.Aşağıdaki değerler geçerlidir:

  • clock: Geçerli tarih ve saat sistem saati DateTime alanlarına kopyalar. Hiçbir ek öznitelik gerekli değildir.İçin COPY ve DEFAULT kuralları için bu değer, yerel bilgisayar saatin gelir.İçin SERVERDEFAULT, iş öğesi bir kullanıcının kaydeder değer sunucu saati gelir.

  • currentuser: Şu anda oturum açan kullanıcının adını kopyalar.Geçerli kullanıcının kısa kullanıcı adı, değer olarak kullanın.Hiçbir ek öznitelik gerekli değildir.Dize alanları için kullanılır.

  • field: Değeri kopyalar field belirttiğiniz özniteliği.Gerektiren bir field="abc" özniteliği.Varsayılan olarak, belirtilen "Başlangıç" alanı boşsa, hiçbir şey gerçekleştirilmez.field Özniteliği yalnızca < kopya için > kullanılır ve < varsayılan > kuralları.

  • value: Değeri kopyalar value belirttiğiniz özniteliği.Belirttiğiniz bir dize sabiti değerini kullanın.Gerektiren bir value="abc" özniteliği.valueyalnızca < kopya için > kullanılır ve < varsayılan > kuralları.

"Değeri" veya "alan" belirtirseniz, sırasıyla değer veya alan özniteliği de içermelidir.

field

alan = "fieldReferenceName"

İsteğe bağlı.Değeri olan alana Kopyalanacak alanın adını belirtir olduğunda field için belirtilen from özniteliği.

pattern

desen = "patternValue"

Gerekli.Temel desen eşleştirme için yalnızca dizeleri zorlar.patternValue 1 ila 255 karakter arasında (dahil) içeren bir dize.Bu dize bir eğik çizgi (\) içermemelidir.Aşağıdaki altı meta olmadığı sürece dize içindeki her bir karakter değişmez değer yorumlanır:

  • "a" veya "a" tek bir alfabetik karakter temsil eder.

  • "N" veya "n" tek bir sayısal karakter temsil eder.

  • "x" veya "x" temsil tek bir alfasayısal karakter.

Desen değeri: ^ [^ \\] * $

Örneğin, pattern="xxxxx.nn.nn" herhangi beş alfasayısal karakter sonra bir süre sonra iki sayısal karakter bir süre sonra iki daha fazla sayısal karakterleri eşleştirir.

value

değer = "valueToCopy"

İsteğe bağlı.Alana kopyalanacak değeri belirtir olduğunda value için belirtilen from özniteliği.

Ayrıca bkz.

Kavramlar

İş öğesi alanlarını tanımlama ve değiştirme

İş öğesi türü için iş akışını değiştirme