Існує кілька способів передачі параметрів між шаблонами. Можна передавати параметри безпосередньо в URL, використовувати для цього форму або cookie.

Якщо параметри передаються через URL, то вони додаються до адреси, що викликається шаблону через символ "&" (амперсанд) у вигляді параметр = значення. Наприклад, гіпертекстова посилання, наведена нижче, відправляє параметр з ім'ям 'user_id' і значенням 5 в шаблон 'example.dbm':

При передачі параметрів через форму використовуються поля форми, які повинні мати імена, що збігаються з іменами параметрів, які потрібно передати. Нижче наведено приклад передачі параметра, з попереднього прикладу використовуючи форму:

Зауважимо, що при зверненні до CGI - програму DBML.EXE повинен бути визначений стандартний параметр Template, який вказує на конкретний шаблон.

Змінні, занесені до cookie браузера і змінні оточення CGI доступні в будь-якому шаблоні. Способи занесення інформації в cookie описані в п.5.11. 5.6 Занесення і модифікація даних з використанням тегів DBINSERT і DBUPDATE

При використанні тегів DBINSERT і DBUPDATE для занесення або модифікації даних, параметри повинні бути передані в шаблон обов'язково з форми, використовуючи метод POST.

Для створення нового запису в базі даних використовується тег DBINSERT, а для модифікації існуючої запису використовується тег DBUPDATE. При використанні цих тегів необхідно визначити атрибути DATASOURCE і TABLENAME. DATASOURCE це назва джерела даних ODBC, що містить редаговану таблицю, а TABLENAME - ім'я цієї таблиці.

Наприклад, якщо джерело даних ODBC називається 'Person DB', а таблиця, в якій потрібно створити запис - 'Person', то тег DBINSERT в шаблоні буде мати такий вигляд:

Параметри, передані в шаблон повинні співпадати з іменами полів таблиці, в якій створюється (модифікується) запис. У тому випадку, якщо не всі передаються параметри повинні брати участь у цій процедурі, використовується атрибут FORMFIELDS, в якому через кому перераховуються імена полів таблиці, для яких повинні існувати однойменні параметри.

Особливо слід зазначити, що для того, щоб використовувати тег DBUPDATE для модифікації запису, у таблиці повинен бути визначений первинний ключ, а для всіх полів включених в первинний ключ з оброблюваної HTML-форми обов'язково повинні бути передані відповідні параметри.

Теги DBINSERT і DBUPDATE можуть мати також ще два необов'язкових атрибуту:  TABLEOWNER - для тих джерел даних які підтримують права      власності на таблиці (наприклад, SQL Server, Oracle та ін), цей      атрибут можна використовувати, щоб вказати власника таблиці.  TABLEQUALIFIER - для різних джерел даних цей атрибут      може мати різний зміст. Так, для SQL Server і Oracle - це ім'я бази      даних, у якій міститься таблиця, а для Intersolv dBase - це      директорія в якій розташовані DBF файли.

Приклад
Нехай визначена HTML - форма для введення даних:

Приклад введення даних для створення запису



ПІБ:
Телефон :
Дата народження:
 

Наступний шаблон, example.dbm, якому будуть передані дані з форми створює запис в таблиці і видає що підтверджує повідомлення:

Підтвердження

Запис створена!

5.7 Виконання запитів до баз даних

Для виконання запитів до бази даних використовується тег DBQUERY. Цей тег має наступний синтаксис:

Атрибут NAME визначає ім'я запиту, який використовується далі для відображення результату виконання запиту. Назва запиту має починатися з букви і може містити букви і цифри (прогалин бути не повинно).

Атрибут DATASOURCE задає ім'я джерела даних ODBC, який повинен бути створений за допомогою інтерфейсу адміністратора Cold Fusion.

Співпадіння атрибутом тега DBQUERY, є атрибут SQL, який власне і визначає запит до бази даних на мові SQL (для поліпшення читабельності, допускається розташування значення ознаки SQL на декількох рядках).

Створюючи SQL запит, слід пам'ятати, що конкретна база даних може мати свої особливості в синтаксисі SQL, використання яких обмежується цією базою даних. Щоб перевірити, чи є конкретне SQL вираз сумісним з ODBC і незалежним від конкретної бази даних, краще всього використовувати Microsoft Query, що входить до складу Microsoft Office. Для цього потрібно в меню Microsoft Query вибрати "Файл/Виконати SQL", у вікні діалогу ввести пропозицію SQL, вибрати джерело даних ODBC, натиснувши на кнопку "Джерела ...", після чого натиснути на кнопку "Виконати". Цей продукт можна також використовувати і для створення SQL - виразів, використовуючи для цього візуальні засоби створення запитів. Отримати SQL - вираз створеного таким чином запиту можна натиснувши на кнопку "SQL" в панелі інструментів.

Атрибут MAXROWS є необов'язковим і визначає максимальну кількість записів, які можуть бути повернуті в результаті виконання запиту.

Атрибут TIMEOUT також є необов'язковим і визначає максимальну кількість мілісекунд для виконання запиту, до видачі повідомлення про помилку. Зауважимо, що цей атрибут підтримується лише деякими ODBC - драйверами (наприклад, драйвером для MS SQL Server 6.0).

