Team Foundation 中的命名限制

  • 發行項

Visual Studio Team Foundation Server (TFS) 中的許多元件都有特定的命名限制， 這些限制有助於確保使用者經驗一致，並提供與其他程式的相容性。 這些限制可能包括長度、特殊字元、唯一性或其他屬性。

本主題包含下列子章節：

伺服器、集合、帳戶、群組和電腦名稱限制：

  • 一般考量

  • TFS 帳戶名稱

  • TFS 群組帳戶名稱

  • 電腦名稱

  • Team 專案集合名稱

專案及工作項目追蹤名稱限制：

  • Team 專案名稱

  • 小組名稱

  • 工作項目

  • 工作項目自訂

  • 流程範本

組建及代碼限制：

  • Team Foundation 版本控制

  • Team Foundation Build

一般考量

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

至於其他作業系統檔案，也不允許使用 ASCII 控制字元 (ASCII 1-31) 與 Surrogate 組合。 如需加諸於檔案名稱之作業系統限制的一般資訊，請參閱命名檔案、路徑與命名空間。

Team Foundation Server 帳戶名稱的限制

使用者帳戶會識別 TFS 中的使用者。 這些帳戶可能是 Windows 使用者帳戶、Active Directory 帳戶或其他帳戶類型。 如果您需要關於如何將使用者加入用於 TFS、SharePoint 產品和 SQL Server Reporting Services 的群組之範例，請參閱 將使用者加入至 Team 專案。

當使用者加入 TFS 時，使用者名稱必須符合特定 Team Foundation Server 限制。 下表將說明這些限制。

限制類型

限制

帳戶名稱長度

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

唯一性

  • 不得與 TFS 中任何其他帳戶的名稱相符

保留的群組名稱

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

特殊字元限制

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

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

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

  • 不得包含逗號 (,)

  • 不得包含下列 Unicode 分類：LineSeparator、ParagraphSeparator、Control、Format、OtherNotAssigned
注意事項注意事項

您可以將現有使用者帳戶加入 Team Foundation Server。您無法在 TFS 中建立使用者帳戶。

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

Team Foundation 群組帳戶可讓您將某些權限或使用權限套用至一組使用者。 這個 Team Foundation 群組可由 Windows 使用者帳戶、Windows 群組帳戶、Active Directory 群組帳戶、Team Foundation 群組帳戶或是混合這些類型的任何組合所組成。 如需有關使用群組管理使用者的詳細資訊，請參閱在 Team Foundation Server 部署中的使用者、群組和使用權限和管理 TFS 中的使用者或群組。 如果您需要關於如何將新的成員加入用於 TFS、SharePoint 產品和 SQL Server Reporting Services 的群組的範例，請參閱將使用者加入至 Team 專案。

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

限制類型

限制

群組帳戶名稱長度

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

唯一性 (集合層級的群組帳戶)

  • 不得與 Team 專案集合內群組帳戶的任何其他名稱相符

唯一性 (專案層級的群組帳戶)

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

保留的群組名稱

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

特殊字元限制

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

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

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

  • 不得包含逗號 (,)
注意事項注意事項

您未在 Team Foundation Server 中建立使用者帳戶。

電腦名稱的限制

在 TFS 安裝程序期間，電腦名稱會與伺服器的名稱產生關聯。

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

Team 專案集合名稱的限制

Team 專案集合的名稱可識別一群 Team 專案以及與這些專案相關聯的資源。 Team 專案集合是可供您在 TFS 內定義及控制 Team 專案群組的組織結構。 小組成員在連接到 TFS 中的 Team 專案時，將會使用 Team 專案集合的名稱。如需詳細資訊，請參閱 管理 Team 專案集合。

下表描述集合名稱的限制。

限制類型

限制

長度

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

唯一性

  • 不得與 Team Foundation Server 部署中的任何其他集合名稱相同。

  • 如果部署包含 SharePoint 產品或 SQL Server Reporting Services，則不得與現有 SharePoint 網站、報表伺服器或 Reporting Services 網站的名稱與完整路徑相同。

特殊字元

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

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

  • 不得包含省略符號 (…) 或雙句點 (..)

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

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

保留的名稱

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

    如需保留名稱的詳細資訊，請參閱 Microsoft 網站上的下列頁面：檔案名稱、路徑和命名空間 (英文)。

專案名稱的限制

TFS 中的專案名稱可識別組成 TFS 中特定專案的工作項目、文件、報表、Team 組建和版本控制樹狀結構的集合。 小組成員將會使用此專案名稱，在 TFS 中連接到專案。

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

限制類型

限制

長度

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

唯一性

不得與下列中的任何其他名稱相同：Team 專案集合、支援集合的 SharePoint Web 應用程式或支援集合的 SQL Server Reporting Services 執行個體

特殊字元

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

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

  • 不得包含省略符號 (…) 或雙句點 (..)

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

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

保留的名稱

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

  • 如需保留名稱的詳細資訊，請參閱命名檔案、路徑與命名空間。

Team 名稱的限制

TFS 小組名稱可識別專案中組成小組一起工作並合作的一群人或多個群組。 小組成員將使用這個名稱連接至 Team Web Access 中的小組。 小組名稱必須是可以轉譯成有效 URL 一部分的名稱。 此外，每個小組名稱必須在單一專案中是唯一的，不過，在 Team 專案集合的不同專案中，並不會禁止使用相同的小組名稱。 如需以小組形式工作的詳細資訊，請參閱加入另一個小組或小組階層架構。

