共用方式為


自訂工作追蹤 Web 表單

Azure DevOps Server |Azure DevOps Server 2022

本文適用於當您針對內部部署 Azure DevOps Server 使用裝載的 XML 程式模型或內部部署 Xml 程式模型時,您可以進行的自定義。 如需繼承程序模型,請參閱 自訂程序。 如需程序模型的概觀,請參閱 自訂您的工作追蹤體驗

匯入與匯出 XML 定義檔案

當您使用內部部署 XML 程序模型,並透過匯入個別 XML 定義檔來管理工作追蹤自訂時,請使用此順序。

匯出 WIT 定義檔 編輯 XML 定義檔 匯入 WIT 定義檔 重新整理並驗證變更

匯入與匯出流程 zip 檔

當您使用託管的 XML 流程模型,並透過匯入流程或流程範本來管理工作追蹤自訂化時,請使用此順序。

匯出程序 編輯 XML 定義檔 匯入程序 重新整理並驗證變更

FORM 區段

主要差異在於 FORM 節點現在有兩個主要的版面區塊。 第一部分包含在 Layout 元素中,定義了透過 Visual Studio 等客戶端查看表單時的配置。 第二節包含在 WebLayout 元素中,定義了透過網頁瀏覽器查看表單時的配置。

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

要進行上述客製化,請參閱以下主題:

匯入和匯出定義檔 (內部部署 XML 程序)

如果您沒有專案的管理權限,請 取得這些權限

  1. 依照 witAdmin 中的指示開啟命令提示字元視窗 :自訂並管理追蹤工作物件

    例如:

    %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer 
    
  2. 匯出您想要修改或新增欄位的 WIT 定義檔案。 指定 WIT 的名稱和檔案的名稱。

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
    

    組織的 CollectionURL 範例是 https://dev.azure.com/OrganizationName

  3. 編輯檔案。 如需詳細資訊,請參閱 WebLayout XML 元素

  4. 匯入 WIT 定義檔案。

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"  
    
  5. 開啟任一入口網站以檢視變更。 如果用戶端已開啟,請重新整理頁面。

    系統會從伺服器下載最新的更新,包括您剛匯入的變更。 等待幾秒鐘,直到重新整理完成。

    如需使用 witadmin 的詳細資訊,請參閱 匯入、匯出和管理工作專案類型

小提示

使用 witadmin,您可以 匯入和匯出定義檔案。 您可以使用的其他工具包括 [進程編輯器] (需要您已安裝 Visual Studio 版本)。 從 Visual Studio Marketplace 安裝程序範本編輯器

版面配置和調整大小

網頁表單會根據可用的寬度和定義的區段數目調整大小。 在大多數瀏覽器中,在最大寬度下,頁面內的每個區塊會顯示在自己的欄位中。 隨著顯示寬度的減小,每個區段會按比例調整大小,如下所示:

  • 適用於四個部分:40%、20%、20%和 20%
  • 適用於三個區段:50%、25%和 25%
  • 兩個區段:66% 與33%
  • 一個區段:100%

當顯示寬度無法容納每個區塊的欄狀顯示時,表單會將各區塊堆疊在同一欄內。

全域清單

Hosted XML 管理全域清單的方式與 Azure DevOps Server 不同。 它不支援這個 witadmin 指令或獨立的全域列表檔案。 在裝載的 XML 中,您可以將全域清單附加至現有的工作專案類型,如下列程式碼片段所示。

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

預設情況下,全球清單會連結到共用步驟的工作項目類型。

匯入警告和錯誤

當你匯入修改過的 WIT 定義時,如果你只在 WebLayoutLayout 節點新增了 Required 欄位的控制元素,而其他節點卻沒有,你會收到警告。

如果你啟用新表單,然後修改 WIT 定義,刪除 WebLayout 節點,會收到錯誤訊息。