URL에서 삽입
URL에서 콘텐츠를 필드 또는 변수에 입력합니다.
다음도 참조하십시오.
옵션
-
전체 콘텐츠 선택은 필드 또는 변수의 콘텐츠를 대치합니다. 이 옵션을 선택하지 않은 경우:
-
필드의 경우 활성 필드에서 선택된 부분만 대치하거나 삽입 지점에 데이터를 삽입합니다. 기본 삽입 지점은 필드 데이터의 끝입니다.
-
컨테이너 데이터가 없는 변수의 경우 변수의 현재 값 끝에 데이터를 삽입합니다. 컨테이너 데이터를 가지고 있는 변수의 경우 변수의 콘텐츠를 대치합니다.
-
-
대화상자 사용은 스크립트 단계가 수행되면 "URL에서 삽입" 옵션 대화상자를 표시할지 정합니다
-
대상은 URL 콘텐츠를 삽입할 필드 또는 변수를 지정합니다. 변수가 없는 경우 이 스크립트 단계는 변수를 생성합니다(변수 사용하기 참조).
-
URL 지정을 사용하면 URL을 입력하거나 계산에서 URL을 생성할 수 있습니다.
-
자동으로 URL 인코드는 특수 문자를 URL에 필요한 해당 인코드 값으로 대치합니다. 예를 들어 공백 문자는
%20
으로 대치됩니다. 이 옵션을 선택 해제하면 URL은 입력할 때와 같으며 cURL 옵션은 인코딩되지 않습니다. -
SSL 인증서 확인은 URL에서 지정된 서버의 SSL 인증서를 확인합니다. 인증서를 확인할 수 없는 경우 사용자는 계속 연결하거나 취소하여 이 스크립트 단계를 건너뛸 수 있습니다. 인증서가 유효하지 않고 오류 캡처 설정 스크립트 단계가 켬으로 설정되어 있는 경우 URL에서 삽입은 서버를 사용할 수 없는 것처럼 동작합니다.
-
cURL 옵션 지정은 계산처럼 하나 이상의 지원되는 cURL 옵션 입력을 허용합니다. 지원되는 cURL 옵션을 참조하십시오.
호환성
제품 | 지원 |
FileMaker Pro | 예 |
FileMaker Go | 예 |
FileMaker WebDirect | 예 |
FileMaker Server | 예 |
FileMaker Cloud | 예 |
FileMaker Data API | 예 |
사용자 설정 웹 발행 | 예 |
다음 버전에서 시작됨
12.0
설명
이 스크립트 단계에서는 URL에 의해 지정된 리소스를 변수 또는 필드로 다운로드합니다. 지원되는 프로토콜은 다음과 같습니다.
-
http, https
-
ftp, ftps, sftp
-
file
-
smb
-
smtp, smtps
-
ldap, ldaps
예외 사항은 메모를 참조하십시오. 다른 프로토콜은 지원되지 않고 오류를 반환합니다.
이 스크립트 단계를 수행하기 전에 현재 레이아웃의 대상 필드를 지정하고, 대상 변수를 지정하고, 필드 안을 클릭하거나 필드로 이동 스크립트 단계를 사용해야만 합니다. 대상이 지정되지 않은 경우 데이터는 활성 필드에 위치합니다. 그렇지 않은 경우, 이 스크립트 단계는 Get(마지막 오류) 함수로 캡처될 수 있는 오류 코드를 반환합니다.
그림 목록 및 컨테이너 필드에서 지원되는 오디오/비디오 포맷에 대해 컨테이너 필드에서 데이터 사용하기를 참조하십시오.
중요사항 FileMaker WebDirect에서 더 나은 성능을 위해 대상이 필드일 때 전체 콘텐츠 선택이 선택되어 있는지 확인합니다.
참고
-
Claris Connect는 클라우드 기반 통합 플랫폼으로서 사용자의 FileMaker 사용자 맞춤형 App을 웹 App 및 서비스에 연결하는 손쉬운 방법을 제공합니다. Claris Connect를 참조하십시오.
-
URL에서 삽입은 URL 지정에서 UTF-8만 지원합니다. 하지만 cURL 옵션 지정의 경우, cURL 옵션에서 매개 변수의 문자 인코딩을 제어할 수 있습니다. 지원되는 cURL 옵션을 참조하십시오.
-
대상이 변수인 경우, 데이터는 일반적으로 텍스트로 저장됩니다. 컨테이너 데이터로 저장하려면, 지원되는 cURL 옵션에서 설명된 cURL 옵션을 지정하십시오.
-
이 스크립트 단계가 서버의 응답을 기다리는 시간을 조절하려면
--max-time
cURL 옵션의 값을 지정하십시오. -
FileMaker WebDirect에서:
-
대화상자 사용 옵션이 켬 상태인 경우 이 스크립트 단계는 자동으로 URL 인코드가 선택되어 있는 것처럼 실행합니다.
-
전체 콘텐츠 선택이 선택되어 있지 않고 URL에서 삽입이 콘텐츠를 텍스트 필드로 삽입하는 경우 URL의 콘텐츠는 텍스트 필드에 추가됩니다. 다중 패치는 예기치 않은 결과와 더 느린 성능의 결과를 초래할 수 있습니다.
-
-
파일 프로토콜:
-
FileMaker WebDirect, FileMaker Data API 및 사용자 설정 웹 발행에서 지원되지 않습니다.
-
서버 측 스크립트에서 문서 폴더 또는 임시 폴더에 있는 파일을 참조하는 데에만 사용할 수 있음(서버 측 스크립트의 경로 참조)
-
-
Get(문서 경로) 및 Get(임시 경로)와 같은 가져오기 함수에서 반환된 경로는 FileMaker 포맷이며 URL 지정의 파일 프로토콜로 해당 경로를 사용하려면 표준 URL 포맷으로 변환해야 합니다. (ConvertFromFileMakerPath 함수를 참조하십시오). 변환 없이 이러한 경로를 사용하는 데이터 파일에서 읽기 스크립트 단계를 사용하면 로컬 파일에 더 쉽게 접근할 수 있습니다.
-
FileMaker Go는 ldap 및 ldaps 프로토콜을 지원하지 않습니다.
-
서버의 응답에 내용이 없는 경우, 이 스크립트 단계를 수행한 후 Get(마지막 오류)가 10("요청된 데이터 유실")을 반환할 수 있습니다. 이 반환 값은 예상된 응답이 내용을 수신하지 않는 경우에 오류가 발생했음을 의미하지 않을 수도 있습니다.
예제 1
웹 사이트에 접근하고 PDF를 영업 리포트 컨테이너 필드에 삽입합니다.
URL에서 삽입 [ 대화상자 사용: 끔 ; 대상: 고객::판매 리포트 ; "https://example.com/sales_report.pdf" ]
예제 2
고객 주소를 보여주는 지도를 주소 지도 컨테이너 필드에 삽입합니다.
URL에서 삽입 [ 대화상자 사용: 끔 ; 대상: 고객::주소 지도 ; "http://maps.google.com/maps/api/staticmap?center=" & 고객::주소 & "&zoom=14&markers=" & 고객::주소 & "&size=256x256&sensor=false&key=API_KEY" ]
예제 3
https://www.apple.com에 대한 HTML 코드를 삽입합니다.
URL에서 삽입 [ 대화상자 사용: 끔 ; 대상: 고객::HTML 웹 사이트 코드 ; "https://www.apple.com" ]
예제 4
cURL 옵션 --user
및 --upload-file
을 사용하여 컨테이너 필드에 있는 파일을 myusername
및 mypassword
인증서를 사용하는 서버로 업로드하고 서버로부터의 결과를 변수 $$results
에 저장합니다. HTTP 또는 HTTPS의 경우, 서버에 있는 파일 이름은 컨테이너 필드에 있는 파일 이름과 동일합니다.
변수 설정 [ $file ; 값: 테이블::컨테이너 ]
URL에서 삽입 [ 대화상자 사용: 끔 ; 대상: $$results ;
"https://example.com/uploads" ; SSL 인증서 확인 ;
cURL 옵션: "--user myusername:mypassword --upload-file $file
--header \"Content-type: image/png\"" ]
예제 5
보안 연결을 사용하는 SMTP 서버를 통해 이메일을 보냅니다. --mail-from
(발신자 주소), --mail-rcpt
(수신자 주소), --upload-file
(메시지를 포함하는 파일), --user
(SMTP 서버에 로그인하는 데 사용하는 인증서)와 같은 cURL 옵션을 사용합니다.
변수 설정 [ $mail ; 값: TextEncode(테이블::이메일 ; "utf-8" ; 3) ]
URL에서 삽입 [ 선택 ; 대화상자 사용: 끔 ; 대상: $result ;
"smtps://smtp.example.com:465" ; SSL 인증서 확인 ; cURL 옵션:
"--mail-from sender@example.com
--mail-rcpt recipient@example.com
--upload-file $mail
--user account:password" ]
테이블::이메일 텍스트 필드는 HTML 포맷의 이메일 본문과 다음 메시지 내용을 포함합니다.
발신자: 발신자 이름 <sender@example.com>
수신자: 수신자 이름 <recipient@example.com>
제목: 제목 줄
콘텐츠 유형: text/html; charset="utf8"
<html><body>이메일 본문</body></html>