將工作成果簽入小組的程式碼庫

  • 發行項

使用 [暫止的變更] 頁面 (鍵盤：Ctrl + 0、P)，在小組的程式碼基底中簽入您的程式碼。

Checking in an update to fix a bug

您想要執行甚麼工作？

  • 指定您要簽入的檔案

  • 關聯工作項目

  • 簽入您的變更

  • 解決簽入原則警告

  • 執行閘道簽入

  • 訂閱警示

  • 從命令提示字元工作

  • 取得秘訣

指定您要簽入的檔案

您可以在 [暫止的變更] 頁面中的 [包含的變更] 和 [排除的變更] 區段之間拖曳檔案，以指定要簽入哪些檔案變更。 當您在 Visual Studio 的其他區域中工作時，也可以為簽入設定範圍：

  • 在 [方案總管] 中，選取下列其中一項：

    • 方案

    • 一個或多個程式碼專案

    • 一個或多個檔案

    選取項目之後，開啟其內容功能表，並選擇 [簽入]。

  • 在 [原始檔控制總管] 中，選取一個或多個具有暫止變更的項目或一個或多個包含有暫止變更之項目的資料夾 (具有暫止變更的項目是以這個符號表示：TFSC Checked-Out Status Icon)。 開啟所選取項目的內容功能表，並選擇 [簽入]。

關聯工作項目

當您變更程式碼基底中的檔案時，通常是為了完成工作、修正 Bug 或滿足其他種類之工作項目的需求。 當您簽入變更時，應該將此類工作項目與您所簽入的變更建立關聯性。 這樣做的優點包括：

  • 檢視工作項目的小組成員可以直接連結至變更集來查看您所執行的工作。

  • 檢閱您變更檔案歷程記錄的小組成員可以檢視變更集，並查看做為該項變更之正當理由的工作項目。

  • 如果您在自動化建置系統 (例如使用 CI 組建或閘道簽入組建) 中建置您的變更，您的小組成員可以看到在哪些完成的組建中已完成工作或已修正 Bug。

建立工作項目與簽入之間的關聯性：

  • 選擇 [相關工作項目] 區段中的 [依 ID 加入工作項目] 連結。

  • 將工作項目從查詢視窗中拖曳至 [相關工作項目] 區段中。

在每個工作項目旁邊，選取應該如何將其與您的簽入產生關聯：[關聯] 或 [解析] (只有當工作項目已不處於預先排除此關聯性的 [已解析]、[已完成] 或 [已關閉] 等狀態時才能使用)。

提示

您可以開啟相關聯工作項目的內容功能表，然後選擇：

  • [開啟工作項目]，在暫時性索引標籤中開啟工作項目。如果您想要在一般索引標籤查看工作項目，請開啟索引標籤的內容功能表並選取 [開啟索引標籤] (鍵盤：Ctrl + Alt + Home)。

  • [移除工作項目]，如果不要讓工作項目與您的簽入產生關聯。

  • [新增連結工作項目]、[建立工作項目的複本] 或 [連結至現有項目]。

簽入您的變更

若要簽入您的變更

  1. 在 [Team Explorer] 中，選擇 Home icon [首頁]，然後選擇 [暫止的變更] (鍵盤：Ctrl + 0、P)。

  2. 在 [暫止的變更] 頁面上，輸入 [註解] 讓稍後需要檢閱並了解您的檔案記錄的小組成員知道您所執行的工作。 例如：實作的購物車控制器。

  3. 某些小組傾向於其成員提供有關每個簽入的特定資訊類型。 在某些情況下，甚至會實作簽入原則來要求此項資訊。 如果您的 Team 專案系統管理員啟用簽入提示，您就可以在 [備註] 區段的每個欄位中輸入資訊。

  4. 選擇 [簽入] 按鈕。

下列其中一個結果發生。

已簽入您的變更

所有從工作區中包含的檔案變更，連同註解、簽入提示及相關工作項目之連結，都會儲存在伺服器中，做為您伺服器上的單一變更集。

衝突會封鎖您的簽入

系統會顯示伺服器上檔案最新版本的變更之間的衝突。 請參閱 解決 Team Foundation 版本控制衝突。

由於您的簽入違反簽入原則，因此已被封鎖。

Team 專案系統管理員可以實作簽入原則，鼓勵小組遵循最佳做法。 例如，簽入原則可以促使小組成員將至少一個工作項目與其所做變更產生關聯。 如需詳細資訊，請參閱Set and Enforce Quality Gates。

在某些情況下，建議您覆寫這些簽入原則。 在 [原則警告] 區段中選擇 [覆寫警告]。

在 [原因] 方塊中，說明您選擇覆寫原則的原因。

簽入至閘道簽入建置流程所控制的資料夾

Gated Check-in dialog box

如果您要將變更簽入由閘道簽入建置流程所控制的版本控制資料夾，則會出現 [閘道簽入] 對話方塊。 如需如何完成簽入作業的詳細資訊，請參閱 簽入由閘道簽入組建所控制的暫止變更。

訂閱警示

如果您想要在有人將程式碼簽入您的 TFVC Team 專案時收到相關通知，您可以訂閱接收電子郵件警示。 方式如下。

Alerts page for TFVC team project in web portal

從命令提示字元工作

秘訣

  • Tip 您可以從 Team Explorer Undock 取消停駐 [暫止的變更] 頁面並在新視窗中開啟。

  • Tip 您可以從 [動作] 功能表切換清單和樹狀檢視。

  • Tip在簽入新的程式碼之前，您應該考慮進行程式碼檢閱。 請參閱 暫止工作、 修正 Bug，並進行程式碼檢閱。

  • Tip您可以管理，如果有需要也可以復原您的暫止變更。 請參閱 開發程式碼和管理暫止的變更。

  • Tip 如果您需要擱置您的變更，請參閱暫停工作和管理擱置集。

  • Tip簽入是以不可部分完成的方式執行 -- 不是完全成功就是完全失敗 (擲回一個例外狀況) 的作業。 如果有任一變更無法送出至您的 Team Foundation Server，則不會認可其中一個變更，也不會建立變更集。 例如，如果網路連接您在簽入之際中斷，則整個作業會失敗。

    唯一例外狀況是工作項目與變更集產生關聯。 如果工作項目關聯失敗但簽入的所有其他部分成功，則會建立變更集。 您可以手動使工作項目與變更集產生關聯。 請參閱 連結工作項目以支援可追蹤性。