ユーザがローカルのハードディスクをブラウズできるように、ファイル選択のダイアログを開きます。ユーザがダイアログでファイルまたはディレクトリを選択して「OK」ボタンをクリックすると、この関数は選択されたファイルまたはディレクトリのパスを返します。ユーザが「キャンセル」ボタンをクリックすると、値を返しません。

ファイルタイプ

ファイルタイプのパラメータを指定することにより、ユーザにファイルだけを選択させたり、ディレクトリだけを選択させたり、ファイルとディレクトリの両方から選択させたりすることができます。デフォルトの動作では、ファイルの選択だけを許可します。

ファイルを選択する際、この関数をSCSetContainerと組み合わせて、ユーザのハードディスクから1つのファイルをSuperContainerに読み込むことができます。たとえば以下のコードを使用すると、ユーザが選択したローカルのファイルが、SuperContainerサーバーにアップロードされます。

 SCSetContainer(Asset::ID ; SCChooseFile);

ディレクトリを選択する際、この関数をSCScanDirectoryと組み合わせて、ディレクトリのコンテンツを一括で読み込めます。以下の例では、ユーザにディレクトリを選択させ、そのディレクトリを再帰的にスキャンします（このディレクトリ中の全ファイルのリストを返します）。

 SCScanDirectory ( SCChooseFile("" ; "directories" ) ; true)

注意："directories"または"files + directories"のファイルタイプを指定すると、プラットフォームによっては非ネイティブのファイルダイアログが開きます。ネイティブのダイアログでは、ディレクトリの選択をサポートしていないためです。

パラメータ 

• 初期パス
  • ファイル選択のダイアログで最初に選択される場所を指定するパス（オプション）。初期パスを指定していない場合、ユーザのホームディレクトリがデフォルトになります。
• ファイルタイプ
  • "files"（ファイル）、"directories"（ディレクトリ）、"files + directories"（ファイルとディレクトリの両方）のうち、どれを選択可能にするか。
• タイトル
  •  ファイル選択のダイアログのタイトルとして表示される、タイトルの文字列（オプション）
•  キーと値のペア 
  •  キー = 値のペア（オプション）。オプション：useNativeをfalseに設定して、ネイティブのファイルダイアログの代わりにJavaのファイルダイアログを使用することができます。

戻り値

選択されたファイルのパス。ファイルが選択されなかった場合は、戻り値はなし。エラーが発生した場合は、"ERROR"。

SuperContainer Companion Pluginによってダウンロードされた、ローカルにキャッシュされている一時ファイルをすべて削除します。テンポラリのディレクトリ内のファイルのみを削除します。SuperContainer Companion Pluginは、SCGetContainer がパスを指定せずにコールされたときに一時ファイルを保存します。一時ファイルはテンポラリのディレクトリに保存されます。

戻り値

テンポラリのファイルがすべて正しく削除されたときには、1。1つ以上のファイルを削除できなかったときは、"ERROR"。

SuperContainerサーバー上でファイルを新しい場所へコピーします。オリジナルのファイルへの参照を失うことなくファイルを別の場所へ移動したい場合に便利です。

フォルダパスにファイルが存在しない場合、この関数はエラーを返します。

重要：この関数をコールする前に、SCSetBaseURLをコールしてSuperContainerサーバーの場所を設定する必要があります。

パラメータ

• フォルダパス
  • コピーしたいファイルのフォルダパス。

• コピー先パス

  • オリジナルのファイルのコピー先にしたいフォルダパス。

• キーと値のペア

  • キー = 値のペア（オプション）。オプション：filename。例えば、filename=myNewName.txt。

戻り値

正しくコピーされた場合は、1。エラーが発生した場合は、"ERROR"。

指定されたフォルダパスにより、SuperContainerのファイルを削除します。

指定されたフォルダパスにファイルが存在しない場合、サーバー上では何も変更されません。

重要：この関数をコールする前に、SCSetBaseURLをコールしてSuperContainerサーバーの場所を設定する必要があります。

ローカルのファイルシステムからファイルを削除するには、この関数ではなくSCDeleteLocalFile関数を使用します。

