Tüm FIELD XML Öğeleri Başvurusu

Makale
03/12/2013

Bu konudaki bilgileri bir iş öğesi türü için bir veri alanı tamamlayan tüm öğelere ve temel özniteliklere hızlı başvuru olarak kullanabilirsiniz. FIELD (Tanım) öğesi kapsayıcısındaki bu öğeleri belirtin. FIELDS (Tanım) içinde bir FIELD (Tanım) öğesi belirterek bir çalışma öğesi türüne alan eklersiniz. Bu öğeleri bir iş öğesi türü tanımı içinde ya da genel iş akışının bir parçası olarak belirtebilirsiniz. Bir alanın davranışını belirlemek, varsayılan değerleri tanımlamak veya değerlerin seçim listesini tanımlamak için bu konunun açıkladığı alt öğeleri oluşturabilirsiniz. Alan kural öğelerini birbirleri ile birlikte kullanabilirsiniz. Bir veya birden fazla kullanıcıya veya gruba uygulanacak ya da bir veya birden fazla kullanıcı veya grup için yok sayılacak birçok kuralın kapsamını belirleyebilirsiniz.

FIELD öğesinin tüm alt öğeleri isteğe bağlıdır. Dışında HELPTEXT öğesinin alt öğeleri olarak tüm öğeleri belirtebilirsiniz FIELD (tanım), FIELD (iş akışı) ve FIELD (genel iş akışı) öğesi. Bir iş öğesi alanını tanımlamak ve ona uygulanacak olan kural ve koşulları belirlemek için FIELD (Tanımlama) öğesini kullanın. FIELD (İş akışı) öğesinin değerini tanımlamak için kuralları belirtin veya bir durumdan diğer bir duruma iş öğesi geçişleri için bir alana kuralları uygulayın. Üst öğe ALANLARI'nın bir alt öğe olduğu STATE, TRANSITION, DEFAULTREASON ya da REASON öğesini temel alarak alan kuralları belirtebilirsiniz. Daha fazla bilgi için, bkz. Çalışma Öğesi Alanları ile Çalışma ve İş Akışını Tasarlama.

Bu konuda

ALAN (Tanımlama) Kapsayıcı Öğesi
ALAN Alt Öğeler
GLOBALLIST ve LISTITEM Alt Öğeleri
FIELD Alt Öğeleri Tarafından Belirtilen Öznitelikler

ALAN (Tanımlama) Kapsayıcı Öğesi

İş öğesi türünün veri alanlarını tanımlamak için aşağıdaki sözdizimini kullanın. Bu örnek, FIELD (Tanım) öğesinin ve tüm diğer isteğe bağlı alt öğelerin biçimini gösterir. Daha fazla bilgi için bkz. ALAN (Tanımlama) Öğesi.

<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 Öğeler

Aşağıdaki tablo bir değeri bir alana atamak için kurallar uygulamak için belirtebileceğiniz alt öğeleri açıklar. Tüm alt öğeler isteğe bağlıdır. Yalnızca tek bir gruba veya tek bir gruptaki kullanıcılar dışında herkese uygulanacak birçok alt öğe kapsamını belirleyebilirsiniz.

