تعريف مصادر المحتوى الديناميكي

تاريخ آخر تحديث 25‏/04‏/2024
ملاحظة

تم تبسيط واجهة المستخدم في Dreamweaver والإصدارات الأحدث. ونتيجة لذلك، قد لا تجد بعض الخيارات الموضحة في هذه المقالة في Dreamweaver والإصدارات اللاحقة. للاطلاع على المزيد من المعلومات، راجع هذه المقالة.

عرّف مجموعة سجلات دون كتابة SQL

يمكنك إنشاء مجموعة سجلات دون إدخال عبارات SQL يدويًا.

في نافذة المستند، افتح الصفحة التي ستستخدم مجموعة السجلات.
حدد Windows > Bindings لعرض لوحة Bindings.
في لوحة Bindings، انقر على زر Plus (+) وحدد Recordset (Query) من القائمة المنبثقة.

يظهر مربع الحوار Recordset البسيط إذا كنت تطور موقع ColdFusion، فإن مربع حوار Recordset مختلف قليلاً. (إذا ظهر مربع حوار Recordset المتقدم بدلاً من ذلك، انقر على زر Simple للتبديل إلى مربع حوار Recordset البسيط.)

أكمل مربع الحوار Recordset لنوع المستند لديك.

للاطلاع على الإرشادات، راجع الموضوعات أدناه.

انقر على زر Test لتنفيذ الاستعلام والتأكد من أنه يسترد المعلومات التي تنوي الحصول عليها.

إذا عرّفت عامل تصفية يستخدم معاملات يدخلها المستخدمون، أدخل قيمة في مربع قيمة الاختبار، وانقر على موافق.إذا تم إنشاء مثيل من مجموعة السجلات بنجاح، يظهر جدول يعرض البيانات المستخرجة من مجموعة السجلات.

انقر على OK لإضافة مجموعة السجلات إلى قائمة مصادر المحتوى المتاحة في لوحة Bindings.

خيارات مربع حوار Recordset البسيط (PHP، ASP)

في مربع Name، أدخل اسمًا لمجموعة السجلات.

الممارسة الشائعة هي إضافة البادئة rs إلى أسماء مجموعات السجلات لتمييزها عن أسماء الكائنات الأخرى في الكود، على سبيل المثال: rsPressReleases.

أسماء مجموعات السجلات يمكن أن تحتوي فقط على أحرف وأرقام وحرف الشرطة السفلية (_). لا يمكنك استخدام حروف خاصة أو مسافات.

حدد اتصالاً من القائمة المنبثقة Connection.

إذا لم يظهر أي اتصال في القائمة، انقر على Define لإنشاء واحد.

في قائمة Table المنبثقة، حدد جدول قاعدة البيانات الذي سيوفر البيانات لمجموعة السجلات.

تعرض القائمة المنبثقة جميع الجداول في قاعدة البيانات المحددة.

لتضمين مجموعة فرعية من أعمدة الجدول في مجموعة السجلات، انقر على Selected واختر الأعمدة المرغوبة بالنقر مع الضغط على Control (Windows) أو Command (Macintosh) عليها في القائمة.

لزيادة تقييد السجلات المُرجعة من الجدول، أكمل قسم التصفية:

  • من القائمة المنبثقة الأولى، حدد عمودًا في جدول قاعدة البيانات لمقارنته مع قيمة اختبار تعرّفها.

  • من القائمة المنبثقة الثانية، حدد تعبيرًا شرطيًا لمقارنة القيمة المحددة في كل سجل مع قيمة الاختبار.

  • من القائمة المنبثقة الثالثة، حدد Entered Value.

  • في المربع، أدخل قيمة الاختبار.

    إذا كانت القيمة المحددة في السجل تلبي شرط التصفية الخاص بك، يتم تضمين السجل في مجموعة السجلات.

(اختياري) لترتيب السجلات، حدد عمودًا للترتيب حسبه، ثم حدد ما إذا كان يجب ترتيب السجلات بترتيب تصاعدي (1، 2، 3... أو A، B، C...) أو ترتيب تنازلي.

انقر على اختبار للاتصال بقاعدة البيانات وإنشاء مثيل لمصدر البيانات، وانقر على موافق لإغلاق مصدر البيانات.

يظهر جدول يعرض البيانات المرجعة.يحتوي كل صف على سجل ويمثل كل عمود حقلاً في ذلك السجل.

انقر فوق OK. تظهر مجموعة السجلات المحددة حديثاً في لوحة الربط.

خيارات مربع الحوار البسيط لمجموعة السجلات (ColdFusion)

حدد مجموعة سجلات لأنواع مستندات ColdFusion كمصدر للمحتوى الديناميكي دون الحاجة إلى كتابة عبارات SQL يدوياً.

في مربع الاسم، أدخل اسماً لمجموعة السجلات.

من الممارسات الشائعة إضافة البادئة rs إلى أسماء مجموعات السجلات لتمييزها عن أسماء الكائنات الأخرى في الكود الخاص بك.على سبيل المثال: rsPressReleases

يمكن أن تحتوي أسماء مجموعات السجلات على أحرف وأرقام وعلامة الشرطة السفلية (_) فقط.لا يمكنك استخدام حروف خاصة أو مسافات.

