Определение источников динамического содержимого

В окне документа откройте страницу, которая будет использовать набор записей.

Выберите «Окно» > «Привязки», чтобы отобразить панель «Привязки».

На панели «Привязки» нажмите кнопку «Плюс» (+) и выберите «Набор записей (Запрос)» во всплывающем меню.

Появится простое диалоговое окно «Набор записей». При разработке сайта ColdFusion диалоговое окно «Набор записей» немного отличается. (Если вместо этого появится расширенное диалоговое окно «Набор записей», нажмите кнопку «Простой», чтобы переключиться на простое диалоговое окно «Набор записей».)

Заполните диалоговое окно «Набор записей» в соответствии с типом документа.

Инструкции см. ниже.

Нажмите кнопку «Тест», чтобы выполнить запрос и убедиться, что он извлекает нужную информацию.

Если вы определили фильтр, который использует параметры, введенные пользователями, введите значение в поле «Тестовое значение» и нажмите «ОК». Если экземпляр набора записей успешно создан, появляется таблица, в которой отображаются данные, извлеченные из набора записей.

Нажмите «ОК», чтобы добавить набор записей в список доступных источников контента на панели «Привязки».

В поле «Имя» введите имя набора записей.

Обычной практикой является добавление префикса rs к именам наборов записей, чтобы отличать их от других имен объектов в коде, например: rsPressReleases.

Имена наборов записей могут содержать только буквы, цифры и символ подчеркивания (_). Специальные символы или пробелы использовать нельзя.

Выберите подключение во всплывающем меню «Подключение».

Если в списке не отображается подключение, нажмите «Определить», чтобы создать его.

Во всплывающем меню «Таблица» выберите таблицу базы данных, которая будет предоставлять данные набору записей.

Всплывающее меню отображает все таблицы в указанной базе данных.

Чтобы включить в набор записей подмножество столбцов таблицы, нажмите «Выбранные» и выберите нужные столбцы, удерживая Ctrl и нажимая (Windows) или Command и нажимая (Macintosh) на них в списке.

Чтобы дополнительно ограничить записи, возвращаемые из таблицы, заполните раздел «Фильтр»:

• В первом всплывающем меню выберите столбец в таблице базы данных для сравнения с тестовым значением, которое вы определите.

• Во втором всплывающем меню выберите условное выражение для сравнения выбранного значения в каждой записи с тестовым значением.

• Выберите «Введенное значение» в третьем всплывающем меню.

• Введите тестовое значение в поле.

  Если указанное значение в записи соответствует условию фильтрации, запись включается в набор записей.

(Необязательно) Чтобы отсортировать записи, выберите столбец для сортировки, а затем укажите, должны ли записи сортироваться по возрастанию (1, 2, 3... или A, B, C...) или по убыванию.

Нажмите «Тест», чтобы подключиться к базе данных и создать экземпляр источника данных, затем нажмите «ОК», чтобы закрыть источник данных.

Появляется таблица с возвращенными данными. Каждая строка содержит запись, а каждый столбец представляет поле в этой записи.

Нажмите кнопку «ОК». Новый определенный набор записей появляется на панели «Привязки».

В поле «Имя» введите имя набора записей.

Обычная практика — добавлять префикс rs к именам наборов записей, чтобы отличать их от других имен объектов в вашем коде. Например: rsPressReleases.

Имена наборов записей могут содержать только буквы, цифры и символ подчеркивания (_). Специальные символы или пробелы использовать нельзя.

Если вы определяете набор записей для компонента ColdFusion (то есть если файл CFC открыт в данный момент в Dreamweaver), выберите существующую функцию CFC из всплывающего меню «Функция» или нажмите кнопку «Новая функция», чтобы создать новую функцию.

Набор записей определяется в функции.

Выберите источник данных во всплывающем меню «Источник данных».

Если во всплывающем меню не появляется ни один источник данных, необходимо создать источник данных ColdFusion.

В полях «Имя пользователя» и «Пароль» введите имя пользователя и пароль для сервера приложений ColdFusion при необходимости.

