--- 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 --- # 스크립트된 서비스 # Scripted SOAP Web Services {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분 스크립트 기반 SOAP 웹 서비스를 사용하면 ServiceNow 관리자가 사용자 지정 SOAP 웹 서비스를 작성할 수 있습니다. SOAP 웹 서비스에 대한 입력 및 출력 매개변수를 정의하고 JavaScript를 사용하여 작업을 수행할 수 있습니다. 이 기능은 매우 강력하지만 구현 및 유지 관리가 더 간단하므로 가능하면 [직접 웹 서비스](https://servicenow-prod.fluidtopics.net/m9VjxozjxN6OddqoYslj3g "올바른 액세스 제어 목록이 구성된 경우 시스템의 모든 테이블에 대해 직접 웹 서비스를 사용할 수 있습니다.") 또는 [SOAP 웹 서비스 임포트 세트](https://servicenow-prod.fluidtopics.net/LQw2f4qe8l_JFw_yVMOSSw "웹 서비스 임포트 세트는 임포트 세트 테이블에 웹 서비스 인터페이스를 제공하여 직접 웹 서비스 및 스크립트된 SOAP 웹 서비스를 보완합니다.") 를 사용하십시오. ## 보안 스크립트된 SOAP 웹 서비스에는 모든 SOAP 웹 서비스와 동일한 기본 보안 옵션이 있습니다. SOAP 웹 서비스 보안에 대한 자세한 내용은 다음 문서를 참조하십시오 [SOAP 웹 서비스 보안](https://servicenow-prod.fluidtopics.net/UE_JXSQPzWcNrgorcVoFQQ#c_SOAPWebService__SOAP-web-services-security). 시스템에 [엄격한 보안](https://servicenow-prod.fluidtopics.net/UE_JXSQPzWcNrgorcVoFQQ "SOAP(Simple Object Access Protocol)는 HTTP를 통해 웹 서비스에 액세스하기 위한 XML 기반 프로토콜입니다.") 이 적용되면 HTTP 인증 사용자에게 스크립트된 웹 서비스를 실행할 수 있는 [soap_script](https://servicenow-prod.fluidtopics.net/UE_JXSQPzWcNrgorcVoFQQ "SOAP(Simple Object Access Protocol)는 HTTP를 통해 웹 서비스에 액세스하기 위한 XML 기반 프로토콜입니다.") 역할이 있어야 합니다. ## WSDL {#c_ScriptedWebServices__section_px4_kjf_f3b} 모든 ServiceNow 테이블과 임포트 세트는 해당 테이블 스키마와 사용 가능한 작업을 설명하는 WSDL(웹 서비스 정의 언어) XML 문서를 동적으로 생성합니다. ## WSDL 준수 적용 {#c_ScriptedWebServices__section_ay4_vff_f3b} WSDL에 정의된 것과 동일한 순서로 출력 값을 나열하도록 응답을 강제할 수 있습니다. 스크립트된 SOAP 웹 서비스를 만들 때 생성되는 WSDL은 입력 매개변수 및 출력 매개변수 관련 목록을 기반으로 합니다. 스크립트된 서비스에서 보낸 실제 SOAP 응답은 스크립트에 의해 결정됩니다. 이 동작으로 인해 스크립트가 WSDL에 정의된 순서와 다른 순서로 출력 값을 반환할 수 있습니다. 관련 목록에 정의된 대로 출력 매개변수의 순서를 적용하려면 WSDL 준수 확인란을 선택합니다. 이 확인란을 선택하면 웹 서비스가 스크립트에서 반환한 매개변수를 WSDL의 순서와 일치하도록 재정렬합니다. 주: 추가 응답 매개변수가 스크립트에 의해 반환되었지만 응답 매개변수 관련 목록에 정의되지 않은 경우 이러한 매개변수는 WSDL 준수 가 선택될 때 응답에서 제외됩니다. {#c_ScriptedWebServices__table_ump_jgf_f3b__entry__2} | 매개변수 | 순서 | |-|-| | 매개변수 1 | 200 | | 매개변수 2 | 300 | | 매개변수 3 | 100 | [표 1. 출력 매개변수 관련 목록] {#c_ScriptedWebServices__table_ump_jgf_f3b} 다음은 정의된 출력 매개변수의 값을 설정하는 스크립트입니다. 이 예시 스크립트에서 매개변수는 출력 매개변수 관련 목록에 정의된 순서와 다른 순서로 설정됩니다. 관련 목록에 정의되어 있지 않은 추가 매개변수도 참고하십시오 param4 . Response.param1 = 1; Response.param4 = 4; Response.param3 = 3; WSDL 준수 확인란이 false이면 스크립트에서 생성되는 SOAP 응답은 다음과 같습니다. 1 4 3 WSDL 준수 확인란이 True이면 스크립트에서 생성되는 SOAP 응답은 다음과 같습니다. 3 1 ## 정적 WSDL {#c_ScriptedWebServices__section_yfd_p2f_f3b} 일부 웹 서비스 클라이언트에는 특정 WSDL 형식을 통해 인스턴스에 대한 SOAP 접근 권한이 필요합니다. 이 필수 형식은 표준 ServiceNow WSDL 형식과 다를 수 있습니다. 이러한 경우 필요한 형식과 일치하는 정적 WSDL을 만들 수 있습니다. ## 전역 변수 수신 SOAP 요청의 사용자 지정 처리를 용이하게 하기 위해 스크립트 컨텍스트에서 다음 전역 변수를 사용할 수 있습니다. * soapRequestDocument: 들어오는 SOAP 봉투를 나타내는 Java org.w3c.dom.Document 객체입니다. * soapRequestXML: 수신 SOAP 봉투 XML을 나타내는 문자열 객체입니다. * request: 수신 SOAP 봉투의 매핑된 값(입력 매개변수 이름에 매핑됨)을 포함하는 Javascript 객체입니다. * 응답: 응답 값을 사용자 지정할 수 있는 Javascript 객체입니다. [응답 사용자 지정](https://servicenow-prod.fluidtopics.net/aDEz6KQcN6qlKjLJRyXvdA "다음 예시에 따라 SOAP 응답의 XML 페이로드를 사용자 지정하고 제어합니다.") 참조 {#c_ScriptedWebServices__ul_qxr_xw2_f3b} * **[스크립트된 새 SOAP 웹 서비스 작성](https://servicenow-prod.fluidtopics.net/sz36b9ZHikdLaV60m6pdTA)** 다음 예시에 따라 스크립트된 새 SOAP 웹 서비스를 작성합니다. * **[응답 사용자 지정](https://servicenow-prod.fluidtopics.net/aDEz6KQcN6qlKjLJRyXvdA)** 다음 예시에 따라 SOAP 응답의 XML 페이로드를 사용자 지정하고 제어합니다. * **[정적 WSDL을 사용하여 스크립트된 SOAP 웹 서비스 만들기](https://servicenow-prod.fluidtopics.net/hpuGUxccErFYSwUI7bq~1g)** 다음 예시에 따라 정적 WSDL을 사용하여 스크립트 기반 SOAP 웹 서비스를 만듭니다.