ملاحظة:

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

تحديد مجموعة سجلات دون كتابة SQL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. لإجراء تقييد إضافي للسجلات التي أرجعها الجدول، أكمل القسم Filter.

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

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

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

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

      في حالة توافق القيمة المحددة في أحد السجلات مع شرط التصفية، يتم تضمين السجل في مجموعة السجلات.

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

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

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

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

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

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

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

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

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

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

    ملاحظة:

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

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

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

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

  4. في المربعين Username وPassword، أدخل اسم مستخدم خادم تطبيق ColdFusion وكلمة مروره، عند الحاجة.

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

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

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

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

  7. لإجراء تقييد إضافي للسجلات التي أرجعها الجدول، أكمل القسم Filter.

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

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

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

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

      في حالة توافق القيمة المحددة في أحد السجلات مع شرط التصفية، يتم تضمين السجل في مجموعة السجلات.

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

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

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

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

تحديد مجموعة سجلات متقدمة من خلال كتابة SQL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ملاحظة:

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

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

    وعادة ما تكون القيمة الحقيقية عبارة عن عنوان URL يُدخله المستخدم في حقل نموذج HTML.

    معلمات URL في العمود Run-time Value:

    نموذج الخادم

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

    ASP

    Request.QueryString(“formFieldName”)

    PHP

    $_GET['formFieldName']

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

    نموذج الخادم

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

    ASP

    Request.Form(“formFieldName”)

    PHP

    $_POST['formFieldName']

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

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

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

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

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

استخدم مربع الحوار Recordset المتقدم لكتابة استعلامات SQL، أو استخدام شجرة Database Items لكتابة استعلامات SQL باستخدام إحدى واجهات الإشارة والنقر.

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

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

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

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

    ملاحظة:

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

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

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

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

  3. في المربعين Username وPassword، أدخل اسم مستخدم خادم تطبيق ColdFusion وكلمة مروره، عند الحاجة.

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

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

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

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

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

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

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

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

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

    سيحتوي مربع الحوار Add Page Parameters على زوج- يتألف من الاسم والقيمة- مشابهًا لما يلي:

    الاسم

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

    FormFieldName

    0001

    وعادة ما تكون القيمة الحقيقية عبارة عن عنوان URL يُدخله المستخدم في حقل نموذج HTML.

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

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

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

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

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

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

  1. حدد اسم معلمة من قائمة Name المنبثقة.
  2. أدخل قيمة افتراضية للمعلمة في المربع Default Parameter، ثم انقر فوق OK.

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

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

  1. أدخل اسم معلمة في المربع Name.
  2. أدخل قيمة افتراضية للمعلمة في المربع Default Parameter.
  3. أدخل قيمة حقيقية للمعلمة في المربع Run-time Value، ثم انقر فوق OK.

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

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

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

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

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

SELECT * FROM Employees

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

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

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

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

