---
sourceDocument: Xanadu IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-service-management
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu IT Service Management
ft:clusterId :
- itsm
bundleId :
- itsm
workflow :
- Technology
---
# パイプライン内で DevOps 変更要求の詳細を構成する
# パイプライン内で DevOps 変更要求の詳細を構成する {#ariaid-title1}
* リリースバージョン: Xanadu
*
* 更新日 2024年08月01日
*
*  所要時間：8分
パイプラインの変更ステップで、パイプライン内からクローズ情報、変更ステータス、および変更要求フィールドを更新する方法を構成します。
注:
GitLabパイプライン内からの変更要求の詳細の構成はサポートされていません。
システム変数は、デフォルトでは、ベースシステムの変更を自動的にクローズするためのデフォルトサブフローを指します。パイプライン完了時の DevOps 自動変更クローズサブフロー (sn_devops.auto_close_change) は、パイプラインの完了時にクローズ情報、変更ステータス、および変更要求フィールドを更新する方法を決定します。パイプラインの完了時にアクティブ化する必要があるカスタムサブフローを指定する場合は、このサブフローのクローンを作成し、要件に応じてカスタマイズできます。
クローズ情報と変更要求属性は、 changeRequestDetails オブジェクトに含まれています。
## 自動変更クローズ {#dev-ops-config-change-details__section_ts2_c1b_5yb}
パイプラインから変更を作成するときに changeRequestDetails オブジェクトで autoCloseChange パラメーターを true/false に設定して \[ クローズコード \] フィールドと \[クローズメモ \] フィールドを更新し、パイプラインの完了時に変更要求をクローズします。パイプラインが完了すると、\[ Actual start date \] フィールドと \[ Actual end date \] フィールドの値も更新されます。日付の値は、パイプラインの開始時刻またはパイプラインの最初のステージの開始時刻、およびパイプラインの終了時刻またはパイプラインの最終ステージの終了時刻に基づいています。クローズメモには、自動クローズ変更機能に基づいてクローズ情報が更新されたことを指定するテキストが接尾辞として付加されます。
true に設定すると、 クローズ コード フィールドと クローズ メモ フィールドが更新され、パイプラインの完了時にシステムは変更要求のクローズを試みます。
false に設定すると、パイプラインが完了したときに \[クローズ コード \] フィールドと \[クローズ メモ \] フィールドが更新されますが、変更要求はクローズされません。
ServiceNow アプリケーションでパイプラインの \[自動変更クローズ \] フィールド値を設定することもできます。\[ 変更のみを更新\] を選択すると、パイプラインが完了したときに \[ クローズ コード \] フィールドと \[ クローズ メモ \] フィールドが更新され、\[ 更新して変更をクローズ\] を選択すると、変更要求もクローズ情報の更新と共にクローズされます。
自動クローズの変更がパイプラインと列のどちらで指定されているかに基づいて、考慮される最終ステータスは次のようになります。{#dev-ops-config-change-details__simpletable_vhd_nly_2zb__entry__3}
| 変更要求属性の autoCloseChange フラグ | 自動クローズ 列の値の変更 (sn_devops_pipeline) | 最終状況 |
|-|-|-|
| 正しい | 変更のみ更新 | 変更を更新し、ステータスをクローズに移動します |
| 間違い | 変更を更新してクローズ | 変更の更新のみ |
| - | 変更のみ更新 | 変更の更新のみ |
| - | 変更を更新してクローズ | 変更を更新し、ステータスをクローズに移動します |
[ ]
{#dev-ops-config-change-details__simpletable_vhd_nly_2zb}
注:
パイプラインの autoCloseChange 属性に指定された値は、 ServiceNow の Auto Close Change 列で指定された値よりも優先されます。
注:
* 自動クローズ変更機能は、単一の変更が作成された基本的なパイプラインにのみ適用されます。複数の変更がある場合は、最新の変更が自動クローズで考慮されます。
* 自動変更クローズ機能は、変更受付機能が有効になっている Jenkins フリースタイルパイプラインおよび変更要求ではサポートされていません。
* Azure リリース パイプラインの場合、パイプラインの完了状態は、パイプライン内の各ステージの状態を統合することによって派生します。1 つのステージでも失敗すると、パイプラインは失敗したと見なされます。1 つのステージでも部分的に成功した場合、パイプラインは成功したと見なされますが、問題はあります。
{#dev-ops-config-change-details__ul_j4j_ctd_vyb}
## アップグレード情報 {#dev-ops-config-change-details__section_d2f_jh5_c1c}
アップグレードする場合は、 GitHub および Azure ビルドパイプラインの autoCloseChange パラメーターを設定する前に、オーケストレーションツールを再構成する必要があります。
## 終了コードの設定 {#dev-ops-config-change-details__section_crb_rmc_v4b}
目的の動作に基づいて、 setCloseCode: パラメーターを true/false に設定します。デフォルトは true です。
true に設定すると、変更ステップ属性で指定されたとおりに \[クローズコード \] フィールドと \[クローズメモ \] フィールドが更新され、ステージが完了したときに変更要求が実装後に移動します。この動作は、 自動クローズコード 機能を有効にすることで上書きできます。setCloseCode 機能は、autoCloseChange が有効で true または false に設定されている場合、無効になります。詳細については、「 [自動クローズ変更](https://servicenow-prod.fluidtopics.net/~k56n2JpbhUneOCLEUkJRw#dev-ops-config-change-details__section_ts2_c1b_5yb)」を参照してください。より正確な変更要求の詳細を得るには、autoCloseChange 機能を使用します。
false に設定すると、ジョブまたはパイプラインが完了しても変更要求は更新されず、\[実装\] ステータスのままになります。
* 変更要求のクローズ情報が設定されていません (\[クローズコード \] フィールドと \[クローズメモ \] フィールドは空のままです)。
* ステップ実行へのリンクが 作業メモに追加されます。
{#dev-ops-config-change-details__ul_cjt_hwx_3wb}
## 変更要求フィールド {#dev-ops-config-change-details__section_zq3_wmc_v4b}
指定された変更要求テンプレートのパイプライン内で変更要求フィールド値を設定します。
* attributes: パラメーターを使用してフィールド値を設定します。
* DevOps API の [DevOps - POST /devops/orchestration/changeControl](https://www.servicenow.com/docs/access?context=devops-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) エンドポイントを使用します。
{#dev-ops-config-change-details__ul_rqn_c5c_v4b}
注:
* 指定したフィールドに必須の依存フィールドがある場合は、その属性も設定する必要があります。
* 依存必須フィールドの属性が設定されていない場合、変更要求と関連するステップの実行はキャンセルされ、作業メモが更新されます。
{#dev-ops-config-change-details__ul_byp_vkp_gqb}
attributes:パラメーター内のフィールド値は、キーと値のペアです。つまり、キーはテンプレート内のフィールド名であり、値はフィールドに入力する情報です。
changeControl API を使用して、type、cmdb_ci、template、assignment_group business_service、standard_change_template、chg_modelなどのフィールドを指定し、変更要求を作成できます。
属性が変更のために渡される場合、優先順位は次のとおりです。
1. 変更要求フィールドまたは changeControl API。
2. ステップレコードの値。
3. 変更要求テンプレートで指定された値。
{#dev-ops-config-change-details__ol_hhn_4g4_41c}
注:
パイプライン内から変更要求を構成する場合、変更タイプとテンプレートフィールドは常に 1 つのソースから取得されます。API 要求と変更要求フォームの属性を組み合わせて使用することはできません。
指定されている場合を除き、変更要求 \[change_request\] テーブルのすべてのフィールドがサポートされています。
|-|-|
| サポートされていないフィールド | * risk * impact * 番号 * sys_id * risk_impact_analysis {#dev-ops-config-change-details__ul_lhd_l5q_54b} |
| サポートされているフィールド | 変更要求 \[change_request\] テーブルの残りのすべてのフィールド。 |
[表 : 1. サポートされている変更要求フィールド]
{#dev-ops-config-change-details__table_jtr_dbr_54b}
注:
属性名は変更要求フィールド名と一致する必要があり、指定された値が有効である必要があります。
## サンプル JSON ペイロード {#dev-ops-config-change-details__section_qtj_c4c_v4b}
{
"callbackURL":"http://192.168.0.4:3000/jenkins/sn-devops/pipeline_839b7605-b98d-4831-bc87-96829de7da37",
"orchestrationTaskURL":"http://192.168.0.4:3000/jenkins/job/java_sample_tests#deploy/",
"isMultiBranch":"false",
"orchestrationTaskName":"java_sample_tests#deploy",
"orchestrationTaskDetails":{
"triggerType":"upstream",
"upstreamTaskExecutionURL":"http://192.168.0.4:3000/jenkins/job/java_sample_tests/129/execution/node/35/wfapi/describe",
"taskExecutionURL":"http://192.168.0.4:3000/jenkins/job/java_sample_tests/129/execution/node/50/wfapi/describe"
},
"changeRequestDetails":{
"setCloseCode":false,
"attributes":{
"sys_created_by":"1832fbe1d701120035ae23c7ce610369",
"sys_updated_by":"56826bf03710200044e0bfc8bcbe5dca",
"requested_by":{
"name":"Abel Tuter"
},
"watch_list":[
{
"name":"Abel Tuter"
},
{
"name":"Aileen Mottern"
},
{
"name":"Alejandra Prenatt"
},
"56826bf03710200044e0bfc8bcbe5dca"
],
"work_notes_list":[
"56826bf03710200044e0bfc8bcbe5dca",
"46c6f9efa9fe198101ddf5eed9adf6e7",
"d8f57f140b20220050192f15d6673a98"
],
"assigned_to":"1832fbe1d701120035ae23c7ce610369",
"category":"Service",
"sys_created_on":"2021-02-09 18:58:41",
"priority":"2",
}
}
}
## パイプラインの例 {#dev-ops-config-change-details__section_xs4_xnc_v4b}
図 : 1. 変更要求の詳細 - Azure パイプライン
図 : 2. ジョブレベル設定 --- Jenkins
図 : 3. 変更要求の詳細: Jenkins 図 : 4. 変更要求の詳細 - GitHub