Источники данных в ColdFusion могут требовать имя пользователя и пароль для доступа к ним. Если у вас нет имени пользователя и пароля для доступа к источнику данных в ColdFusion, обратитесь к администратору ColdFusion вашей организации.

Во всплывающем меню «Таблица» выберите таблицу базы данных, которая будет предоставлять данные для набора записей.

Всплывающее меню «Таблица» отображает все таблицы в указанной базе данных.

Чтобы включить подмножество столбцов таблицы в набор записей, нажмите «Выбранные» и выберите нужные столбцы, щелкая по ним с зажатой клавишей CTRL (Windows) или COMMAND (Macintosh).

Чтобы дополнительно ограничить записи, возвращаемые из таблицы, заполните раздел «Фильтр»:

• Из первого всплывающего меню выберите столбец в таблице базы данных для сравнения с тестовым значением, которое вы определяете.

• Из второго всплывающего меню выберите условное выражение для сравнения выбранного значения в каждой записи с тестовым значением.

• Выберите «Введенное значение» в третьем всплывающем меню.

• Введите тестовое значение в поле.

  Если указанное значение в записи соответствует вашему условию фильтрации, запись включается в набор записей.

(Необязательно) Чтобы отсортировать записи, выберите столбец для сортировки, затем укажите, должны ли записи быть отсортированы по возрастанию (1, 2, 3...или A, B, C...) или по убыванию.

Нажмите «Тест», чтобы подключиться к базе данных и создать экземпляр источника данных.

Отобразится таблица с возвращёнными данными.Каждая строка содержит запись, а каждый столбец представляет поле в этой записи. Нажмите кнопку «ОК», чтобы закрыть тестовый набор записей.

Нажмите кнопку «ОК». Новый набор записей ColdFusion появится на панели «Привязки».

В окне «Документ» откройте страницу, которая будет использовать набор записей.

Выберите «Окно» > «Привязки» для отображения панели «Привязки».

На панели «Привязки» нажмите кнопку «Плюс» (+) и выберите «Набор записей (Запрос)» во всплывающем меню.

Откроется расширенное диалоговое окно «Набор записей». При разработке сайта ColdFusion диалоговое окно «Набор записей» немного отличается. (Если вместо этого появляется простое диалоговое окно «Набор записей», переключитесь на расширенное диалоговое окно «Набор записей», нажав кнопку «Расширенный».)

Заполните поля в расширенном диалоговом окне «Набор записей».

Инструкции см. ниже.

Нажмите кнопку «Тест», чтобы выполнить запрос и убедиться, что он извлекает нужную информацию.

Если вы определили фильтр, который использует параметры, вводимые пользователями, кнопка «Тест» отображает диалоговое окно «Тестовое значение».Введите значение в поле «Тестовое значение» и нажмите ОК.Если экземпляр набора записей успешно cоздан, появляется таблица с данными из набора записей.

Нажмите ОК, чтобы добавить набор записей в список доступных источников контента на панели «Привязки».

Введите имя набора записей в поле «Имя».

Общепринятой практикой является добавление префикса rs к именам набора записей, чтобы отличить их от других имен объектов в коде. Например: rsPressRelease.

Имена набора записей могут содержать только буквы, цифры и символ подчеркивания (_). Нельзя использовать специальные символы или пробелы.

Выберите подключение во всплывающем меню «Подключение».

Введите SQL-оператор в текстовую область SQL или используйте графическое дерево «Элементы базы данных» в нижней части диалогового окна, чтобы построить SQL-оператор из выбранного набора записей.

Выполните следующие действия, чтобы использовать дерево «Элементы базы данных» для построения SQL-оператора:

• Убедитесь, что текстовая область SQL пуста.

• Разверните ветви дерева, пока не найдете нужный объект базы данных — например, столбец в таблице или хранимую процедуру в базе данных.