# 削除する
Set Variable [$result; Value:SCDelete( Get( LayoutTableName ) & "/" & ID)]
# 削除中のエラーをチェックする
If [$result = "ERROR"
Show Custom Dialog ["Could not delete file"; SCLastError]
End If
# Webビューアを更新して空のWebビューアを表示する
Set Web Viewer [Object Name: "webviewer"; Action: Reload]

パラメータ

• フォルダパス
  • SuperContainerのファイルを一意に特定するパス。

戻り値

ファイルが正しく削除された場合、または存在しなかった場合には、1。エラーが発生した場合には、"ERROR"。

ローカルのファイルシステムからファイルを削除します。バッチ読み込みのプロセスの一部として、ファイルがSuperContainerに正しくアップロードされた後で削除するために使用できます。

注意：ローカルのファイルを削除する前に、正しくアップロードされたことを必ず確認してください！SuperContainerサーバーからファイルを削除するには、この関数ではなく SCDelete関数 を使用します。

パラメータ

• ローカルファイル
  • 削除するローカルファイルのパス

戻り値

ファイルが正しく削除されたときは、1。ファイルが存在しなかったときは、""。ファイルは存在したが削除できなかったときは、"ERROR"。

ファイルが存在しない場合やサーバー上のバージョンに対して最新でない場合に、SuperContainerサーバーからファイルを別の場所にダウンロードします。この関数が同一のファイルに対して複数回コールされた場合、サーバー上のファイルが変更されていない限りは再度ダウンロードされることはありません。

注意：保存先のURLを指定していない場合、ダウンロードされたファイルはユーザのテンポラリのディレクトリに保管され、FileMakerを終了するときにユーザのローカルのドライブから削除されます。

この処理は同名のファイルを上書きするため、カスタムのパスを指定する際には十分注意してください！

この関数はURLを返すため、「Open URL（URLを開く）」スクリプトステップと組み合わせてダウンロードしたファイルを開くことができます。例を以下に示します。

Open URL [SCDownload("Photos/12345")]

フラグ

この関数では、以下のフラグを使用できます。

• showSaveDialog
  • 保存のダイアログを開きたい場合に設定します。
• checkForFile
  • ファイルがすでに存在するときに警告を表示したい場合に設定します。showSaveDialogが設定されていると、このフラグはデフォルトでfalseになります。ネイティブの保存ダイアログが自動でファイルをチェックするためです（showSaveDialogがfalseである場合のみ適用されます）。
• filename
  • ダウンロードするファイルのファイル名を変更します（自動でファイル名のスペースを取り除きます。.txt や .pdf などの拡張子を付けるのを忘れないようにしてください！）。
• progress
  • falseに設定すると、プログレスバーが無効になります。
• returns
  • 返したいファイルパスのタイプを指定します（fmpath、filepath）

注意：filenameなどの名前のついたパラメータを指定すると、保存先フォルダ、幅、高さが必要になります。これらのパラメータは並び順に依存するためです。例を以下に示します。

SCDownload ( "Photos/Original/" & Photos::Photo ID ;  // Folder Path
Get( DesktopPath ) & "MyPhotos/" ; // Destination folder
0 ; 0 ; //width & height parameters
"filename=" & $fileName ; "returns=filepath" )

重要：この関数をコールする前に、SCSetBaseURL をコールしてSuperContainerサーバーの場所を設定する必要があります。

パラメータ

• フォルダパス
  • 一意のSuperContainerのパス。
• ユーザが定義した保存先パス
  • ファイルのダウンロード先となるフォルダのURLまたはFileMakerのパス（オプション）（例：/Macintosh HD/Users/Shared/Images）。
• 幅
  • イメージの幅を表す整数値（オプション）。幅／高さが指定されている場合、イメージ以外のリソースはファイル全体ではなくファイル名だけがダウンロードされます。
• 高さ
  • イメージの高さを表す整数値（オプション）。幅／高さが指定されている場合、イメージ以外のリソースはファイル全体ではなくファイル名だけがダウンロードされます。
• フラグ
  • キーと値のペア - キー = 値のペア（オプション）。オプション：elfSignedSSL、returns、filename。例えば、selfSignedSSL=1。

戻り値

ファイルのダウンロード先のURL。ファイルが存在しない場合や何らかのエラーが発生した場合は、"ERROR"が返されます。

SuperContainerのファイルのコンテンツを、オブジェクトデータとして取得します。この関数は、SuperContainerのファイルのコンテンツを、FileMakerのオブジェクトフィールドに書き出すために使用することを意図しています。FileMakerのデータベース中でイメージやその他のファイルを表示したい場合は、この関数を使用するのではなく、レイアウトオブジェクトのWebビューアを用いてSuperContainerを直接参照します。

指定したフォルダパスにファイルが存在しない場合は、空の結果を返します。

重要：この関数をコールする前に、SCSetBaseURLをコールしてSuperContainerサーバーの場所を設定する必要があります。

パラメータ

• フォルダパス
  • SuperContainerのファイルを一意に特定するパス。
• 幅
  • 幅のパラメータ（オプション）。SuperContainerのファイルがイメージである場合、ここで指定した幅にサイズ変更されます。幅を制限しない場合は0を渡します。
• 高さ
  • 高さのパラメータ（オプション）。SuperContainerのファイルがイメージである場合、ここで指定した高さにサイズ変更されます。高さを制限しない場合は0を渡します。
• 解像度
  • 解像度のパラメータ（オプション）。SuperContainerのファイルがイメージである場合、そのファイルのJPEGのプレビューが指定した解像度でレンダリングされます。指定しない場合、デフォルトの解像度である72dpiが使用されます。

戻り値

正しく処理された場合は、オブジェクトデータ。指定したパスにファイルが存在しない場合は、戻り値はなし。エラーが発生した場合は、"ERROR"。

保管されたファイルのフォルダの場所を、マウントされた／マップされたファイルサーバーを指定するURLとして取得します。SuperContainerサーバーからは何もダウンロードしないことに注意してください。この関数は、SuperContainerサーバー上に直接保管されているフォルダを指すURLを返します。この関数は、FileMakerの「Open URL（URLを開く）」スクリプトステップと組み合わせて、保管されているリソースをブラウズするのに便利です。

重要：この関数をコールする前に、SCSetBaseURL をコールしてSuperContainerサーバーの場所を設定する必要があります。

注意：参照するフォルダを開くには、アクセス可能なファイルシステムの保管場所がマウントされている、またはマップされていることが必要です。マウントまたはマップされていない場合、SCGetContainer を使ってファイルをローカルのハードディスクにダウンロードし、そのファイルを開く必要があります。

パラメータ

• Macのパス
  • SuperContainerの保管場所をルートとするOS Xのパス。
• Windowsのパス
  • SuperContainerの保管場所をルートとするWindowsのパス。
• フォルダパス
  • SuperContainerのファイルのフォルダを一意に特定するパス。

ファイル名、サイズ、高さ、幅、大きさ、アップロードされた日付といった、SuperContainerのファイルに関するメタ情報を返します。

結果は、改行で区切られた3個以上の値です。

• ファイル名
• ファイルのサイズ（単位はバイト）
• ファイルがSuperContainerにアップロードされた日時

この関数に追加の引数を渡すことで、さらに別のメタデータを指定して取得できます。詳しくは後述する「追加のフィールド」を参照してください。

MD5ハッシュ

追加の引数として"md5"を渡すと、この関数の結果の中にファイルのMD5ハッシュが返されます。これはデジタルファイルのフィンガープリント（指紋）の役割を果たすもので、ファイルが複製されたかどうかを把握したりファイルの整合性を確認したりするために使用できます。例を以下に示します。

SCGetInfo("/photos/12345" ; "md5"; "width"; "height")

この式は、以下のような結果を返します。

Lucy.jpg
51231
4/8/08 3:02:56 PM
c7f47955c825ed83dfe2a6a2fac1a092
640
480

（4行目がMD5ハッシュです）

指定したフォルダパスにファイルが存在しない場合は、空の結果を返します。

重要：この関数をコールする前に、SCSetBaseURL をコールしてSuperContainerサーバーの場所を設定する必要があります。

パラメータ

• フォルダパス
  • SuperContainerのファイルを一意に特定するパス。
• 追加のフィールド
  • md5、height、width、dimension、pagecountから選択。

戻り値

リクエストされたデータ。ファイルが存在しない場合は、戻り値はなし。エラーが発生した場合は、"ERROR" 。

プラグイン関数のエラーが発生するたびに、"ERROR"の文字列を返します。直近のエラーを発生させたのは何かを認識できる形で取得するには、この関数をコールします。以下に使い方の例を示します。

If [ SCSetContainer( Asset::ID ; theContainer ) = "ERROR" ]
Show Custom Dialog ["Could not store this file"; SCLastError]
End If

戻り値

エラーメッセージ

SuperContainerサーバー上でファイルを移動します。ダウンロードはしません。FileMakerで何らかの理由でフォルダパスを変更し、関連するSuperContainerのファイルを移動させたい場合に便利です。

旧フォルダパスにファイルが存在しない場合、この関数はエラーを返します。

重要：この関数をコールする前に、SCSetBaseURL をコールしてSuperContainerサーバーの場所を設定する必要があります。

ローカルのファイルシステム上でファイルを移動するには、SCMoveLocalFile関数を使用します。

# 移動する
Set Variable [$result; Value:SCMove( Get( LayoutTableName ) & "/" & ID ; Get( LayoutTableName ) & "/" & DestID; "filename=New Word Document.docx")]
# 移動中のエラーをチェックする
If [$result = "ERROR"
Show Custom Dialog ["Could not move file"; SCLastError]
End If
# Webビューアを更新して新しいファイルを表示する
Set Web Viewer [Object Name: "webviewer"; Action: Reload] 

パラメータ

• 旧フォルダパス
  • 移動したいファイルの、元のフォルダパス。
• 新フォルダパス
  • ファイルを移動する先のフォルダパス。
• キーと値のペア
  • キー = 値のペア（オプション）。オプション：filename。例えば、filename=myNewName.txt。

戻り値

正しく移動された場合は、1。エラーが発生した場合は、"ERROR"。

ファイルを、ソースファイルから移動先ファイルへローカルで移動します。SuperContainerサーバーとまったく通信しない便利な関数です。SCSetContainer関数でファイルをSuperContainerにアップロードした後に、作業していたディレクトリからファイルをこの関数で移動できます。

SuperContainerサーバー上でファイルを移動するには、SCMove関数を使用します。

パラメータ

• ソースファイル
  • 移動されるファイルまたはディレクトリ。
• 移動先ファイル
  • ソースファイルが移動する先のファイルまたはディレクトリ。

参考： SCScanDirectory、SCMove

戻り値

正しく移動された場合は、FMType 1。ファイルを移動できなかった場合は"ERROR"。

ローカルのディレクトリをスキャンしてファイルを調べます。この関数を使ってディレクトリ中の全ファイルのリストを取得し、FileMakerでリストを反復して、SCSetContainer関数を用いてSuperContainerのインスタンスに複数のファイルを追加することができます。

パラメータ

パススキャンするディレクトリへのパス。再帰サブディレクトリに再帰するか、またはトップレベルのディレクトリ中のファイルのみを返すか。

参考： SCMoveLocalFile

戻り値

指定したディレクトリ下にある、ディレクトリを除くすべてのファイルのリスト。エラーが発生した場合は、"ERROR"。

プラグインが使用するSuperContainerサーバーのインスタンスの場所を設定します。SuperContainerサーバーにアクセスするすべてのプラグイン関数をコールする前に、この関数をコールする必要があります！　コンピュータ上でスタンドアローンのSuperContainerサーバーを使用している場合は、ホスト名としてlocalhostを使用できます。

SCSetBaseURL("http://localhost:8020/SuperContainer/Files")

ライブデプロイメントに使用する際には、SuperContainerの共有インスタンスを動作させるコンピュータのIPアドレスの実ホスト名を指定する必要があります。例を以下に示します。

SCSetBaseURL("http://server.mycompany.com:8020/SuperContainer/Files")

有効なURLを指定していても指定したホストに動作中のSuperContainerサーバーが存在しない場合、ベースURLは設定されますが、"ERROR"のエラーコードが返されます（詳しいエラーメッセージを取得するにはSCLastErrorを使用します）。

スタンドアローンのSuperContainerサーバーのデフォルトのポート番号は8020番であり、FileMaker Serverで展開している場合には80番であることに留意してください。

一般的には、この関数はFileMakerデータベースのスタートアップスクリプトでコールします。この関数は、FileMakerを起動するたびに、またはベースURLを変更するときに、一度だけコールする必要があります。

注意： selfSignedSSLなどの名前のついたパラメータを指定すると、ユーザ名とパスワードのフィールドが必要になります。これらのパラメータは並び順に依存するためです。ユーザ名／パスワードが使用されていない場合は、代わりに空のダブルクオーテーション（""）を挿入します。例を以下に示します。

SCSetBaseURL("http://localhost:8020/SuperContainer/Files" ; "" ; "" ; "selfSignedSSL=1")

パラメータ

• SuperContainerのURL
  • プラグインが使用するSuperContainerのインスタンスのURL。例えば、http://fmpro.example.com:8020/SuperContainer/Files 。
• ユーザ名
  • ユーザ名（オプション）。SuperContainerサーバーがパスワードで保護されている場合、ここでユーザ名を入れます。
• パスワード
  • パスワード（オプション）。SuperContainerサーバーがパスワードで保護されている場合、ここでパスワードを入れます。
• キーと値のペア
  • キー = 値のペア（オプション）。オプション：selfSignedSSL。たとえば、example selfSignedSSL=1。

戻り値

正しく処理された場合は、1。（空、または無効なURLのために）エラーが発生した場合は、"ERROR"。

FileMakerのオブジェクトフィールドからデータをSuperContainerのファイルにプッシュします。SuperContainerのファイルがすでに存在する場合は、上書きします。

注意：データのパラメータが空の場合、この関数はSuperContainerのファイルを削除しません。この関数ではなく、SCDelete関数を使用してください。

重要：この関数をコールする前に、SCSetBaseURLをコールしてSuperContainerサーバーの場所を設定する必要があります。

レイアウト上のWebビューアを更新して新たにアップロードされたファイルを表示したい場合は、アップロードのスクリプトに「Set Web Viewer [Action: Reload]（Webビューアの設定[処理: 再読み込み]）」スクリプトステップを追加します。このステップが、即座に更新するトリガーとなります。

オプションのパラメータ

SCSetContainer関数に、以下のパラメータを追加で渡すことができます。

• filename
  • filename=desired_name で、ファイルに対し目的のファイル名を指定します。
• showProgress
  • showProgress=false を使うと、アップロード中のプログレスバーが表示されなくなります。

例を以下に示します。

Set Variable[$result =
        SCSetContainer(
                "Documents/D23" ;
                Documents::Legacy Container ;
                "filename=newName.txt" ;
                "selfSignedSSL=1" ;
    )
]
# アップロードする
Set Variable [$result; Value:SCSetContainer( Get( LayoutTableName ) & "/" & ID ; SCChooseFile)]
# アップロード中のエラーをチェックする
If [$result = "ERROR"
Show Custom Dialog ["Could not upload file"; SCLastError]
End If
# Webビューアを更新して新しいファイルを表示する
Set Web Viewer [Object Name: "webviewer"; Action: Reload]

パラメータ

• フォルダパス
  • SuperContainerのファイルを一意に特定するパス。
• データ
  • 保管されているデータで、通常はオブジェクトフィールド。URL（例：http://server/someFile 、または file:///Users/Shared/aFile ）も、ファイルのパス（例：/Macintosh HD/Users/Shared/aFile、またはC:¥Documents and Settings¥aFile）も使用できます。
• パラメータ
  • オプションで追加するパラメータ（filename）。

戻り値

正しく処理された場合は、1。エラーが発生した場合は、"ERROR"。

SuperContainer Companion Pluginのバージョン番号を返します。

戻り値

バージョン番号。例：1.32。