إذا كنت تحدد مجموعة سجلات لمكوِّن ColdFusion (أي، إذا كان ملف CFC مفتوحاً حالياً في Dreamweaver)، فحدد دالة CFC موجودة من القائمة المنبثقة للدالة، أو انقر فوق زر الدالة الجديدة لإنشاء دالة جديدة.

ملاحظة

تتوفر القائمة المنبثقة للدالة فقط إذا كان ملف CFC هو المستند الحالي وكان لديك إمكانية الوصول إلى جهاز كمبيوتر يشغل ColdFusion MX 7 أو أحدث.

يتم تعريف مجموعة السجلات في الدالة.

حدد مصدر بيانات من القائمة المنبثقة Data Source.

إذا لم يظهر مصدر بيانات في القائمة المنبثقة، فيجب إنشاء مصدر بيانات ColdFusion.

في مربعي اسم المستخدم وكلمة المرور، أدخل اسم المستخدم وكلمة المرور لخادم تطبيق ColdFusion إذا لزم الأمر.

قد تتطلب مصادر البيانات في ColdFusion اسم مستخدم وكلمة مرور للوصول إليها.إذا لم يكن لديك اسم المستخدم وكلمة المرور للوصول إلى مصدر بيانات في ColdFusion، اتصل بمسؤول ColdFusion في مؤسستك.

في القائمة المنبثقة للجدول، حدد جدول قاعدة البيانات الذي سيوفر البيانات لمجموعة السجلات.

تعرض القائمة المنبثقة للجدول جميع الجداول في قاعدة البيانات المحددة.

لتضمين مجموعة فرعية من أعمدة الجدول في مجموعة السجلات، انقر على خيار "محدد" واختر الأعمدة المطلوبة بالنقر مع الضغط على Control (Windows) أو Command (Macintosh) عليها في القائمة.

لتحديد السجلات المرجعة من الجدول بشكل أكبر، أكمل قسم عامل التصفية:

  • من القائمة المنبثقة الأولى، حدد عموداً في جدول قاعدة البيانات للمقارنة مع قيمة اختبار تحددها.

  • من القائمة المنبثقة الثانية، حدد تعبيراً شرطياً لمقارنة القيمة المحددة في كل سجل مع قيمة الاختبار.

  • من القائمة المنبثقة الثالثة، حدد Entered Value.

  • في المربع، أدخل قيمة الاختبار.

    إذا استوفت القيمة المحددة في السجل شرط التصفية الخاص بك، يتم تضمين السجل في مجموعة السجلات.

(اختياري) لترتيب السجلات، حدد عموداً للترتيب حسبه، ثم حدد ما إذا كان يجب ترتيب السجلات بترتيب تصاعدي (1، 2، 3...أو A، B، C...).أو الترتيب التنازلي.

انقر فوق اختبار للاتصال بقاعدة البيانات وإنشاء مثيل لمصدر البيانات.

يظهر جدول يعرض البيانات المُسترجعة.يحتوي كل صف على سجل ويمثل كل عمود حقلاً في ذلك السجل.انقر فوق OK لإغلاق مجموعة سجلات الاختبار.

انقر فوق OK. يظهر مجموعة السجلات ColdFusion المُعرَّفة حديثاً في لوحة الربط.

عرِّف مجموعة سجلات متقدمة بكتابة SQL

اكتب عبارات SQL الخاصة بك باستخدام مربع الحوار مجموعة السجلات المتقدم، أو أنشئ عبارة SQL باستخدام شجرة عناصر قاعدة البيانات الرسومية.

في نافذة المستند، افتح الصفحة التي ستستخدم مجموعة السجلات.
حدد Windows > Bindings لعرض لوحة الربط.
في لوحة الربط، انقر فوق الزر (+) وحدد Recordset (Query) من القائمة المنبثقة.

يظهر مربع الحوار Recordset المتقدم. إذا كنت تقوم بتطوير موقع ColdFusion، فإن مربع الحوار Recordset يكون مختلفاً قليلاً.(إذا ظهر مربع حوار Recordset البسيط بدلاً من ذلك، انتقل إلى مربع حوار Recordset المتقدم بالنقر على زر المتقدم.)

أكمل مربع الحوار Recordset المتقدم.

للاطلاع على الإرشادات، راجع الموضوعات أدناه.

انقر على زر اختبار لتنفيذ الاستعلام والتأكد من أنه يسترد المعلومات التي تقصدها.

إذا حددت عامل تصفية يستخدم معاملات يدخلها المستخدمون، فسيعرض زر الاختبار مربع حوار Test Value.أدخل قيمة في مربع Test Value وانقر على موافق.إذا تم إنشاء مثيل من مجموعة السجلات بنجاح، فسيظهر جدول يعرض البيانات من مجموعة السجلات.

انقر على موافق لإضافة مجموعة السجلات إلى قائمة مصادر المحتوى المتاحة في لوحة الربط.

خيارات مربع حوار Recordset المتقدم (PHP, ASP)

حدد recordset كمصدر للمحتوى الديناميكي من خلال كتابة عبارة SQL مخصصة، أو من خلال إنشاء عبارة SQL باستخدام شجرة Database Items الرسومية.

اكتب اسمًا لمجموعة السجلات، في المربع Name.

