---
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


---

# DevOpsChangeRelationshipHelper スクリプトを使用して変更要求データを取得

# DevOpsChangeRelationshipHelper スクリプトを使用して変更要求データを取得 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

DevOpsChangeRelationshipHelper スクリプトインクルードを使用して、指定された関係タイプに基づいて変更要求に関連付けられたデータを取得します。

## 始める前に

必要なロール:sn_devops.viewer

## このタスクについて

[スクリプトインクルード](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)を使用して、サーバースクリプトで使用できるように JavaScript の関数およびクラスを格納します。スクリプトインクルードは、ビジネスルール、UI アクション、ワークフロースクリプト、スクリプト済み REST API などから呼び出すことができます。

このメソッドは、指定された関係タイプに基づいて変更要求に関連するデータを取得します。  
サポートされている関係タイプは次のとおりです。

* DevOpsCommonConstants.COMMIT_TABLE
* DevOpsCommonConstants.DEVOPS_WORK_ITEM
* DevOpsCommonConstants.DEVOPS_TEST_SUMMARY_TABLE
* DevOpsCommonConstants.DEVOPS_SECURITY_SCAN_SUMMARY_TABLE
* DevOpsCommonConstants.DEVOPS_ARTIFACT_VERSION_TABLE
* DevOpsCommonConstants.DEVOPS_SOFTWARE_QUALITY_SUMMARY_TABLE
* DevOpsCommonConstants.DEVOPS_PULL_REQUEST_TABLE
{#retrieve-change-request-data-using-devopschangerelationshiphelper-script__ul_nnd_kdr_xzb}

## 手順

1. 移動先 すべてシステム定義スクリプトインクルード.
2. DevOpsChangeRelationshipHelper スクリプトを検索します。  
   このスクリプトインクルードは、ビジネスルール、UI アクション、ワークフロースクリプト、スクリプト済み REST API などから呼び出すことができます。

## 例

changeRelationHelperObj メソッドを含むオブジェクトのインスタンスがあるとします。

    var changeRelationHelperObj = new sn_devops.DevOpsChangeRelationshipHelper();

変更要求を表す GlideRecord オブジェクトがあるとします。

    var changeRequest = new GlideRecord('change_request');
    changeRequest.addQuery('number', 'CHG123456');
    changeRequest.query();
    changeRequest.next();

取得されるデータには、関係タイプに応じて追加の詳細が含まれる場合があります。データが見つかった場合は、関連する Sys ID 情報を含むアレイが返されます。データが見つからない場合は、デバッグメッセージが表示され、空の配列が返されます。データの取得中に問題が発生した場合は、詳細を含むエラーメッセージが表示されます。

例 1:変更要求のコミットデータの取得

    try {
        var commitsData = changeRelationHelperObj.getChangeRelationData(changeRequest, sn_devops.DevOpsCommonConstants.COMMIT_TABLE);
        if (commitsData && commitsData.length > 0) {
            gs.log('Commits Data:', commitsData);
        } else {
            gs.log('No commits found for Change Request:', changeRequest.getDisplayValue());
        }
    } catch (error) {
        gs.error('Error fetching commits data:', error.getMessage());
    }

例 2:変更要求の作業アイテムの取得

    try {
        var workItemsData = changeRelationHelperObj.getChangeRelationData(changeRequest, sn_devops.DevOpsCommonConstants.DEVOPS_WORK_ITEM);
        if (workItemsData && workItemsData.length > 0) {
            gs.log('Work Items Data:', workItemsData);
        } else {
            gs.log('No work items found for Change Request:', changeRequest.getDisplayValue());
        }
    } catch (error) {
        gs.error('Error fetching work items data:', error.getMessage());
    }