割り当てまたはワークフローの変更によるクエリ

• アクセス レベル:
  • 共有クエリを表示して実行するには、Project メンバーです。
  • 共有クエリを追加して保存するには:少なくとも Basic アクセス。
• アクセス許可: クエリを追加するフォルダーに対する [投稿] アクセス許可が [許可] に設定されていること。 既定では、共同作成者 グループにはこのアクセス許可がありません。

• アクセス レベル:
  • 共有クエリを表示して実行するには、プロジェクトメンバー が必要です。
  • 共有クエリを追加して保存するには:少なくとも Basic アクセス。
• アクセス許可: クエリを追加するフォルダーに対する [投稿] アクセス許可が [許可] に設定されていること。 既定では、共同作成者 グループにはこのアクセス許可がありません。

1. 日付フィールドと ID フィールドを参照してください。

2. 既定では、サーバーはシステム定義のユーザー名または ID ベースのフィールドを Active Directory または Microsoft Entra ID と同期します。 これらのフィールドは、[アクティブ化した人]、[担当者]、[終了者]、[作成者]、[解決者] です。 プロジェクトへのアクセス権を付与するには、Active Directory または Microsoft Entra ID で作成したセキュリティ グループを追加するか、[セキュリティ] ページのコレクション設定で定義された既存のグループまたはカスタム グループ アカウントを追加します。 Active Directory または Microsoft Entra IDの設定を参照してください。

   オンプレミスのデプロイでは、witadmin changefields コマンドライン ツールを使用して、ユーザー名フィールドの同期を有効または無効にすることができます。 syncnamechanges 属性を指定して、カスタムユーザー名フィールドを同期することもできます。 「作業項目フィールド の管理」および「FIELD (定義) 要素のリファレンス」を参照してください。

3. 属性がディメンションに設定されているレポート可能フィールド。 オンプレミスの XML モデルをサポートするようにコレクションが構成されている場合にのみ有効です。 レポート可能なデータはデータ ウェアハウスにエクスポートされ、Excel または SQL Server レポートに含めることができます。 オンプレミスの Azure DevOps の場合は、witadmin changefield コマンドを使用して、フィールドのレポート可能な属性を変更します。

4. インデックス付きフィールド。 フィールドのインデックス作成を有効にすると、クエリでそのフィールドを指定する作業項目を検索するパフォーマンスが向上する可能性があります。 オンプレミスの Azure DevOps の場合は、witadmin indexfield コマンド を使用して、フィールドのインデックス属性を変更します。

5. 要件カテゴリは、製品バックログとボードに表示されるすべての作業項目の種類に適用されます。 このカテゴリには、「バックログとボードにバグを表示する」のチーム設定に基づいてバグ カテゴリに追加された項目が含まれます。 作業項目タイプカテゴリの詳細については、「カテゴリを使用して作業項目タイプをグループ化する」を参照してください。

選択できる ID のスコープを、プロジェクトに追加されたユーザーのみに制限するには、Project-Scoped Users グループを使用します。 詳細については、「組織の管理」の「ID 検索と選択のを制限する」を参照してください。

状態変更

次の 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>

[アクティブ化した人] と [アクティブ化された日] の遷移の割り当て

バグ ワークアイテムに対して次の遷移が発生すると、次の割り当てが [有効化者] フィールドと [有効化日] フィールドに対して行われます。

<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>

バグ作業項目に対して次の遷移が発生した場合:

<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>

[有効日] フィールドと [解決日] フィールド

対応するワークフロー カテゴリの状態に基づいて変更が行われると、これらのフィールド (、アクティブ化日付、解決日、解決日) が更新されます。 ワークフローの状態が 進行中 状態カテゴリに変わると、 によってアクティブ化され、アクティブ化された日付 が更新されます。 ワークフローの状態が 解決済み 状態カテゴリに変わると、解決日 と 解決日 が更新されます。

ワークフロー状態を状態カテゴリにマップする方法の詳細については、「ワークフローの状態と状態のカテゴリをバックログとボードので使用する方法」を参照してください。

これらのフィールドはワークフロー状態カテゴリを参照するため、追加したカスタム ワークフローの状態はフィールドの更新時に参照されます。 カスタマイズの詳細については、「プロセスのワークフローをカスタマイズする」を参照してください。

その他の注意事項:

• フィールドは、設定されている以外のカテゴリの状態から作業項目が移動するたびに更新されます。 たとえば、作業項目を New から Fixedに更新すると、解決日/解決日 フィールドが更新されます。 ただし、固定 から更新し、テストの準備完了(同じカテゴリ状態) の場合、解決日/解決日 フィールドは更新されません。
• "解決済み" 状態から "アクティブ" 状態へなど、逆方向に移行すると、システムによって [解決者] と [解決日] フィールドの値がクリアされます。 "アクティブ" から "新規" に移行した場合、システムによって [アクティブ化した人] と [アクティブ化された日] フィールドの値がクリアされます。
• これらのフィールドの値は手動で変更しないでください。 システム ルールによって管理されるシステム フィールドです。 設定しようとする値はすべて上書きされます。