動的コンテンツのソースの定義

基本のレコードセットダイアログボックスが表示されます。 ColdFusion サイトを開発している場合は、レコードセットダイアログボックスが少し異なります。 （代わりに詳細レコードセットダイアログが表示される場合は、「シンプル」ボタンをクリックして、シンプルレコードセットダイアログボックスに切り替えます。）

手順については、以下のトピックを参照してください。

ユーザーが入力したパラメータを使用するフィルターを定義した場合は、 テスト値ボックスに値を入力してOKをクリックします。レコードセットの インスタンスが正常に作成されると、レコードセットから抽出されたデータを表示するテーブルが表示されます。

名前ボックスに、 レコードセットの名前を入力します。

一般的な方法として、レコードセット名に接頭辞rsを追加して、 コード内の他のオブジェクト名と区別します。例：rsPressReleases。

レコードセット名には、英字、数字、アンダースコア文字（_）のみ含めることができます。特殊文字またはスペースは使用できません。

接続ポップアップメニューから接続を選択します。

リストに接続が表示されない場合は、「定義」をクリックして接続を作成します。

テーブルポップアップメニューで、 レコードセットにデータを提供するデータベーステーブルを選択します。

ポップアップメニューには、 指定されたデータベース内のすべてのテーブルが表示されます。

レコードセットにテーブルの列のサブセットを含めるには、 「選択済み」をクリックし、リスト内で目的の列をCtrlキーを押しながらクリック （Windows）またはCommandキーを押しながらクリック（Macintosh）して選択します。

テーブルから返されるレコードをさらに制限するには、フィルターセクションを設定します。

• 最初のポップアップメニューから、定義するテスト値と 比較するデータベーステーブル内の列を選択します。

• 2番目のポップアップメニューから、各レコード内の選択した値を テスト値と比較する条件式を選択します。

• 3 つ目のポップアップメニューで「入力値」を選択します。

• ボックスにテスト値を入力します。

  レコード内の指定された 値がフィルタリング条件を満たす場合、そのレコードは レコードセットに含まれます。

（オプション）レコードをソートするには、ソート基準となる列を選択し、 レコードを昇順（1、2、3...またはA、B、C...）でソートするかどうかを指定します。または降順。

「テスト」をクリックしてデータベースに接続し、データソースのインスタンスを作成してから、「OK」をクリックしてデータソースを閉じます。

返されたデータを表示するテーブルが表示されます。各行にはレコードが含まれ、各列はそのレコードのフィールドを表します。

「OK」をクリックします。 新しく定義されたレコードセットが「バインディング」パネルに表示されます。

「名前」ボックスに、レコードセットの名前を入力します。

一般的な手法は、レコードセット名に接頭辞 rs を追加して、コード内の他のオブジェクト名と区別することです。例：rsPressReleases

レコードセット名には、文字、数字、アンダースコア文字（_）のみを使用できます。特殊文字またはスペースは使用できません。

ColdFusion コンポーネントのレコードセットを定義している場合（つまり、CFC ファイルが現在 Dreamweaver で開いている場合）、「機能」ポップアップメニューから既存の CFC 機能を選択するか、「新しい機能」ボタンをクリックして新しい機能を作成します。

レコードセットは関数で定義されます。

データソースポップアップメニューでデータソースを選択します。

ポップアップメニューにデータソースが表示されない場合は、ColdFusionデータソースを作成する必要があります。

「ユーザー名」ボックスと「パスワード」ボックスに、必要に応じて ColdFusion アプリケーションサーバーのユーザー名とパスワードを入力します。

ColdFusion のデータソースにアクセスするには、ユーザー名とパスワードが必要な場合があります。ColdFusion でデータソースにアクセスするためのユーザー名とパスワードがない場合は、組織の ColdFusion 管理者に連絡してください。

「テーブル」ポップアップメニューで、レコードセットにデータを提供するデータベーステーブルを選択します。

「テーブル」ポップアップメニューには、指定されたデータベース内のすべてのテーブルが表示されます。

レコードセットにテーブルの列のサブセットを含めるには、「選択済み」をクリックし、リスト内で Ctrl キーを押しながらクリック（Windows）または Command キーを押しながらクリック（Macintosh）して目的の列を選択します。

テーブルから返されるレコードをさらに制限するには、フィルターセクションを設定してください。

• 最初のポップアップメニューから、定義するテスト値と比較するデータベーステーブルの列を選択します。

• 2 番目のポップアップメニューから、各レコードの選択された値をテスト値と比較する条件式を選択します。

• 3 つ目のポップアップメニューで「入力値」を選択します。

• ボックスにテスト値を入力します。

  レコード内の指定された値がフィルタリング条件を満たす場合、そのレコードはレコードセットに含まれます。