Öge	Açıklama ve sözdizimi
ALLOWEDVALUES	Kullanıcıların iş öğesi formlarının alan listesinde ve sorgu düzenleyicisinde belirleyebileceği değerler listesini tanımlar. Kullanıcıların listelediğiniz değerlerden birini seçmesi 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	Bir alanın varolan bir değeri artık seçim listesinde olmasa bile koruyabileceğini belirtir. Tüm yeni alan değerleri listede olmalıdır. `<ALLOWEXISTINGVALUE />` Daha fazla bilgi için bkz. Seçim Listeleri Tanımlama.
CANNOTLOSEVALUE	Kullanıcıların bir değer belirtildikten sonra değer alanını temizleyemeyeceğini belirtir. Alanın bir değer içermesinden sonra, bu alan her zaman NULL olmayan bir değer içermelidir. `<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
COPY	Bir kullanıcı iş öğesini oluşturduğunda veya kaydettiğinde belirtilen sunucu değerini 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ı çalışma öğesi oluşturduğunda veya değiştirdiğinde boş olan bir alan için değer belirtir. Alan zaten bir değere sahipse, 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 her değeri temizler. EMPTY kuralı ayrıca bir alanı salt okunur yapar ve onu READONLY kuralı ile kullanmamalısınız. Bir kullanıcı çalışma öğesini kaydettiğinde alan değeri kaldırılır ve hiçbir değer belirtemezsiniz. Bu kural temel olarak durum geçişi sırasında öğenin geçtiği duruma etki eden alanları temizlemek için kullanılır. `<EMPTY for="userGroupName" not=" userGroupName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
FROZEN	Değişiklikler uygulandıktan sonra alanı boş olmayan bir değere değiştiremeyeceğinizi belirtir. Bir kullanıcı o alandaki değeri olan bir iş öğesini kaydettiği anda, değeri artık değiştirilemez. `<FROZEN for="userGroupName" not="userGroupName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
HELPTEXT	Bir kullanıcı iş öğesi formunda bir alanı işaret ettiğinde görüntülenen metni tanımlar. tooltipText: 1-255 karakter içeren bir metin dizesi. `<HELPTEXT>tooltipText </HELPTEXT>` Daha fazla bilgi için bkz. Çalışma Öğesi Alanı için Yardım Metni Tanımlama.
MATCH	Dize türü alanlarının değerlerini eşleşmesi gereken bir model tanımlar. `<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />` Daha fazla bilgi için bkz. Dize Alanının Desenle Eşleşmesini Sağlama.
NOTSAMEAS	Bir alanın aynı değeri, başka bir belirtilen alanın atandığı atanmamış belirtir. field özniteliğinin değeri bir alana ilişkin geçerli bir başvuru adı olmalıdır. `<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
PROHIBITEDVALUES	Bir alanın içeremeyeceği değerlerin listesini tanımlar. Kullanıcılar, alan herhangi bir yasaklanmış değer içerirse iş öğesini kaydedemeyebilir. `<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	Değeri alanın atandığı değere değiştiremeyeceğinizi belirtir. `<READONLY for="userGroupName" not="userGroupName" />` Not Bu öğeyi, EMPTY öğesi ile birlikte kullanmayın, EMPTY de salt okunur bir alan yapar.Bu öğeleri birleştirirseniz, sonuçlar tutarsız olacaktır. Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
REQUIRED	Kullanıcıların alan için bir değer belirtmesi gerektiğini belirtir. Zorunlu alanlar boş olamaz. Kullanıcılar gerekli tüm alanlara değer atamadıkça bir çalışma öğesini kaydedemez. `<REQUIRED for="userGroupName" not="userGroupName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Alanında Koşulları Ayarlama.
SERVERDEFAULT	Bir kullanıcı iş öğesini kaydettiğinde belirtilen sunucu değerini bir alana kopyalar. Bu alanlar 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	Kullanıcıların iş öğesi formlarının alan listesinde ve sorgu düzenleyicisinde belirleyebileceği bir önerilen değerler listesini tanımlar. Kullanıcılar önerdiğiniz değerlerden başka değerler de belirleyebilir. `<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	Çalışma öğelerinin belirttiğiniz gruba ait kullanıcılar tarafından değiştirilmesini önler. Varsayılan grup Team Foundation Geçerli Kullanıcılar grubudur. Tüm öznitelikler isteğe bağlıdır. Tüm öznitelikler, 1 ile 255 arasında karakter içeren bir metin dizesinden oluşmalıdır. Belirteçleri grupları belirlemek için kullanabilirsiniz. Daha fazla bilgi için bkz. Kullanıcılara ve Gruplara Başvurmak için Belirteçleri Kullanma. `< VALIDUSER group="groupName" for="userName" not="userName" />` Daha fazla bilgi için bkz. Çalışma Öğesi Oluşturma ve Değiştirme İznini Yönetme.
WHEN	Diğer bir alan özel bir değere sahip olduğunda mevcut alana uygulanacak bir ya da daha fazla kuralı belirler. Üst FIELD öğe, 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	Diğer bir alan özel bir değere sahip olmadığında mevcut alana uygulanan bir veya daha fazla kuralı belirtir. Üst FIELD öğe, 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 geçerli alana uygulanacak bir veya daha fazla kural belirtir. Üst FIELD öğe, 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şmediğinde geçerli alana uygulanacak bir veya daha fazla kural belirtir. Üst öğe, güncel 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

Aşağıdaki tablo GLOBALLIST ve LISTITEM öğelerini açıklar. ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin alt öğeleri olarak bu öğeleri belirtin. Bu öğeleri, kullanıcının belirleyebileceği seçim listesi veya açılır menü öğeleri olarak görünen değer listesini numaralandırmak için kullanabilirsiniz. Daha fazla bilgi için bkz. Kullanıcı Listeleri, Seçim Listeleri ve Genel Listeler Tanımlama.

Öge	Sözdizimi	Tanımlama
GLOBALIST	`<GLOBALLIST name="globalListName "> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>`	Bir ekip projesi için depolanan ve bir koleksiyon içindeki tüm ekip projelerinin kullanabileceği LISTITEM kümesini tanımlar. globalListName 1 ila 255 arasında karakter içeren bir metin dizesi. GLOBALLIST; GLOBALLISTS öğesinin gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir. Bir genel listeyi bir iş öğesi türü tanımı, bir genel liste tanımı veya bir genel işi akışı içinde tanımlayabilirsiniz.
LISTITEM	`<LISTITEM value="listName" />`	Geçerli bir liste değeri tanımlar. LISTITEM; GLOBALLIST'in gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir.

Öge

Sözdizimi

Tanımlama

GLOBALIST

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

Bir ekip projesi için depolanan ve bir koleksiyon içindeki tüm ekip projelerinin kullanabileceği LISTITEM kümesini tanımlar.

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

GLOBALLIST; GLOBALLISTS öğesinin gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir. Bir genel listeyi bir iş öğesi türü tanımı, bir genel liste tanımı veya bir genel işi akışı içinde tanımlayabilirsiniz.

LISTITEM

<LISTITEM value="listName" />

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

LISTITEM; GLOBALLIST'in gerekli bir alt öğesi ve ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES öğelerinin seçeneğe bağlı bir alt öğesidir.

Başa dön

FIELD Alt Öğeleri Tarafından Belirtilen Öznitelikler

for veya not özniteliklerini dahil ederek gruplar veya kullanıcılar kümesine uygulamak veya uygulamamak üzere birçok FIELD kuralını nitelikli hale getirebilirsiniz. Daha fazla bilgi için bkz. Alan Kuralını Bir Grubun Kapsamı Olarak Belirleme.

Öznitelik	Sözdizimi	Tanımlama
expanditems	expanditems = "doğru \| yanlış"	İsteğe Bağlı. Belirtir bir grup olup, LISTITEM öğe tanımlayan listedeki bağlı grupları içermek üzere genişletilmesini. Bu özniteliğin varsayılan değeri true öğesidir.
filteritems	filteritems = "excludegroups"	İsteğe Bağlı. Grup adları değil de sadece grup üyeleri listeye dahil edilir. Bu öznitelik için değeri izin verilen tek değer excludegroups öğesidir.
for	için="userGroupName"	İsteğe Bağlı. Kuralın uygulandığı Team Foundation'daki bir kullanıcının veya grubun adını belirtir. Geçerli değerler, 1 ile 255 arasında karakter içeren bir metin dizesinden oluşmalıdır.
not	değil="userGroupName"	İsteğe Bağlı. Bu kuralın uygulanmadığı Team Foundation'daki bir kullanıcının veya grubun adını belirtir. Geçerli değerler, 1 ile 255 arasında karakter içeren bir metin dizesinden oluşmalıdır.
from	from="value \| field \| clock \| currentuser"	Gerekli. Bir değerin kopyalanacağı değer kaynağını veya varsayılan değeri belirtir. Aşağıdaki değerler geçerlidir: clock: Geçerli tarih ve saati sistem saatinden DateTime alanlarına kopyalar. Ek öznitelik gerekmez. COPY ve DEFAULT kuralları için, bu değer yerel bilgisayar saatinden alınır. SERVERDEFAULTiçin, kullanıcı iş öğesini kaydettiğinde değer sunucu saatinden alınır. currentuser: Şu anda oturum açmış kullanıcının adını kopyalar. Geçerli kullanıcının kısa kullanıcı adını değer olarak kullanın. Ek öznitelik gerekmez. Dizi alanları için kullanılır. field: Belirttiğiniz field özniteliğinin değerini kopyalar. Bir field="abc" özniteliği gerektirir. Varsayılan olarak, belirtilen "from" alanı boşsa, hiçbir şey gerçekleştirilmez. field özniteliği yalnızca <COPY> ve <DEFAULT> kuralları için kullanılır. value: Belirttiğiniz value özniteliğinin değerini kopyalar. Belirlediğiniz bir dize sabitinin değerini kullanın. Bir value="abc" özniteliği gerektirir. value yalnızca <COPY> ve <DEFAULT> kuralları için kullanılır. "değer"i veya "alan"ı belirtirseniz, sırasıyla değer veya alan özniteliklerini de dahil etmelisiniz.
field	alan = "fieldReferenceName"	İsteğe Bağlı. from özniteliği için field öğesi belirtildiğinde, değeri alana kopyalanacak olan alanın adını belirtir.
pattern	desen = "patternValue"	Gerekli. Sadece dizinler için olan temel kalıp eşleşmelerini zorlar. patternValue 1 ile 255 karakter arasında (dahil) oluşan bir dizedir. Bu dizeyi bir ters eğik çizgi (\) içermemelidir. Aşağıdaki altı metakarakterler olmadığı sürece dizedeki her karakter bir sabit değer olarak yorumlanır: "a" veya "a" tek bir alfabetik karakter temsil eder. "n" veya "n" bir tek sayısal karakterle temsil eder. "x" veya "x" tek bir alfasayısal karakteri temsil eder. Desen değeri: ^[^\\]*$ Örneğin, pattern="xxxxx.nn.nn" herhangi bir beş alfasayısal karakterden sonra bir süre sonra iki sayısal karakter bir süre sonra ve iki daha çok sayısal karakter ile eşleşir.
value	değer="valueToCopy"	İsteğe Bağlı. from özniteliği için value öğesi belirtildiğinde, alana kopyalanacak değeri belirtir.

Başa dön

Ayrıca bkz.

Kavramlar

Kullanıcı Listeleri, Seçim Listeleri ve Genel Listeler Tanımlama

Çalışma Öğesi Alanları ile Çalışma

İş Akışını Tasarlama

Aracılığıyla paylaş