• Выберите объект базы данных и нажмите одну из кнопок в правой части дерева.

  Например, если вы выберете столбец таблицы, доступными кнопками будут SELECT, WHERE и ORDER BY. Нажмите одну из кнопок, чтобы добавить соответствующее предложение в ваш SQL-запрос.

  Также можно использовать предопределенный SQL-запрос в хранимой процедуре, выбрав хранимую процедуру из дерева элементов базы данных и нажав кнопку «Процедура». Dreamweaver автоматически заполняет области SQL и «Переменные».

Если SQL-запрос содержит переменные, определите их значения в области «Переменные», нажав кнопку «Плюс» (+) и введя имя переменной, тип (целое число, текст, дата или число с плавающей точкой), значение по умолчанию (значение, которое должна принять переменная, если во время выполнения значение не возвращается) и значение времени выполнения.

Если SQL-запрос содержит переменные, убедитесь, что столбец «Значение по умолчанию» в поле «Переменные» содержит действительные тестовые значения.

Значение времени выполнения обычно представляет собой параметр URL или формы, введенный пользователем в поле HTML-формы.

Параметры URL в столбце «Значение времени выполнения»:

Параметры форм в столбце «Значение времени выполнения»

Нажмите «Тест», чтобы подключиться к базе данных и создать экземпляр набора записей.

Если SQL-запрос содержит переменные, убедитесь, что столбец «Значение по умолчанию» в поле «Переменные» содержит действительные тестовые значения перед нажатием «Тест».

При успешном выполнении появится таблица, отображающая данные в вашем наборе записей. Каждая строка содержит запись, а каждый столбец представляет поле в этой записи. Нажмите «ОК», чтобы очистить набор записей.

Если выдаются правильные результаты, нажмите кнопку «ОК».

Введите имя набора записей в поле «Имя».

Распространенной практикой является добавление префикса rs к именам наборов записей для их отличия от других имен объектов в вашем коде. Например: rsPressReleases.

Имена наборов записей могут содержать только буквы, цифры и символ подчеркивания (_). Специальные символы или пробелы использовать нельзя.

Если вы определяете набор записей для компонента ColdFusion (то есть если CFC-файл в настоящее время открыт в Dreamweaver), выберите существующую CFC-функцию из всплывающего меню «Функция» или нажмите кнопку «Новая функция», чтобы создать новую функцию.

Набор записей определяется в функции.

Выберите источник данных во всплывающем меню «Источник данных».

Если во всплывающем списке меню не появляется источник данных, сначала необходимо cоздать источник данных ColdFusion.

В полях «Имя пользователя» и «Пароль» введите имя пользователя и пароль для сервера приложений ColdFusion, если требуется.

Источники данных в ColdFusion могут требовать имя пользователя и пароль для доступа к ним. Если у вас нет имени пользователя и пароля для доступа к источнику данных в ColdFusion, обратитесь к администратору ColdFusion вашей организации.

Введите инструкцию SQL в текстовой области SQL или используйте графическое дерево элементов базы данных в нижней части диалогового окна, чтобы построить инструкцию SQL из выбранного набора записей.

(Необязательно) Выполните следующие действия, чтобы использовать дерево элементов базы данных для построения инструкции SQL:

• Убедитесь, что текстовая область SQL пуста.

• Разверните ветки дерева, пока не найдете необходимый объект базы данных — например, столбец в таблице.

• Выберите объект базы данных и нажмите одну из кнопок справа от дерева.

Например, если вы выбираете столбец таблицы, доступными кнопками являются Select, Where и Order By. Нажмите одну из кнопок, чтобы добавить соответствующее предложение в вашу инструкцию SQL.

Если ваша инструкция SQL содержит параметры, определите их значения в области «Параметры», нажав кнопку «Плюс» (+) и введя имя параметра и значение по умолчанию (значение, которое должен принимать параметр, если значение времени выполнения не возвращается).

Если инструкция SQL содержит параметры, убедитесь, что столбец «Значение по умолчанию» поля «Параметры» содержит допустимые тестовые значения.

Параметры страницы позволяют указать значения по умолчанию для ссылок на значения времени выполнения в SQL-запросе, который вы пишете.Например, следующая инструкция SQL выбирает запись сотрудника на основе значения ID сотрудника. Вы можете назначить значение по умолчанию этому параметру, обеспечив возврат значения времени выполнения. В этом примере FormFieldName ссылается на поле формы, в которое пользователь вводит ID сотрудника:

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

