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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SOAP 직접 웹 서비스 API 함수

# SOAP 직접 웹 서비스 API 함수 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 1분

표준 SOAP API는 대상 자원에서 수행할 수 있는 전역적으로 정의된 작은 함수 세트입니다.
대상 자원(또는 테이블)은 `URL에서 https://<인스턴스 이름>.service-now.com/<table name>.do` 형식으로 정의됩니다.
{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb__entry__2}

| 메서드 요약 | 설명 |
|-|-|
| [삽입](https://servicenow-prod.fluidtopics.net/BJWvzMhpPUys_ic8yKLpCg "URL의 대상 테이블에 대한 새 기록을 생성합니다.") | URL의 대상 테이블에 대한 새 기록을 생성합니다. |
| [insert다중](https://servicenow-prod.fluidtopics.net/zA55JseAJ9jyRNCuDVBTgw "URL의 대상 테이블에 대한 새 기록을 여러 개 만듭니다.") | URL의 대상 테이블에 대한 새 기록을 여러 개 만듭니다. 여러 삽입을 사용하려면 [웹 서비스 임포트 세트를](https://www.servicenow.com/docs/access?context=c_WebServiceImportSets&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US) 활성화합니다. |
| [업데이트](https://servicenow-prod.fluidtopics.net/M29fkN1KwdrTcycVF~8MSQ "필수 sys_id 필드로 식별되는 URL의 대상 지정 테이블에 기존 기록을 업데이트합니다.") | 필수 sys_id 필드로 식별되는 URL의 대상 지정 테이블에 기존 기록을 업데이트합니다. |
| [삭제 기록](https://servicenow-prod.fluidtopics.net/X8nXvtoV3Iv_b0DuI6L6Qw "기록을 sys_id 제공하여 대상 테이블에서 기록을 삭제합니다.") | `기록을 sys_id` 제공하여 대상 테이블에서 기록을 삭제합니다. |
| [delete다중](https://servicenow-prod.fluidtopics.net/zsK1DGeu5t_KBs4ewg0ZvQ "예제 값으로 대상 테이블에서 여러 기록을 삭제합니다.") | 예제 값으로 대상 테이블에서 여러 기록을 삭제합니다. |
[표 1. 데이터 수정 API]

{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb} {#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb__entry__2}

| 메서드 요약 | 설명 |
|-|-|
| [getKeys (영문)](https://servicenow-prod.fluidtopics.net/~ALIoU7s_3~KKC_NBK7Tzw "예제 값으로 대상 테이블을 쿼리하고 쉼표로 구분된 sys_id 목록을 반환합니다.") | 예제 값으로 대상 테이블을 쿼리하고 쉼표로 구분된 `sys_id` 목록을 반환합니다. |
| [getRecords (영문)](https://servicenow-prod.fluidtopics.net/UjkwC33FNbAoO6uvOU5PEg "예제 값으로 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다.") | 예제 값으로 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다. |
| 가져오기 | 대상 테이블에서 `단일 기록을 sys_id` 으로 쿼리하고 기록과 해당 필드를 반환합니다. |
| [집계](https://servicenow-prod.fluidtopics.net/sOELMUwQ973Cu90WUw4jyg "SUM, COUNT, MIN, MAX, LAST 및 AVG를 포함한 집계 함수를 사용하여 테이블을 쿼리합니다.") | 집계 함수 SUM, COUNT MIN, MAX, LAST 및 AVG를 사용하여 쿼리합니다. 집계 기능을 사용하려면 집계 웹 서비스 플러그인을 활성화하십시오. |
[표 2. 데이터 검색 API]

{#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb}
* **[데이터 검색 API](https://servicenow-prod.fluidtopics.net/w8DEUyqaZsFzTjJGORh7zQ)**   
  데이터 검색 API 메서드 요약 및 설명입니다.
* **[데이터 수정 API](https://servicenow-prod.fluidtopics.net/uBUhvR4dZbYq8faWR0Sw2Q)**   
  데이터 수정 API 메서드 요약 및 설명입니다.

**관련 개념**   

* [양식을 사용하여 쿼리 응답 제한 또는 확장](https://servicenow-prod.fluidtopics.net/FpNqWtHcT8KhdbCeCZnnbA "경우에 따라 SOAP 쿼리가 반환하는 필드 값의 수를 제한해야 합니다.")
* [참조 변수에 대한 표시 값 반환](https://servicenow-prod.fluidtopics.net/_RLuKUfBASMyqjlTdnIJLQ "또는 getRecords 함수를 사용하여 get 레코드를 쿼리하면 인스턴스가 해당 레코드와 연결된 모든 필드를 반환합니다. 이 필드는 종종 다른 테이블의 기록에 대한 sys_id 포함하는 참조 필드입니다.")
* [대상 인스턴스에서 값 지우기](https://servicenow-prod.fluidtopics.net/HsqQyTMijQruKHPv7_MSTw "SOAP 매개변수를 통해 빈 값을 전달하여 대상 인스턴스에서 해당 값을 지울 수 있습니다.")
* [직접 웹 서비스를 사용하여 저널 항목 검색](https://servicenow-prod.fluidtopics.net/yAJcREMJfjOoXVUt8NX_PA "저널 필드의 내용을 가져오려면 sys_journal_field 테이블에 대해 두 번째 SOAP 요청을 작성하여 해당 레코드에 대해 적절한 저널 레코드를 다시 가져옵니다.")
* [직접 웹 서비스를 사용하여 선택 필드 검색](https://servicenow-prod.fluidtopics.net/NECbFyN5fqhw0yRr2SFfcA "선택 필드를 검색하거나 설정하려면 레이블이 아닌 선택 값을 사용하십시오.")
* [모든 SOAP 호출에서 HTTP 세션 유지](https://servicenow-prod.fluidtopics.net/PhZbX0njUbKVlS1SDvfOiw "SOAP 클라이언트가 짧은 시간에 많은 호출을 수행하는 경우 모든 SOAP 호출에 대해 단일 HTTP 세션을 다시 사용할 수 있습니다.")