FAMLog

「FileMaker Server カスタムWebテクニック」目次

第1章　イントロダクション
・1.1　FileMakerの特色
・1.2　FileMaker 7の製品ライン
・1.3　FileMakerのWeb公開機能の歴史
・1.4　カスタムWeb公開機能の主な変更点
・1.5　FileMaker Server 7 Advancedの新機能
・1.6　FileMaker Server 7 AdvancedのWeb公開機能
・1.7　Web公開に使用するソフトウェア
・1.8　FileMaker Server 7 AdvancedのWeb公開の仕組み

第2章　データの取得と処理
・2.1　Web公開エンジンの情報の取得
・2.2　データベース情報の取得
・2.3　データベース処理の実行
・2.4　オブジェクトデータの表示
・2.5　クライアント情報の取得

第3章　出力結果の調整
・3.1　出力方法の指定と調整
・3.2　文字列の加工と操作
・3.3　数値演算
・3.4　条件分岐
・3.5　日付と時刻の処理
・3.6　エラー処理

第4章　Web公開エンジンが備える機能の活用
・4.1　メールの送信
・4.2　Cookieの利用
・4.3　セッション拡張関数
・4.4　ヘッダー関数の活用
・4.5　ログの利用
・4.6　その他のテクニック

第5章　セキュリティ
・5.1　FileMaker Server 7 Advancedのセキュリティ機能
・5.2　Webアプリケーション開発における注意点

第6章　XSLT機能の拡張
・6.1　Javaによる機能拡張
・6.2　JavaScriptによる機能拡張

付録A　FileMaker Server 7 Advancedをインストールする前の準備
・A.1　FileMaker Server Advancedの製品概要
・A.2　インストール前の確認事項

付録B　FileMaker Server Advancedのインストールと設定
・B.1　FileMaker Serverのインストール
・B.2　FileMaker Serverのライセンスキーを確認
・B.3　FileMaker Serverのバージョンを確認
・B.4　FileMaker Serverのアップデート
・B.5　FileMaker Serverの設定を変更
・B.6　Web公開エンジンおよび管理コンソールのインストール
・B.7　FileMaker Server ID（識別子）とパスコードの設定
・B.8　Web公開エンジンの設定

付録C　データベース公開のための設定
・C.1　拡張アクセス権の設定
・C.2　ファイルを所定のフォルダに配置
・C.3　FileMaker Server Adminでファイルを開く

（2006/12/07追記：リンク先のURLを変更しました。）

FileMaker Server 7の評価版からアップグレードする場合や、FileMaker Server 7からFileMaker Server 7 Advancedにアップグレードする場合には、FileMaker Serverのライセンスキーを更新する必要があります。

FileMaker Server 7のライセンスを更新するには、FileMaker Server Adminを使用します。FileMaker Server Adminで更新対象のFileMaker Serverに接続し、FileMaker Serverのライセンス更新画面においてユーザー名やライセンスキーなどの必要な情報を入力して、ライセンスの更新ボタンを押します。

FileMaker Server Adminでサーバーの概要も確認できますが、「FileMaker Web 公開エンジン」の値が「許可されています」になっているとFileMaker Server Advancedのライセンスに更新されたことが確認できます。

FileMaker Pro 7の関数である「Get(アプリケーションバージョン)関数」は、FileMakerのアプリケーションの種類およびバージョン情報を示す文字列を返します。

各アプリケーションに対して返される値は、次の通りです。

・FileMaker Pro：「Pro」
・FileMaker Developer：「Developer」
・FileMaker Runtime：「Runtime」
・Web公開エンジンやWebブラウザーなど：「Web Publishing Engine」

Web公開機能経由で、Webブラウザーがこの関数を利用した場合には、「Web Publishing Engine 7.0v5」という形式で値が返されます。

（2016/01/26追記：リンク先のページがなくなっていたので、リンクを削除しました。）

defaultsコマンドを使用して、FileMaker Server 7の使用状況ログの最大サイズ設定を変更するには、ターミナルで次のように入力します。

（Mac OS X v10.4.1の場合）
sudo su - fmserver -c 'defaults -currentHost write "/Library/FileMaker Server 7/Library/Preferences/com.filemaker.fmserver" Preferences -dict-add MaxStatsLogSize -int 40'

使用状況ログの最大サイズとして設定できる値は1から40までの整数であるため、使用状況ログ（Stats.log）は最大40MBのサイズまで1つのファイルで保存できます。

（2015/09/02追記：OS X版のFileMaker Server 14では設定ファイルの形式およびパスが変更されたため、上記の方法は利用できません。）

FileMaker Server 7 Advancedにおいて、XMLデータおよびオブジェクトにアクセスするためのURLは、非ASCII文字列についてはURLエンコードされたUTF-8形式の文字列を利用する必要があります。

例えば、「data」フィールドの値を「XMLデータ」に設定する場合には、下記のようなURLを使用します。