Диалоговое окно «Добавить параметры страницы» будет содержать пару имя-значение, похожую на:

Значение времени выполнения обычно является параметром URL или формы, введенным пользователем в поле HTML-формы.

Нажмите «Тест», чтобы подключиться к базе данных и создать экземпляр набора записей.

Если инструкция SQL содержит ссылки времени выполнения, убедитесь, что столбец «Значение по умолчанию» поля «Параметры страницы» содержит допустимые тестовые значения перед нажатием кнопки «Тест».

В случае успеха появится таблица, отображающая данные в вашем наборе записей. Каждая строка содержит запись, а каждый столбец представляет поле в этой записи. Нажмите «ОК», чтобы очистить набор записей.

Если выдаются правильные результаты, нажмите кнопку «ОК».

Выберите имя параметра во всплывающем меню «Имя».

Введите значение по умолчанию для параметра в поле «Параметр по умолчанию» и нажмите «ОК».

Введите имя параметра в поле «Имя».

Введите значение по умолчанию для параметра в поле «Параметр по умолчанию».

Введите значение времени выполнения для параметра в поле «Значение времени выполнения» и нажмите «ОК».

Разверните ветвь «Таблицы», чтобы отобразить все таблицы в выбранной базе данных.

Выберите таблицу Employees.

Нажмите кнопку «Выбрать».

Нажмите кнопку «ОК», чтобы добавить набор записей на панель «Привязки».

Разверните ветвь «Таблицы», чтобы отобразить все таблицы в выбранной базе данных; затем разверните таблицу Employees, чтобы отобразить отдельные строки таблицы.

Составьте SQL-оператор следующим образом.

• Выберите emplNo и нажмите кнопку «Выбрать».

• Выберите emplName и нажмите кнопку «Выбрать».

• Выберите emplJob и нажмите кнопку «Where».

• Выберите emplName и нажмите кнопку Order By.

Поместите курсор после WHERE emplJob в текстовой области SQL и введите ='varJob' (включая знак равенства).

Определите переменную 'varJob', нажав кнопку «Плюс» (+) в области Variables и введя следующие значения в столбцы Name, Default Value и Run-Time Value: varJob, CLERK, Request("job").

Нажмите кнопку «ОК», чтобы добавить набор записей на панель «Привязки».

В окне Document откройте страницу, которая будет использовать переменную.

Выберите Windows > Bindings, чтобы отобразить панель Bindings.

На панели Bindings нажмите кнопку «плюс» (+) и выберите один из следующих вариантов во всплывающем меню:

В диалоговом окне URL Variable введите имя URL-переменной в поле и нажмите OK.

Имя URL-переменной обычно является именем поля формы HTML или объекта, используемого для получения ее значения.

Переменная URL появится на панели «Привязки».

В окне «Документ» откройте страницу, которая будет использовать переменную.

Выберите «Windows» > «Bindings», чтобы отобразить панель «Bindings».

На панели «Bindings» нажмите кнопку «Плюс» (+) и выберите один из следующих пунктов во всплывающем меню:

В диалоговом окне «Form Variable» введите имя переменной формы и нажмите «ОК». Имя параметра формы обычно совпадает с именем поля или объекта HTML-формы, используемого для получения его значения.

Параметр формы появляется на панели «Привязки».

Создайте переменную сеанса в исходном коде и присвойте ей значение.

Например, в этом примере ColdFusion создается сеанс с именем username, и ему присваивается значение Cornelius:

<CFSET session.username = Cornelius>

Выберите «Окно» > «Привязки», чтобы отобразить панель «Привязки».

Нажмите кнопку «Плюс» (+) и выберите «Переменная сеанса» во всплывающем меню.

Введите имя переменной, которую вы определили в исходном коде приложения, и нажмите «ОК».

Откройте динамический документ в окне документа.

Выберите «Окно» > «Привязки», чтобы отобразить панель «Привязки».