الممارسة الشائعة هي إضافة البادئة rs إلى أسماء recordset لتمييزها عن أسماء الكائنات الأخرى في الكود.على سبيل المثال: rsPressRelease

يمكن أن تحتوي أسماء Recordset على أحرف وأرقام وحرف الشرطة السفلية (_) فقط.لا يمكنك استخدام أحرف خاصة أو مسافات.

حدد اتصالاً من القائمة المنبثقة Connection.
أدخل عبارة SQL في منطقة نص SQL أو استخدم شجرة Database Items الرسومية في أسفل مربع الحوار لبناء عبارة SQL من recordset المحدد.

قم بما يلي لاستخدام شجرة Database Items لبناء عبارة SQL:

  • تأكد من أن منطقة نص SQL فارغة.

  • وسّع فروع الشجرة حتى تعثر على كائن قاعدة البيانات الذي تحتاجه—عمود في جدول، على سبيل المثال، أو إجراء مخزن في قاعدة البيانات.

  • حدد كائن قاعدة البيانات وانقر على أحد الأزرار الموجودة في الجانب الأيمن من الشجرة.

    على سبيل المثال، إذا حددت عمود جدول، فإن الأزرار المتاحة هي SELECT وWHERE وORDER BY.انقر على أحد الأزرار لإضافة العبارة المرتبطة إلى تعليمة SQL الخاصة بك.

    يمكنك أيضًا استخدام تعليمة SQL محددة مسبقًا في إجراء مخزن عن طريق تحديد الإجراء المخزن من شجرة عناصر قاعدة البيانات والنقر على زر Procedure.يملأ Dreamweaver تلقائيًا منطقتي SQL والمتغيرات.

إذا كانت عبارة SQL تحتوي على متغيرات، حدد قيمها في منطقة المتغيرات عن طريق النقر على زر علامة الزائد (+) وإدخال اسم المتغير ونوعه (عدد صحيح أو نص أو تاريخ أو رقم عشري) وقيمته الافتراضية (القيمة التي يجب أن يأخذها المتغير إذا لم يتم إرجاع قيمة وقت التشغيل) وقيمة وقت التشغيل.
ملاحظة

عند استخدام متغيرات في تعليمة SQL في PHP، يضيف Dreamweaver تلقائيًا علامة الدولار في بداية اسم المتغير، لذا يجب عليك حذف علامة الدولار (مثل colname، بدلاً من $colname).

إذا كانت تعليمة SQL تحتوي على متغيرات، تأكد من أن عمود القيمة الافتراضية في مربع المتغيرات يحتوي على قيم اختبار صحيحة.

قيمة وقت التشغيل عادة ما تكون عنوان URL أو معلمة نموذج يدخلها المستخدم في حقل نموذج HTML.

معاملات عنوان URL في عمود قيمة وقت التشغيل:

نموذج الخادم

تعبير القيمة Run-Time لمعلمة URL

ASP

Request.QueryString(“formFieldName”)

PHP

$_GET['formFieldName']

معلمات النموذج في العمود Run-time Value:

نموذج الخادم

تعبير القيمة Run-Time لمعلمة النموذج

ASP

Request.Form(“formFieldName”)

PHP

$_POST['formFieldName']

انقر على اختبار للاتصال بقاعدة البيانات وإنشاء مثيل من مجموعة السجلات.

إذا كان بيان SQL يحتوي على متغيرات، تأكد من أن عمود القيمة الافتراضية في مربع المتغيرات يحتوي على قيم اختبار صالحة قبل النقر على اختبار.

في حالة النجاح، يظهر جدول يعرض البيانات في مجموعة السجلات الخاصة بك.كل صف يحتوي على سجل وكل عمود يمثل حقلاً في ذلك السجل.انقر على موافق لمسح مجموعة السجلات.

إذا كنت راضيًا عن العمل الذي أنجزته، فانقر فوق OK.

خيارات مربع الحوار المتقدم لمجموعة السجلات (ColdFusion)

استخدم مربع حوار مجموعة السجلات المتقدم لكتابة استعلامات SQL مخصصة، أو استخدم شجرة عناصر قاعدة البيانات لتأليف استعلامات SQL باستخدام واجهة النقر والإشارة.

اكتب اسمًا لمجموعة السجلات، في المربع Name.

من الممارسات الشائعة إضافة البادئة rs إلى أسماء مجموعات السجلات لتمييزها عن أسماء الكائنات الأخرى في الكود الخاص بك.على سبيل المثال: rsPressReleases

أسماء مجموعات السجلات يمكن أن تحتوي فقط على أحرف وأرقام وحرف الشرطة السفلية (_).لا يمكنك استخدام حروف خاصة أو مسافات.

إذا كنت تحدد مجموعة سجلات لمكون ColdFusion (أي إذا كان ملف CFC مفتوحًا حاليًا في Dreamweaver)، حدد دالة CFC موجودة من القائمة المنبثقة للدالة، أو انقر على زر الدالة الجديدة لإنشاء دالة جديدة.

ملاحظة

القائمة المنبثقة للوظيفة متاحة فقط إذا كان ملف CFC هو المستند الحالي ولديك وصول إلى جهاز كمبيوتر يشغل ColdFusion MX 7 أو أحدث.