Атрибут DEBUG використовується для налагодження запитів. При наявності цього атрибуту користувачеві відправляється додаткова інформація про виконання цього запиту, така як текст виконаного SQL - запиту, кількість повернутих записів та ін

Наведемо приклад запиту з назвою 'AllPersons', який повертає всі записи таблиці 'Persons' з бази даних, з якою пов'язаний джерело даних ODBC з ім'ям 'Person DB':

Для динамічного настроювання SQL - вирази можна використовувати параметри, передані в шаблон. Це можуть бути параметри, передані з форми, URL, а також змінні CGI. Параметри, що використовуються всередині SQL - вирази, повинні бути обрамлені символом "#" (наприклад # Name #). При обробці запиту Cold Fusion шукає параметр з такою назвою серед параметрів, отриманих з форми, в URL або серед змінних CGI. При знаходженні відповідного параметра його значення підставляється замість відповідної посилання на параметр.

Приклади використання параметрів в SQL-вираженні

Приклад 1
Припустимо що обробляється URL

"/ cgi-shl/dbml.exe? Template = prs.dbm & Id = 22",

а атрибут SQL в DBQUERY має вигляд

SQL = "select * from Persons where Id = # Id #",

тоді в базу даних буде передано наступне SQL - вираз:

select * from Persons where Id = 22.

Приклад 2
Припустимо, що в шаблон переданий параметр FirstLetters і потрібно знайти в таблиці Persons записи, в яких перші літери в полі FullName збігаються зі значенням цього параметра. Значення атрибуту SQL в цьому випадку буде наступним:

SQL = "select * from Persons
where FullName like '# FirstLetters #%'"

Слід звернути увагу на те, що маска, що складається з параметра або символ '%', на відміну від попереднього прикладу, обрамлена одинарними лапками. Це пов'язано з тим, що поле Id з прикладу 1 має числовий тип, а поле FullName - текстовий тип (синтаксис SQL вимагає, щоб текстові значення завжди були обрамлені одинарними лапками).

Для того щоб задати маску, у прикладі використовувався символ '%', який в SQL - запитах відповідає довільній послідовності символів. Також для визначення маски може використовуватися символ '_' (почерк), що відповідає одному довільному символу. 5.8 Використання результатів запиту для динамічного створення HTML - документа

Для виведення даних що повертаються у результаті виконання запиту визначеного в DBQUERY застосовується тег DBOUTPUT. Всередині цієї мітки, пов'язаного з конкретним запитом, може знаходитися звичайний текст, теги HTML, посилання на поля визначені в запиті. При обробці шаблону, вміст тегу DBOUTPUT відправляється клієнтові для кожного запису, що повертається в результаті виконання запиту, з підстановкою відповідних значень параметрів і полів.

Тег DBOUTPUT має наступний синтаксис:

Текст, теги HTML,
посилання на поля та параметри (тобто # Name #)

Атрибут QUERY застосовується для зазначення імені запиту DBQUERY, результат виконання якого буде використовуватися, а атрибут MAXROWS визначає Максимальна кількість записів цього запиту, які будуть передані для виведення в тег DBOUTPUT.

Приклад
Для виведення результату виконання запиту з назвою 'AllPersons', відображаючи ім'я персони і телефон, і розділяючи запису горизонтальною лінією, може використовуватися наступна конструкція:

# FullName # (Телефон: # Phone #)

Результат обробки цього тега буде мати вигляд:

Іванов Іван Іванович (Телефон: 222-22-22)

 
Петров Петро Петрович (Телефон: 444-44-44)
5.9 Висновок результату виконання запиту у вигляді таблиці

Теги DBTABLE і DBCOL завжди вживаються разом для відображення результату виконання запиту у вигляді таблиці.

Атрибути тега DBTABLE:                      · QUERY         - Ім'я DBQUERY, для якого потрібно відобразити дані;             · MAXROWS         - Максимальна кількість записів, що може бути відображено в таблиці;             · COLSPACING         - Кількість прогалин, які будуть вставлені між колонками (за замовчуванням 2);             · HEADERLINES         - Кількість рядків, які будуть відведені для заголовка (за замовчуванням 2);             · HTMLTABLE         - За наявності?? цього тегу результат запиту буде відображено у вигляді HTML - таблиці, в іншому випадку   буде використаний тег HTML.             · BORDER         - Використовуєте тільки разом з атрибутом HTMLTABLE для відображення рамки в таблиці.     

Атрибути тега DBTABLE:                      · HEADER         - Текст, який буде виводитися як заголовок колонки;             · WIDTH         - Ширина колонки в символах (за замовчуванням 20);             · ALIGN         -вирівнювання вмісту колонки (LEFT, RIGHT і CENTER);             · TEXT         -укладений в лапки текст, що визначає вміст стовпчика, в якому можуть знаходитися ті самі   теги, посилання на параметри та ін, що і в тезі DBOUTPUT.     

Наведемо приклад використання тегів DBTABLE і DBCOL:

 
  5.10 Додаткові зауваження по створенню DBML - шаблонів  У шаблонах DBML, для коментарів, використовується три тире      (