あるチームから別のチームに作業項目を移動する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

チームを追加したり、既存のチームを再編成したりする場合は、作業項目をエリア パスを更新して、あるチームから別のチームに転送することが必要になる場合があります。 Azure DevOps のすべての作業項目は、チームの所有権を決定し、バックログとボードでの作業項目の表示方法に影響を与えるエリア パスに割り当てられます。

[要件] カテゴリに分類された作業項目は、チームのエリア パスへの割り当てに基づいてチームのバックログに表示されます。 同様に、チームのエリア パスに他の作業項目を割り当てると、チームの所有権に基づくクエリとレポートがサポートされます。

前提条件

• アクセス許可:

  • 作業項目を表示、フォロー、および編集するには、「このノードの作業項目を表示」および「このノードの作業項目の編集」のアクセス許可を許可に設定します。 デフォルトでは、 Contributors グループにこれらの権限が与えられます。 詳細については、「作業追跡権限を設定する」を参照してください。
  • 作業項目にタグを追加するには、プロジェクト レベルの [新しいタグの定義を作成] アクセス許可を [許可] に設定します。 デフォルトでは、 Contributors グループにこの権限が与えられます。

• アクセス レベル:

  • プロジェクト メンバー。
  • 作業項目に新しいタグを追加したり、プルリクエストを表示またはフォローしたりするには：少なくとも Basic アクセスが必要です。
  • 作業項目を表示またはフォローするには、少なくとも 利害関係者 アクセス権が必要です。 詳細については、「アクセス レベルについて」を参照してください。
  • Readers グループのメンバーを含むすべてのプロジェクト メンバーは、作業項目を含む電子メールを送信できます。

  Note

  • ディスカッションに貢献し、進捗状況を確認するメンバーにStakeholder アクセス権を付与します。 これらは通常、コードには貢献しないが、作業項目、バックログ、ボード、ダッシュボードを表示したいメンバーです。
  • 既定では、パブリック プロジェクトのすべての共同作成者および関係者が、新規および既存のタグを追加できます。 プライベート プロジェクトでは、関係者は既存のタグのみを追加できます。 新しいタグを作成する権限を制御するには、プロジェクト レベルで [タグ定義の作成] アクセス許可を設定します。 詳細については、 プロジェクトレベルのアクセス許可の変更に関する記事を参照してください。

• エリア パスの権限: エリア パス ノードで作業項目を 表示 し、編集 します。 詳細については、「領域または反復パスの下の作業項目を 変更するを参照してください。
• 構成済みのエリア パス: ターゲット チームのエリア パスが正しく構成されていることを確認します。 そうでない場合は、作業項目を転送する前に必要なエリア パスを設定します。
• 一貫性のあるプロセス モデル: Teams は互換性のあるプロセス モデル (継承、ホストされた XML、またはオンプレミスの XML) を使用して、作業項目をシームレスに移動できるようにする必要があります。
• 作業項目のバックアップ: エラーが発生した場合にデータが失われるのを防ぐために、一括移動を実行する前に作業項目をバックアップまたはエクスポートすることをお勧めします。
• ツール: Azure CLI コマンドを使用するには、「 Get started with Azure DevOps CLI」の説明に従って Azure CLI をインストールします。

チームの下で作業項目を移動する

チームの下で作業項目を移動するには、次の手順を実行します。

1. 再割り当てするすべての作業項目のクエリを作成します。

2. 各チームに属する項目を複数選択し、区分パスを一括編集します。

1. 一括変更した後、一括保存します。

Azure CLI を使用して作業項目を移動する

az boards の作業項目の更新を使用してそのエリア パスを更新することで、1 つの作業項目を移動できます。

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--reason]
                           [--state]
                           [--title]

パラメーター

• id: 必須。 更新する作業項目の ID。
• area: 省略可能。 区分の絶対パス。 例: --path \ProjectName\Area\AreaName。
• assigned-to: 省略可能。 作業項目が Jamal に割り当てられているユーザーの名前。
• description: 省略可能。 作業項目の説明。
• discussion: 省略可能。 作業項目のディスカッションに追加するコメント。
• fields: 省略可能。 設定するカスタム フィールドのスペース区切りの "フィールド=値" ペア。
• iteration: 省略可能。 イテレーションの絶対パス。 例: \ProjectName\Iteration\IterationName。
• open: 省略可能。 作業項目を既定の Web ブラウザーで開きます。
• reason: 省略可能。 作業項目の状態の理由。
• state: 省略可能。 作業項目の状態 ([アクティブ] など)。
• title: 省略可能。 作業項目のタイトル。

例

Azure DevOps CLI を使用して一度に移動できる作業項目は 1 つだけです。 この例では、作業項目 ID=148 を Fabrikam Fiber\Production Planning 区分パスの下に移動します。

az boards work-item update --id 148 --area "Fabrikam Fiber\Production Planning" --output yaml

次の YAML 出力は、作業項目に定義されている各フィールドに関する情報を提供します。

fields:
  Microsoft.VSTS.Common.Priority: 2
  Microsoft.VSTS.Common.StackRank: 1500000001.0
  Microsoft.VSTS.Common.StateChangeDate: '2021-11-23T22:26:28.27Z'
  Microsoft.VSTS.Common.ValueArea: Business
  System.AreaPath: Fabrikam Fiber\Production Planning
  System.AssignedTo:
    _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.BoardColumn: Backlog
  System.ChangedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.ChangedDate: '2022-05-19T22:58:52.93Z'
  System.CommentCount: 0
  System.CreatedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.CreatedDate: '2021-11-23T22:26:28.27Z'
  System.Description: <div>This user story is for documentation purposes.&nbsp; </div>
  System.IterationPath: Fabrikam Fiber\Release 2\Sprint 1
  System.Reason: New
  System.State: New
  System.TeamProject: Fabrikam Fiber
  System.Title: Test the Request feedback functionality
  System.WorkItemType: User Story
  WEF_10182DA5BCCD4CE2A43629FFBD290EF2_Kanban.Column: Backlog
id: 148
relations:
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/152
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/153
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/151
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/149
rev: 5
url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/148

可視性を確認する

作業項目をあるチームから別のチームに移動した後に作業項目が表示されない場合は、次のアクションを実行します。

• 更新: ボードを更新するか、新しく追加した作業項目が表示されない場合は 「その他のアイテムを表示」を選択します。
• チームの確認: バックログに項目が表示されるようにするために、適切なチームを選択したことを確認します。
• エリア パスの確認: 移動した作業項目が、チームのバックログに対応する適切なエリア パスに割り当てられていることを確認します。 各チームには、バックログに表示される作業項目を決定する特定のエリア パスがあります。 このアクションは、バックログの可視性を確保するために重要です。
• イテレーション パスの確認: スプリントのイテレーション パスを確認します。 スプリント バックログには、選択したスプリントのイテレーション パスに割り当てられた作業項目のみが表示されます。
• 作業項目の種類とフィルターの確認: バックログ フィルターを確認し、作業項目の種類が正しく分類されており、関連するすべての項目が表示されることを確認します。

詳細については、「プロジェクトのバックログとボードを設定する」を参照してください。

関連記事

• チームを作成または追加する
• チームとアジャイル ツールについて学習する