FAMLog

FileMakerクエリー文字列でクエリーコマンドおよび引数を使用する場合には、いくつか注意すべき点があります。

まず重要な点として、FileMakerクエリー文字列に含めるクエリーコマンドは、1つだけにする必要があります。クエリーコマンドを指定しなかったり、2種類以上のクエリーコマンドを指定すると、データベースに接続できず正常に処理されません。

XSLTスタイルシート内の<?xslt-cwp-query?>処理命令でクエリーコマンドを指定しなかった場合には、Webブラウザーでアクセスするときに、URLのクエリー文字列でクエリーコマンドを指定する必要があります。

エラー処理対策およびセキュリティ上の観点からすると、<?xslt-cwp-query?>処理命令でクエリーコマンドを指定することが推奨されるでしょう。

FileMaker Server 7 Advancedでは、「-password」や「-format」、「-fmtfield」、エラー処理関連およびメール送信関連の変数タグが引数名としてサポートされなくなりました。

-passwordは、-dbopenにデータベースのパスワードを指定するために使用されていました。

-formatは、CDMLフォーマットファイルまたはXML文法を指定するために使用されていました。バージョン7ではCDMLがサポートされなくなり、XSLTスタイルシートを使用するようにWeb公開の方法が変わったことにより、-format変数タグは使用する必要がなくなっています。

-fmtfieldは、データベース内のフィールドからフォーマットファイルの情報を取得するために使用されていました。

FileMaker Server 7 Advancedでは、「-dbopen」、「-dbclose」および「-img」がリクエスト名としてサポートされなくなりました。

-dbopenおよび-dbcloseは、リモート管理機能が有効で、「Web」フォルダにあるデータベースを開くあるいは閉じるために使用されていました。

-imgは、指定されたイメージを取得するために使用されていましたが、バージョン7では代わりにオブジェクトを取得するURL構文を使用します。

FileMaker Server Web公開エンジンを使用してFileMakerのデータにアクセスする場合に、クエリー文字列で使用できるクエリーコマンドの一覧は下記の通りです。

-dbnames
-delete
-dup
-edit
-find
-findall
-findany
-layoutnames
-new
-process
-scriptnames
-view

-dbnames、-layoutnamesおよび-scriptnames以外のすべてのクエリーコマンドで、レイアウトを指定するための-layクエリー引数が必須になっています。

また、-dbopen、-dbcloseおよび-imgといったリクエスト名はバージョン7では廃止され、サポートされなくなりました。

FileMaker Server 7 Advancedにおいて、オブジェクトフィールドで実際のオブジェクトがデータベース内に保存されている場合、オブジェクトデータにアクセスするためのURL構文は次のようになります。

（XMLを使用したカスタムWeb公開の場合）
<スキーム>://<ホスト>[:<ポート>]/fmi/xml/cnt/data.<拡張子>?<クエリー文字列>
（例）http://www.example.com/fmi/xml/cnt/data.jpg?-db=dbname&-lay=layoutname&-field=fieldname(1)&-recid=1

（XSLTを使用したカスタムWeb公開の場合）
<スキーム>://<ホスト>[:<ポート>]/fmi/xsl/cnt/data.<拡張子>?<クエリー文字列>
（例）http://www.example.com/fmi/xsl/cnt/data.jpg?-db=dbname&-lay=layoutname&-field=fieldname(1)&-recid=1

<拡張子>には、「jpg」や「mov」など、オブジェクトのタイプを識別するファイル拡張子を指定します。

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 XSLTスタイルシートをWeb公開エンジンで使用するためのURL構文は次のようになります。

<スキーム>://<ホスト>[:<ポート>]/fmi/xsl/[<パス>/]<スタイルシート.xsl>[?<クエリー文字列>]
（例）http://www.example.com/fmi/xsl/foldername/example.xsl?-grammar=fmresultset&-db=dbname&-lay=layoutname&-encoding=UTF-8&-findall

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

・<スキーム>には、HTTPまたはHTTPSプロトコルを指定します。
・<ホスト>には、WebサーバーがインストールされているホストのIPアドレスまたは完全修飾ドメイン名を指定します。
・<ポート>には、Webサーバーが使用するTCPのポート番号を指定します（オプション）。ポートが指定されていない場合は、プロトコルのデフォルトのポート（HTTPではポート80、HTTPSではポート443）が使用されます。
・<パス>はオプションで、XSLTスタイルシートが保存されている「xslt-template-files」フォルダ内のフォルダ名を指定します。
・<スタイルシート.xsl>には、XSLTスタイルシートのファイル名を指定します。
・<クエリー文字列>には、XSLTを使用したカスタムWeb公開で使用する1つのクエリーコマンドと1つまたは複数のクエリー引数の組み合わせを指定することができます。

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

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

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

FileMaker Server 7 Advancedには「FileMaker CDML Converter」というツールも含まれています。

CDML Converterは、既存のCDMLフォーマットファイルをWeb公開エンジンと互換性があるXSLTスタイルシートに変換する場合に使用します。

変換作業にあたっては、CDMLフォーマットファイルが入っている変換元のフォルダ、および生成するXSLTスタイルシートファイルを入れる変換先のフォルダを選択し、ファイルのテキストエンコードを指定します。

意図通りに動作させるためには、変換後のXSLTスタイルシートファイルをさらに編集する必要があるでしょう。

FileMaker Server Web公開エンジンは、「Web公開コア」と「カスタムWeb公開エンジン」から構成されます。

Web公開コアは、WebサーバーおよびFileMaker Serverと通信し、ホストされたデータベースのインスタントWeb公開用のページを生成することができます。また、適切なクエリーコマンドと引数を指定したHTTPリクエストに基づいて、FileMakerデータベースからXMLデータを生成することもできます。

なお、Web公開エンジンからXMLドキュメントを取得するための、クエリーコマンドと引数を指定したHTTPリクエストは、FileMaker Server 7 Advancedでは「XMLリクエスト」と呼ばれています。