تُعرَّف مجموعة السجلات في الدالة.

حدد مصدر بيانات من القائمة المنبثقة Data Source.

إذا لم يظهر أي مصدر بيانات في قائمة النافذة المنبثقة، ستحتاج أولاً إلى إنشاء مصدر بيانات ColdFusion.

في مربعي اسم المستخدم وكلمة المرور، أدخل اسم المستخدم وكلمة المرور لخادم تطبيق ColdFusion إذا كان ذلك مطلوباً.

قد تتطلب مصادر البيانات في ColdFusion اسم المستخدم وكلمة المرور للوصول إليها.إذا لم يكن لديك اسم المستخدم وكلمة المرور للوصول إلى مصدر البيانات في ColdFusion، تواصل مع مدير ColdFusion في مؤسستك.

أدخل عبارة SQL في منطقة نص SQL أو استخدم شجرة عناصر قاعدة البيانات الرسومية في أسفل مربع الحوار لإنشاء عبارة SQL من مجموعة السجلات المختارة.
(اختياري) قم بما يلي لاستخدام شجرة عناصر قاعدة البيانات لإنشاء عبارة SQL:
  • تأكد من أن منطقة نص SQL فارغة.

  • وسّع فروع الشجرة حتى تجد كائن قاعدة البيانات الذي تحتاجه—على سبيل المثال، عمود في جدول.

  • حدد كائن قاعدة البيانات وانقر على أحد الأزرار على الجانب الأيمن من الشجرة.

على سبيل المثال، إذا حددت عمود جدول، الأزرار المتاحة هي Select وWhere وOrder By.انقر على أحد الأزرار لإضافة الجملة المرتبطة إلى عبارة SQL الخاصة بك.

إذا كانت عبارة SQL تحتوي على معاملات، حدد قيمها في منطقة المعاملات بالنقر على زر Plus (+) وإدخال اسم المعامل وقيمته الافتراضية (القيمة التي يجب أن يأخذها المعامل إذا لم يتم إرجاع قيمة وقت التشغيل).

إذا كانت عبارة SQL تحتوي على معاملات، تأكد من أن عمود القيمة الافتراضية في مربع المعاملات يحتوي على قيم اختبار صالحة.

تسمح لك معاملات الصفحة بتوفير قيم افتراضية لمراجع قيم وقت التشغيل في SQL الذي تكتبه.على سبيل المثال، عبارة SQL التالية تحدد سجل موظف استناداً إلى قيمة معرف الموظف.يمكنك تعيين قيمة افتراضية لهذا المعامل، مما يضمن إرجاع قيمة وقت التشغيل دائماً.في هذا المثال، FormFieldName يشير إلى حقل نموذج يدخل فيه المستخدم معرف موظف:

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

سيحتوي مربع حوار إضافة معاملات الصفحة على إقران اسم-قيمة مماثل لما يلي:

الاسم

القيم الافتراضية

FormFieldName

0001

قيمة وقت التشغيل عادة ما تكون عنوان URL أو معامل نموذج يدخله المستخدم في حقل نموذج HTML.

انقر على اختبار للاتصال بقاعدة البيانات وإنشاء مثيل لمجموعة السجلات.

إذا كانت عبارة SQL تحتوي على مراجع وقت التشغيل، تأكد من أن عمود القيمة الافتراضية في حقل معاملات الصفحة يحتوي على قيم اختبار صالحة قبل النقر على اختبار.

إذا نجح الأمر، سيظهر جدول يعرض البيانات في مجموعة السجلات الخاصة بك.كل صف يحتوي على سجل وكل عمود يمثل حقلاً في ذلك السجل.انقر على موافق لمسح مجموعة السجلات.

إذا كنت راضيًا عن العمل الذي أنجزته، فانقر فوق OK.

تحديد المعاملات في عبارة SQL (ColdFusion)

حدد المعاملات في عبارة SQL؛ القيمة الافتراضية هي القيمة التي يجب أن يستخدمها المعامل إذا لم يتم إرجاع قيمة وقت التشغيل.

حدد اسم معلمة من قائمة Name المنبثقة.
ادخل قيمة افتراضية للمتغير في مربع المتغير الافتراضي، ثم انقر فوق موافق.

حدد المعاملات في عبارة SQL (PHP)

حدد المعاملات في عبارة SQL؛ القيمة الافتراضية هي القيمة التي يجب أن يستخدمها المعامل إذا لم يتم إرجاع قيمة وقت التشغيل.

أدخل اسم معلمة في المربع Name.
ادخل قيمة افتراضية للمتغير في مربع المتغير الافتراضي.
ادخل قيمة وقت التشغيل للمتغير في مربع قيمة وقت التشغيل، ثم انقر فوق موافق.

أنشئ استعلامات SQL باستخدام شجرة عناصر قاعدة البيانات

بدلاً من كتابة عبارات SQL يدوياً في مربع SQL، يمكنك استخدام واجهة الإشارة والنقر الخاصة بعناصر قاعدة البيانات لإنشاء استعلامات SQL معقدة.تتيح لك شجرة عناصر قاعدة البيانات تحديد كائنات قاعدة البيانات وربطها باستخدام عبارات SQL SELECT و WHERE و ORDER BY.بعد إنشاء استعلام SQL، يمكنك تحديد أي متغيرات باستخدام منطقة المتغيرات في مربع الحوار.

