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


---

# 직접 서비스

# 직접 웹 서비스 {#ariaid-title1}

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

올바른 액세스 제어 목록이 구성된 경우 시스템의 모든 테이블에 대해 직접 웹 서비스를 사용할 수 있습니다.

수신 메시지의 지원되는 형식은 문서 스타일 리터럴 XML SOAP 문서(문서/리터럴)입니다. 직접 웹 서비스 WSDL 설명과 XML 스키마를 검색하려면 상대 URL \<tablename\>.do? WSDL입니다. 예를 들어, 온라인 데모 시스템에서 인시던트 테이블의 WSDL을 검색하려면 다음 URL을 사용하십시오. https://\<인스턴스 이름\>.service-now.com/incident.do?WSDL.

## 확장된 쿼리 매개변수 {#c_DirectWebServices__section_nj5_kfy_23b}

확장된 쿼리 매개변수를 사용하면 get, getKeys 및 getRecords 함수를 사용할 때 SOAP 쿼리의 반환 결과를 필터링하고 수정할 수 있습니다.  
주:  
확장된 쿼리 요소 이름 앞에는 두 개의 밑줄 문자가 옵니다.
{#c_DirectWebServices__table_xwm_4fy_23b__entry__3}

| 매개변수 | 설명 | 예제 |
|-|-|-|
| __encoded_query | 반환된 결과를 필터링하는 데 사용할 인코딩된 쿼리 문자열을 지정합니다. 인코딩된 쿼리 문자열 형식은 `sysparm_query` URL 매개변수에 지정할 수 있는 값과 비슷합니다. RSS 피드 생성기 예제에서 인코딩된 쿼리 작성 예제를 참조하십시오. | `<__encoded_query>active=true^category='하드웨어'</__encoded_query>` |
| __order_by | 반환된 결과를 지정된 필드별로 정렬하도록 지시합니다. | `<__order_by>우선순위</__order_by>` |
| __order_by_desc | 반환된 결과를 지정된 필드별로 내림차순으로 정렬하도록 지시합니다. | `<__order_by_desc>opened_date</__order_by_desc>` |
| __exclude_columns | 결과 세트에서 제외할 쉼표로 구분된 필드 이름의 목록을 지정합니다. | `<__exclude_columns>sys_created_on,sys_created_by,caller_id,우선순위</__exclude_columns>` |
| __limit | 반환되는 기록 수를 제한합니다. | `<__limit>100</__limit>` |
| __first_row | 결과를 세트의 시작부에서 이 기록 수로 오프셋하도록 지시합니다. `__last_row`과 함께 사용하면 결과 창을 쿼리하는 효과가 있습니다. 결과에는 첫 번째 행 번호가 포함됩니다. | `<__first_row>250</__first_row>` |
| __last_row | 세트의 시작부터는 이 기록 수 또는 지정된 경우 `__start_row` 값으로 결과를 제한하도록 지시합니다. `__first_row`과 함께 사용하면 결과 창을 쿼리하는 효과가 있습니다. 결과는 마지막 행 번호보다 작으며 마지막 행은 포함되지 않습니다. | `<__last_row>500</__last_row>` |
| __use_view | 반환되는 결과를 제한하고 확장하는 데 사용할 이름으로 양식 뷰를 지정합니다. 양식 뷰에 caller_id.email과 같은 심층 참조 필드가 포함되어 있으면 이 필드도 결과에 반환됩니다. | `<__use_view>soap_view</__use_view>` |
[표 1. 사용 가능한 확장 쿼리 매개변수]

{#c_DirectWebServices__table_xwm_4fy_23b}

## 직접 웹 서비스 네임스페이스 {#c_DirectWebServices__section_lc1_lgy_23b}

## 각 테이블에 고유한 네임스페이스 지정 {#c_DirectWebServices__section_hb2_kgy_23b}

이 속성은 glide.wsdl.definition.use_unique_namespace 각 테이블의 직접 웹 서비스 WSDL에 고유한 targetNamespace 속성이 있는지 확인합니다. 이 속성은 기본적으로 true이며, 이를 위해서는 테이블의 직접 웹 서비스 WSDL에서 http://www.service-now.com/\<table name\> 값을 사용해야 targetNamespace 합니다. false인 경우(또는 속성이 없는 경우) 모든 테이블은 동일한 targetNamespace값인 http://www.service-now.com 을 사용합니다. 또한 모든 테이블이 동일한 작업 이름을 공유하므로 둘 ServiceNow 이상의 웹 서비스를 사용하려는 웹 서비스 클라이언트는 여러 테이블 간의 요청을 구분할 수 없습니다. 고유 targetNamespace 값을 사용하면 웹 서비스 클라이언트가 여러 테이블 간의 요청을 구분할 수 있습니다.

예를 들어, 인시던트 테이블에 대한 직접 웹 서비스 WSDL은 다음 targetNamepsace 값을 사용합니다.

    <wsdl:definitions xmlns:soapenc= "http://schemas.xmlsoap.org/soap/encoding/"xmlns:wsdl = "http://schemas.xmlsoap.org/wsdl/"xmlns:http = "http://schemas.xmlsoap.org/wsdl/http/"xmlns:tns = "http://www.service-now.com/incident"xmlns:xsd = "http://www.w3.org/2001/XMLSchema"xmlns:mime = "http://schemas.xmlsoap.org/wsdl/mime/"xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"targetNamespace = "http://www.service-now.com/incident" ><wsdl:types><xsd:schema elementFormDefault = "unqualified"targetNamespace = "http://www.service-now.com/incident" >

## 네임스페이스 요구 사항 설정 {#c_DirectWebServices__section_yvp_mgy_23b}

ServiceNow의 WSDL 스키마는 기본적으로 속성을 선언 elementFormDefault="unqualified"합니다. 이 속성은 로컬로 선언된 요소가 인스턴스 문서의 에 targetNamepsace 의해 규정되어야 하는지 여부를 나타냅니다. 이 속성의 값이 정규화되지 않은 경우 로컬로 선언된 요소는 .targetNamepsace 이 속성의 값이 한정된 경우 로컬로 선언된 요소 targetNamepsace는 .

그러나 이는 WSDL에서 생성된 클라이언트(예: .NET, Axis2, webMethods)가 포함된 스키마를 처리하는 방식과 호환되지 않습니다. 결과적으로 스키마 네임스페이스가 제거되어 웹 서비스 응답을 분리할 수 없게 됩니다.

이 호환성 문제를 해결하기 위해 호출 glide.wsdl.schema.UnqualifiedElementFormDefault 된 부울 속성이 도입되었습니다. 이 속성의 기본값은 true 입니다. false로 설정하면 WSDL에서 작성된 클라이언트가 웹 서비스 호출의 반환 값을 구문 분석할 수 있습니다. 다음 위치의 웹 서비스 속성 페이지를 사용하여 이 속성을 수정할 수 있습니다. 시스템 속성웹 서비스.

## 중복 서비스 이름 허용 {#c_DirectWebServices__section_ytf_qjv_bdb}

기본적으로 동적으로 작성되는 WSDL의 서비스 이름은 고유하며 다음과 같은 형식을 갖습니다.

    ServiceNow_<table name>

중복된 서비스 이름을 허용하려면 관리자가 속성을 false로 설정할 glide.wsdl.unique_service_name 수 있습니다. 속성이 없는 경우 속성을 생성합니다.
* **[양식을 사용하여 쿼리 응답을 제한하거나 확장](https://servicenow-prod.fluidtopics.net/PN6fGpLP1YjzkiOH_9LGpA)**   
  SOAP 쿼리가 반환하는 필드 값의 수를 제한해야 하는 경우가 있습니다.
* **[참조 변수에 대한 표시 값 반환](https://servicenow-prod.fluidtopics.net/fS6yFXtlOoxjBjqgS9xFOg)**   
  or getRecords 함수를 사용하여 get 레코드를 쿼리하면 인스턴스가 해당 레코드와 연결된 모든 필드를 반환합니다. 필드는 종종 다른 테이블의 기록에 대한 sys_id을 포함하는 참조 필드입니다.
* **[대상 인스턴스에서 값 지우기](https://servicenow-prod.fluidtopics.net/UPE96UpccAL4GTbA12BCWg)**   
  SOAP 매개변수를 통해 빈 값을 전달하여 대상 인스턴스에서 해당 값을 지울 수 있습니다.
* **[직접 웹 서비스를 사용하여 저널 항목 검색](https://servicenow-prod.fluidtopics.net/utD71_I1vJfWWMsJAhDGpw)**   
  저널 필드의 내용을 가져오려면 sys_journal_field 테이블에 대해 두 번째 SOAP 요청을 만들어 해당 레코드에 해당하는 저널 레코드를 다시 가져옵니다.
* **[직접 웹 서비스를 사용하여 선택 필드 검색](https://servicenow-prod.fluidtopics.net/koybMrDprqo~_L0zEeJC~A)**   
  선택 필드를 검색하거나 설정하려면 레이블이 아닌 선택 값을 사용하십시오.
* **[모든 SOAP 호출에서 HTTP 세션 유지](https://servicenow-prod.fluidtopics.net/kUGXf10jI11dl2FzvbTNRw)**   
  SOAP 클라이언트가 짧은 시간에 많은 호출을 수행하는 경우 모든 SOAP 호출에 대해 단일 HTTP 세션을 다시 사용할 수 있습니다.
* **[SOAP 직접 웹 서비스 API 함수](https://servicenow-prod.fluidtopics.net/csYkfRM63DnHi1jSUNUu1A)**   
  표준 SOAP API는 대상 리소스에서 수행할 수 있는 전역으로 정의된 작은 기능 집합입니다.

**관련 개념**   

* [SOAP 웹 서비스](https://servicenow-prod.fluidtopics.net/UE_JXSQPzWcNrgorcVoFQQ "SOAP(Simple Object Access Protocol)는 HTTP를 통해 웹 서비스에 액세스하기 위한 XML 기반 프로토콜입니다.")