레코드 목록으로 이동

레이아웃으로 이동하여 레코드 ID 목록에 의해 지정된 결과 세트를 반환합니다.

옵션 

• 레코드 ID 목록은 레코드가 이동할 식별자 목록입니다. 레코드 ID의 순서는 찾기 세트에 사용할 정렬 순서를 지정합니다. 레코드 ID는 지정된 레이아웃과 연결된 테이블의 유효한 레코드 식별자여야 합니다. 지원되는 목록 포맷은 설명을 참조하십시오.

• 레이아웃을 사용하여 레코드 보기는 목록의 레코드를 표시하는 데 사용할 현재 파일의 레이아웃을 지정합니다. 레이아웃이 지정되지 않은 경우 현재 레이아웃이 사용됩니다.

• 새로운 윈도우에서 보기는 새로운 윈도우에서 관련 레코드를 표시하고 새로운 윈도우에 대한 설정을 지정할 수 있습니다. 새로운 윈도우 스크립트 단계를 참조하십시오.

  팁  새로운 윈도우를 자동으로 앞으로 가져오려면 윈도우 선택 스크립트 단계를 추가합니다.

• 애니메이션은 레코드를 표시할 때 사용할 애니메이션을 지정합니다(FileMaker Go만 해당).

다음 버전에서 시작됨 

22.0

설명 

이 스크립트 단계는 현재 윈도우(또는 새로운 윈도우)에서 지정된 레이아웃으로 이동합니다. 그런 다음 레코드의 찾기 세트와 정렬 순서를 레코드 ID 목록에서 지정한 대로 변경하고 해당 세트의 첫 번째 레코드로 이동합니다.

레코드 ID 목록 옵션은 다음 포맷 중 하나로 지정할 수 있습니다.

1
5
21
22
23
7

1
5
21-23
7

[1,5,21,22,23,7]

["1","5","21","22","23","7"]

["1","5","21-23","7"]

[
  {
    "recordId" : "1"
  },
  {
    "recordId" : "5"
  },
  {
    "recordId" : "21"
  },
  {
    "recordId" : "22"
  },
  {
    "recordId" : "23"
  },
  {
    "recordId" : "7"
  }
]

연속 레코드 ID는 값 목록(예: 21-23) 또는 JSON 문자열 배열(예: ["21-23"])의 범위(하이픈으로 구분된 두 숫자)로 지정될 수 있습니다. JSON 숫자 배열의 범위는 유효하지 않은 JSON이므로 이 스크립트 단계는 오류를 반환합니다.

지정된 레코드 ID를 찾을 수 없는 경우(예: 레코드가 삭제된 경우) 해당 ID는 무시되고 찾기 세트에는 성공적으로 찾은 레코드만 포함됩니다. 결과 찾기 세트의 레코드는 제공된 레코드 ID의 순서와 일치하는 정렬 순서로 표시됩니다. 레코드 정렬 대화상자에서 이 정렬 상태는 <사전 정의된 순서>로 표시됩니다.

참고 

• 레코드 ID는 레코드가 생성되었을 때 FileMaker 클라이언트에서 할당한 유효한 레코드 식별자여야 합니다. 이는 Get(레코드 ID) 및 GetRecordIDsFromFoundSet 함수와 FileMaker Data API 및 OData API 호출로 반환되는 것과 같이 다른 곳에서 사용되는 레코드 ID와 동일합니다. 기본 키 필드 값 또는 기타 사용자 설정 식별자는 지원되지 않습니다.

• 지정된 레코드를 찾을 수 없는 경우, 이 스크립트 단계는 Get(마지막 오류) 함수로 캡처될 수 있는 오류 코드 101("레코드가 유실되었습니다") 또는 401("요청과 일치하는 레코드가 없습니다")을 반환합니다.