（オプション）レコードをソートするには、ソートする列を選択し、レコードを昇順（1、2、3...）でソートするかどうかを指定します。または A、B、C...）または降順。

「テスト」をクリックしてデータベースに接続し、データソースのインスタンスを作成します。

返されたデータを表示するテーブルが表示されます。各行にはレコードが含まれ、各列はそのレコード内のフィールドを表します。「OK」をクリックしてテストレコードセットを閉じます。

「OK」をクリックします。 新しく定義された ColdFusion レコードセットが「バインディング」パネルに表示されます。

詳細設定のレコードセットダイアログボックスが表示されます。 ColdFusion サイトを開発している場合、レコードセットダイアログボックスは若干異なります。(シンプルなレコードセットダイアログボックスが代わりに表示される場合は、「詳細設定」ボタンをクリックして詳細なレコードセットダイアログボックスに切り替えてください。)

手順については、以下のトピックを参照してください。

ユーザーが入力するパラメーターを使用するフィルターを定義した場合、「テスト」ボタンをクリックすると「テスト値」ダイアログボックスが表示されます。「テスト値」ボックスに値を入力し、「OK」をクリックします。レコードセットのインスタンスが正常に作成されると、レコードセットからのデータを表示するテーブルが表示されます。

一般的な方法は、コード内の他のオブジェクト名と区別するために、レコードセット名に接頭辞rsを追加することです。例：rsPressRelease

レコードセット名には、文字、数字、アンダースコア文字（_）のみを含めることができます。特殊文字やスペースは使用できません。

データベース項目ツリーを使用してSQL文を作成するには、次の操作を行います：

• SQL テキスト領域が空白であることを確認します。

• 必要なデータベースオブジェクト（例えば、テーブル内の列やデータベース内のストアドプロシージャなど）が見つかるまで、ツリーの分岐を展開します。

• データベースオブジェクトを選択し、ツリーの右側にあるボタンのいずれかをクリックします。

  例えば、テーブル列を選択した場合、使用可能なボタンは SELECT、WHERE、ORDER BY です。ボタンのいずれかをクリックして、関連する句を SQL 文に追加します。

  データベースアイテムツリーからストアドプロシージャを選択して「プロシージャ」ボタンをクリックすることで、ストアドプロシージャ内の定義済み SQL 文を使用することもできます。Dreamweaver が自動的に SQL と変数の領域を入力します。

SQL 文に変数が含まれている場合は、変数ボックスのデフォルト値列に有効なテスト値が含まれていることを確認してください。

実行時値は通常、HTML フォームフィールドでユーザーが入力する URL またはフォームパラメーターです。

実行時値列の URL パラメーター：

「ランタイム値」列のフォームパラメーター：

SQL 文に変数が含まれている場合は、「テスト」をクリックする前に、変数ボックスのデフォルト値列に有効なテスト値が含まれていることを確認してください。

成功すると、レコードセットのデータを表示するテーブルが表示されます。各行にはレコードが含まれ、各列はそのレコード内のフィールドを表します。「OK」をクリックしてレコードセットをクリアします。

一般的な方法として、レコードセット名にプレフィックス rs を追加して、コード内の他のオブジェクト名と区別します。例：rsPressReleases

レコードセット名には、文字、数字、およびアンダースコア文字（_）のみを使用できます。特殊文字またはスペースは使用できません。

ColdFusion コンポーネントのレコードセットを定義している場合（つまり、CFC ファイルが現在 Dreamweaver で開かれている場合）、機能ポップアップメニューから既存の CFC 機能を選択するか、「新しい機能」ボタンをクリックして新しい機能を作成します。

レコードセットは関数内で定義されます。

ポップアップメニューリストにデータソースが表示されない場合は、まず ColdFusion データソースを作成する必要があります。

ColdFusion のデータソースにアクセスするには、ユーザー名と パスワードが必要な場合があります。ColdFusion のデータソースにアクセスするためのユーザー名とパスワードがない場合は、組織の ColdFusion 管理者に連絡してください。

• SQL テキスト領域が空白であることを確認します。

• 必要なデータベースオブジェクト（例：テーブル内の列）が見つかるまで ツリーのブランチを展開します。

• データベースオブジェクトを選択し、ツリーの右側にある ボタンのいずれかをクリックします。

例えば、テーブル列を選択した場合、使用可能な ボタンは「選択」、「Where」、「Order By」です。ボタンのいずれかをクリックして、関連する句をSQL文に追加します。

SQL 文にパラメーターが含まれている場合は、プラス（+）ボタンをクリックして パラメーターの名前とデフォルト値（実行時の値が返されない場合にパラメーターが取るべき値）を入力し、パラメーターエリアでその値を定義します。

SQL 文にパラメーターが含まれている場合は、パラメーターボックスのデフォルト値列に有効なテスト値が含まれていることを確認してください。

