將工作專案連結至物件
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
工作項目連結是兩個工作專案或工作專案與另一個對象之間的關聯。 連結描述對象之間的關聯性。 您可以使用工作項目連結來追蹤相依性和相關工作以進行可追蹤性、共用資訊、管理涉及多個小組或產品的複雜專案、追蹤程式碼變更、測試等等。
- 將工作專案連結至各種物件
- 將工作項目連結至其他工作專案
- 連結數個工作專案
- 變更現有連結的連結類型
- 將工作項目連結至新的工作專案
- 將工作項目連結至不同專案中的工作專案(跨組織)
- 將工作項目連結至提取要求
- 將工作項目連結至 GitHub 物件
- 將數個項目連結至新的 Git 分支
- 將工作專案連結至組建
- Link work items to deployments (將工作項目連結到部署)
- 將工作項目連結至 TFVC 程式代碼開發
- 將工作專案連結至測試
- 將工作專案連結至網站、網路共用、分鏡腳本或檔
- 檢視相依性並追蹤相關工作
- 查詢連結的工作專案
- 使用 Azure CLI 新增、移除或顯示連結
- 刪除工作項目連結
在本文中,瞭解如何執行下列工作:
必要條件
必要條件 | 描述 |
---|---|
專案管理員或參與者成員 | 您必須新增至專案做為參與者或專案管理員安全組的成員。 |
項目關係人存取 | 若要新增或修改工作專案,您必須獲得 項目關係人 存取權或更高許可權。 具有 公用專案項目關係人 存取權的使用者可以完整存取待辦專案和面板功能,例如具有 基本 存取權的使用者。 如需詳細資訊,請參閱專案關係人存取快速參考。 |
參與者成員或允許存取 | - 若要檢視或修改工作專案,您必須將此 節點 中的 [檢視工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。 根據預設, 參與者 群組具有此許可權設定為 [允許]。 如需詳細資訊,請參閱 設定工作追蹤的許可權和存取權。 - 若要設定傳統發行管線的整合選項,您必須具有編輯發行的許可權。 - 若要將工作專案連結至認可和提取要求,您必須將此 節點 許可權中的 [編輯工作專案] 設定為 [ 允許 指派給工作專案的區域路徑]。 根據預設,參與者群組具有此許可權集合。 - 若要檢視工作專案,您必須將此 節點 許可權中的 [檢視工作專案] 設定為 [ 允許 ] 指派給工作專案的 [區域路徑]。 |
已定義的反覆專案 | 若要使用 [ 規劃 ] 窗格,您的小組系統管理員必須 定義反覆專案 (sprint) 路徑,並設定小組反覆專案。 |
必要條件 | 描述 |
---|---|
專案管理員或參與者成員 | 您必須新增至專案做為參與者或專案管理員安全組的成員。 |
項目關係人存取 | 若要新增或修改工作專案,您必須獲得 項目關係人 存取權或更高許可權。 |
參與者成員或允許存取 | - 若要檢視或修改工作專案,您必須將此 節點 中的 [檢視工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。 根據預設, 參與者 群組具有此許可權設定為 [允許]。 如需詳細資訊,請參閱 設定工作追蹤的許可權和存取權。 - 若要設定傳統發行管線的整合選項,您必須具有編輯發行的許可權。 - 若要將工作專案連結至認可和提取要求,您必須將此 節點 許可權中的 [編輯工作專案] 設定為 [ 允許 指派給工作專案的區域路徑]。 根據預設,參與者群組具有此許可權集合。 - 若要檢視工作專案,您必須將此 節點 許可權中的 [檢視工作專案] 設定為 [ 允許 ] 指派給工作專案的 [區域路徑]。 |
已定義的反覆專案 | 若要使用 [ 規劃 ] 窗格,您的小組系統管理員必須 定義反覆專案 (sprint) 路徑,並設定小組反覆專案。 |
必要條件 | 描述 |
---|---|
專案管理員或參與者成員 | 您必須新增至專案做為參與者或專案管理員安全組的成員。 |
項目關係人存取 | 若要新增或修改工作專案,您必須獲得 項目關係人 存取權或更高許可權。 |
參與者成員或允許存取 | 若要檢視或修改工作專案,您必須將此 節點 中的 [檢視工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。 根據預設, 參與者 群組具有此許可權設定為 [允許]。 如需詳細資訊,請參閱 設定工作追蹤的許可權和存取權。 |
已定義的反覆專案 | 若要使用 [ 規劃 ] 窗格,您的小組系統管理員必須 定義反覆專案 (sprint) 路徑,並設定小組反覆專案。 |
有哪些連結類型?
下列連結類型可協助您管理工作專案與其他對象之間的各種關聯性。
連結類型 | 描述 |
---|---|
超連結 | 將工作項目連線至任何 URL 或網路共用 |
外部連結類型 | 將工作專案連接到外部物件,例如程式代碼物件、組建或Wiki頁面 |
遠端工作連結類型 | 連接不同組織中定義的工作專案 |
GitHub 連結類型 | 將工作項目連線至 GitHub 存放庫認可、問題或提取要求 |
工作連結類型 | 連接工作專案,包括選取測試案例管理工作專案 |
如需連結類型的詳細資訊,包括父系/子系、相關和前置任務項,請參閱 工作連結類型。
將工作專案連結至各種物件
若要將工作項目連結至各種物件,請執行下列步驟。
從入口網站開啟您要連結的工作專案,或建立新的專案。
選取 [連結] 索引標籤,然後選取 [連結至]。
在 [ 鏈接類型 ] 下拉式清單中,選取您要建立的連結類型。
在 [ 鏈接至] 欄位中,輸入或選取您要連結的物件。 視連結類型而定,您可以輸入或選取下列物件。
(選擇性)輸入批註來描述連結。
選取確定以建立連結。
提示
還有其他功能可用來連結或變更使用 Parent/Child 連結類型的連結。 某些功能與版本相關。 如需詳細資訊,請參閱連結的文章。
- 若要將待辦專案連結至組合待辦專案,或變更這些專案之間的鏈接結構, 請使用對應窗格來組織待辦專案。 或者,您可以選擇在樹狀結構階層中顯示父項和拖放專案。
- 若要建立工作並將工作連結至待辦專案, 請使用短期衝刺待辦專案頁面。 您也可以從入口網站拖放項目來變更連結結構。
- 若要縮排 ()、縮排 (),並變更樹狀結構階層的鏈接結構、從入口網站中的待辦專案重新父代和重新排序專案,或使用Team Explorer中的樹狀查詢。
- 若要新增或刪除工作專案或變更鏈接結構,您可以使用 Excel。 請參閱 使用 Excel 大量新增或修改工作專案。
將工作項目連結至其他工作專案
執行下列步驟,從入口網站將連結新增至另一個用戶劇本、Epic、功能、Bug、問題或工作。
開啟您要連結至另一個工作專案的工作專案。
在工作項目表單中,選取 [ 相關工作] 區段。
選取 [新增連結],然後選取 [現有專案]。
在 [鏈接類型] 下拉式清單中,選取您要建立的連結類型,例如[父系]、[子系] 或 [相關]。
在 [ 工作專案 ] 字段中,輸入您要連結的工作專案標識符,然後選取 [ 確定]。
下列範例使用 Related 連結類型,將三個專案連結至標識碼為 400 的 Bug。
您一次只能新增一個連結。 您無法輸入以逗號或空白分隔的識別碼。
若要連結至多個工作專案,請輸入以逗號或空格分隔的標識碼。 如果您不知道標識碼,或想要連結到不同專案中的專案,請選取 [更多動作]。
(選擇性)如果您是從 [ 查詢結果 ] 頁面工作,請大量儲存您修改的工作專案。 當您從待辦專案工作時,工作專案會自動儲存。
連結數個工作專案
從入口網站中,開啟 待辦專案 或 查詢結果頁面,然後 多重選取您要新增連結的工作專案 。
開啟其中一個選取工作專案的 ... 操作功能表,選擇 [新增連結],然後選擇 [現有專案...] 或 [新增專案...]。
在下列範例中,從產品待辦項目進行多重選取,然後選擇 [ 現有專案...]。
在 [鏈接類型] 下拉式清單中,選取您想要建立的連結類型,例如[父系]、[子系] 或 [相關]。
在 [ 工作專案 ] 字段中,輸入您要連結的工作專案標識符,然後選取 [ 確定]。
變更現有連結的連結類型
從入口網站開啟您的工作項目,然後選取 [ 連結]。
選取 [更多動作>編輯] 連結。
選擇要變更的連結類型,然後選取 [ 儲存]。
儲存 工作專案。
將工作項目連結至新的工作專案
執行下列步驟,將工作項目連結至新的工作專案。
指定新工作項目的連結類型、工作專案類型和標題。 選取 [確定]。 您選取類型的工作項目隨即開啟。
輸入其他資訊並 儲存 工作專案。
(選擇性)如果您是從 [查詢結果] 頁面工作,請大量儲存您修改的工作專案。
將工作專案連結至遠端工作專案(跨組織)
使用Microsoft Entra ID 的組織可以連結至跨組織不同專案中的工作專案。 使用下列連結類型,如下所示:
- 當您想要追蹤在不同組織中定義並由不同小組管理的工作專案相依性時,請使用 [取用來源] 或 [產生] 連結類型。
- 當所連結的工作項目定義在不同的組織中並由不同小組管理,但之間沒有強大的相依性時,請使用 [遠端相關] 鏈接類型。
執行下列步驟,將工作項目連結至其他 Azure DevOps 組織中定義的物件。 只有當兩個組織使用相同的Microsoft Entra ID 來管理使用者時,您才能這麼做。
從下列其中一種遠端連結類型中選擇:
- 取用 From 或 Produces For:當您想要追蹤在不同組織中定義且由不同小組管理的工作專案相依性時。
- 遠端相關:當所連結的工作項目定義於不同的組織中,並由不同的小組管理,但沒有強大的相依性。
從 [ 新增連結 ] 對話框中,選取連結類型、輸入遠端工作專案的 URL,然後選取 [ 確定]。
下列範例會使用遠端相關連結類型連結至存在於 remotelinkingtest2 組織中 RemoteLinking 專案的工作專案識別碼 350。
連結索引標籤會維護工作專案的所有連結計數。 [遠端連結計數] 字段會維護新增至工作專案的連結數目,該鏈接會連結到另一個專案或組織中定義的工作專案。
下列範例顯示兩個遠端連結,由 雲端圖示所指示,已新增至用戶劇本。
將工作項目連結至提取要求
在提取要求的描述中,輸入
#
以觸發#ID
工作項目選擇器。 清單會顯示您最近修改或指派給您的 50 個工作專案。若要縮小建議的工作專案清單,請輸入最多五個符合工作專案類型、標識碼或標題的關鍵詞。
如需詳細資訊,請參閱 從提取要求、認可和批注連結至工作專案。
當您將 Azure Boards 與 GitHub 存放庫連線時,您可以將工作項目連結至 GitHub 認可、 GitHub 提取要求、 GitHub 分支和 GitHub 問題。 您可以使用 GitHub 進行軟體開發,同時使用 Azure Boards 來規劃和追蹤您的工作。
當您將 Azure Boards 與 GitHub 存放庫連線時,您可以將工作項目連結至 GitHub 認可 和 GitHub 提取要求。 您可以使用 GitHub 進行軟體開發,同時使用 Azure Boards 來規劃和追蹤您的工作。
重要
您只能將工作項目連結至已連線至 Azure Boards 的 GitHub 物件。 如需詳細資訊,請參閱 將 Azure Boards 連線至 GitHub,以及 從提取要求、認可和批注連結至工作專案。
如需詳細資訊,請參閱 連結 GitHub 認可、提取要求、分支和工作項目 的問題,以及 使用提取要求自動完成工作專案。
將數個工作項目連結至新的 Git 分支
從待辦專案或查詢結果頁面,多重選取您想要連結至新 Git 分支的工作專案,選擇動作圖示,然後選取 [新增分支...]。如需詳細資訊,請參閱將工作項目連結至 Git 開發物件。
將工作專案連結至組建
執行下列步驟,將工作專案連結至現有的組建。 這些組建可以位於您的項目或組織或集合中的其他專案。
注意
此功能需要安裝 Azure DevOps Server 2020.1 更新。 如需詳細資訊,請參閱 Azure DevOps Server 2020 Update 1 RC1 版本資訊、Boards。
從工作專案的 [連結] 索引標籤中,選取 [新增鏈接>現有專案]。
從 [新增連結] 對話框中,選擇其中一個組建連結類型:[建置]、[在組建中找到]、[整合在組建中]。 指定組建編號。
組建編號是管線和組建名稱的組合。 如果您不知道組建編號,請藉由選擇 圖示來搜尋它。
從 [ 鏈接組建] 對話框中,選擇參數來篩選您的組建搜尋。
若要連結到不同專案中的組建,請先選擇您要連結其組建的專案。
例如,您可以指定組建編號、選取組建管線或組建結果,例如[全部]、[成功]、部分成功、失敗或取消。 或者,針對 [結果] 選取 [全部] 時,選擇 [尋找] 以列出要連結的可用組建。
從您想要連結的清單中選擇組建,然後選取 [ 確定]。
從 [ 新增連結] 對話框中,選取 [ 確定 ] 以完成作業。
您可以從 [ 新增連結 ] 對話框將工作專案連結至現有的組建。
從工作專案的 [連結] 索引標籤,選擇 [新增鏈接>現有專案]。
從 [新增連結] 對話框中,選擇其中一個組建連結類型:[建置]、[在組建中找到]、[整合在組建中]。 指定組建編號。
組建編號是管線和組建名稱的組合。 如果您不知道組建編號,請藉由選擇 圖示來搜尋它。
從 [ 鏈接組建] 對話框中,選擇參數來篩選您的組建搜尋。
例如,您可以指定組建編號、選取組建管線或組建結果,例如[全部]、[成功]、部分成功、失敗或取消。 或者,針對 [結果] 選取 [全部] 時,選擇 [尋找] 以列出要連結的可用組建。
從您想要連結的清單中選擇組建,然後選取 [ 確定]。
從 [ 新增連結 ] 對話框中,選擇 [ 確定 ] 來完成作業。
Link work items to deployments (將工作項目連結到部署)
當您開發軟體時,您可以擷取哪些程式代碼變更和組建支援完成工作專案。 您的小組可以瞭解已完成的工作,或透過程式代碼基底變更的稽核線索修正錯誤的方式。
用來建構這些鏈接的連結類型包括:Branch、Build、Changeset、Commit、Found in build、Integrated in build、Pull Request、Versioned Item 和 Integrated in release environment。 這些類型會出現在下圖中。
提示
建議您在建立工作專案時,從工作專案推動開發。 您也可以在建立分支、認可和提取要求時新增工作項目標識碼。 Git 可讓您使用認可連結類型將工作專案連結至認可。 您可以透過下列方式執行此動作。
在認可變更之前,請在 Visual Studio 2022 的 Git 變更或適用於舊版 Visual Studio 的 Team Explorer 中新增工作專案標識符:
使用 git-commit 命令,並在批注中包含工作專案識別碼。 例如,將此批注
#35 Catch null exception
套用至您的認可。 當您推送認可時,系統會在認可與工作專案 #35 之間建立認可連結。使用開發控制件從工作專案進行 Git 開發。 如需詳細資訊,請參閱 在 Azure Boards 中從工作專案驅動 Git 開發。
如下圖所示,部署控件會顯示兩個發行階段的版本資訊。 其中包含連結至 Git 認可或提取要求的工作專案,以取得設定為與 Azure Boards 整合的發行管線。
部署控制
工作項目表單提供兩個控件來顯示並移至開發物件。 本文說明部署控制件。 如需開發控件的相關信息,請參閱 從工作專案驅動 Git 開發。
根據預設,部署控件會出現在使用者故事 (Agile)、產品待辦專案 (Scrum)、問題(基本)、需求 (CMMI)、功能、Epic、Bug、工作和測試案例工作項目類型的工作專案表單上。
使用繼承程式的自定義工作項目類型會自動啟用。 部署控件會顯示與 Azure Boards 整合之發行管線兩個階段的版本資訊。
此控件只會顯示連結至此管線之 Git 認可或提取要求的工作專案。 您也可以在工作專案部署到不同的發行環境時,取得工作項目狀態的視覺見解。 您可以移至每個發行階段並執行。
與組建中認可相關聯的工作專案會顯示發行的狀態。 只有相同專案內的工作專案會連結至定義發行管線的位置。
當您開啟工作專案時,您可以即時查看階段。
若要填入 部署 控制項,請執行下列步驟:
注意
部署控制項需要設定傳統發行管線。 它不支援連結至針對 YAML 管線定義的發行階段。
定義傳統發行管線並設定發行階段。 如需詳細資訊,請參閱 定義多階段持續部署 (CD) 管線。
設定管線。 如需詳細資訊,請參閱 設定管線以支援工作追蹤、將部署狀態報告給 Boards。
將工作項目連結至 Azure Repos Git 存放庫中的認可或提取要求。 如需詳細資訊,請參閱
執行管線。
將工作項目連結至 TFVC 程式代碼開發
Team Foundation 版本控制 (TFVC) 可讓您使用 Changeset 和 Versioned Item 連結類型,將工作專案連結至版本控制變更集或版本控制原始程式碼檔案。 當您簽入擱置中的變更或使用 [我的工作] 簽入變更時,工作專案會自動連結到您的變更。 如需詳細資訊,請參閱 簽入您的工作。
將工作專案連結至測試
測試相關的連結類型會將測試案例管理工作項目連結至彼此,或連結至其他工作專案。 從入口網站或Microsoft測試管理員,您可以檢視測試套件所定義的測試案例,以及針對測試計劃定義哪些測試套件。 這些物件不會透過連結類型彼此連結。
您可以使用 [測試/測試者] 連結類型,將工作專案連結至測試案例。 使用您用來將工作項目連結至其他工作專案的相同連結控制件。 請參閱 連結工作專案。
下圖顯示您可以搭配測試管理工作項目類型使用的完整連結類型集。 測試管理對象之間的大部分連結都是透過從 [測試 ] 頁面或 Microsoft Test Manager 執行工作所發生。
例如,當您將共用步驟新增至測試案例時,它們會自動使用 測試案例/共用步驟 鏈接類型進行連結。 如需詳細資訊,請參閱 在測試案例之間共用步驟。
從 [測試] 中,您可以新增連結的測試計劃、測試套件和測試案例。 您無法透過特定連結類型加以新增。 測試系統會建立及管理測試結果與測試案例和測試計劃的關聯。
將工作專案連結至網站、網路共用、分鏡腳本或檔
您可以使用超連結或分鏡腳本連結類型,將工作專案連結到位於網路共享的網站、網路共用或檔。 這兩種連結類型都是單向連結。 若要新增這些連結類型,請使用稍早所述的相同控件。 請參閱 連結工作專案。
當您使用分鏡文本連結類型時,請區分連結來指定提供工作項目規格的分鏡腳本或檔。 使用此連結類型,為您的小組提供共用檔案的存取權,讓他們可以在其中新增其批注。
檢視相依性並追蹤相關工作
Azure DevOps 提供數種方式來檢視相依性並追蹤相關工作:
- 查詢編輯器:您可以使用 查詢編輯器 來建立自定義查詢,以顯示連結到特定工作專案的所有工作專案。
- 待辦專案和面板:待辦專案和 Boards 檢視會顯示工作專案之間的父子關聯性,讓您一目了然地查看相依性。
- 相依性追蹤器:相依性追蹤器是Power BI報表,可提供工作項目之間相依性的視覺表示法。
若要檢視連結至工作專案的所有物件清單,請執行下列步驟。
開啟工作專案,然後選取 [連結]。 [連結] 索引標籤會指出所有連結物件的計數。 連結的物件會依其連結類型進行分組,且每個群組內都有計數。
(選擇性)展開或折疊每個群組,然後選擇對應的數據行標題,依 [狀態]、 [最新更新] 或 [批註 ] 排序每個群組。
例如,下列 [連結 ] 索引標籤會顯示工作專案 64 個鏈接物件的一部分。
前面加上 驚嘆號的連結表示會刪除組建、發行或其他物件。 由於保留原則,這些物件會在特定時段後自動刪除。
查詢連結的工作專案
若要根據階層式連結篩選專案,請使用 工作專案 樹狀結構查詢類型。 若要根據所有連結類型篩選專案,請使用 [工作專案] 和 [直接連結]。
若要尋找連結到具有特定連結類型之其他工作專案的工作專案,請使用顯示主要和次要工作項目的查詢。 主要集合符合欄位準則,而次要集合會連結至主要集合。 您無法在版本中查詢工作專案。 您可以使用外部連結查詢工作專案。 若要精簡搜尋,請新增更多查詢篩選。
如需查詢範例,請參閱 依連結或附件計數查詢工作專案。
您無法建構顯示測試計劃、測試套件和測試案例階層式檢視的查詢。 這些專案不會使用 Parent/Child 或任何其他連結類型連結在一起。 您只能透過 [測試>計劃] 頁面檢視階層。 如需詳細資訊,請參閱 建立測試計劃和測試套件。
使用 Azure CLI 新增、移除或顯示連結
您可以使用 az boards work-item relation 命令來新增、移除及顯示工作專案連結的詳細數據。 如需詳細資訊,請參閱 開始使用 Azure DevOps CLI。
連結類型包括工作連結類型、遠端連結類型、超連結和附加檔案。 如需您可以指定的所有連結類型清單,請執行 az boards work-item relation list-type 命令。
az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show
在下列範例中,組織是 fabrikam,而專案標識符會對應至 aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb。 數據表格式是用來顯示輸出。 如需其他格式,請參閱 Azure CLI 命令的輸出格式。
連結工作專案
若要將一或多個工作項目連結至單一工作專案,請輸入 az boards work-item relation add 命令。
必要的參數包括要連結的工作項目標識碼和連結類型。 支援的連結類型包括 Parent、Child、Related 和 Remote Related。 如需所有連結類型的清單,請執行 az boards work-item relation list-type 命令。
針對在相同組織內定義的工作專案,您必須指定工作專案識別碼或目標 URL。 針對在遠端組織中定義的工作專案,請指定目標 URL。 您可以使用逗號分隔識別碼或網址來指定多個值。
az boards work-item relation add --id
--relation-type
[--detect {false, true}]
[--org]
[--target-id]
[--target-url]
下列命令會將工作專案標識碼=2807 連結到具有子連結類型的工作專案標識元=2794。 此命令會傳回目前為工作項目定義的所有連結清單。
az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type Url
--------------- -------------------------------------------------------------------------------------------------
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807
若要檢視連結工作專案的資訊,請輸入瀏覽器中所列的其中一個URL。
拿掉工作項目連結
若要從單一工作專案中移除一或多個連結的工作專案,請輸入 az boards work-item relation remove 命令。
必要的參數包括要從 中移除連結的工作專案標識碼,以及連結類型。 您只能移除相同組織中定義之工作項目的連結。 您可以指定遠端連結類型以外的任何支援連結類型。
您必須指定目標工作項目識別碼。 您可以使用逗號分隔識別碼或網址來指定多個值。
az boards work-item relation remove --id
--relation-type
--target-id
[--detect {false, true}]
[--org]
[--yes]
下列命令會將工作專案標識碼=2794 的連結從工作專案標識元=2856 移除至具有子連結類型的工作專案。 此命令會傳回目前為工作項目定義的所有連結清單。
az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type Url
--------------- -------------------------------------------------------------------------------------------------
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
若要檢視連結工作專案的資訊,請輸入瀏覽器中所列的其中一個URL。
顯示單一工作專案所建立連結的詳細數據
若要檢視連結到單一工作專案的工作專案,請輸入 az boards work-item relation show 命令。 如需可傳回的所有連結類型清單,請執行 az boards work-item relation list-type 命令。
az boards work-item relation show --id
[--detect {false, true}]
[--org]
下列命令會以數據表格式列出 fabrikam 組織為工作專案 ID=2931 定義的鏈接詳細數據。
az boards work-item relation show --id 2931 --output table
Relation Type Url
--------------- -----------------------------------------------------------------------------------------------------------------------------------
Related https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7
若要檢視連結工作專案的資訊,請輸入瀏覽器中所列的其中一個URL。 選擇附加檔案的 URL 以下載附件。
刪除工作項目連結
請執行下列步驟來刪除工作項目連結。
- 開啟具有連結的工作專案,或從查詢結果中選取它。
- 選取 [連結] 索引標籤以查看連結清單。
- 選取您要刪除的連結,然後選取 [ 移除連結]。
- 確認您想要刪除連結。
在工作專案連結到認可或提取要求之後,它就會繼續顯示為發行階段的一部分。 例如,如果您有未通過測試準則的工作專案,您可能會想要從組建和發行中移除它。
若要移除參與未來組建和發行的工作專案,請刪除最近認可和提取要求的連結。
相關文章
將相關的工作和其他物件可視化。 從 Visual Studio Marketplace、Azure DevOps 索引標籤下載 [工作項目視覺效果] 延伸模組。