下表說明小組名稱的限制。

限制類型

限制

長度

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

唯一性

不得與專案中的任何其他名稱相同

特殊字元

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

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

  • 不得包含省略符號 (…) 或雙句點 (..)

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

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

保留的名稱

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

  • 如需保留名稱的詳細資訊，請參閱命名檔案、路徑與命名空間。

工作項目的限制

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

工作項目附件的限制

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

限制類型

限制

檔案大小

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

  • 預設大小：4,096 KB

  • 大小上限：2 GB

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

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

[專案區域] 和 [專案反覆項目] 是由多個節點項目所組成的路徑 (項目之間以反斜線 (\) 字元分隔)。 節點是由 Team Foundation Server 管理員所定義，用來反映專案區域和專案週期。 下表描述節點和路徑的限制。

限制類型

限制

節點長度

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

節點的特殊字元

  • 不得包含 Unicode 控制字元

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

  • 不得包含本機檔案系統所禁止使用的字元。 如需 Windows 字元限制的詳細資訊，請參閱命名檔案、路徑與命名空間。

保留的名稱

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

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

  • 如需保留名稱的詳細資訊，請參閱命名檔案、路徑與命名空間。

路徑長度

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

路徑階層架構深度

  • 深度不得超過 14 層

工作項目自訂的限制

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

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

工作項目欄位名稱的限制

每一個工作項目類型都包含一個或多個工作項目欄位， 這些欄位會定義儲存於工作項目類型中的資訊。 工作項目欄位名稱可唯一識別每一個工作項目欄位。

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

限制類型

限制

長度

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

特殊字元

  • 不得包含前置或尾端空白字元

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

  • 不得包含句點 (.)

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

範圍

  • 工作項目欄位名稱的範圍設定為 TFS 的整個部署。 如果變更了欄位名稱，該項變更將會反映在所有專案以及包含該工作項目欄位的工作項目類型中。

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

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

限制類型

限制

長度

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

特殊字元

  • 不得包含連字號 (-)

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

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

  • 不得以數字當做開頭

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

唯一性

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

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

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

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

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

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

限制類型

限制

長度

  • 不得包含 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 Server 應用程式層、資料層或 Visual Studio 用戶端分開安裝。 您可以指定個別電腦， 否則，您也可以在用戶端電腦或伺服器上並行安裝組建。

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

限制類型

限制

磁碟空間

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

組建目錄

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

置放位置目錄

必須是 UNC 路徑 (例如，\\server\share)。

置放位置使用權限

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

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

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

Team Foundation Build Service 帳戶

如果您在最初安裝之後變更 TFS 服務帳戶，則必須確定下列條件成立。

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

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

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

防火牆 (Firewall) 問題

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

組建類型名稱

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

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

限制類型

限制

唯一性

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

特殊字元

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

組建品質名稱

組建品質可讓您將品質層級或完成狀態附加至已完成的組建。 Team Foundation Build 也可讓您針對組建品質類型建立新值。 如需詳細資訊，請參閱建立或編輯組建定義。 如需預設組建品質的值清單，請參閱 評比已完成組建的品質。

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

限制類型

限制

長度

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

唯一性

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

版本控制的限制

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

版本控制路徑

下表說明版本控制路徑的限制。

限制類型

限制

伺服器原始檔控制資料夾路徑長度

  • 單一資料夾或檔案名稱不得包含 259 個以上的 Unicode 字元。

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

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

本機資料夾路徑長度

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

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

請參閱：最佳化工作區。

將檔案加入至版本控制

版本控制系統會儲存許多不同類型的檔案。 如需如何將現有的 Visual Studio 專案或方案加入至版本控制的詳細資訊，請參閱在開發電腦上設定 Team Foundation 版本控制。

下表說明要加入至版本控制之檔案和資料夾所套用的限制。

限制類型

限制

檔案和資料夾

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

  • 資料夾不得位於使用中工作區的對應目錄之外

檔案名稱

  • 不得以 $ 開頭

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

標籤名稱

在 Team Foundation 版本控制中，標籤是指套用至特定一組修訂的名稱。 您可以在版本控制中，將標籤附加至一組不相關的檔案， 如此可讓您以群組方式擷取檔案或處理檔案。 下表描述標籤名稱的限制。

限制類型

限制

長度

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

特殊字元

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

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

擱置集

擱置集可讓您將一批暫止的變更暫時擱置在一旁，並選擇性地從工作區中移除暫止的變更。 之後，您可以將擱置集內的變更還原至工作區，或是將這些變更放到另一個使用者的工作區中。

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

限制類型

限制

長度

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

特殊字元

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

工作區名稱

工作區是指 Team Foundation 版本控制中之檔案和資料夾的用戶端複本。 當您建立多個工作區時，在用戶端電腦上可以有相同版本控制資料夾的不同版本。 如需工作區的詳細資訊，請參閱建立和使用工作區。 下表描述工作區名稱的限制。

限制類型

限制

長度

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

特殊字元

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

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

請參閱

工作

建立或編輯組建定義

評比已完成組建的品質

概念

自訂工作追蹤物件以支援小組的流程

定義全域清單

自訂流程範本

定義您的建置流程

建立和使用工作區