---
sourceDocument: Xanadu 빌드 워크플로우
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 빌드 워크플로우

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# 기록 조회 단계

# 기록 조회 단계 {#ariaid-title1}

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

정의된 조건을 사용하여 테이블에서 여러 기록을 조회합니다.

## 역할 및 가용성 {#lookup-records-action-designer__section_pwq_rb5_kcb}

워크플로우 스튜디오 동작 단계로 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.

## 입력 {#lookup-records-action-designer__section_lx4_cfl_kyb}

작업에 필요한 각 입력에 대한 값을 제공합니다. 동적 값을 추가하려면 데이터 패널에서 알약을 드래그하거나 알약 선택기에서 선택할 수도 있습니다.{#lookup-records-action-designer__inputs-description}

테이블
:   데이터 유형: Table Name

    조회하려는 기록이 들어 있는 테이블 이름입니다.

조건
:   데이터 유형: Conditions

    기록을 검색하는 데 사용할 필드 이름 및 필드 값입니다. 인라인 스크립트를 사용하여 조건을 지정하려면 GlideRecord 및 GlideQueryCondition 클래스를 사용하여 쿼리를 작성하는 것이 좋습니다. [GlideRecord - Global](https://www.servicenow.com/docs/access?context=c_GlideRecordAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) 및 [GlideQueryCondition - Global](https://www.servicenow.com/docs/access?context=c_GlideQueryConditionAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) 문서를 참조하십시오.

정렬 기준
:   데이터 유형: Field Name

    결과를 정렬하는 데 사용할 필드입니다.

정렬 유형
:   데이터 유형: Choice

    오름차순 또는 내림차순으로 알파벳순으로 정렬하는 옵션입니다.

최대 결과
:   데이터 유형: Integer

    단계가 반환할 수 있는 최대 기록 결과 수입니다.

## 작업 오류 평가 {#lookup-records-action-designer__id_lg2_4s3_15b}

이 단계가 실패할 경우
:   데이터 유형: Choice

    다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 대한 단계 상태 코드 또는 메시지를 사용하려면 을 참조하십시오 [작업 오류 평가](https://servicenow-prod.fluidtopics.net/g1aRQeLp52NrNhkF7k8Rkg "단계 실패를 포착하고 실행을 계속하는 작업을 활성화합니다. 특정 오류 조건이 발생하는 시기를 식별하고 고유한 작업 상태 코드, 상태 메시지 및 오류 상태를 반환합니다.").

## 출력 {#lookup-records-action-designer__section_zch_jln_lyb}

이러한 출력은 데이터 패널에 표시됩니다. 이러한 항목을 플로우의 다른 곳에서 입력으로 사용할 수 있습니다.{#lookup-records-action-designer__outputs-description}

기록
:   데이터 유형: Records

    입력한 조회 기준에 따라 찾은 기록 시스템 ID 목록입니다. 자세한 내용은 [레코드를 참조하십시오.\[ Table\] 데이터 유형입니다](oMIJmYOAbz5hVmJc_foBtg "기록에 대한 하나 이상의 시스템 ID 참조를 특정 테이블에 저장합니다. 기록 데이터 형식은 GlideRecord Sys ID 값 목록을 저장하므로 Glide 목록이라고도 합니다.").

테이블
:   데이터 유형: Table Name

    기록 목록이 포함된 테이블입니다.

카운트
:   데이터 유형: Integer

    단계가 반환한 기록 수입니다.

## 일반 가이드라인 {#lookup-records-action-designer__section_x2g_czf_gcc}

기록 조회 작업을 수행할 때 이러한 일반 지침을 사용합니다.  

For Each 플로우 논리를 사용하여 기록 처리
:   For Each 플로우 논리를 사용하여 기록 목록을 반복합니다. For Each 플로우 논리 사용에 대한 자세한 내용은 다음 문서를 참조하십시오 [각 플로우 논리에 대해](https://servicenow-prod.fluidtopics.net/CPj8ClYY6i67liB3G3YnMw "기록 목록의 각 기록에 하나 이상의 작업을 적용합니다."). 또는 스크립트 단계를 사용하여 사용자 지정 동작 내에서 기록 목록을 처리할 수 있습니다.

최대 결과를 설정하여 성능 향상
:   최대 결과 입력을 1,000개 이하로 설정하여 작업 성과를 개선하십시오. 시스템에서 조회해야 하는 기록이 많을수록 기록을 식별하고 처리하는 데 더 많은 시스템 자원이 필요합니다.

조건을 사용하여 기록 필터링
:   조건을 사용하여 단계가 반환하는 기록 수를 제한합니다. 제공할 수 있는 조건이 많을수록 작업의 성과가 향상됩니다.

## 예제 {#lookup-records-action-designer__section_zf4_dj5_kcb}