ページパラメーターを使用すると、 作成する SQL の実行時値参照にデフォルト値を提供できます。例えば、次の SQL 文は 従業員 ID の値に基づいて従業員レコードを選択します。このパラメーターにデフォルト値を割り当てることで、実行時値が常に返されることを保証できます。この例では、FormFieldName は、ユーザーが従業員 ID を入力するフォームフィールドを指します。

SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))

ページパラメーター追加ダイアログボックスには、 次のような名前と値のペアが含まれます：

実行時値は通常、HTML フォームフィールドでユーザーが入力する URL または フォームパラメーターです。

SQL 文に実行時参照が含まれている場合は、「テスト」をクリックする前に 、ページパラメーターフィールドのデフォルト値列に有効なテスト値が含まれていることを確認してください。

成功すると、レコードセット内のデータを表示する テーブルが表示されます。各行にはレコードが含まれ、各列はそのレコード内のフィールドを表します。「OK」をクリックして レコードセットをクリアします。

• emplNo を選択し、 「選択」ボタンをクリックします。

• emplName を選択し、 「選択」ボタンをクリックします。

• emplJob を選択し、「Where」 ボタンをクリックします。

• emplName を選択し、「Order By」ボタンをクリックします。

URL 変数名は通常、その値を取得するために使用される HTML フォームフィールドまたはオブジェクトの名前です。

フォームパラメーターがバインディングパネルに表示されます。

例えば、この ColdFusion の例では、username というセッションをインスタンス化し、Cornelius という値を割り当てます：

<CFSET session.username = Cornelius>

アプリケーション変数は、バインディングパネルのアプリケーションアイコンの下に表示されます。

データソース名変数ダイアログボックスが表示されます。

レコードセットダイアログボックスでは、変数がサーバー上の ColdFusion データソースと一緒にデータソースポップアップメニューに表示されます。

Dreamweaver は変数を初期化しないため、必要な方法と場所で初期化できます。変数は、ページコード（cfquery タグの前）、インクルードファイル、またはセッションやアプリケーション変数として他のファイルで初期化できます。

GETメソッドを使用するHTMLフォームがあるページなど、 送信ページのURLに追加された情報を取得します。 クエリ文字列は、疑問符（?）を使用してURLに追加された1つ以上の名前と値のペア（例：last=Smith、first=Winston） で構成されます。クエリ文字列に複数の名前と値のペアがある場合、 アンパサンド（&）で結合されます。

POSTメソッドを使用するHTMLフォームによって HTTPリクエストの本文に含まれるフォーム情報を取得します。

定義済みの環境変数の値を取得します。 このコレクションには、CONTENT_LENGTH（HTTPリクエストで送信されたコンテンツの長さで、フォームが空かどうかを確認するために使用できます）やHTTP_USER_AGENT（ユーザーのブラウザーに関する情報を提供）など、多数の変数があります。

例えば、Request.ServerVariables("HTTP_USER_AGENT")には、 Mozilla/4.07 [en] (WinNT; I)などの送信ブラウザーに関する情報が含まれており、 これはNetscape Navigator 4.07 ブラウザーを示しています。

ASPサーバー環境変数の完全なリストについては、 Microsoft Personal Web Server（PWS）またはInternet Information Server（IIS）と ともにインストールされたオンラインドキュメントを参照してください。

HTTP 要求で送信される Cookie の値を取得します。 例えば、ページがユーザーのシステム上で「readMe」という cookieを読み取るとします。サーバーでは、cookie の値が変数 Request.Cookies("readMe") に格納されます。

ブラウザーから送信された HTTP リクエストから証明書フィールドを取得します。証明書フィールドは X.509 標準で規定されています。

例えば、Request.ServerVariables("HTTP_USER_AGENT") 変数の情報にアクセスしたい場合は、引数 HTTP_USER_AGENT を入力します。Request.Form("lastname") 変数の情報にアクセスしたい場合は、引数 lastname を入力します。

リクエスト変数がバインディングパネルに表示されます。

詳細については、PHP ドキュメントでキーワード $_SERVER を検索してください。

例えば、Client.LastVisit ColdFusion 変数の情報にアクセスするには、LastVisit を入力します。

クライアント変数は、特定のクライアントにデータを関連付けるためにコードで作成される変数です。クライアント変数は、アプリケーション内でユーザーがページ間を移動する際、またセッション間でアプリケーションの状態を維持します。

クライアント変数は、ユーザー定義変数または組み込み変数です。 以下の表に、組み込み ColdFusion クライアント変数のリストを示します。

例えば、CGI.HTTP_REFERER 変数の情報にアクセスする場合は、 HTTP_REFERERと入力します。

次の表は、 サーバーで作成される最も一般的なColdFusion CGI変数を 示しています：

次の表に、ブラウザーによって作成され サーバーに渡される最も一般的なCGI変数を示します。