共用方式為

HOW TO：使用全域清單

  • 發行項

更新：2007 年 11 月

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

當您定義工作項目類型時，可能會發現某些欄位共用一組相同的值。通常，這一組值會發生在數個工作項目類型之間，甚至是數個 Team 專案之間。這些清單中有一些可能會經常變更，例如夜間建置的組建編號。如果系統管理員常常需要在許多地方更新這些清單，這實在是不太理想。全域清單可以幫助解決這個問題。全域清單不得包含以專案當做範圍的群組，因為全域清單的範圍與專案範圍不相同。

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

必要權限

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

若要在命令提示字元中使用 Team Foundation 命令

  • 依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2008]、[Visual Studio Tools]，然後按一下 [Visual Studio 2008 命令提示字元]。

    另外，您也可以在 Visual Studio 安裝路徑 (通常是 DriveLetter:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools) 中執行 vsvars32。

    注意事項：

    您必須先安裝 Visual Studio 2008，才能使用 Visual Studio 2008 命令提示字元。

若要將全域清單加入至 Team Foundation Server

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

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

  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 檔所做的變更。

    [另存新檔] 對話方塊隨即顯示。

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

    注意事項：

    如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。如果嘗試將全域清單儲存至您無法存取的位置，登錄模擬技術便會自動重新導向，並將該檔案儲存在虛擬存放區中。如需詳細資訊，請參閱 https://msdn2.microsoft.com/zh-tw/library/aa965884.aspx 和 https://go.microsoft.com/fwlink/?LinkId=92323。若要避免此重新導向，可以將此檔案儲存至您能存取的位置。

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

  7. 輸入下列命令並按 ENTER，即可將此全域清單匯入 Team Foundation Server 中：

    glimport /f "File Path" /t "Team Foundation Server name"

    注意事項：

    因為全域清單在 Team Foundation Server 上具有全域性的影響，所以在執行 glimport 命令時，請不要指定 Team 專案。如需詳細資訊，請參閱 glimport。

  8. 在命令提示字元上輸入下列命令並按 ENTER，即可在 Team Foundation Server 上顯示全域清單：

    glexport /t "<Team Foundation Server 名稱>"

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

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

  1. 執行 witexport 來匯出 Task.xml。如需詳細資訊，請參閱 HOW TO：從現有的專案匯出工作項目類型。

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

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

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

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

    注意事項：

    如果您是執行 Windows Vista，則可能沒有存取特定資料夾的權限。如果嘗試將工作項目類型匯出至您無法存取的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。如需詳細資訊，請參閱 https://msdn2.microsoft.com/zh-tw/library/aa965884.aspx 和 https://go.microsoft.com/fwlink/?LinkId=92323。若要避免此重新導向，可以將此檔案匯出至您能存取的位置。

  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 中。如需詳細資訊，請參閱 HOW TO：將工作項目類型匯入至現有的專案。

  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，即可將此全域清單匯入至 Team Foundation Server。

    glimport /f "File Path" /t "Team Foundation Server name"

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

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

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

  7. 選取 [Discipline] 方塊。

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

    注意事項：

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

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

請參閱

概念

全域清單

參考

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

GLOBALLISTS 項目 (工作項目類型定義結構描述)

其他資源

工作項目類型定義結構描述