---
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) 소요 시간: 2분

작업 매개변수는 JSON 객체 매개변수가 HTTP GET 또는 POST 요청의 일부일 때 수행할 작업을 지정하므로 데이터 매개변수와 별개입니다.

매개변수는 제공된 JSON 객체의 필드로 지정할 수도 있습니다. `sysparm_action`의 경우 작업을 트리거하고, `sysparm_query`의 경우 업데이트 또는 쿼리의 결과를 필터링하는 효과가 있습니다.

## sysparm_action

다음은 API에 의해 트리거되는 `sysparm_action` 및 해당 작업에 대한 유효한 값입니다.{#c_ActionParameters__table_ess_ybj_bp__entry__2}

| 메서드 요약 | 설명 |
|-|-|
| getKeys | 인코딩된 쿼리 문자열을 사용하여 대상 테이블을 쿼리하고 쉼표로 구분된 `sys_id` 값 목록을 반환합니다. |
| get기록 | 인코딩된 쿼리 문자열을 사용하여 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다. |
| 가져오기 | `sysparm_sys_id` URL 매개변수에 `sys_id` 지정하여 대상 테이블에서 단일 기록을 쿼리하고 기록과 해당 필드를 반환합니다. |
[표 1. 데이터 검색]

{#c_ActionParameters__table_ess_ybj_bp} {#c_ActionParameters__table_jtf_3cj_bp__entry__2}

| 메서드 요약 | 설명 |
|-|-|
| 삽입 | URL에서 대상으로 하는 테이블에 대해 하나 이상의 새 기록을 만듭니다. |
| 삽입다중 | URL에서 대상으로 지정된 테이블에 대해 새 기록을 여러 개 생성합니다. |
| 업데이트 | URL의 대상 테이블에서 인코딩된 쿼리 문자열로 필터링된 기존 기록을 업데이트합니다. |
| 기록 삭제 | `sysparm_sys_id` URL 매개변수에 기록 `sys_id` 지정하여 URL에서 대상으로 지정된 테이블에서 기록을 삭제합니다. |
| delete다중 | URL을 대상으로 하는 테이블에서 인코딩된 쿼리 문자열로 필터링된 여러 기록을 삭제합니다. |
[표 2. 데이터 수정]

{#c_ActionParameters__table_jtf_3cj_bp}

## sysparm_query

get, getRecords, update 또는 deleteMultiplesysparm_action 값에 사용할 인코딩된 쿼리 문자열을 지정합니다.

## sysparm_view

양식 뷰를 지정하여 get 및 getRecords 함수 호출에 대한 반환 값을 사용자 지정합니다. 뷰를 사용할 때 쿼리는 참조된 값을 포함하여 뷰에 정의된 필드만 반환합니다. 뷰 이름이 없거나 뷰 이름이 유효하지 않은 경우 쿼리는 딕셔너리에서 활성으로 표시된 모든 필드 이름을 반환합니다.

## sysparm_sys_id

get 또는 delete 함수 호출 중 대상 sys_id(`sysparm_action` 값)을 지정합니다.

## sysparm_record_count

정수 값을 지정하여 이 요청에 대해 검색되는 기록 수를 제한합니다. 이 값은 시스템 속성에 glide.processor.json.row_limit 의해 제한됩니다.

## displayvalue

기록에 참조 필드가 있는 경우 해당 필드의 표시 값을 가져옵니다. 예를 들어 인시던트 기록에는 사용자 기록에 대한 참조인 `assigned_to` 필드가 있을 수 있습니다. 사용자 기록 sys_id를 전송하는 대신 사용자 이름을 전송합니다.  
displayvalue 매개변수에는 true, false 또는 all의 세 가지 값이 있을 수 있습니다.

* true: 모든 참조 필드에 `sys_id` 대신 표시 값이 표시됩니다.
* false(기본값): 모든 참조 필드가 `sys_ids으로 표시됩니다.`
* all: 표시 값과 `sys_id` 가 표시됩니다. 예를 들어 인시던트 기록의 assignedto 필드는 assigned_to:1234556, dv_assigned_to:Fred Luddy로 다시 전송됩니다.
{#c_ActionParameters__ul_unp_vdj_bp}

## display변수

get 또는 getRecords 함수 호출 중에 이 부울 값을 true 로 설정하여 이 기록에 연결된 모든 변수를 검색합니다.