Team Foundation Server 的命名限制

更新:2007 年 11 月

Team Foundation Server 中的許多元件都遵守特定的命名限制,如此可確保使用者經驗一致,並提供與其他程式之間的相容性。這些限制可能包括長度、特殊字元、唯一性或其他屬性。

本主題包含下列子章節:

一般考量

Team Foundation Server 群組帳戶名稱的限制

電腦名稱的限制

Team Foundation Server 專案名稱的限制

工作項目的限制

工作項目自訂的限制

流程範本的限制

Team Foundation Build 的限制

原始檔控制的限制

請參閱

一般考量

本主題的長度限制是由允許的 Unicode 字元數所測量。如需 Unicode 的詳細資訊,請參閱<關於 Unicode 和字元集>(https://go.microsoft.com/fwlink/?LinkId=76837) (英文)。Surrogate 字元是由兩個 Unicode 字元所組成,而這些字元在與長度限制的比較時會計算為兩個字元。

如需檔案名稱所套用之作業系統限制的一般資訊,請參閱<命名檔案>(https://go.microsoft.com/fwlink/?LinkId=76838) (英文)。

Team Foundation Server 群組帳戶名稱的限制

Team Foundation 群組帳戶可讓您將某些權限或使用權限套用至一組使用者。這個 Team Foundation 群組可由 Windows 使用者帳戶、Windows 群組帳戶、Active Directory 群組帳戶、Team Foundation 群組帳戶或是混合這些類型的任何組合所組成。

如果您想要建立在多項專案中都具有使用權限的群組,請參閱 HOW TO:建立伺服器層級群組。如果您想要為 Team 專案建立安全性群組,請參閱 HOW TO:建立 Team 專案群組。如果您想要將新的成員加入至 Team Foundation Server 所預先定義的其中一個群組,請參閱 HOW TO:將使用者加入至預設群組

建立或變更 Team Foundation 群組帳戶時,該群組帳戶必須符合特定的 Team Foundation Server 限制。下表將說明這些限制。

限制類型

限制

群組帳戶名稱長度

  • 不得包含 256 個以上的 Unicode 字元

唯一性 (伺服器層級的群組帳戶)

  • 不得與任何其他伺服器層級的群組帳戶名稱相同

唯一性 (專案群組帳戶)

  • 不得與相同專案內的任何其他群組名稱相同

保留的群組名稱

  • 不得在專案或伺服器層級命名為 $NAMESPACE

特殊字元限制

  • 不得包含下列可列印的字元:"/ \ [ ] : | < > + = ; ?"/ \ [ ] : | < > + = ; ? *

  • 不得包含 ASCII 值 1-31 範圍內的無法列印字元

  • 不得以句點 (.) 當做結尾

  • 不得包含逗號 (,)

注意事項:

您未在 Team Foundation Server 中建立使用者帳戶。在某些情況下,您可能會想要將特定的 Windows 使用者加入至 Team Foundation 群組或 Team Foundation Server 本身。如需詳細資訊,請參閱 HOW TO:加入使用者

電腦名稱的限制

在 Team Foundation Server 安裝程序期間,電腦名稱會與 Team Foundation 伺服器的名稱產生關聯。若要重新命名 Team Foundation 伺服器,您必須遵循 HOW TO:重新命名應用程式層伺服器HOW TO:將資料層伺服器重新命名中所概述的程序。

作業系統和 Windows Server 2003 Active Directory 對於電腦名稱都加入了某些限制。如需重新命名電腦的詳細資訊,請參閱<重新命名電腦>(https://go.microsoft.com/fwlink/?LinkId=76839) (英文)。如需 Active Directory 的詳細資訊,請參閱<Windows Server 2003 Active Directory>(https://go.microsoft.com/fwlink/?LinkId=47541) (英文)。

Team Foundation Server 專案名稱的限制

Team Foundation Server 專案名稱會識別組成特定 Team Foundation 專案的工作項目、文件、報表、Team Build 和原始檔控制樹狀結構的集合。小組成員將會使用此專案名稱,在 Team Foundation Server 中連接到此專案。

下表描述專案名稱的限制。

限制類型

限制

長度

  • 不得包含 64 個以上的 Unicode 字元

唯一性

不得和 Team Foundation Server、Windows SharePoint Services 或 SQL Server Reporting Services 中的任何其他名稱相同

特殊字元

  • 不得包含任何 Unicode 控制字元或 Surrogate1 字元

  • 不得包含下列可列印的字元:/ : \ ~ & % ; @ ' " ?/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不得以底線 (_) 當做開頭

  • 不得以句點 (.) 當做開頭或結尾

保留的名稱

  • 不得為系統保留的名稱,例如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 如需保留名稱的詳細資訊,請參閱<命名檔案>(https://go.microsoft.com/fwlink/?LinkId=76838) (英文)

1如需 Surrogate 字元的詳細資訊,請參閱<問問國際博士專欄 #18>(https://go.microsoft.com/fwlink/?LinkId=76840).

工作項目的限制

Microsoft Visual Studio Team System 會使用如 Bug、需求、工作和風險等項目來追蹤專案的進度,這些項目統稱為工作項目。本節將說明儲存在工作項目中資料的限制。

工作項目附件的限制

檔案可以附加至工作項目中。下表描述工作項目附件的限制。

限制類型

限制

檔案大小

  • 根據預設,工作項目檔案附件的大小限制為 4,096 KB。Team Foundation 管理員可以變更這個值。管理員可設定的大小上限為 2 GB。如需詳細資訊,請參閱設定附件大小限制

  • 預設大小:4,096 KB

  • 大小上限:2 GB

工作項目區域和反覆項目的限制

工作項目包含一個 [專案區域] 欄位和一個 [專案反覆項目] 欄位,這兩個欄位是用來將工作項目組織及顯示為邏輯群組。

[專案區域] 和 [專案反覆項目] 是由多個節點項目所組成的路徑 (項目之間以反斜線 (\) 字元分隔)。節點是由 Team Foundation Server 管理員所定義,用來反映專案區域和專案週期。如需詳細資訊,請參閱設定初始專案區域或反覆項目。下表描述節點和路徑的限制。

限制類型

限制

節點長度

  • 不得包含 255 個以上的字元

節點的特殊字元

  • 不得包含 Unicode 控制字元

  • 不得包含下列任何一個字元:\ / $ ?\ / $ ? * : " & > < # % |

  • 不得包含本機檔案系統所禁止使用的字元。如需 Windows 字元限制的詳細資訊,請參閱<命名檔案>(https://go.microsoft.com/fwlink/?LinkId=76838) (英文)

保留的名稱

  • 不能只由一個句點 (.) 或兩個句點 (..) 組成

  • 不得為系統保留的名稱,例如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 如需保留名稱的詳細資訊,請參閱<命名檔案>(https://go.microsoft.com/fwlink/?LinkId=76838) (英文)

路徑長度

  • 不得包含 4000 個以上的 Unicode 字元

路徑階層架構深度

  • 深度不得超過 14 層

工作項目自訂的限制

Team Foundation Server 會使用如 Bug、需求、工作和風險等項目來追蹤專案的進度,這些項目統稱為工作項目。

Team 專案的管理員可決定在專案層級或流程範本中變更工作項目類型定義。如需如何自訂工作項目類型的詳細資訊,請參閱自訂工作項目類型。此章節會描述當您自訂工作項目和其關聯元素時,將會遇到的限制。

工作項目欄位名稱的限制

每一個工作項目類型都包含一或多個工作項目欄位,這些欄位會定義儲存於工作項目類型中的資訊。工作項目欄位名稱可唯一識別每一個工作項目欄位。如需工作項目欄位名稱的詳細資訊,請參閱欄位名稱

下表描述工作項目欄位名稱的限制。

限制類型

限制

長度

不得包含 128 個以上的 Unicode 字元

特殊字元

  • 不得包含前置或尾端空格

  • 不得包含兩個或多個連續空白字元

  • 不得包含句點 (.)

  • 不得包含左右方括弧 ([ ])

範圍

  • 工作項目欄位名稱是以整個 Team Foundation 伺服器為範圍。如果變更了欄位名稱,該項變更將會反映在所有專案以及包含該工作項目欄位的工作項目類型中。

工作項目欄位參考名稱的限制

每一個工作項目欄位都有關聯的欄位參考名稱,此欄位參考名稱可唯一識別每一個欄位,而且在指派此名稱之後將無法變更。如需欄位參考名稱的詳細資訊,請參閱欄位參考名稱。下表描述欄位參考名稱所套用的限制。

限制類型

限制

長度

  • 不得包含 70 個以上的 Unicode 字元

特殊字元

  • 不得包含連字號 (-)

  • 至少必須包含一個句點 (.)

  • 不得以句點 (.) 當做開頭或結尾

  • 不得以數字當做開頭

  • 不得以底線 (_) 當做開頭

唯一性

  • 不得與 Team Foundation Server 中的任何其他欄位參考名稱相同

  • 不得與任何其他欄位參考名稱相同 (這些名稱會由電腦加以處理,以底線 (_) 取代所有句點 (.))

    例如,電腦會將欄位參考名稱 My._Field 和 My_.Field 處理為相同的名稱:My__Field

工作項目欄位說明文字的限制

您也可以選擇使用 <HELPTEXT> 標記 (Tag),讓說明文字與工作項目欄位產生關聯。系統會在執行階段顯示此文字,好讓使用者知道要在欄位中輸入什麼資料。如需工作項目欄位說明文字的詳細資訊,請參閱定義欄位說明文字

下表描述工作項目欄位說明文字的限制。

限制類型

限制

長度

  • 不得包含 255 個以上的 Unicode 字元

範圍

與欄位名稱和欄位類型不同,欄位說明文字是設定為特定 Team 專案中某個特定工作項目類型。

全域清單的限制

全域清單是一組清單項目值,所有的 Team Foundation 伺服器會在 Team Foundation Server 實作 (Implementation) 中全域性地儲存及使用此全域清單。當您定義工作項目類型時,可能會發現某些工作項目欄位共用一組相同的可能值。全域清單可讓您一次定義這些值,並在多個工作項目類型中共用這些值。如需詳細資訊,請參閱全域清單

全域清單 (GLOBALLIST) 包含一或多個清單項目 (LISTITEM 元素)。

下表描述清單項目的限制。

限制類型

限制

長度

  • 不得包含 254 個以上的 Unicode 字元

  • 不得為空白

特殊字元

  • 不得包含前置或尾端空格

  • 不得包含兩個連續的空白字元

  • 不得包含反斜線 (\) 字元

範圍

  • 由於所有專案中都可使用全域清單,所以全域清單不得包含在專案層級所定義的元素,例如專案特定的群組帳戶定義。

下表描述全域清單所套用的限制。

限制類型

限制

項目數

全域清單不得為空白,它至少必須包含一個 [LISTITEM] 元素。

唯一性

  • 此全域清單名稱不得與 Team Foundation Server 中的任何其他全域清單名稱相同。

流程範本的限制

流程範本是在 Team Foundation 中影響專案結構的一組預設工作項目、工作項目查詢、產品範本、報表、安全性群組和指引。Team Foundation Server 包含兩個預設流程範本,這兩個範本內含兩個不同的樣式來管理軟體週期。您可以自訂這些範本來反映組織的獨特需求。如需詳細資訊,請參閱自訂流程範本

下表描述流程範本的限制。

限制類型

限制

流程範本名稱長度

不得包含 256 個以上的 Unicode 字元

流程範本名稱唯一性

  • 在整個 Team Foundation 伺服器中都必須是唯一的。

  • 如果您上載一個與現有範本相同名稱的範本,現有範本將會被覆寫。

流程範本檔案大小

此流程範本檔案大小不得超過 2 GB。

Team Foundation Build 的限制

Team Foundation Build 可讓您在一台電腦上管理建置程序的所有層面。透過 Team Foundation Build,您就可以同步處理原始檔、編譯應用程式、執行關聯的單元測試、進行程式碼分析、在檔案伺服器上發行組建,以及發行組建報告。如需詳細資訊,請參閱 Team Foundation Build 概觀

組建電腦的限制

Team Foundation Build 會與 Team Foundation Server 應用程式層、資料層或 Visual Studio 用戶端分開安裝。您可以指定個別電腦,否則,您也可以在用戶端電腦或伺服器上並行安裝組建。如需如何設定組建電腦的詳細資訊,請參閱 HOW TO:設定及安裝 Team Foundation Build

下表說明組建電腦的限制。

限制類型

限制

磁碟空間

必須有足夠的空間可容納組建 (空間不足將會導致組建失敗)。

組建目錄

必須是本機路徑 (例如,C:\builddirectory)。

置放位置目錄

必須是通用命名碼 (Universal Naming Code,UNC) 路徑 (例如,\\server\share)。

置放位置使用權限

產生的每一個組建都會放到新目錄的置放資料夾中。

  • Team Foundation Server 服務帳戶 (例如,Domain\TFSSERVICE) 對於 UNC 置放位置的存取必須有完整控制權限。

  • UNC 置放位置必須是共用資料夾。

Team Build 服務帳戶

如果您在最初安裝之後變更 Team Foundation Server 服務帳戶,您必須確定下列條件成立。

  • 此帳戶是 Build Services 群組的成員。

  • 此帳戶對於暫存資料夾及 ASP.NET 暫存資料夾有讀取/寫入權限。

  • 此帳戶對於組建目錄和置放位置有完全控制權限。

防火牆 (Firewall) 問題

如果組建電腦已啟用防火牆,請確定 tfsbuildservice 程式已在例外清單中。

組建類型名稱

Team Foundation Build 會使用組建類型來設定在 Team 專案中建置 (Build) 單一方案或一組方案的條件。若要執行組建,您必須建立新的組建類型,或是使用現有的組建類型。如需組建類型的詳細資訊,請參閱在 Team Foundation Build 中使用組建定義

下表描述組建類型名稱的限制。

限制類型

限制

唯一性

不得與專案中的任何其他組建類型名稱相同

特殊字元

  • 不得包含下列可列印的字元:$$

組建品質名稱

組建品質可讓您將品質等級或完成狀態附加至已完成的組建;Team Foundation Build 也可讓您為組建品質類型建立新的值。如需詳細資訊,請參閱 HOW TO:建立組建定義。如需預設組建品質的值清單,請參閱 HOW TO:設定組建品質

下表描述組建品質名稱的限制。

限制類型

限制

長度

不得包含 256 個以上的 Unicode 字元

唯一性

不得與 Team Foundation Build 電腦中其他任何「組建品質」名稱相同

原始檔控制的限制

Team Foundation 原始檔控制提供了檔案的中央儲存機制以及跨小組管理這些檔案所需的命令。此外,它也提供了可自訂的簽入原則、分支、合併、擱置和許多其他功能。

如需 Team Foundation 中之原始檔控制的詳細資訊,請參閱 Team Foundation 版本控制

原始檔控制伺服器路徑

原始檔控制伺服器路徑是儲存於原始檔控制中之檔案的完整路徑位置。

下表描述原始檔控制伺服器路徑長度的限制。

限制類型

限制

長度

  • 一個目錄不得包含 248 個以上的 Unicode 字元。

  • 目錄和檔案名稱結合時,不得包含 260 個以上的 Unicode 字元。

將檔案加入至原始檔控制

原始檔控制系統會儲存許多不同類型的檔案。如需如何將現有的 Visual Studio 專案或方案加入至原始檔控制的詳細資訊,請參閱將專案和方案加入至版本控制。您也可以加入與 Visual Studio 專案或方案無關的檔案或資料夾。如需詳細資訊,請參閱 HOW TO:將非專案或非方案的檔案和資料夾加入至版本控制

下表描述要加入至原始檔控制之檔案和資料夾所套用的限制。

限制類型

限制

副檔名

  • 不得包含下列可列印的字元:/ \ : * ?/ \ : * ? " < > |

資料夾

  • 不得為空白

  • 不得包含有暫止之變更的檔案

  • 不得位於使用中工作區 (Workspace) 的對應目錄之外

標籤名稱

在 Team Foundation 原始檔控制中,標籤是指套用至特定一組修訂的名稱。您可以在原始檔控制中,將標籤附加至一組不相關的檔案,如此可讓您以群組方式擷取檔案或處理檔案。如需詳細資訊,請參閱使用標籤。下表描述標籤名稱的限制。

限制類型

限制

長度

不得包含 64 個以上的 Unicode 字元

特殊字元

  • 不得以空格字元 ( ) 或句點 (.) 當做結尾

  • 不得包含下列可列印的字元:" / : < > \ | * ?@

擱置集

擱置集可讓您將一批暫止的變更暫時擱置在一旁,並選擇性地從工作區中移除暫止的變更。之後,您可以將擱置集內的變更還原至工作區,或是將這些變更放到另一個使用者的工作區中。如需詳細資訊,請參閱使用版本控制擱置集

下表描述擱置集名稱的限制。

限制類型

限制

長度

不得包含 64 個以上的 Unicode 字元

特殊字元

  • 不得包含下列可列印的字元:" / : < > \ | * ?

工作區名稱

工作區是原始檔控制伺服器上檔案與資料夾的用戶端複本。當您建立多個工作區時,在用戶端電腦上可以有相同原始檔控制資料夾的不同版本。如需工作區的詳細資訊,請參閱使用版本控制工作區。下表描述工作區名稱的限制。

限制類型

限制

長度

不得包含 64 個以上的 Unicode 字元

特殊字元

  • 不得以空格字元 ( ) 或句點 (.) 當做結尾

  • 不得包含下列可列印的字元:" / : < > \ | * ?@

請參閱

工作

HOW TO:建立伺服器層級群組

HOW TO:建立 Team 專案群組

HOW TO:將使用者加入至預設群組

HOW TO:加入使用者

HOW TO:重新命名應用程式層伺服器

HOW TO:將資料層伺服器重新命名

HOW TO:設定及安裝 Team Foundation Build

HOW TO:建立組建定義

HOW TO:設定組建品質

HOW TO:將非專案或非方案的檔案和資料夾加入至版本控制

HOW TO:修改 Team 專案區域

HOW TO:修改 Team 專案反覆項目

概念

Team Foundation Server 管理

欄位名稱

定義欄位說明文字

全域清單

Team Foundation Build 概觀

Team Foundation 版本控制

使用標籤

使用版本控制擱置集

使用版本控制工作區

欄位參考名稱

設定初始專案區域或反覆項目

其他資源

Team Foundation Server 疑難排解

自訂工作項目類型

自訂流程範本

在 Team Foundation Build 中使用組建定義

將專案和方案加入至版本控制