URL から挿入
目的
URL からフィールドまたは変数に内容を入力します。
参照
構文
URL から挿入 [SSL 証明書の検証 ; 選択 ; ダイアログあり: オン/オフ; <テーブル::フィールドまたは変数> ; <リソース URL> ; <cURL オプション>]
オプション
•[
SSL 証明書の検証] は、URL で指定されたサーバーの SSL 証明書を検証します。証明書が検証できない場合、ユーザはそのまま接続するか、キャンセルしてこのスクリプトステップをスキップするかを選択できます。証明書が検証できず、
エラー処理 スクリプトステップが [
オン] に設定されている場合、[URL から挿入] はサーバーが使用不可の場合と同様に動作します。
•[内容全体を選択] オプションを選択すると、フィールドまたは変数の内容が置き換えられます。このオプションが選択されていない場合、次のようになります。
•フィールドの場合、アクティブなフィールドで選択されている部分のみが置き換えられるか、または挿入ポイントにデータが挿入されます。選択されている部分がない場合は、挿入ポイントに結果が挿入されます。デフォルトの挿入ポイントはフィールド内のデータの末尾です。
•オブジェクトデータがない変数の場合、変数の現在の値の末尾にデータが挿入されます。オブジェクトデータがある変数の場合、変数の内容が置き換えられます。
•[ダイアログあり] により、このスクリプトステップを実行したときに [[URL から挿入] オプション] ダイアログボックスを表示するかどうかが指定されます。
•[
ターゲット] では、URL の内容を挿入するフィールドまたは変数を指定します。変数が存在しない場合は、このスクリプトステップによって変数が作成されます (
変数の使用を参照)。
•[URL を指定] では、URL を入力するか、計算式から URL を作成できます。
•[URL を自動的にエンコード] を使用すると、特殊文字が URL に必要な対応エンコード値に置き換えられます。たとえば、スペース文字は「%20」で置き換えられます。このオプションの選択が解除されると、URL は入力されたままの形式になります。cURL オプションはエンコードされません。
•[
cURL オプションの指定] では、1 つまたは複数のサポートされる cURL オプションを計算式として入力することができます。詳細については、
サポートされている cURL オプションを参照してください。
互換性
スクリプトステップを実行する場所 | サポート |
FileMaker Pro | はい |
FileMaker Server | はい |
FileMaker Go | はい |
カスタム Web 公開 | はい |
FileMaker WebDirect | はい |
Runtime ソリューション | 一部 |
起点
FileMaker Pro 12.0
説明
[URL から挿入] は、http、https、ftp、ftps、および file プロトコルをサポートします。FileMaker Pro は、URL によって変数またはフィールドに指定されたリソースをダウンロードします。
このスクリプトステップを実行する前に、ターゲット変数を指定するか、現在のレイアウト上でターゲットフィールドを指定するか、フィールドをクリックするか、または
フィールドへ移動 スクリプトステップを使用します。[
ターゲット] を指定していない場合は、アクティブなフィールドにデータが配置されます。それ以外の場合は、このスクリプトステップはエラーコードを返します。このエラーコードは
Get (最終エラー) 関数を使用して処理することができます。
オブジェクトフィールドでサポートされているピクチャ、オーディオ/ビデオ形式の一覧は、
オブジェクトフィールドのデータの操作を参照してください。
重要 FileMaker WebDirect の性能を高めるには、ターゲットがフィールドの場合は [内容全体を選択] オプションが選択されていることを確認してください。
メモ
•[URL から挿入] でサポートされるのは、[
URL を指定] および返されるテキスト内の UTF-8 だけです。ただし、[
cURL オプションの指定] で、引数の文字エンコードを制御することができます。
サポートされている cURL オプションを参照してください。
•[cURL オプションの指定] は、Runtime ソリューションではサポートされません。
•FileMaker WebDirect の場合:
•[ダイアログあり] オプションが [オン] の場合、このスクリプトステップは [URL を自動的にエンコード] が選択されている場合と同様に実行します。
•[内容全体を選択] オプションが選択されていない場合、[URL から挿入] が内容をテキストフィールドに挿入すると、URL からの内容がテキストフィールドに追加されます。複数の取得は予期せぬ結果となり、パフォーマンスを低下させる結果になる場合があります。
•file プロトコルの場合:
•file プロトコルは FileMaker WebDirect およびカスタム Web 公開ではサポートされません。
•FileMaker Server のドキュメントフォルダまたはテンポラリフォルダ内のファイルのみを参照するサーバーサイドスクリプトで使用できます (
サーバーサイドスクリプト内のパスを参照)。
例 1
Web サイトにアクセスして、売り上げレポートオブジェクトフィールドに PDF を挿入します。
URL から挿入 [ダイアログあり: オフ; 顧客::売り上げレポート ; "http://www.filemaker.com/sales_report.pdf"]
例 2
顧客の住所を示す地図を住所地図オブジェクトフィールドに挿入します。
URL から挿入 [ダイアログあり: オフ; 顧客::住所地図 ; "http://maps.google.com/maps/api/staticmap?center=" & 顧客::住所 & "&zoom=14&markers=" & 顧客::住所 & "&size=256x256&sensor=false"]
例 3
http://www.apple.com の HTML コードを挿入します。
URL から挿入 [ダイアログあり: オフ; 顧客::HTML Web サイトコード ; "http://www.apple.com"]
例 4
cURL オプション --user および --upload-file を使用して、資格情報 myusername および mypassword でオブジェクトフィールドのファイルをサーバーにアップロードしてから、サーバーからの結果を変数 $$results に保存します。サーバー上のファイル名は、オブジェクトフィールドのファイル名と同じになります。
変数を設定 [ $ファイル ; 値: テーブル::オブジェクト ]
URL から挿入 [SSL 証明書の検証 ; ダイアログあり: オフ; $$results ;
"https://www.filemaker.com/uploads" ;
"--user myusername:mypassword --upload-file $file
--header \"Content-type: image/png\""]
関連項目