레코드 가져오기
지정된 파일이나 데이터 원본에서 레코드를 가져옵니다.
다음도 참조하십시오.
옵션
- 대화상자 사용은 스크립트 단계가 수행되면 표시할 가져오기 관련 대화상자를 지정합니다. 그러나 데이터 원본 파일이 지정되지 않은 경우 스크립트가 실행될 때 파일 열기 대화상자가 표시됩니다.
- 데이터 원본 지정은 가져올 파일이나 데이터의 원본을 지정합니다. 선택하는 파일이나 원본에 따라 다음 추가 옵션을 지정하기 위해 대화상자가 나타날 수 있습니다.
- 가져오기 순서 지정은 이 스크립트 단계를 실행할 때 현재 찾기 세트의 레코드를 추가, 업데이트 또는 대치할지 여부와 원본 필드가 대상 필드에 맵핑되는 방식을 정의합니다. 가져오는 동안 가져오기 동작 및 맵핑 필드 설정하기를 참조하십시오.
참고 일치하는 이름을 사용하여 맵핑되어 있는 원본 필드와 대상 필드를 가져올 때, 필드 이름 일치는 스크립트 단계가 수행될 때마다 동적으로 수행됩니다.
- SSL 인증서 확인은 XML 데이터에 대한 HTTP 요청에 지정된 서버의 SSL 인증서를 확인합니다. 인증서를 확인할 수 없는 경우 사용자는 계속 연결하거나 취소하여 이 스크립트 단계를 건너뛸 수 있습니다. 인증서가 유효하지 않고 오류 캡처 설정 스크립트 단계가 켬으로 설정되어 있는 경우 이 스크립트 단계는 서버를 사용할 수 없는 것처럼 동작합니다.
파일 또는 원본 선택 |
방법 |
파일 |
파일 지정 대화상자에서 가져올 파일을 선택하거나 파일 경로를 목록에 직접 입력합니다. 한 줄당 한 경로를 지정합니다. FileMaker Pro는 파일이 위치하는 첫 번째 경로를 가져올 파일로 사용합니다. 파일 경로 생성하기를 참조하십시오. 데이터 원본을 지정한 후 첫 번째 행 옵션 대화상자가 나타난 경우, 첫 번째 행을 필드 이름으로 사용할지 여부를 지정할 수 있습니다. 가져오기 순서 지정 옵션을 사용하는 경우, 지원되는 가져오기/내보내기 파일 포맷에 표시된 특정 파일 포맷에서 가져올 때 아무 레코드를 선택하여 필드 이름으로 사용할 수 있습니다. 파일 지정 대화상자에서 사용자 설정 필드 구분 기호가 있는 파일을 지정하는 경우, 파일 유형에 대해 사용자 설정 문자로 구분된 값을 선택하고 필드 구분 기호를 지정하십시오. |
폴더 |
파일 가져오기 폴더 옵션 대화상자에서 가져오려는 이미지 또는 텍스트 파일의 폴더를 선택하거나 목록에 직접 입력합니다. 한 줄당 한 경로를 지정합니다. FileMaker Pro는 폴더가 위치하는 첫 번째 경로를 가져올 폴더로 사용합니다. 폴더의 파일을 한 번에 가져오기 및 파일 경로 생성하기를 참조하십시오. 이 옵션은 FileMaker WebDirect 및 서버 측 스크립트에서 지원되지 않습니다. |
XML 데이터 |
XML 및 XSL 옵션 지정 대화상자에서 가져오려는 XML 데이터의 원본을 선택하고 가져오기 전에 적용하려는 경우 XSLT 스타일 시트를 선택합니다. XML 및 XSLT 원본은 파일, HTTP 요청 결과 또는 파일 경로나 HTTP 요청을 생성하는 계산일 수 있습니다. XML 데이터 가져오기를 참조하십시오. |
ODBC 데이터 |
데이터 원본 이름 및 위치, 사용자 ID 및 암호(있는 경우) 및 실행될 SQL 쿼리를 지정합니다. 레코드 가져오기 스크립트 단계를 사용하여 ODBC 가져오기 자동화하기를 참조하십시오. SQL 문은 최대 길이가 256,000자(512KB)로 제한됩니다. 참고 레코드 가져오기 스크립트 단계를 사용하여 Unicode 문자열을 포함하는 ODBC 데이터를 가져오는 경우 ODBC 드라이버는 Unicode를 지원해야 합니다. 그렇지 않으면 결과가 일치하지 않습니다. |
호환성
제품 | 지원 |
FileMaker Pro | 예 |
FileMaker Go | 부분 |
FileMaker WebDirect | 부분 |
FileMaker Server | 부분 |
FileMaker Cloud | 부분 |
FileMaker Data API | 아니요 |
사용자 설정 웹 발행 | 아니요 |
다음 버전에서 시작됨
6.0 또는 이전
설명
가져오기 순서를 설정하고 가져오기 순서 지정 옵션을 사용하거나, 사용자가 데이터를 새로운 테이블로 가져오기와 같은 새로운 조건을 설정할 수 있는 대화상자와 함께 이 스크립트 단계를 수행할 수 있습니다.
원본 파일이 열려 있는 경우 찾기 세트를 가져오고 그렇지 않으면 원본 테이블에 있는 모든 레코드를 가져옵니다.
서버 측 스크립트에 이 스크립트 단계를 포함하고 대화상자 사용을 켬으로 설정한 경우, 해당 옵션이 흐리게 표시되지만 이 스크립트 단계는 실행됩니다. 마치 대화상자 사용이 끔으로 설정된 것처럼 동작합니다. 자세한 정보는 Get(문서 경로 목록) 함수를 참조하십시오.
다음 작업을 수행하기 위해 서버 측 스크립트를 실행하면 오류를 반환합니다.
- 새로운 테이블로 레코드를 가져오기
- 폴더에서 레코드 가져오기
- 컨테이너 필드로 이미지 가져오기
FileMaker Pro로 데이터 가져오기를 참조하십시오.
참고
- FileMaker Go에서:
- FileMaker Pro 파일에서 다른 FileMaker Pro 파일로 가져오기만 지원됩니다.
- 새로운 테이블로 가져오기는 지원되지 않습니다.
- FileMaker WebDirect에서:
- 이 스크립트 단계는 모바일 브라우저에서 지원되지 않습니다.
- 데이터 원본 지정 옵션은 지원되지 않습니다. 사용자는 웹 브라우저에서 접근 가능한 파일을 지정해야 합니다.
- FileMaker Pro, 쉼표로 분리된 값, 탭으로 분리된 값, DBF, 병합 및 Excel 파일 포맷에서 가져오기만 지원됩니다.
- 서버측 스크립트는 특정 폴더에만 접근할 수 있습니다. 서버 측 스크립트의 경로를 참조하십시오.
- 서버 측 스크립트, FileMaker Go 및 FileMaker WebDirect는 대화상자 사용이 끔으로 설정된 경우에만 다음 옵션이 지원됩니다.
- 사용자 설정 문자로 구분된 값 포맷의 원본 파일
- 아무 행을 필드 이름으로 지정(대화상자 사용이 켬으로 설정되어 있는 경우, 첫 번째 행만 지정할 수 있음)
- 개별 필드의 자동 입력 옵션 수행
FileMaker WebDirect에서 이 스크립트 단계에 이 옵션이 사전 정의되어 있고 대화상자 사용이 켬으로 설정되어 있는 경우, 스크립트가 실행될 때 사용자가 선택한 옵션은 사전 정의된 옵션을 덮어씁니다.
- 데이터 원본 지정 옵션에서 변수를 지정하는 경우입니다.
- 데이터 원본 지정 옵션을 선택하고 가져오기 순서 지정 옵션을 선택할 때 파일 경로 변수를 지정하려면 가져오려는 포맷의 로컬 파일 경로로 이어지는 파일 경로 목록에 변수를 우선 배치합니다. 가져오기 순서 지정 옵션을 선택하면 스크립트 단계는 찾을 수 있는 첫 번째 파일 경로를 사용합니다. 스크립트 단계는 스크립트 실행 전까지는 변수를 평가할 수 없으므로 목록에 있는 다음 파일 경로(로컬 파일)를 사용하며, 이로써 사용자는 옵션을 선택할 수 있습니다. 그러나 스크립트를 실행하면 변수가 평가될 수 있는 경우, 스크립트 단계는 변수로 정의된 파일 경로를 사용합니다.
변수만 지정하고 가져오기 순서 지정 옵션을 사용하지 않으려는 경우, 첫 번째 행 옵션 대화상자가 나타나며 첫 번째 행에 필드 이름을 포함할지 선택할 수 있습니다.
예제 1
사용자에게 프롬프트로 표시하지 않고 새 제품 카탈로그.xlsx의 정보를 새로운 레코드로 가져옵니다.
레이아웃으로 이동 ["제품"(제품) ; 애니메이션: 없음 ]
레코드 가져오기 [ 대화상자 사용: 끔 ; 테이블: 제품 ; 원본: "새 제품 카탈로그.xlsx" ; 워크시트: "재고" ; 추가; Mac 로마체 ]
예제 2
기존 레코드를 새 제품 카탈로그.xlsx의 정보로 대치합니다.
레이아웃으로 이동 ["제품"(제품) ; 애니메이션: 없음 ]
레코드 정렬 [ 복원 ; 대화상자 사용: 끔 ]
레코드/요청/페이지로 이동 [ 처음 ]
레코드 가져오기 [ 대화상자 사용: 끔 ; 테이블: 제품 ; 원본: "새 제품 카탈로그.xlsx" ; 워크시트: "재고" ; 대치; Mac 로마체 ]
예제 3
레코드를 가져온 후에 다음 일련 값을 설정합니다. 이 옵션은 날짜와 다른 자동 입력된 값을 유지하기 위해 가져오는 동안 자동 입력 옵션 수행을 선택하지 않은 경우 유용합니다.
레이아웃으로 이동 ["제품"(제품) ; 애니메이션: 없음 ]
레코드 가져오기 [ 대화상자 사용: 끔 ; 테이블: 제품 ; 원본: "새 제품 카탈로그.xlsx" ; 워크시트: "재고" ; 추가; Mac 로마체 ]
다음 일련번호 값 설정 [ 제품::제품 ID ; Get(총 레코드 개수) + 1 ]
레코드 정렬 [ 복원 ; 대화상자 사용: 끔 ]
레코드/요청/페이지로 이동 [ 처음 ]