SELECT emplNo, emplName 
FROM Employees 
WHERE emplJob = 'varJob' 
ORDER BY emplName
  1. قم بتوسيع فرع Tables لعرض كل الجداول الموجودة في قاعدة البيانات؛ ثم قم بتوسيع الجدول Employees لعرض الصفوف الفردية للجدول.
  2. إنشاء جملة SQL على النحو التالي:
    • حدد emplNo، ثم انقر فوق الزر Select.

    • حدد emplName‎، ثم انقر فوق الزر Select.

    • حدد emplJob، ثم انقر فوق الزر Where.

    • حدد emplName، ثم انقر فوق الزر Order By.

  3. ضع نقطة الإدراج بعد WHERE emplJob في منطقة نص SQL واكتب ='varJob' (قم بتضمين علامة يساوي).
  4. حدد المتغير 'varJob' بالنقر فوق زر علامة الزائد (+) في المنطقة Variables وإدراج القيم التالية في الأعمدة Name، وDefault Value، وRun-Time Value: varJob، CLERK، Request("job").
  5. انقر فوق OK لإضافة مجموعة سجلات إلى اللوحة Bindings.

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

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

  1. في النافذة Document، افتح الصفحة التي ستستخدم مجموعة المتغير.
  2. حدد Windows > Bindings لعرض اللوحة Bindings.
  3. في اللوحة Bindings، انقر فوق زر علامة الزائد (+) وحدد واحدًا مما يلي من القائمة المنبثقة.

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

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

    ASP

    Request Variable > Request.QueryString

    ColdFusion

    URL Variable

    PHP

    URL Variable

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

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

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

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

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

  1. في النافذة Document، افتح الصفحة التي ستستخدم مجموعة المتغير.
  2. حدد Windows > Bindings لعرض اللوحة Bindings.
  3. في اللوحة Bindings، انقر فوق زر علامة الزائد (+) وحدد واحدًا مما يلي من القائمة المنبثقة.

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

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

    ASP

    Request Variable > Request.Form

    ColdFusion

    Form Variable

    PHP

    Form Variable

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

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

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

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

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

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

  1. قم بإنشاء متغير جلسة عمل في التعليمة البرمجية المصدر، وتعيين قيمة له.

    على سبيل المثال، يضفي مثال ColdFusion هذا مزيدًا من التحديد على جلسة عمل تسمى username، ويعينها إلى القيمة Cornelius:

    <CFSET session.username = Cornelius>
  2. حدد Window > Bindings لعرض اللوحة Bindings.
  3. انقر فوق علامة الزائد (+)، وحدد Session Variable من القائمة المنبثقة.
  4. أدخل اسم المتغير الذي حددته في التعليمة البرمجية المصدر الخاصة بالتطبيق، ثم انقر فوق OK.

تحديد متغيرات التطبيق لـASP وColdFusion‎

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

ملاحظة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يسرد الجدول التالي متغيرات خادم 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. يظهر المتغير المحلي المحدد في اللوحة Bindings.

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

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

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

  1. افتح اللوحة Bindings (Window > Bindings).
  2. انقر فوق زر علامة الزائد (+)، وحدد Request Variable من القائمة المنبثقة.
  3. في مربع الحوار 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.

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

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

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

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

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

  1. افتح اللوحة Bindings (Window > Bindings).
  2. انقر فوق زر علامة الزائد (+)، وحدد المتغير من القائمة المنبثقة.
  3. في مربع الحوار Request Variable، أدخل اسم المتغير (على سبيل المثال، REQUEST_METHOD)، وانقر فوق OK.

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

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

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

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

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

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

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

    المتغير

    الوصف

    Client.CFID

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

    Client.CFTOKEN

    رقم مكوَّن عشوائيًا يستخدم لتحديد عميل معين بشكل فريد.

    Client.URLToken

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

    Client.LastVisit

    سجل الطابع الزمني لآخر زيارة لعميل ما.

    Client.HitCount

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

    Client.TimeCreated

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

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

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

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

يظهر متغير CGI المحدد في اللوحة Bindings.

  1. في مربع الحوار CGI Variable، أدخل اسم المتغير، وانقر فوق 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

    مسار افتراضي للبرنامج النصي الذي يجري تنفيذه؛ والمستخدَم لـعناوين 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. يمكن استخدامه للاستفادة من التخزين المؤقت لجانب المستعرض.

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

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

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

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

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

يمكنك تغيير أو حذف أي مصدر موجود لمحتوى ديناميكي—وهو، أي مصدر محتوى مسرود في اللوحة Bindings.

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

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

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

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

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

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

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

  1. حدد مجموعة السجلات إما في اللوحة Bindings أو اللوحة Server Behaviors.
  2. انقر بزر الماوس الأيمن فوق مجموعة السجلات، وحدد Copy من القائمة المنبثقة.
  3. افتح الصفحة التي تريد نسخ مجموعة السجلات إليها.
  4. انقر بزر الماوس الأيمن فوق اللوحة Bindings أو شريط الأدوات Server Behaviors، وحدد Paste من القائمة المنبثقة.

تم ترخيص هذا العمل بموجب الترخيص العام غير المعدل الخاص بالإسناد وعدم التجارة والمشاركة الإصدار 3.0 ‏من ‏‏Creative Commons‏‏  إن بنود Creative Commons لا تشمل منشورات Twitter™‎ وFacebook.

إشعارات قانونية   |   سياسة الخصوصية على الإنترنت