GetRecordIDsFromFoundSet

현재 찾기 세트의 레코드 ID를 목록 또는 JSON 배열로 반환합니다. 관련 레코드에 대한 ID를 가져오려면 테이블 일치 항목 또는 포털의 이름을 지정하십시오.

포맷 

GetRecordIDsFromFoundSet ( 유형 { ; 테이블 일치 항목 또는 포털 } )

매개 변수 

유형 - 반환된 레코드 ID의 포맷을 지정하는 숫자 표현식입니다. 설명을 참조하십시오.

테이블 일치 항목 또는 포털 - 현재 레이아웃에서 관련 테이블 일치 항목의 이름 또는 포털의 대상체 이름을 지정하는 텍스트 표현식입니다.

괄호{ }의 매개 변수는 옵션입니다.

반환되는 데이터 유형 

텍스트

다음 버전에서 시작됨 

22.0

설명 

이 함수는 현재 찾기 세트에 있는 모든 레코드의 레코드 ID를 현재 순서로 반환하거나 지정된 테이블 일치 항목 또는 포털을 기준으로 현재 레코드와 관련된 모든 레코드의 레코드 ID를 반환합니다. 레코드 ID는 레코드가 생성될 때 FileMaker 클라이언트가 테이블의 각 레코드에 할당하는 고유 식별자이며 변경할 수 없습니다.

유형 매개 변수는 반환된 데이터의 포맷을 결정합니다. 유형은 상수 이름 또는 숫자 값으로 지정하십시오.

1
5
21
22
23
7

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

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

1
5
21-23
7

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

테이블 일치 항목에서 관련 레코드의 ID를 얻으려면 tableOccurrenceOrPortal 매개 변수를 사용하여 관련 테이블 발생의 이름을 지정합니다. 관련 레코드 ID는 관계로 지정된 정렬 순서로 반환됩니다. 관계 생성 및 변경하기를 참조하십시오.

현재 레이아웃의 포털에서 관련 레코드의 ID를 얻으려면 tableOccurrenceOrPortal 매개 변수를 사용하여 포털의 대상체 이름을 지정합니다(대상체 이름 지정하기 참조). 반환된 레코드 ID는 포털 설정 대화상자의 포털 설정에 따라 필터링되고 정렬됩니다. 관련 레코드를 표시하기 위해 포털 생성하기를 참조하십시오.

참고 

• 반환된 레코드 ID는 레코드 목록으로 이동 스크립트 단계와 함께 사용하여 동일한 테이블을 기반으로 레이아웃을 지정할 때 동일한 찾기 세트를 다시 생성할 수 있습니다.

• 발견된 레코드가 없으면 이 함수는 지정된 포맷의 빈 결과를 반환합니다. 빈 값 목록의 경우, 빈 문자열("")을 반환합니다. 빈 JSON 배열의 경우 "[]"을 반환합니다.

• tableOccurrenceOrPortal 매개 변수가 지정된 경우, 이 함수는 먼저 해당 값을 테이블 일치 항목 이름과 일치시켜 봅니다. 실패하면 포털의 해당 값을 대상체 이름과 일치시켜 봅니다. 일치하는 항목이 발견되지 않으면 이 함수는 "?"를 반환합니다.

예제 1 - 레코드 ID를 값 목록으로 가져오기

레코드 ID를 캐리지 리턴으로 구분된 목록으로 반환합니다.

GetRecordIDsFromFoundSet ( 값 번호 )

현재 찾기 세트에 ID가 101, 102, 105인 레코드가 포함된 경우 이 예제는 다음을 반환합니다.

101
102
105

예제 2 - 포털에서 관련 레코드 ID를 JSON 숫자 배열로 가져오기

ContactsPortal이라는 포털 대상체에서 관련 레코드 ID를 JSON 숫자 배열로 반환합니다.

GetRecordIDsFromFoundSet ( JSONNumber ; "ContactsPortal" )

포털이 정렬하고 필터링하여 ID 1101, 702, 1015로 표시된 세 개의 관련 레코드가 현재 레코드의 포털에 있는 경우 이 예제는 다음을 반환합니다.

[1101,702,1015]

예제 3 - 나중에 다시 생성할 수 있도록 찾기 세트 저장

현재 찾기 세트의 레코드 ID와 현재 레이아웃 이름을 포함하는 JSON 대상체를 전역 필드에 저장합니다.

변수 설정 [ $recordIDs ; 값: GetRecordIDsFromFoundSet ( JSON 문자열 범위) ]
변수 설정 [ $currentLayout ; 값: Get ( 레이아웃 이름) ]

변수 설정 [ $foundSetInfo ; 값: 
  JSONSetElement ( "{}" ; 
    [ "recordIDs" ; $recordIDs ; JSONArray ] ; 
    [ "layout" ; $currentLayout ; JSONString ] 
  )
]

필드 설정 [ 전역::LastFind ; $foundSetInfo ]

연락처 레이아웃의 찾기 세트인 경우 전역::LastFind에 저장된 JSON 대상체는 다음과 같이 표시될 수 있습니다.

{
  "recordIDs": ["1-3", "5", "7-9"],
  "layout": "연락처"
}

나중에 레코드 목록으로 이동 스크립트 단계 스크립트 단계를 통해 다른 스크립트에서 동일한 레이아웃과 찾기 세트로 이동할 수 있습니다.

변수 설정 [ $foundSetInfo ; 값: 전역::LastFind ]
변수 설정 [ $recordIDs ; 값: JSONGetElement ( $foundSetInfo ; "recordIDs" ) ]
변수 설정 [ $layoutName ; 값: JSONGetElement ( $foundSetInfo ; "layout" ) ]

레코드 목록으로 이동 [ 레코드 ID 목록: $recordIDs ; 레이아웃 사용: $layoutName ; 애니메이션: 없음 ]

관련 주제 

• 함수 참조
• 공식 정보
• 함수 정보
• 계산 필드 정의하기
• 공식에 연산자 사용하기
• 레코드 목록으로 이동 스크립트 단계
• Get(레코드 ID) 함수