يصف المثالان التاليان عبارتي SQL والخطوات لإنشائهما باستخدام شجرة عناصر قاعدة البيانات في مربع الحوار المتقدم لمجموعة السجلات.

مثال: تحديد جدول

يحدد هذا المثال المحتويات الكاملة لجدول الموظفين.تظهر عبارة SQL التي تحدد الاستعلام كما يلي:

SELECT * FROM Employees

لإنشاء هذا الاستعلام، اتبع هذه الخطوات.

وسع فرع الجداول لعرض جميع الجداول في قاعدة البيانات المحددة.
حدد الجدول Employees.
انقر فوق الزر Synchronize.
انقر فوق OK لإضافة مجموعة سجلات إلى اللوحة Bindings.

مثال: تحديد صفوف محددة من جدول وترتيب النتائج

يحدد المثال التالي صفين من جدول الموظفين، ويحدد نوع الوظيفة باستخدام متغير يجب أن تقوم بتعريفه.يمكن ترتيب النتائج حينها حسب اسم الموظف.

SELECT emplNo, emplName

FROM Employees

WHERE emplJob = 'varJob'

ORDER BY emplName

وسع فرع الجداول لعرض جميع الجداول في قاعدة البيانات المحددة؛ ثم وسع جدول 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").
انقر فوق OK لإضافة مجموعة سجلات إلى اللوحة Bindings.

تحديد معلمات URL

تخزن معاملات URL المعلومات المستردة التي يدخلها المستخدمون.قبل أن تبدأ، تأكد من تمرير نموذج أو معامل URL إلى الخادم.بعد تعريف متغير URL، يمكنك استخدام قيمته في الصفحة المحددة حاليًا.

في نافذة Document، افتح الصفحة التي ستستخدم المتغير.
حدد Windows > Bindings لعرض لوحة Bindings.
في لوحة Bindings، انقر على زر Plus (+) و حدد أحد الخيارات التالية من القائمة المنبثقة:

أنواع المستندات

عنصر القائمة في اللوحة Bindings لمتغير URL

ASP

Request Variable > Request.QueryString

ColdFusion

URL Variable

PHP

URL Variable

في مربع الحوار URL Variable، أدخل اسم متغير URL في المربع، وانقر على OK.

اسم متغير URL عادة ما يكون اسم حقل النموذج HTML أو الكائن المستخدم للحصول على قيمته.

يظهر متغير عنوان URL في اللوحة Bindings.

تحديد معلمات النماذج

تخزن معاملات النموذج المعلومات المستردة المتضمنة في طلب HTTP لصفحة الويب.إذا أنشأت نموذجًا يستخدم طريقة POST، فإن البيانات المرسلة بواسطة النموذج يتم تمريرها إلى الخادم.قبل أن تبدأ، تأكد من تمرير معامل نموذج إلى الخادم.بعد تعريف معامل النموذج كمصدر محتوى، يمكنك استخدام قيمته في صفحتك.

في نافذة Document، افتح الصفحة التي ستستخدم المتغير.
حدد Windows > Bindings لعرض لوحة Bindings.
في لوحة Bindings، انقر على زر Plus (+) و حدد أحد الخيارات التالية من القائمة المنبثقة:

أنواع المستندات

عنصر القائمة في اللوحة Bindings لمتغير النموذج

ASP

Request Variable > Request.Form

ColdFusion

Form Variable

PHP

Form Variable

في مربع الحوار Form Variable، أدخل اسم متغير النموذج، وانقر على OK.اسم معامل النموذج عادة ما يكون اسم حقل نموذج HTML أو الكائن المستخدم للحصول على قيمته.

تظهر معلمة النموذج في اللوحة Bindings.

إنشاء اللوحة من خلال توسيع النموذج
إنشاء اللوحة من خلال توسيع النموذج

تحديد متغيرات جلسة العمل

يمكنك استخدام متغيرات الجلسة لتخزين وعرض المعلومات المحفوظة طوال مدة زيارة المستخدم (أو الجلسة).ينشئ الخادم كائن جلسة مختلف لكل مستخدم ويحتفظ به لفترة زمنية محددة أو حتى يتم إنهاء الكائن بشكل صريح.

قبل تعريف متغيرات الجلسة للصفحة، يجب إنشاؤها في الكود المصدري.بعد إنشاء متغير جلسة في الكود المصدري للتطبيق الإلكتروني، يمكنك استخدام Dreamweaver لاسترداد قيمته واستخدامها في صفحة ويب.

أنشئ متغير جلسة في الكود المصدري، وحدد قيمة له.

على سبيل المثال، ينشئ مثال ColdFusion هذا جلسة تُسمى username، ويعيّن لها القيمة Cornelius:

<CFSET session.username = Cornelius>

حدد Window > Bindings لعرض لوحة Bindings.
انقر على زر Plus (+)، وحدد Session Variable من القائمة المنبثقة.
أدخل اسم المتغيّر الذي عرّفته في كود المصدر للتطبيق، وانقر على OK.

تعريف متغيّرات التطبيق لـ ASP وColdFusion