Нажмите кнопку «Плюс» (+) и выберите «Переменная приложения» во всплывающем меню.

Введите имя переменной, как определено в исходном коде приложения, и нажмите «ОК».

Переменная приложения появится на панели «Привязки» под значком «Приложение».

Убедитесь, что страница ColdFusion активна в окне «Документ».

На панели «Привязки» нажмите кнопку «Плюс» (+) и выберите «Переменная имени источника данных» во всплывающем меню.

Появится диалоговое окно «Переменная имени источника данных».

Определите переменную и нажмите кнопку «ОК».

При определении набора записей выберите переменную в качестве источника данных для набора записей.

В диалоговом окне «Набор записей» переменная появляется во всплывающем меню «Источник данных» вместе с источниками данных ColdFusion на сервере.

Заполните поля диалогового окна «Набор записей» и нажмите кнопку «ОК».

Инициализируйте переменную.

Dreamweaver не инициализирует переменную за вас, чтобы вы могли инициализировать ее как и где хотите.Можно инициализировать переменную в коде страницы (перед тегом cfquery), во включаемом файле или в каком-то другом файле как переменную сеанса или переменную приложения.

Откройте панель «Привязки» («Окно» > «Привязки»). В диалоговом окне «Серверная переменная» введите имя серверной переменной и нажмите «ОК».

Нажмите кнопку «Плюс» (+) и выберите серверную переменную из всплывающего меню.

Введите имя переменной и нажмите кнопку «ОК». Серверная переменная ColdFusion отображается в панели «Привязки».

В диалоговом окне «Локальная переменная» введите имя локальной переменной и нажмите «ОК».

Откройте панель «Привязки» (меню «Окно» > «Привязки»).

Нажмите кнопку с плюсом (+) и выберите «Переменная запроса» из всплывающего меню.

В диалоговом окне «Переменная запроса» выберите одну из следующих коллекций запросов из всплывающего меню «Тип»:

Извлекает информацию, присоединенную к URL отправляющей страницы, например, когда страница содержит HTML-форму, использующую метод GET. Строка запроса состоит из одной или нескольких пар имя-значение (например, last=Smith, first=Winston), присоединенных к URL со знаком вопроса (?). Если строка запроса содержит более одной пары имя-значение, они объединяются символом амперсанда (&).

Извлекает информацию формы, включенную в тело HTTP-запроса HTML-формой, использующей метод POST.

Извлекает значения предварительно заданных переменных окружения. Коллекция содержит длинный список переменных, включая 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).

Извлекает значения cookie-переменных, передаваемых в HTTP-запросе. Например, предположим, что страница считывает файл cookie с именем «readMe» в системе пользователя. На сервере значения файлов cookie хранятся в переменной Request.Cookies("readMe").

Извлекает поля сертификации из HTTP-запроса, отправленного браузером. Поля сертификации указаны в стандарте X.509.

Укажите переменную в коллекции, к которой вы хотите получить доступ, и нажмите OK.

Например, если вы хотите получить доступ к информации в переменной Request.ServerVariables("HTTP_USER_AGENT"), введите аргумент HTTP_USER_AGENT. Если вы хотите получить доступ к информации в переменной Request.Form("lastname"), введите аргумент lastname.

Переменная запроса появляется на панели «Привязки».

Откройте панель «Привязки» («Окно» > «Привязки»).

Нажмите кнопку «Плюс» (+) и выберите переменную из всплывающего меню.

В диалоговом окне «Переменная запроса» введите имя переменной (например, REQUEST_METHOD) и нажмите OK.

Для получения дополнительной информации найдите ключевое слово $_SERVER в документации PHP.

В диалоговом окне «Клиентская переменная» введите имя переменной и нажмите OK.

Например, для доступа к информации в переменной ColdFusion Client.LastVisit введите LastVisit.

Клиентские переменные — это переменные, созданные в коде для связывания данных с конкретным клиентом. Клиентские переменные поддерживают состояние приложения при переходе пользователя со страницы на страницу внутри приложения, а также между сеансами.

