---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Recupere dados da solicitação de mudança usando o script DevOpsChangeRelationshipHelper

# Recupere dados da solicitação de mudança usando o script DevOpsChangeRelationshipHelper {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Recupere dados associados a uma solicitação de mudança com base no tipo de relação especificado usando a inclusão de script DevOpsChangeRelationshipHelper.

## Antes de Iniciar

Função necessária: sn_devops.viewer

## Por Que e Quando Desempenhar Esta Tarefa

Uso [Inclusões de script](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Para armazenar funções e classes JavaScript para uso por scripts de servidor. Você pode chamar a inclusão de script a partir de uma regra de negócio, ação de IU, script de fluxo de trabalho, REST API com script e assim por diante.

Este método recupera dados relacionados a uma solicitação de mudança com base no tipo de relação especificado.  
Os tipos de relação compatíveis são:

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

## Procedimento

1. Navegar até TudoDefinição do SistemaInclusões de script.
2. PESQUISE o script DevOpsChangeRelationshipHelper.  
   Você pode chamar esta inclusão de script a partir de uma regra de negócio, ação de IU, script de fluxo de trabalho, REST API com script e assim por diante.

## Exemplo

Suponha que você tenha uma instância do objeto que contém o método changeRelationHelperObj.

    var changeRelationHelperObj = new sn_devops.DevOpsChangeRelationshipHelper();

Suponha que você tenha um objeto GlideRecord representando uma solicitação de mudança.

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

Os dados recuperados podem incluir detalhes adicionais, dependendo do tipo de relação. Se forem encontrados dados, uma matriz que contém as informações de sys IDs relacionadas será retornada. Se os dados não forem encontrados, uma mensagem de depuração será exibida e uma matriz vazia será retornada. Se houver um problema durante a recuperação de dados, uma mensagem de erro será exibida com detalhes.

Exemplo 1: Recuperando dados de confirmação para uma solicitação de mudança.

    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());
    }

Exemplo 2: Recuperando itens de trabalho para uma solicitação de mudança.

    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());
    }