Azure DevOpsパイプラインでの変更要求の詳細を取得および更新
Azure DevOpsパイプラインに関連付けられた変更要求の詳細を取得して更新します。
始める前に
この手順を実行する前に、次の前提条件を満たしていることを確認してください。
- Azure DevOps ツールに接続して構成し、既存のリポジトリ、オーケストレーションタスク、パイプラインを検出します。
- 次のカスタム拡張タスクを Azure DevOps インスタンスにインストールします。
- ServiceNow Azure Pipelines を DevOps チェンジベロシティ と統合するための拡張機能。詳細については、「Azure DevOpsおよびAzure DevOpsカスタムアクションに ServiceNow DevOps 拡張機能を使用する」を参照してください。
必要なロール：
- DevOps 変更速度管理の admin または sn_devops.admin
- Azure DevOps のアドミン
このタスクについて
変更要求 のステータスパラメーターを更新する と、次の移行のみがサポートされます。
- cancel:ステータスを [キャンセル] に移行するには、変更要求ステータスが [実装済み] である必要があります。理由は、ステータスをキャンセルに更新するための必須入力です。
- クローズ済み:ステータスをクローズに移動するには、変更要求ステータスが実装後である必要があります。close_codeとclose_notesは、ステータスをクローズ済みに更新するための必須入力です。
変更要求状況を整数値として指定します。
- 4:キャンセル (sn_devops.change_request.cancel_state プロパティに設定された値)
- 3:クローズ済み (sn_devops.change_request.closed_state プロパティに設定された値)
選択フィールドを更新するときは、対応する選択リストで利用可能な有効な選択値を指定する必要があります。たとえば、[ クローズコード ] フィールドの選択リスト値は、[成功]、[successful_issues]、[不成功] です。
手順
-
[タスクを追加] アイコン ( [タスク
] ) を選択し、[タスクを追加] 検索バーで ServiceNow 拡張機能を検索します。
-
タスクで、使用している関数に基づいて次の入力パラメーターを更新します。
Get 関数 - プロジェクト名
- パイプライン名
- ステージ名
- ジョブ 名
- ビルド ID
- 試行番号
- 分岐名 (複数分岐パイプラインの場合のみ)
注:変更要求の詳細を入力パラメーターとして指定しない場合、現在のパイプラインとステージに関連付けられた変更要求番号が取得されます。更新タスクで変更要求番号を参照するために使用される、変更要求取得タスクの参照名を入力します。以下の例を参照してください。
関数を更新 - 詳細を更新する必要がある変更要求番号。
- キー:値のペアとして更新される変更要求属性。
{ "short_description": "Test description", "priority": "1", "start_date": "2021-02-05 08:00:00", "end_date": "2022-04-05 08:00:00", "justification": "test justification", "description": "test description", "cab_required": <true/false>, "comments": "This update for work notes is from ADO file", "work_notes": "test work notes", "assignment_group": "<SYS_ID>", "state":"<STATE_CODE>", "close_code":"<successful/successful_issues/unsuccessful>", "reason":"<As per Choice List>" }changeRequestNumber 値は、「<task_name>.<changeRequestNumber>」形式のタスク参照名の取得を使用して参照する必要があります。以下の例を参照してください。
注:試行番号はオプションです。指定しない場合、現在のパイプライン実行からの最新の CHG 番号が取得されます。それ以外の場合は、環境変数を使用せずに試行回数を明示的に指定できます。