Клиентские переменные могут определяться пользователем или быть встроенными. В следующей таблице приведены встроенные клиентские переменные ColdFusion.

В диалоговом окне переменной cookie введите имя переменной cookie и нажмите ОК.

В диалоговом окне «Переменная CGI» введите имя переменной и нажмите «OK».

Например, если вы хотите получить доступ к информации в переменной CGI.HTTP_REFERER , введите HTTP_REFERER.

В следующей таблице перечислены наиболее распространенные переменные ColdFusion CGI, которые создаются на сервере:

Переменная	Описание
SERVER_SOFTWARE	Имя и версия программного обеспечения информационного сервера, отвечающего на запрос (и выполняющего шлюз). Формат: название/версия.
SERVER_NAME	Имя хоста сервера, псевдоним DNS или IP-адрес в том виде, в котором они отображаются в URL-адресах, ссылающихся на этот же сервер.
GATEWAY_INTERFACE	Редакция спецификации CGI, которой соответствует данный сервер. Формат: CGI/версия.
SERVER_PROTOCOL	Имя и редакция информационного протокола, с которым поступил этот запрос. Формат: протокол/версия.
SERVER_PORT	Номер порта, на который был отправлен запрос.
REQUEST_METHOD	Метод, с помощью которого был отправлен запрос. В случае с HTTP это Get, Head, Post и т. д.
PATH_INFO	Дополнительная информация пути, предоставленная клиентом. К скриптам можно получить доступ по их виртуальному пути, за которым следует дополнительная информация в конце этого пути.Дополнительная информация отправляется как PATH_INFO.
PATH_TRANSLATED	Сервер предоставляет переведенную версию PATH_INFO, которая берет путь и выполняет любое сопоставление виртуального к физическому.
SCRIPT_NAME	Виртуальный путь к выполняемому Script; используется для саморефереционных URL.
QUERY_STRING	Информация запроса, которая следует за знаком вопроса (?) в URL-адресе, ссылающемся на этот сценарий.
REMOTE_HOST	Имя хоста, сделавшего запрос. Если сервер не располагает этой информацией, он устанавливает REMOTE_ADDR и не устанавливает REMOTE_HOST.
REMOTE_ADDR	IP-адрес удаленного хоста, делающего запрос.
AUTH_TYPE	Если сервер поддерживает аутентификацию пользователя, и Script защищен, это метод аутентификации, специфичный для протокола, используемый для проверки пользователя.
REMOTE_USER AUTH_USER	Если сервер поддерживает аутентификацию пользователя, и скрипт защищен, это имя пользователя, под которым была выполнена аутентификация.(Доступно также в виде AUTH_USER.)
REMOTE_IDENT	Если HTTP-сервер поддерживает идентификацию RFC 931, эта переменная устанавливается в имя удаленного пользователя, полученное с сервера. Используйте эту переменную только для ведения журнала.
CONTENT_TYPE	Для запросов с прикрепленной информацией, таких как HTTP POST и PUT, это тип содержимого данных.
CONTENT_LENGTH	Длина содержимого, предоставленная клиентом.

В следующей таблице перечислены наиболее распространенные переменные CGI, создаваемые браузером и передаваемые на сервер:

Нажмите кнопку со стрелкой в правом верхнем углу панели «Привязки» и переключите «Кэш» во всплывающем меню.

В панели «Привязки» («Окно» > «Привязки») дважды нажмите имя источника контента, который хотите отредактировать.

Внесите изменения в появившемся диалоговом окне.

Если выдаются правильные результаты, нажмите кнопку «ОК».

В панели «Привязки» («Окно» > «Привязки») выберите источник контента из списка.

Нажмите кнопку со знаком «минус» (–).

Выберите набор записей в панели «Привязки» или в панели «Поведения сервера».

Щелкните правой кнопкой мыши набор записей и выберите «Копировать» из всплывающего меню.

Откройте страницу, в которую необходимо скопировать набор записей.

Щелкните правой кнопкой мыши панель «Привязки» или панель инструментов «Поведения сервера» и выберите «Вставить» из всплывающего меню.