작업 매개변수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분

    • 작업 매개변수는 JSON 객체 매개변수가 HTTP GET 또는 POST 요청의 일부일 때 수행할 작업을 지정한다는 점에서 데이터 매개변수와 별개이며 다릅니다.

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

    sysparm_action

    다음은 API에서 트리거되는 sysparm_action 및 해당 작업에 유효한 값입니다.
    표 1. 데이터 검색
    메서드 요약 설명
    getKeys 인코딩된 쿼리 문자열을 사용하여 대상 테이블을 쿼리하고 쉼표로 구분된 sys_id 값 목록을 반환합니다.
    getRecords 인코딩된 쿼리 문자열을 사용하여 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다.
    가져오기 sysparm_sys_id URL 매개변수에 sys_id 지정하여 대상 테이블에서 단일 기록을 쿼리하고 기록과 해당 필드를 반환합니다.
    표 2. 데이터 수정
    메서드 요약 설명
    삽입 URL의 타깃팅된 테이블에 대해 하나 이상의 새 기록을 생성합니다.
    insertMultiple URL에서 타깃팅된 테이블에 대해 새 기록을 여러 개 만듭니다.
    업데이트 인코딩된 쿼리 문자열로 필터링된 URL의 대상 테이블에서 기존 기록을 업데이트합니다.
    삭제 기록 sysparm_sys_id URL 매개변수에 sys_id 지정하여 URL의 대상이 되는 테이블에서 기록을 삭제합니다.
    deleteMultiple URL의 대상이 된 테이블에서 인코딩된 쿼리 문자열로 필터링된 여러 기록을 삭제합니다.

    sysparm_query

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

    sysparm_view

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

    sysparm_sys_id

    함수 호출(sysparm_action 값)을 가져오거나 삭제하는 동안 대상 sys_id 지정합니다.

    sysparm_record_count

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

    표시 값

    기록에 있는 경우 참조 필드의 표시 값을 가져옵니다. 예를 들어 인시던트 기록에는 사용자 기록에 대한 참조인 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로 다시 전송됩니다.

    displayvariables

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