在 Azure Boards 中依指派或工作流程變更進行查詢

1. 請參閱 日期和身分識別欄位。

2. 根據預設，伺服器會使用 Active Directory 或 Microsoft Entra ID 同步系統定義的人員名稱或身分識別型字段。 這些欄位包括：Activated By、Assigned To、Closed By、Created By 和 Resolved By。 您可以新增您在 Active Directory 中建立或Microsoft Entra ID 中建立的安全組，或將帳戶新增至從集合設定 [安全性 ] 頁面定義的現有或自定義群組，來授與專案的存取權。 請參閱設定 Active Directory 或 Microsoft Entra ID。

   針對內部部署，您可以使用 witadmin changefields 命令行工具來啟用或停用人員名稱字段 的 同步處理。 您也可以指定 syncnamechanges 屬性來同步處理自訂人員名稱欄位。 請參閱 管理工作專案欄位 和 FIELD （定義） 元素參考。

3. 屬性設定為 Dimension 的可報告欄位。 只有在集合設定為支持內部部署 XML 模型時才有效。 可報告的數據會匯出至數據倉儲，而且可以包含在 Excel 或 SQL Server 報表中。 針對內部部署 Azure DevOps，請使用 witadmin changefield 命令來變更字段的可報告屬性。

4. 索引欄位。 啟用欄位的索引編製可能會提高尋找查詢指定該欄位的工作專案的效能。 針對內部部署 Azure DevOps，請使用 witadmin indexfield 命令 來變更字段的索引屬性。

5. 需求類別會套用至產品待辦專案和面板上出現的所有工作項目類型。 類別包含根據面板和待辦項目顯示 Bug 之小組設定 新增至 Bug 類別的專案。 如需工作專案類型類別的詳細資訊，請參閱 使用類別來群組工作項目類型。

若要將可供選取的身分識別範圍限制為僅新增至專案的那些使用者，您可以使用 [專案範圍使用者] 群組來執行此動作。 如需詳細資訊，請參閱 管理您的組織、限制身分識別搜尋和選取。

狀態變更

下列 XML 語法範例說明可能針對管理選取欄位值的工作項目類型所定義的規則。 在這裡，當 [狀態] 值設定為 [新增] 時，[已解析的日期]、[已解決的日期]、[關閉日期]、[關閉日期]、[關閉日期]、[啟動日期] 和 [啟動者] 字段會設定EMPTY為 。 狀態值指派會先評估，然後接著評估轉換指派。

   <WORKFLOW>
      <STATES>
        <STATE value="New">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Active">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Resolved">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Closed" />
      </STATES>

Activated By 和 Activated Date 轉換指派

當 Bug 工作項目發生下列轉換時，就會對 [啟用者] 和 [啟用日期] 欄位進行下列工作分派：

<TRANSITION from="" to="New">
<TRANSITION from="New" to="Active">
<TRANSITION from="New" to="Resolved">
<TRANSITION from="New" to="Closed">
<TRANSITION from="Resolved" to="Active">
<TRANSITION from="Closed" to="Active">

<FIELDS>
   <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
       <COPY from="currentuser" />
           <VALIDUSER />
           <REQUIRED />
    </FIELD>
    <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <SERVERDEFAULT from="clock" />
   </FIELD>
</FIELDS>

當 Bug 工作項目發生下列轉換時：

<TRANSITION from="Active" to="New">
<TRANSITION from="Active" to="Closed">
<TRANSITION from="Resolved" to="Closed">

然後[啟用者] 和 [啟用日期] 字段會設定為 READONLY。

<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
   <READONLY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
   <READONLY />
</FIELD>

Activated By/Date 和 Resolved By/Date 字段

系統會根據對應的工作流程類別狀態發生變更時，更新這些字段：Activated By、 Activated Date、 Resolved By 和 Resolved Date。 當工作流程狀態變更為 [進行 中] 狀態類別時， 會更新 [啟用者] 和 [啟動日期 ]。 當工作流程狀態變更為 [已 解析] 狀態類別時， [已解析的依據 ] 和 [已解析日期 ] 會更新。

若要深入瞭解工作流程狀態如何對應至狀態類別，請參閱 工作流程狀態和狀態類別如何在待辦專案和面板中使用。

由於這些欄位會參考工作流程狀態類別，因此更新欄位時會參考您新增的自定義工作流程狀態。 若要深入瞭解自定義，請參閱 自定義程式的工作流程。

其他注意事項

• 每當工作項目從設定以外的任何類別狀態移動時，欄位就會更新。 例如，如果您將工作專案從 [新增 ] 更新為 [已修正]，則會 更新 [已解析的日期] 字段。 不過，如果您從 [已修正 ] 和 [準備好進行測試] 更新，且處於相同類別狀態， 則不會更新 [已解決的依據/解決日期 ] 字段。
• 當您向後轉換時，例如從 [已解析] 轉換為 [使用中] 狀態，系統會清除 [已解析的依據/解析日期] 字段的值。 如果您從 [使用中] 到 [新增]，系統會清除 [啟用者/啟動日期] 字段的值。
• 請勿手動變更這些欄位的值。 它們是系統規則所控管的系統欄位。 您嘗試設定的任何值都會經過寫入。