creating-fix-work-item

前提条件

最初に checking-devops-prerequisites — 前提条件 1～4 を読み込みます。doce-org-alias、登録先の DevopsProjectId、および OwnerId（担当者）が必要です。DevopsProject が存在しない場合は、プロジェクトが作成されるまで作業項目を作成できないことを伝えます。

作成前に必要な入力

入力	取得方法
DevopsProjectId	パイプラインに関連付けられたプロジェクトから取得します。不明な場合は、doce 組織で DevopsProject WHERE Name = '<projectName>' を検索します
Subject	失敗の分析から導きます。例：「修正：blitz-10-06 リポジトリに code-analyzer-v5.yml ワークフローがありません」
OwnerId	割り当て先の開発者のユーザー ID です。不明な場合は、doce 組織で SELECT Id, Name FROM User WHERE Username = '<username>' を検索します。ユーザー名が不明な場合は、ユーザーに確認します。
doce-org-alias	前提条件で設定済みです

確認ゲート

作業項目を作成する前に、概要を提示して明示的な確認を待ちます。

「以下の内容で修正作業項目を作成します。

• 件名： <subject>
• 担当者： <assigneeName>
• プロジェクト： <projectName>

作成してもよろしいですか？」

ユーザーが確認するまで先に進まないでください。

作業項目の作成

sf data create record \
  --sobject WorkItem \
  --values "Subject='<subject>' DevopsProjectId='<DevopsProjectId>' OwnerId='<OwnerId>'" \
  --target-org <doce-org-alias> \
  --json

重要： WorkItem（名前空間なし）を使用してください。この組織バージョンでは DevopsWorkItem はサポート対象の sObject ではありません。

成功時

結果から返された id を解析して、次のように確認します。

「修正作業項目を作成しました（<id>）：<subject>。<projectName> プロジェクトで <assigneeName> に割り当てられています。」

エラー処理

API エラーメッセージをそのまま表示しないでください。エラーをわかりやすいメッセージに置き換えます。

エラー	応答
FIELD_INTEGRITY_EXCEPTION	「担当者 ID が無効です。正しいユーザー ID を確認します。開発者のユーザー名を教えてください。」
REQUIRED_FIELD_MISSING	「必須フィールドがありません。Subject と DevopsProjectId の両方が指定されていることを確認してください。」
INSUFFICIENT_ACCESS	「このプロジェクトで作業項目を作成する権限がありません。」
その他のエラー	「作業項目を作成できませんでした。エラー：<plain summary>。もう一度試すか、DevOps Center で手動作成してください。」

関連スキル

• analyzing-test-failures — 修正作業項目の作成につながる、失敗の分析と改善案を提供します