變更工作項目表單配置

發行項
03/12/2013

您可以透過匯出 XML 檔並修改 FORM 區段的內容，變更工作項目表單配置。在您修改並匯入 XML 檔之後，就可以確認您在更新之工作項目類型中所做的變更。您可以變更的配置類型包括但不限於下列各項：

變更表單上欄位的標籤或位置。
將欄位群組從某個索引標籤移動到另一個索引標籤
加入新的索引標籤或資料行

如需可以在工作項目表單中放置之控制項的概觀，請參閱指定工作項目表單控制項。如需 FORM 區段之最上層結構項目的概觀，請參閱設計工作項目表單的配置.

本主題內容

匯出和開啟工作項目類型定義檔
變更定義檔 FORM 區段的配置
確認變更出現在工作項目表單中

必要的使用權限

您必須是 [Team Foundation Administrators] 群組的成員或專案之 [Project Administrators] 群組的成員，才能執行此程序。如需詳細資訊，請參閱Team Foundation Server 使用權限。

匯出和開啟工作項目類型定義檔

若要匯出和開啟工作項目類型定義檔

根據您要執行的自訂範圍，執行下列其中一個步驟：

如果您要修改單一專案的工作項目類型：

執行 witadmin exportwitd，以針對您想要修改的工作項目類型匯出 XML 檔。如需詳細資訊，請參閱自訂和管理工作項目類型 [witadmin]。

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

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

在 Visual Studio 中，依序按一下 [檔案]、[開啟] 和 [檔案]。
如此會顯示 [開啟檔案] 對話方塊。
在 [查詢] 下，移至匯出檔案的位置。

如果您要修改工作項目類型以自訂流程範本：

移至已下載流程範本的位置。
選取您想要更新的工作項目類型 XML 檔，然後按一下 [開啟]。然後在收到關於行尾結束符號的提示時，按一下 [否]。

回到頁首

變更定義檔 FORM 區段的配置

若要變更表單配置

尋找 XML 檔的 <TabGroup> 區段。請注意，Links 和 File Attachments 這類項目 (Item) 含有 <Tab> 項目 (Element)，其中的每個 <Tab> 項目 (Element) 都包含可呈現各自控制項的 <Control> 項目 (Element)。
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```
將上一個步驟中所示的 XML 程式碼取代成下列範例中所示的新 XML 程式碼，即可將兩個 <Tab> 項目合併成包含兩個控制項的單一 Links and Attachments <Tab> 項目：
```
<Tab Label="Links and Attachments">
  <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
  <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
</Tab>
```

尋找 <FORM>、<Layout> 定義的區段，其中描述您想要修改的群組，例如 Classification 群組。

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>

注意事項
為了得到最佳結果，即使資料行橫跨表單的整個寬度，每個控制項或群組還是應該會顯示在資料行中。因此，即使群組沒有可見的標籤或界限，每個資料行也都應該會顯示在群組中。

選取下列範例中粗體顯示的程式碼行，然後按一下 [編輯] 功能表上的 [複製]，將此內容複製到剪貼簿供之後使用。

  <Column PercentWidth="70">
    <Group>
      <Column PercentWidth="100">
        <Group Label="Classification">
          <Column PercentWidth="100">
            <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
            <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
          </Column>
        </Group>
      </Column>
    </Group>
  </Column>

刪除下列 XML 程式碼中粗體顯示的程式碼行，即可從表單上的目前位置中移除 Classification 群組。

<Layout>
  <Group>
    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
    </Column>
    <Column PercentWidth="30">
      <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
    </Column>
  </Group>
  <Group Label="Classification">
    <Column PercentWidth="100">
      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" />
      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" />
    </Column>
  </Group>

在 <TabGroup> 區段中，尋找下列定義 [詳細資料] 索引標籤的程式碼行：

<Tab Label="Details">
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&amp;ontext:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group Label="Schedule">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&amp;e:" LabelPosition="Left" ReadOnly="True" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&amp;Finish Date:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
  </Group>
</Tab>

將剪貼簿的內容貼到下列位置，即可將這些控制項移到 [Details] 索引標籤。

<Tab Label="Details">
  <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
  <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

進行下列範例中粗體顯示的變更，在移動的欄位周圍建立群組，並將這些欄位分成兩個資料行。

<Tab Label="Details">
  <Group Label="Classification">
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
          <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group>
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
  </Group>
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

在工具列上，按一下 [儲存] 儲存對 XML 檔所做的變更。
若要將新的工作項目類型匯入單一專案，請參閱自訂和管理工作項目類型 [witadmin]。若要將工作項目類型加入至流程範本，請參閱將工作項目的類型定義加入至流程範本。

回到頁首

確認網頁或 HTML 內容出現在工作項目表單中

若要驗證匯入單一專案的變更

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

這些更新檔含有您剛匯入的變更。等候數秒，直到載入 [工作項目] 節點為止。仍在載入中的節點會顯示 [正在執行] 一詞。
使用您所修改的工作項目類型，建立新的工作項目。若要這樣做，請以滑鼠右鍵按一下 [工作項目] 節點、指向 [加入工作項目]，然後按一下工作項目類型。

此工作項目是從您所變更的工作項目類型而建立。

請注意，類別 (Classification) 群組不再顯示於主要表單上。按一下 [連結和附件] (Links and Attachments) 索引標籤和 [詳細資料] (Details) 索引標籤，查看您所做的變更結果。
按一下 [關閉] 關閉新的工作項目。當您收到儲存工作項目的提示時，請按一下 [否]。

回到頁首

請參閱

共用方式為

變更工作項目表單配置

匯出和開啟工作項目類型定義檔

若要匯出和開啟工作項目類型定義檔

變更定義檔 FORM 區段的配置

若要變更表單配置

確認網頁或 HTML 內容出現在工作項目表單中

若要驗證匯入單一專案的變更

請參閱

工作

參考

概念

其他資源