---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DevOpsOrchestrationToolIntegrationHandler - 범위 지정됨

# DevOpsOrchestrationToolIntegrationHandler - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

DevOpsOrchestrationToolIntegrationHandler API를 사용하면 사용자 지정 DevOps 도구에서 페이로드를 처리할 수 있습니다.

사용자 지정 DevOps 도구는 와 통합 DevOps되지 않은 모든 도구입니다. 통합이 있는 DevOps 도구 목록은 다음 문서를 참조하십시오 [DevOps Change Velocity integrations](https://www.servicenow.com/docs/access?context=dev-ops-overview&version=australia&pubname=australia-it-service-management&ft:locale=en-US).

이 API를 사용하면 REST 엔드포인트 [DevOps - POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/0QRqH4zxfDKAO3~vMNcrlg#devops-POST-tool "사용자 지정 DevOps 하위 플로우에서 처리하기 위해 전달된 페이로드를 인바운드 이벤트 [sn_devops_inbound] 테이블에 게시합니다.")에서 사용하는 페이로드 처리가 가능합니다. POST /devops/tool/{capability} 엔드포인트를 호출하기 전에 스크립트 포함에서 이 API의 메서드를 구현해야 합니다.

이 API는 `sn_devops` 네임스페이스에서 실행됩니다. DevOps에 대한 자세한 내용은 [DevOps Config](https://www.servicenow.com/docs/access?context=devops-config-landing-page&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 문서를 참조하십시오.

## DevOpsOrchestrationToolIntegrationHandler - getNativeIdForOrchestrationTask(객체 페이로드) {#ariaid-title2}

POST /devops/tool/{capability} 엔드포인트에 대한 페이로드에서 매개변수 값을 orchestrationTaskName 반환합니다.
REST 엔드포인트 [DevOps - POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/0QRqH4zxfDKAO3~vMNcrlg#devops-POST-tool "사용자 지정 DevOps 하위 플로우에서 처리하기 위해 전달된 페이로드를 인바운드 이벤트 [sn_devops_inbound] 테이블에 게시합니다.")를 호출하기 전에 스크립트 포함에서 이 메서드를 구현해야 합니다.
{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 페이로드 | 객체 | REST 엔드포인트 POST /devops/tool/{capability}에서 수락하는 사용자 지정 도구의 데이터를 포함하는 페이로드입니다. 여기서 capability<kbd class="ph userinput">오케스트레이션</kbd>은 무엇입니까? |
[표 1. 매개변수]

{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb} {#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 페이로드의 매개변수 값 orchestrationTaskName 입니다. |
[표 2. 반환]

{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb}  
이 예제에서 <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler</kbd> 라는 스크립트 포함은 handleTool 및 getNativeIdForOrchestrationTask 메서드를 구현합니다. getNativeIdForOrchestrationTask 메서드는 POST /devops/tool/{capability}에 대한 페이로드에서 매개변수 값을 orchestrationTaskName 반환하도록 구현됩니다.

    var DevOpsOrchestrationCustomToolIntegrationHandler = Class.create(); 

    DevOpsOrchestrationCustomToolIntegrationHandler.prototype = {     

        handleTool: function(toolName) { 
            if (!gs.nil(toolName) && toolName == 'sn_devops_custom_tool') 
                return true; 
            return false; 
        }, 

        getNativeIdForOrchestrationTask: function(payload) { 
            return payload.orchestrationTaskName; 
        }, 

        type: 'DevOpsOrchestrationCustomToolIntegrationHandler' 

    }; 

## DevOpsOrchestrationToolIntegrationHandler - handleTool(문자열 toolName) {#ariaid-title3}

이 핸들러가 지정된 도구에 유효한지 확인합니다.
[DevOps - POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/0QRqH4zxfDKAO3~vMNcrlg#devops-POST-tool "사용자 지정 DevOps 하위 플로우에서 처리하기 위해 전달된 페이로드를 인바운드 이벤트 [sn_devops_inbound] 테이블에 게시합니다.")를 호출하기 전에 스크립트 포함에서 이 메서드를 구현해야 합니다.
{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| toolName | 문자열 | 도구의 이름입니다. 테이블: DevOps 도구 통합 \[sn_devops_tool_integration\] 테이블의 <var class="keyword varname">도구 이름</var> 필드 |
[표 3. 매개변수]

{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb} {#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 지정된 도구에 이 핸들러가 유효한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 지정된 도구에 이 핸들러를 사용할 수 있습니다. * false: 지정된 도구에 이 핸들러를 사용할 수 없습니다. {#DevOpsOrchToolIntH-handleTool_S__ul_ovl_gb4_ctb} |
[표 4. 반환]

{#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb}  
이 예제에서 <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler</kbd> 라는 스크립트 포함은 handleTool 및 getNativeIdForOrchestrationTask 메서드를 구현합니다. handleTool 메서드는 전달된 이름이 올바른 도구에 대한 것인지 확인하기 위해 구현됩니다. ' `sn_devops_custom_tool'` 을 사용 중인 도구의 이름으로 바꿉니다.

    var DevOpsOrchestrationCustomToolIntegrationHandler = Class.create(); 

    DevOpsOrchestrationCustomToolIntegrationHandler.prototype = {     

      handleTool: function(toolName) { 
        if (!gs.nil(toolName) && toolName == 'sn_devops_custom_tool') 
          return true; 
        return false; 
      }, 

      getNativeIdForOrchestrationTask: function(payload) { 
        return payload.orchestrationTaskName; 
      }, 

      type: 'DevOpsOrchestrationCustomToolIntegrationHandler' 

    };