• 이 스크립트 단계가 새로운 윈도우를 열 때, 트리거된 스크립트가 원하는 레이아웃 또는 보기로 이동하지 않을 수도 있기 때문에 해당 윈도우는 OnFirstWindowOpen 스크립트 트리거 또는 OnWindowOpen 스크립트 트리거를 활성화하지 않습니다. 이 스크립트 단계가 새로운 윈도우를 연 다음 스크립트를 수행하도록 하려면 스크립트 수행을 다음 스크립트 단계로 추가하십시오.

• 애니메이션 옵션은 FileMaker Go에서만 지원됩니다.

  • 선택된 윈도우에 대해서만 애니메이션을 사용할 수 있습니다.

  • 슬라이더 또는 상태 툴바 버튼을 사용하여 레코드를 탐색하는 데 애니메이션을 사용할 수 없습니다.

예제 1 - 값 목록의 레코드로 이동

연락처 레이아웃으로 이동하여 캐리지 리턴으로 구분된 레코드 ID 목록에서 지정한 레코드를 표시합니다.

변수 설정  [ $recordList ; 값: "15¶8¶23¶4¶12" ]
레코드 목록으로 이동 [ 레코드 ID 목록: $recordList ; 레이아웃 사용: "연락처" (연락처) ]

예제 2 - 저장된 시맨틱 찾기의 레코드로 이동

의미론적 찾기 수행 의 예제 2에서 수행된 시맨틱 찾기는 $$result의 레코드 목록을 recordId 키-값 쌍이 있는 대상체의 JSON 배열로 저장했습니다. (저장된 찾기 결과 JSON 포맷은 레코드 목록으로 이동의 포맷과 호환됩니다.) 나중에 동일한 FileMaker 클라이언트 세션에서 이 스크립트는 새로운 윈도우를 열고 동일한 레이아웃(미팅 세부 정보)으로 이동하여 동일한 찾기 세트를 표시합니다. 실패하면 스크립트가 오류 메시지를 표시합니다.

레코드 목록으로 이동 [ 레코드 ID 목록: $$result ; 레이아웃 사용: "미팅 세부 정보" (미팅) ; 새로운 윈도우 ]

If [ Get ( 마지막 오류 ) ≠ 0 ]
    사용자 설정 대화상자 보기 [ "오류" ; "지정된 레코드로 이동할 수 없습니다. Error: " & Get ( 마지막 오류 ) ]
End If

예제 3 - 호스트에서 클라이언트의 찾기 세트 재생성

FileMaker 클라이언트에서 재고가 적은(< 50) 제품 찾기를 수행한 다음, GetRecordIDsFromFoundSet 함수를 사용하여 찾기 세트의 레코드 ID를 가져옵니다. 그러면 클라이언트 스크립트가 호스트에서 스크립트를 호출하고 레코드 ID 목록을 전달합니다.

레이아웃으로 이동 [ "제품 (제품) ; 애니메이션: 없음 ]
찾기 모드로 전환 [일시 정지: 끔]
필드 설정 [ 제품::재고 ; "<50" ]
찾기 수행 [ ]

변수 설정 [ $foundSetIDs ; 값: GetRecordIDsFromFoundSet ( 값 숫자 범위 ) ]

서버에서 스크립트 수행 [ "호스트 스크립트" ; 지정됨: 목록에서 ; 매개 변수: $foundSetIDs ; 완료 대기: 켬 ]

사용자 설정 대화상자 보기 [ "결과" ; Get ( 스크립트 결과 ) ]

호스트 스크립트는 제품 레이아웃의 레코드 목록으로 이동하여 결과를 계산한 다음, 결과를 클라이언트 스크립트로 다시 전달합니다.

변수 설정 [ $recordIDs ; Get ( 스크립트 매개 변수 ) ]
레코드 목록으로 이동 [ 레코드 ID 목록: $recordIDs ; 레이아웃 사용: "제품" (제품) ; 애니메이션: 없음 ]

# 찾기 세트의 레코드를 처리하고 $result 반환
스크립트 종료 [ 텍스트 결과: $result ]

관련 주제 

• GetRecordIDsFromFoundSet 함수

• 의미론적 찾기 수행 스크립트 단계

• FileMaker Data API 실행 스크립트 단계

• 스크립트 단계 참조