（例）http://www.example.com/fmi/xml/fmresultset.xml?-db=dbname&-lay=layoutname&data=XML%E3%83%87%E3%83%BC%E3%82%BF&-recid=2&-edit

FileMaker Server 7 Advancedにおいて、-findクエリーコマンドを使用した場合には、フィールドの値の大文字と小文字は区別されません。一方、-newおよび-editクエリーコマンドを利用する場合には、フィールドの値に使用した大文字と小文字は保持され、クエリー文字列で指定した通りにデータベースに保存されます。

例えば、検索処理を行うように指定されたクエリー文字列内において、下記のように「Product=FileMaker」と指定しても、「Product=filemaker」と指定しても、両者の検索結果に違いはありません。

http://www.example.com/fmi/xml/fmresultset.xml?-db=dbname&-lay=layoutname&Product=FileMaker&-find
http://www.example.com/fmi/xml/fmresultset.xml?-db=dbname&-lay=layoutname&Product=filemaker&-find

逆に、-newや-editクエリーコマンドの場合には、前者はFileMakerと、後者はfilemakerと登録もしくは修正され、大文字小文字は保持されます。

Web公開エンジンを使用してFileMakerデータベースのXMLデータにアクセスするためのURL構文は次のようになります。

<スキーム>://<ホスト>[:<ポート>]/fmi/xml/<XML文法>.xml[?<クエリー文字列>]
（例）http://www.example.com/fmi/xml/fmresultset.xml?-db=dbname&-lay=layoutname&-findall

各要素の意味は、下記の通りです。

・<スキーム>には、HTTPまたはHTTPSプロトコルを指定します。
・<ホスト>には、WebサーバーがインストールされているホストのIPアドレスまたは完全修飾ドメイン名を指定します。
・<ポート>には、Webサーバーが使用するTCPのポート番号を指定します（オプション）。ポートが指定されていない場合は、プロトコルのデフォルトのポート（HTTPではポート80、HTTPSではポート443）が使用されます。
・<XML文法>には、FileMaker XML文法の名前を指定します。指定できる値は、fmresultset、FMPXMLRESULT、FMPXMLLAYOUTまたはFMPDSORESULTです。
・<クエリー文字列>には、XMLを使用したカスタムWeb公開で使用する1つのクエリーコマンドと1つまたは複数のクエリー引数の組み合わせを指定することができます。

FileMaker Server 7 AdvancedのWeb公開エンジンでデータベースセッションオプションを有効にした場合と無効にした場合では、それぞれ長所と短所があります。

データベースセッションを有効にすると、グローバルフィールドの値およびスクリプトによって変更された状態がリクエスト間で維持されますが、Webセッションの数がFileMaker Server上の同時データベースセッションの最大数（100）に制限されるという短所があります。

逆に、データベースセッションを無効にすると、グローバルフィールドの値や状態がリクエスト間で維持されませんが、Webセッションの数がデータベースセッションの最大数に制限されなくなります。この場合、Webセッションの最大数は、Web公開エンジンのホストコンピュータに搭載されているメモリサイズによってのみ制限されます。

グローバルフィールドの値や状態をリクエスト間で維持する必要が特にない場合には、データベースセッションオプションを有効にする必要はありません。

FileMaker Server 7 AdvancedのXSLTを使用したカスタムWeb公開で「データベースセッション」オプションを有効にした場合、リクエスト間でグローバルフィールドの値を保持することができます。また、スクリプトで状態を変更した場合、リクエスト間で変更後の状態が維持されます。

セッションを使用するXSLTスタイルシートによって実行されるリクエストでは、スタイルシートで定義されたセッションの期間中、または他のリクエストで変更されるまで、グローバルフィールドの値が保持されます。また、リクエスト間で状態も維持されますが、例えば、「再ログイン」スクリプトステップによってアカウントを切り替えた場合、変更されたアクセス権がリクエスト間で維持されます。

データベースセッションオプション設定は最初は無効になっています。リクエスト間でグローバルフィールドの値やアカウントの状態を維持したい場合は、管理コンソールを使用して、Web公開エンジンのデータベースセッションオプションを有効にする必要があります。

（2006/03/24追記：「XSLTスタイルシートでグローバルフィールドを使用する場合やリクエスト間で状態を維持したい場合」を「リクエスト間でグローバルフィールドの値やアカウントの状態を維持したい場合」に修正しました。）

FileMaker Server 7 AdvancedのカスタムWeb公開では、多くの重要な新機能が提供されています。

その1つに、FileMaker XSLTスタイルシートにおいて、XMLデータの要求時に使用するクエリーコマンド、引数および値を静的に定義しておくことで、クエリーコマンドとクエリー引数の不正使用を防止できるようになったことが挙げられます。

クエリーコマンドと引数をXSLTスタイルシートに静的に定義した場合、それらはURLクエリー文字列で指定されたクエリーコマンドや引数よりも優先されるため、セキュリティを高める効果的な方法の1つとなります。また、URLクエリー文字列を短くできるという利点もあります。