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

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

はじめに

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

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

前提条件

• Project access: project メンバーになります。

• アクセス許可:

  • 作業項目を表示、フォロー、編集するには、このノードの作業項目を表示しこのノードの作業項目を編集権限を Allow に設定します。 デフォルトでは、 Contributors グループにこれらの権限が与えられます。 詳細については、「作業追跡権限を設定する」を参照してください。

• 作業項目にタグを追加するには、プロジェクト レベルの 新しいタグ定義の作成 権限を Allow に設定します。 デフォルトでは、 Contributors グループにこの権限が与えられます。

• アクセス レベル:

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

  Note

  • ディスカッションに貢献し、進捗状況を確認するメンバーにStakeholder アクセス権を付与します。 これらは通常、コードには貢献しないが、作業項目、バックログ、ボード、ダッシュボードを表示したいメンバーです。
  • 利害関係者 アクセス レベルにより、アクセス許可が明示的に設定されている場合でも、新しいタグを追加することはできません。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

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

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

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

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

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

   

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

   

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

チーム バックログを確認する

あるチームから別のチームに作業項目を移動した後、チーム バックログを確認して、項目が表示されるようにします。 詳細については、バックログの作成に関するページを参照してください。

問題が発生した場合は、プロジェクトのバックログとボードの設定に関する記事を参照してください。

関連記事

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