في ASP وColdFusion، يمكنك استخدام متغيّرات التطبيق لتخزين وعرض المعلومات التي يتم الحفاظ عليها طوال عمر التطبيق وتستمر من مستخدم إلى آخر. بعد تعريف متغيّر التطبيق، يمكنك استخدام قيمته في صفحة.

ملاحظة

لا توجد كائنات متغيّرات تطبيق في PHP.

افتح نوع مستند ديناميكي في النافذة Document.
حدد Window > Bindings لعرض لوحة Bindings.
انقر على زر Plus (+)، وحدد Application Variable من القائمة المنبثقة.
أدخل اسم المتغيّر كما هو معرّف في كود المصدر للتطبيق، وانقر على OK.

يظهر متغيّر التطبيق في لوحة Bindings تحت أيقونة Application.

لوحة Bindings مع توسيع Application
لوحة Bindings مع توسيع Application

استخدام متغيّر كمصدر بيانات لمجموعة سجلات ColdFusion

عندما تعرّف مجموعة سجلات لصفحة في لوحة Bindings، يقوم Dreamweaver بإدخال اسم مصدر بيانات ColdFusion في علامة cfquery في الصفحة. للمزيد من المرونة، يمكنك تخزين اسم مصدر البيانات في متغيّر واستخدام المتغيّر في علامة cfquery. يوفر Dreamweaver طريقة مرئية لتحديد مثل هذا المتغيّر في مجموعات السجلات الخاصة بك.

تأكد من أن صفحة ColdFusion نشِطة في نافذة Document.
في لوحة Bindings، انقر على زر Plus (+) وحدد Data Source Name Variable من القائمة المنبثقة.

يظهر مربع الحوار Data Source Name Variable.

حدد متغيرًا، ثم انقر فوق OK.
عند تعريف مجموعة السجلات، حدد المتغيّر كمصدر بيانات لمجموعة السجلات.

في مربع الحوار Recordset، يظهر المتغيّر في قائمة Data Source المنبثقة مع مصادر بيانات ColdFusion الموجودة على الخادم.

أكمل مربع الحوار Recordset، وانقر فوق OK.
قم بتهيئة المتغير.

لا يقوم Dreamweaver بتهيئة المتغيّر لك حتى تتمكن من تهيئته كيف وأين تريد. يمكنك تهيئة المتغيّر في كود الصفحة (قبل علامة cfquery)، في ملف include، أو في ملف آخر كمتغيّر جلسة أو تطبيق.

تحديد متغيرات الخادم

تعرّف متغيّرات الخادم كمصادر محتوى ديناميكي للاستخدام داخل تطبيق ويب. تختلف متغيّرات الخادم من نوع مستند إلى آخر وتشمل متغيّرات النموذج، ومتغيّرات URL، ومتغيّرات الجلسة، ومتغيّرات التطبيق.

يمكن الوصول إلى متغيرات الخادم بواسطة جميع العملاء الذين يصلون إلى الخادم، وبواسطة أي تطبيقات تعمل على الخادم.تستمر المتغيرات حتى يتم إيقاف الخادم.

تحديد متغيرات خادم ColdFusion

افتح لوحة الربط (Window > Bindings).في مربع حوار متغير الخادم، أدخل اسم متغير الخادم، وانقر فوق موافق.
انقر فوق زر علامة الجمع (+) وحدد متغير الخادم من القائمة المنبثقة.
أدخل اسم المتغير، وانقر فوق OK. يظهر متغير خادم ColdFusion في لوحة الربط.

يسرد الجدول التالي متغيرات خادم ColdFusion المدمجة:

المتغير

الوصف

Server.ColdFusion.ProductName

اسم منتج ColdFusion

Server.ColdFusion.ProductVersion

رقم إصدار ColdFusion

Server.ColdFusion.ProductLevel

نسخة ColdFusion (Enterprise, Professional).

Server.ColdFusion.SerialNumber

الرقم التسلسلي للإصدار المثبت حاليًا من ColdFusion.

Server.OS.Name

اسم نظام التشغيل الذي يعمل على الخادم (Windows XP، Windows 2000، Linux).

Server.OS.AdditionalInformation

معلومات إضافية حول نظام التشغيل المثبت (حزم الخدمة، التحديثات).

Server.OS.Version

إصدار نظام التشغيل المثبت.

Server.OS.BuildNumber

رقم إنشاء نظام التشغيل المثبت.

تحديد متغير محلي لـ ColdFusion

المتغيرات المحلية هي متغيرات تم إنشاؤها باستخدام علامة CFSET أو CFPARAM داخل صفحة ColdFusion.يظهر المتغير المحلي المُعرَّف في لوحة الربط.

في مربع حوار المتغير المحلي، أدخل اسم المتغير المحلي وانقر فوق موافق.

تحديد متغيرات خادم ASP

يمكنك تعريف متغيرات خادم ASP التالية كمصادر للمحتوى الديناميكي: Request.Cookie، Request.QueryString، Request.Form، Request.ServerVariables، وRequest.ClientCertificates.

افتح لوحة الربط (Window > Bindings).
انقر فوق زر علامة الجمع (+)، وحدد Request Variable من القائمة المنبثقة.
في مربع حوار Request Variable، حدد إحدى مجموعات الطلبات التالية من القائمة المنبثقة Type:

المجموعة QueryString

يسترد المعلومات المُلحقة بعنوان URL للصفحة المُرسِلة، مثل عندما تحتوي الصفحة على نموذج HTML يستخدم طريقة GET. تتكون سلسلة الاستعلام من زوج أو أكثر من أزواج الاسم-القيمة (على سبيل المثال، last=Smith، first=Winston) مُلحقة بعنوان URL مع علامة استفهام (?).إذا كانت سلسلة الاستعلام تحتوي على أكثر من زوج اسم-قيمة واحد، فيتم دمجها بعلامات العطف (&).

مجموعة Form

يسترد معلومات النموذج المُدرجة في نص طلب HTTP بواسطة نموذج HTML يستخدم طريقة POST.

مجموعة ServerVariables

استرداد قيم متغيرات بيئة محددة مسبقًا. تحتوي المجموعة على قائمة طويلة من المتغيرات، بما في ذلك 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).

مجموعة Cookies

استرداد قيم ملفات تعريف الارتباطات المرسلة في طلب HTTP. على سبيل المثال، لنفترض أن الصفحة تقرأ ملف تعريف ارتباط يُسمى "readMe" على نظام المستخدم.على الخادم، يتم تخزين قيم ملفات تعريف الارتباط في المتغير Request.Cookies("readMe").

مجموعة ClientCertificate

يسترد حقول الشهادات من طلب HTTP المُرسل بواسطة المتصفح.حقول الشهادات محددة في معيار X.509.

حدد المتغير في المجموعة الذي تريد الوصول إليه، وانقر على موافق.

على سبيل المثال، إذا كنت تريد الوصول إلى المعلومات في متغير Request.ServerVariables("HTTP_USER_AGENT")، أدخل المعامل HTTP_USER_AGENT.إذا كنت تريد الوصول إلى المعلومات في متغير Request.Form("lastname")، أدخل المعامل lastname.

يظهر متغير الطلب في لوحة الربط.

تحديد متغيرات خادم PHP

عرّف متغيرات الخادم كمصدر للمحتوى الديناميكي لصفحات PHP.تظهر متغيرات خادم PHP في لوحة الربط.

افتح لوحة الربط (النافذة > الربط).
انقر على زر علامة الجمع (+)، وحدد المتغير من القائمة المنبثقة.
في مربع حوار متغير الطلب، أدخل اسم المتغير (على سبيل المثال، REQUEST_METHOD)، وانقر على موافق.

لمزيد من المعلومات، ابحث عن الكلمة المفتاحية $_SERVER في وثائق PHP.

تحديد متغير عميل لـColdFusion

عرّف متغير عميل ColdFusion كمصدر للمحتوى الديناميكي للصفحة.تظهر متغيرات عميل ColdFusion المُعرّفة حديثاً في لوحة الربط.

في مربع حوار متغير العميل، أدخل اسم المتغير، وانقر على موافق.

على سبيل المثال، للوصول إلى المعلومات في متغير ColdFusion Client.LastVisit، أدخل LastVisit.

متغيرات العميل هي متغيرات تم إنشاؤها في الكود لربط البيانات بعميل محدد. تحافظ متغيرات العميل على حالة التطبيق عندما ينتقل المستخدم من صفحة إلى صفحة داخل التطبيق، وكذلك من جلسة إلى جلسة.

يمكن أن تكون متغيرات Client محددة من قبل المستخدم أو متضمنة. يسرد الجدول التالي متغيرات عميل ColdFusion المضمنة:

المتغير

الوصف

Client.CFID

معرف تزايدي لكل عميل يتصل بالخادم.

Client.CFTOKEN

رقم مُولد عشوائياً يُستخدم لتحديد هوية عميل معين بطريقة فريدة.

Client.URLToken

مزيج من CFID وCFTOKEN ليتم تمريره بين القوالب عندما لا تُستخدم ملفات تعريف الارتباط.

Client.LastVisit

يسجل الطابع الزمني للزيارة الأخيرة التي قام بها العميل.

Client.HitCount

عدد طلبات الصفحة المرتبطة بعميل واحد (يتم تتبعها باستخدام CFID وCFTOKEN).

Client.TimeCreated

يسجل الطابع الزمني عندما تم إنشاء CFID وCFTOKEN لأول مرة لعميل معين.

يتم إنشاء متغيرات ملفات تعريف الارتباط في الكود، وتُستخدم للوصول إلى المعلومات الموجودة في ملفات تعريف الارتباط التي يمررها المتصفح إلى الخادم.يظهر متغير ملف تعريف الارتباط المُعرَّف في لوحة Bindings.

في مربع الحوار Cookie Variable، أدخل اسم متغير ملف تعريف الارتباط، وانقر فوق OK.

تحديد متغير ColdFusion CGI

يظهر متغير CGI المُعرَّف في لوحة Bindings.

في مربع الحوار CGI Variable، أدخل اسم المتغير، وانقر فوق OK.

على سبيل المثال، إذا كنت تريد الوصول إلى المعلومات الموجودة في متغير CGI.HTTP_REFERER ، أدخل HTTP_REFERER.

يسرد الجدول التالي متغيرات CGI الخاصة بـ ColdFusion الأكثر شيوعاً والتي يتم إنشاؤها على الخادم:

المتغير

الوصف

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

مسار افتراضي إلى البرنامج النصي قيد التنفيذ؛ يُستخدم لعناوين URL المرجعية الذاتية.

QUERY_STRING

معلومات الاستعلام التي تتبع علامة الاستفهام (?)في عنوان URL المشار إليه بهذا البرنامج النصي.

REMOTE_HOST

اسم المضيف الذي ينشئ الطلب. إذا لم يكن لدى الخادم هذه المعلومات، فإنه يحدد REMOTE_ADDR ولا يحدد REMOTE_HOST.

REMOTE_ADDR

عنوان IP الخاص بالمضيف البعيد الذي يقوم بالطلب.

AUTH_TYPE

إذا كان الخادم يدعم مصادقة المستخدم، والبرنامج النصي محمي، فهذه هي طريقة المصادقة الخاصة بالبروتوكول المستخدمة للتحقق من صحة المستخدم.

REMOTE_USER AUTH_USER

إذا كان الخادم يدعم مصادقة المستخدم، والبرنامج النصي محمي، فهذا هو اسم المستخدم الذي تمت مصادقته به.(أيضًا متاح كـAUTH_USER.)

REMOTE_IDENT

إذا كان خادم HTTP يدعم تعريف RFC 931، يتم تعيين هذا المتغير لاسم المستخدم البعيد المسترد من الخادم.استخدم هذا المتغير لسجل الدخول فقط.

CONTENT_TYPE

للاستعلامات التي تحتوي على معلومات مرفقة، مثل HTTP POST وPUT، هذا هو نوع محتوى البيانات.

CONTENT_LENGTH

طول المحتوى كما يوفره العميل.

يسرد الجدول التالي متغيرات CGI الأكثر شيوعًا التي ينشئها المتصفح وينقلها إلى الخادم:

المتغير

الوصف

HTTP_REFERER

المستند المشير. هذا هو المستند الذي أنشأ رابطًا أو أرسل بيانات النموذج.

HTTP_USER_AGENT

المتصفح الذي يستخدمه العميل حاليًا لإرسال الطلب.التنسيق: البرنامج/مكتبة الإصدارات/الإصدار.

HTTP_IF_MODIFIED_SINCE

آخر وقت تم تعديل الصفحة فيه. يتم إرسال هذا المتغير حسب تقدير المتصفح، عادةً استجابة لإرسال الخادم لرأس LAST_MODIFIED HTTP.يمكن استخدامه للاستفادة من التخزين المؤقت من جانب المتصفح.

تخزين مصادر المحتوى مؤقتًا

يمكنك تخزين—أو حفظ—مصادر المحتوى الديناميكي في ملاحظة التصميم. هذا يتيح لك العمل على موقع حتى لو لم يكن لديك وصول إلى قاعدة البيانات أو خادم التطبيق الذي يخزن مصادر المحتوى الديناميكي. قد يؤدي التخزين المؤقت أيضًا إلى تسريع التطوير من خلال إلغاء الوصول المتكرر عبر الشبكة إلى قاعدة البيانات وخادم التطبيق.

انقر على زر السهم في الزاوية العلوية اليمنى من لوحة الربط وقم بتبديل Cache في القائمة المنبثقة.

إذا قمت بإجراء تغييرات على أحد مصادر المحتوى، يمكنك تحديث التخزين المؤقت بالنقر على زر التحديث (أيقونة السهم الدائري) في الزاوية العلوية اليمنى من لوحة الربط.(قم بتوسيع اللوحة إذا لم تر الزر.)

تغيير مصادر المحتوى أو حذفها

يمكنك تغيير أو حذف أي مصدر موجود للمحتوى الديناميكي—أي أي مصدر محتوى مدرج في لوحة الربط.

تغيير أو حذف مصدر المحتوى في لوحة الربط لا يؤدي إلى تغيير أو حذف أي مثيل لهذا المحتوى على الصفحة.إنه مجرد تغيير أو حذف له كمصدر محتمل للمحتوى للصفحة.

تغيير مصدر المحتوى في لوحة الربط

في لوحة الربط (Window > Bindings)، انقر نقرًا مزدوجًا على اسم مصدر المحتوى الذي تريد تعديله.
قم بإجراء التغييرات التي تريدها في مربع الحوار الذي يظهر.
إذا كنت راضيًا عن العمل الذي أنجزته، فانقر فوق OK.

حذف مصدر المحتوى من لوحة الربط

في لوحة الربط (Window > Bindings)، حدد مصدر المحتوى من القائمة.
انقر فوق زر علامة الطرح (-).

نسخ مجموعة السجلات من صفحة إلى صفحة أخرى

يمكنك نسخ مجموعة السجلات من صفحة إلى أخرى ضمن موقع محدد.

حدد مجموعة السجلات في لوحة الربط أو لوحة سلوكيات الخادم.
انقر بزر الماوس الأيمن فوق مجموعة السجلات، وحدد Copy من القائمة المنبثقة.
افتح الصفحة التي تريد نسخ مجموعة السجلات إليها.
انقر بزر الماوس الأيمن على لوحة الربط أو شريط أدوات سلوكيات الخادم، وحدد Paste من القائمة المنبثقة.