加入、使用和管理全域清單

  • 發行項

您只需在一個或多個 GLOBALLIST 項目內包含清單項目，即可在多個工作項目類型之間共用清單項目。

當您定義工作項目類型時，可能會發現某些欄位共用一組相同的值。 通常，這一組值會橫跨於數個工作項目類型，甚至是數個 Team 專案。 其中某些清單可能會經常變更，例如夜間組建的組建編號，而系統管理員需要經常在許多位置更新這類清單。 全域清單可以幫助解決這個問題。

注意事項注意事項

全域清單不得包含以專案當做範圍的群組，因為全域清單的範圍與專案範圍不相同。 全域清單是針對專案集合進行管理。

下列程序會告訴您如何針對工作 (Task) 工作 (Work) 項目類型建立名為 Disciplines 的全域清單。

必要的使用權限

您必須是專案集合的 [Team Foundation Valid Users] 群組成員，才能匯出全域清單。 您必須是專案集合的 [Team Foundation Administrators] 群組成員或 [Project Administrators] 群組成員，才能匯入全域清單。 如需詳細資訊，請參閱 Team Foundation Server 使用權限。

若要將全域清單加入至 Team 專案集合

  1. 在 Visual Studio 中，依序按一下 [檔案]、[新增] 和 [檔案]。

  2. 在 [分類] 窗格中，按一下 [一般]。

  3. 在 [範本] 窗格中，按一下 [XML 檔]，然後再按 [開啟]。

  4. 將下列範例中標示的 XML 程式碼加入至這個新檔案中。 這個範例會定義與組織有關之規程的全域清單。

    <?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

  5. 在工具列上，按一下 [儲存] 儲存對 XML 檔所做的變更。

    [另存新檔] 對話方塊隨即出現。

  6. 在 [另存新檔] 對話方塊中的 [儲存於] 下，瀏覽至您要儲存檔案的位置。 爲檔案命名，然後按一下 [儲存]。

    注意事項注意事項

    如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。 如果嘗試將工作項目類型匯出至您沒有設定權限的位置，登錄模擬技術便會自動重新導向已匯出的檔案，並將該檔案儲存在虛擬存放區中。 若要避免此重新導向，您可以將此檔案匯出至您已設定權限的位置。 如需登錄模擬的詳細資訊，請參閱 Microsoft 網站：登錄模擬 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。

  7. 開啟 [Visual Studio 2010 命令提示字元] 視窗。

  8. 輸入下列命令，然後按 Enter 鍵，即可將此全域清單匯入至專案集合。

    witadmin importgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /f:"File Path"

    如需詳細資訊，請參閱 管理工作項目類型的全域清單 [witadmin]。

  9. 在命令提示字元上輸入下列命令，然後按 Enter 鍵，即可在 Team Foundation Server 上顯示全域清單：

    witadmin exportgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName

    請注意，現在會顯示新加入的清單。

若要在工作項目類型中使用全域清單

  1. 執行 witadmin exportwitd 以匯出 Task.xml。 如需詳細資訊，請參閱 自訂和管理工作項目類型 [witadmin]。

  2. 在 Visual Studio 中，依序按一下 [檔案]、[開啟] 和 [檔案]。

    如此會顯示 [開啟檔案] 對話方塊。

  3. 在 [查詢] 下，移至匯出檔案的位置。

    如果您要修改工作項目類型，以便自訂流程範本，請移至存放所下載之流程範本的位置。

    注意事項注意事項

    如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。 如果嘗試將工作項目類型匯出至您沒有設定權限的位置，登錄模擬技術便會自動重新導向已匯出的檔案，並將該檔案儲存在虛擬存放區中。 若要避免此重新導向，您可以將此檔案匯出至您已設定權限的位置。 如需登錄模擬的詳細資訊，請參閱 Microsoft 網站：登錄模擬 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。

  4. 選取 Task.xml，然後按一下 [開啟]。 然後在收到關於行尾結束符號的提示時，按一下 [否]。

  5. 尋找下列 XML 檔中定義 [Discipline] 欄位的區段：

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  6. 移除下列範例中所標示的 XML 程式碼，即可刪除允許值的清單：

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  7. 將下列 XML 程式碼加入至檔案中，即可將 [Discipline] 欄位的允許值設定為之前所定義的全域清單：

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

  8. 在工具列上，按一下 [儲存] 儲存對 XML 檔所做的變更。

  9. 將已變更的工作匯入 Team Foundation Server 中。 如需詳細資訊，請參閱 自訂和管理工作項目類型 [witadmin]。

  10. 在 Visual Studio 的 Team 總管視窗中，按一下 [重新整理]，從伺服器下載最新的更新檔。

    這些更新檔含有您剛匯入的變更。 等待數秒，直到載入所有節點為止。 仍在載入中的節點會標示為 [正在執行]。

  11. 建立工作。 若要這樣做，請以滑鼠右鍵按一下 [工作項目] 節點，並指向 [加入工作項目]，然後按一下 [工作]。

    此工作是根據您所變更並匯入的工作項目類型而建立。

  12. 在新的工作項目表單上選取 [Discipline] 方塊。

    請注意，現在已從全域 [Disciplines] 清單填入 (Populate) 允許的值。

  13. 按一下 [關閉]，關閉新的工作。 當您收到儲存此工作的提示時，請按一下 [否]。

若要將值加入至欄位中，而不編輯或匯入工作項目類型 XML 檔案

  1. 若要將值加入至 [Discipline] 欄位，而不編輯及重新匯入工作項目類型定義檔，請使用 Visual Studio 開啟 disciplines.xml 檔，然後加入下列新的值，如下列範例中所標示：

    <GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>

  2. 在工具列上，按一下 [儲存] 儲存對 XML 檔所做的變更。

  3. 開啟 [Visual Studio 命令提示字元] 視窗。

  4. 在命令提示字元中輸入下列命令，然後按 Enter 鍵，即可將此全域清單匯入至專案集合。

    witadmin importgloballist /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /f:"File Path"

  5. 在 Team 總管中，按一下 [重新整理]，從伺服器下載最新的更新檔。

    這些更新檔含有您剛匯入的變更。 等待數秒，直到載入所有節點為止。 仍在載入中的節點會標示為 [正在執行]。

  6. 建立工作。 若要這樣做，請以滑鼠右鍵按一下 [工作項目] 節點，並指向 [加入工作項目]，然後按一下 [工作]。

  7. 選取 [Discipline] 方塊。

    請注意，現在全域清單中的新值會以選項的形式出現在此方塊中。

    注意事項注意事項

    您可以參考在數個工作項目類型或不同 Team 專案之間共用的允許值之全域清單， 如此可讓全域清單的單一更新項目可以自動更新參考此清單的所有工作項目類型的允許值。

  8. 按一下 [關閉]，關閉新的工作。 當您收到儲存此工作的提示時，請按一下 [否]。

請參閱

參考

GLOBALLISTS 項目 (全域清單結構描述)

GLOBALLISTS Element (Work Item Type Definition Schema)

概念

自訂專案追蹤資料、表單、工作流程和其他物件

定義全域清單

定義並使用清單、挑選清單和全域清單

其他資源

工作項目類型的 XML 項目定義索引