افتح صفحة ColdFusion في Dreamweaver.
تاريخ آخر تحديث
25 أبريل 2024
ملاحظة
تمت إزالة الدعم لـ ColdFusion في Dreamweaver والإصدارات الأحدث.
مقدمة إلى مكونات ColdFusion
ملفات مكونات ColdFusion (CFC) تتيح لك تغليف منطق التطبيق والأعمال في وحدات مستقلة وقابلة لإعادة الاستخدام.كما توفر CFCs طريقة سريعة وسهلة لإنشاء خدمات الويب.
CFC هو وحدة برمجية قابلة لإعادة الاستخدام مكتوبة بلغة ترميز ColdFusion (CFML)، مما يجعل من السهل إعادة استخدام وصيانة الكود الخاص بك.
يمكنك استخدام Dreamweaver للعمل مع ملفات CFC. للحصول على معلومات حول علامات وبناء جملة CFC، راجع وثائق ColdFusion من داخل Dreamweaver (مساعدة > استخدام ColdFusion).
ملاحظة
يمكنك استخدام ملفات CFC فقط مع إصدار ColdFusion MX والإصدارات الأحدث. CFCs غير مدعومة في ColdFusion 5.
CFCs مخصصة لتوفير طريقة بسيطة وقوية للمطورين لتغليف عناصر مواقعهم الإلكترونية.بشكل عام، يجب استخدام المكونات لمنطق التطبيق أو الأعمال.استخدم العلامات المخصصة لعناصر العرض مثل التحيات المخصصة والقوائم الديناميكية وما إلى ذلك.
كما هو الحال مع العديد من أنواع البناء الأخرى، يمكن للمواقع الديناميكية أن تستفيد غالباً من الأجزاء القابلة للتبديل.على سبيل المثال، قد يشغل الموقع الديناميكي نفس الاستعلام بشكل متكرر، أو يحسب السعر الإجمالي لصفحات عربة التسوق ويعيد حسابه في كل مرة يتم إضافة عنصر فيها.يمكن للمكونات معالجة مثل هذه المهام. يمكنك إصلاح وتحسين وتوسيع وحتى استبدال مكون بأقل تأثير على باقي التطبيق الخاص بك.
لنفترض أن متجراً إلكترونياً يحسب رسوم الشحن استناداً إلى سعر الطلبات.للطلبات التي تقل عن 20 دولاراً أمريكياً، رسوم الشحن 4 دولارات أمريكية؛ وللطلبات بين 20 و40 دولاراً أمريكياً، رسوم الشحن 6 دولارات أمريكية، وهكذا.يمكنك إدراج منطق حساب رسوم الشحن في كل من صفحة عربة التسوق وصفحة الدفع، لكن ذلك سيخلط كود عرض HTML وكود منطق CFML ويجعل الكود صعب الصيانة وإعادة الاستخدام بشكل عام.
تقرر إنشاء CFC يسمى Pricing يحتوي، من بين أشياء أخرى، على دالة تسمى ShippingCharge.الدالة تأخذ سعراً كمعامل وترجع رسوم شحن.على سبيل المثال، إذا كانت قيمة المعامل 32.80، تُرجع الدالة 6.
في كل من صفحة عربة التسوق وصفحة الدفع، تُدرج علامة خاصة لاستدعاء دالة ShippingCharge. عندما يتم طلب الصفحة، يتم استدعاء الدالة وإرجاع رسوم شحن إلى الصفحة.
لاحقاً، يعلن المتجر عن عرض ترويجي خاص: شحن مجاني لجميع الطلبات التي تزيد عن 100 دولار أمريكي.تقوم بإجراء التغيير على أسعار الشحن في مكان واحد—دالة ShippingCharge في مكون Pricing—وجميع الصفحات التي تستخدم الدالة تحصل تلقائياً على رسوم شحن دقيقة.
مقدمة عامة إلى لوحة Components (ColdFusion)
استخدم لوحة المكونات (نافذة > مكونات) لعرض وتعديل مكونات ColdFusion، وإضافة كود في الصفحة التي تستدعي الدالة عندما يتم طلب صفحة CFM.
ملاحظة
لوحة المكونات متاحة فقط عند عرض صفحة ColdFusion في Dreamweaver.
إنشاء ملف CFC أو حذفه في Dreamweaver
يمكنك استخدام Dreamweaver لكي تحدد بشكل مرئي ملف CFC ودواله. يُنشئ Dreamweaver ملف .cfc ويُدرج علامات CFML الضرورية لك.
ملاحظة
بناءً على المكون، قد تضطر لإكمال بعض التعليمات البرمجية بنفسك.
في لوحة المكونات (Window > Components)، حدد CF Components من القائمة المنبثقة.
انقر فوق زر علامة الجمع (+)، واملأ مربع الحوار Create Components، وانقر فوق OK.
أ.في قسم Components، أدخل التفاصيل الخاصة بالمكون. فيما يلي قائمة جزئية:
Name يحدد اسم ملف المكون. يجب أن يحتوي الاسم فقط على حروف أبجدية رقمية وشرطة سفلية (_). لا تحدد امتداد الملف .cfc عند إدخال الاسم.
Component Directory يحدد مكان حفظ المكون. حدد مجلد الجذر لتطبيق الويب (مثل \Inetpub\wwwroot\myapp\) أو أي من مجلداته الفرعية.
ب. لتعريف وظيفة واحدة أو أكثر للمكون، حدد Functions من قائمة Section، وانقر فوق زر علامة الجمع (+)، وأدخل تفاصيل الوظيفة الجديدة.
تأكد من تحديد نوع القيمة التي ترجعها الدالة في خيار Return Type.
ملاحظة
إذا قمت بتحديد remote من قائمة Access، فإن الدالة تصبح متوفرة بمثابة خدمة ويب.
ج. لتعريف معامل واحد أو أكثر لوظيفة، حدد Arguments من قائمة Section، وحدد الوظيفة من القائمة المنبثقة، وانقر فوق زر علامة الجمع (+)، وأدخل تفاصيل المعامل الجديد على اليمين.
إذا كنت تستخدم خادم تطوير بعيد، ارفع ملف CFC وأي ملفات تابعة (مثل تلك المستخدمة لتنفيذ وظيفة أو تضمين الملفات) إلى الخادم البعيد.
رفع الملفات يضمن أن ميزات Dreamweaver مثل Live view وPreview In Browser تعمل بشكل صحيح.
يكتب Dreamweaver ملف CFC ويحفظه في المجلد الذي حددته. يظهر المكون الجديد أيضًا في لوحة المكونات (بعد النقر على Refresh).
إذا كنت تستخدم خادم تطوير بعيد، ارفع ملف CFC وأي ملفات تابعة (مثل تلك المستخدمة لتنفيذ وظيفة أو تضمين الملفات) إلى الخادم البعيد.
عرض ملفات CFC في Dreamweaver
يوفر Dreamweaver طريقة لإجراء فحص مرئي لمكونات ColdFusion (CFC) الموجودة في مجلد موقعك أو على الخادم بصفة كلية. يقرأ Dreamweaver ملفات CFC ويعرض معلومات حولها في عرض شجرة سهل التصفح في لوحة المكونات.
يبحث Dreamweaver عن المكونات على خادم الاختبار الخاص بك (راجع الاتصال بقاعدة البيانات في Dreamweaver). إذا قمت بإنشاء ملفات CFC أو إجراء تغييرات على ملفات CFC الموجودة، فتأكد من تحميل ملفات CFC إلى خادم الاختبار بحيث تنعكس بدقة في لوحة Components.
لعرض المكونات الموجودة على خادم آخر، قم بتغيير إعدادات خادم الاختبار.
يمكنك عرض أي من المعلومات التالية حول مكونات CF:
قائمة بكل مكونات ColdFusion المعرفة على الخادم.
إذا كنت تقوم بتشغيل ColdFusion MX 7 أو إصدار أحدث، قم بتصفية القائمة كي تعرض فقط ملفات CFC الموجودة في مجلد موقعك.
استكشف الدوال والوسيطات الخاصة بكل مكون.
افحص خصائص الدوال التي تعمل بمثابة خدمات الويب.
ملاحظة
لاستخدام Dreamweaver بهدف فحص ملفات CFC الموجودة في مجلد الخادم أثناء إدارة ملفات موقعك أيضًا في جذر موقع ويب مختلف، يمكنك تحديد موقعي Dreamweaver. عين الموقع الأول الذي يشير إلى جذر الخادم والموقع الثاني الذي يشير إلى جذر موقع الويب. استخدم قائمة الموقع المنبثقة على لوحة Files للتبديل سريعًا بين الموقعين.
لعرض ملفات CFC في Dreamweaver، اتبع الخطوات التالية:
افتح أي من صفحات ColdFusion في Dreamweaver.
في لوحة المكونات (Window > Components)،
حدد CF Components من القائمة المنبثقة.
انقر فوق زر Refresh في اللوحة لاسترداد
المكونات.
يتم عرض حزمة المكونات على الخادم. حزمة المكونات هي مجلد يحتوي على ملفات CFC.
إذا لم تظهر حزم المكونات الموجودة، انقر فوق زر Refresh في شريط الأدوات الخاص باللوحة.
لعرض ملفات CFC الموجودة في مجلد موقعك فقط،
انقر فوق زر Show Only Current Site's CFCs في شريط الأدوات
الخاص بلوحة المكونات.
ملاحظة
هذه الميزة متوفرة فقط إذا كنت قد عرّفت جهاز كمبيوتر يشغل ColdFusion MX 6 أو أحدث كخادم اختبار لـ Dreamweaver.
ملاحظة
إذا كان الموقع الحالي مدرجًا في مجلد افتراضي على الخادم البعيد، فإن التصفية لا تعمل.
انقر فوق زر علامة الجمع (+) بجوار اسم الحزمة
لعرض المكونات المحفوظة في الحزمة.
لإدراج وظائف مكون، انقر فوق زر علامة الجمع (+) بجوار اسم المكون.
لرؤية المعاملات التي تأخذها الوظيفة، بالإضافة إلى نوع المعاملات وما إذا كانت مطلوبة أو اختيارية، افتح فرع الوظيفة في عرض الشجرة.
الوظائف التي لا تأخذ معاملات لا تحتوي على زر علامة الجمع (+) بجوارها.
لعرض تفاصيل معامل أو وظيفة أو مكون أو حزمة بسرعة، حدد العنصر في عرض الشجرة، و انقر فوق زر Get Details في شريط الأدوات الخاص باللوحة.
يمكنك أيضًا النقر بزر الماوس الأيمن (Windows) أو Control-النقر (Macintosh) على العنصر وتحديد Get Details من القائمة المنبثقة.
تُعرض تفاصيل العنصر في مربع رسالة.
تحرير ملفات CFC في Dreamweaver
يوفر Dreamweaver طريقة مبسطة لتحرير كود مكونات ColdFusion المحددة لموقعك.على سبيل المثال، يمكنك إضافة أو تغيير أو حذف أي وظيفة مكون دون ترك Dreamweaver.
لاستخدام هذه الميزة، يجب إعداد بيئة التطوير الخاصة بك كما يلي:
يجب أن يعمل ColdFusion محليًا.
في مربع حوار Site Definition المتقدم في Dreamweaver، يجب أن يكون نوع الوصول المحدد في فئة Testing Server هو Local/Network.
في مربع حوار Site Definition المتقدم، يجب أن يكون مسار المجلد الجذر المحلي نفس مسار مجلد خادم الاختبار (على سبيل المثال، c:\Inetpub\wwwroot\cf_projects\myNewApp\). يمكنك فحص وتغيير هذه المسارات بتحديد Site > Edit Sites.
يجب تخزين المكون في مجلد الموقع المحلي أو أي من مجلداته الفرعية على القرص الصلب.
افتح أي صفحة ColdFusion في Dreamweaver واعرض المكونات في لوحة Components.لعرض المكونات، افتح لوحة Components (Window > Components)، حدد CF Components من القائمة المنبثقة للوحة، وانقر على زر Refresh في اللوحة.
نظراً لأن ColdFusion يعمل محلياً، يعرض Dreamweaver حزم المكونات الموجودة على القرص الصلب.
استخدم الإجراء التالي لتحرير المكونات.
افتح أي صفحة ColdFusion في Dreamweaver واعرض المكونات في لوحة المكونات (Window > Components).
حدد CF Components من القائمة المنبثقة للوحة، و
انقر على زر Refresh في اللوحة.
نظراً لأن ColdFusion يعمل محلياً، يعرض Dreamweaver حزم المكونات الموجودة على القرص الصلب.
ملاحظة
لتحرير مجموعة سجلات CFC بصرياً، انقر نقراً مزدوجاً عليها في لوحة Bindings.
لتحرير ملف مكون بشكل عام، افتح الحزمة
وانقر نقراً مزدوجاً على اسم المكون في عرض الشجرة.
يتم فتح ملف المكون في عرض Code.
لتحرير وظيفة أو وسيطة أو خاصية محددة، انقر نقراً مزدوجاً
على العنصر في عرض الشجرة.
قم بإجراء التغييرات يدويًا في عرض Code.
احفظ الملف (File > Save).
لرؤية أي وظيفة جديدة في لوحة Components، حدث
العرض بالنقر على زر Refresh في شريط الأدوات للوحة.
إنشاء صفحات ويب تستخدم ملفات CFC
من بين إحدى طرق استخدام دالة مكون في صفحات الويب لديك كتابة التعليمات البرمجية في الصفحة التي تستدعي الدالة عند طلب الصفحة. يمكنك استخدام Dreamweaver لمساعدتك في كتابة هذا الكود.
ملاحظة
للطرق الأخرى لاستخدام المكونات، راجع وثائق ColdFusion من داخل Dreamweaver (Help > Using ColdFusion).
في Dreamweaver، افتح
صفحة ColdFusion التي ستستخدم وظيفة المكون.
التبديل إلى عرض Code (View > Code)
افتح لوحة Components (Window > Components)،
وحدد CF Components من القائمة المنبثقة للوحة.
ابحث عن المكون الذي تريده وأدرجه باستخدام إحدى
التقنيات التالية:
اسحب وظيفة من عرض الشجرة إلى الصفحة.يتم إدراج تعليمات برمجية في الصفحة لاستدعاء الدالة.
حدد الدالة في اللوحة وانقر على زر الإدراج في شريط أدوات اللوحة (الزر الثاني على اليمين).يُدرج Dreamweaver الكود في الصفحة عند نقطة الإدراج.
إذا قمت بإدراج دالة تحتوي على وسائط، أكمل
كود الوسيطة يدوياً.
لمزيد من المعلومات، راجع وثائق ColdFusion من داخل Dreamweaver (مساعدة > استخدام ColdFusion).
حفظ الصفحة (ملف > حفظ).
تحديد مجموعة سجلات في ملف CFC
يمكن أن يساعدك Dreamweaver في تحديد مجموعة سجلات (معروفة أيضًا باسم استعلام ColdFusion) في مكون ColdFusion (CFC). من خلال تحديد مجموعة سجلات في مكون CFC، لست مضطرًا لتحديد مجموعة السجلات على كل صفحة تستخدمها. إذ تقوم بتحديد مجموعة السجلات مرةً واحدة في مكون CFC وتستخدم هذا المكون على صفحات مختلفة.
ملاحظة
تكون هذه السمة متوفرة فقط إذا كان لديك وصول إلى كمبيوتر يستخدم نظام التشغيل ColdFusion MX 7 أو إصدار أحدث. لمزيدٍ من المعلومات، انظر تمكين تحسينات ColdFusion.
افتح ملف CFC موجود أو قم بإنشاء واحد في Dreamweaver.
في لوحة الربطات (نافذة > ربطات)،
انقر على زر الجمع (+) وحدد مجموعة السجلات (استعلام) من
القائمة المنبثقة.
يظهر مربع الحوار Recordset. يمكنك العمل في مربعات الحوار البسيطة أو المتقدمة لمجموعة السجلات.
لاستخدام دالة موجودة في CFC، حدد الدالة
من القائمة المنبثقة للدالة وانتقل إلى الخطوة 5.
يتم تعريف مجموعة السجلات في الدالة.
لتعريف دالة جديدة في CFC، انقر على زر الدالة الجديدة، أدخل اسماً للدالة في مربع الحوار الذي يظهر، ثم انقر على موافق.
يجب أن يحتوي الاسم على أحرف أبجدية رقمية وشرطات سفلية (_) فقط.
لتعريف مجموعة سجلات للدالة، أكمل
خيارات مربع الحوار لمجموعة السجلات.
يتم إدراج الدالة الجديدة في CFC التي تعرّف مجموعة السجلات.
استخدم مجموعة سجلات CFC كمصدر للمحتوى الديناميكي
يمكنك استخدام مكون ColdFusion(CFC) بمثابة مصدر لمحتوى ديناميكي على صفحاتك إذا كان المكون يحتوي على دالة تحدد مجموعة سجلات.
ملاحظة
تكون هذه السمة متوفرة فقط إذا كان لديك وصول إلى كمبيوتر يستخدم نظام التشغيل ColdFusion MX 7 أو إصدار أحدث. لمزيدٍ من المعلومات، انظر تمكين تحسينات ColdFusion.
افتح أي من صفحات ColdFusion في Dreamweaver.
في لوحة Bindings (نافذة > Bindings)،
انقر فوق الزر Plus (+) وحدد Recordset (Query) من
القائمة المنبثقة.
يظهر مربع الحوار Recordset. يمكنك العمل في مربع حوار Recordset البسيط أو المتقدم.
انقر فوق الزر CFC Query.
أكمل مربع حوار CFC query، وانقر فوق موافق، ثم
انقر فوق موافق مرة أخرى لإضافة CFC recordset إلى قائمة
مصادر المحتوى المتاحة في لوحة Bindings.
استخدم لوحة Bindings لربط recordset بعناصر
الصفحة المختلفة.
للحصول على مزيد من المعلومات، راجع إضافة محتوى ديناميكي إلى الصفحات.
تعريف محتوى ديناميكي باستخدام CFC
يمكنك تعريف recordset كمصدر للمحتوى الديناميكي في Dreamweaver باستخدام CFC يحتوي على تعريف recordset.
1.في مربع الاسم، أدخل اسماً لـ CFC recordset.
من الممارسات الشائعة إضافة البادئة rs إلى أسماء recordset لتمييزها عن أسماء الكائنات الأخرى في الكود، على سبيل المثال: rsPressRelease.
يجب أن تحتوي أسماء مجموعة السجلات فقط على حروف أبجدية رقمية وشرطة سفلية (_). لا يمكنك استخدام حروف خاصة أو مسافات.
2.حدد حزمة من الحزم المحددة مسبقاً على الخادم.
إذا لم تظهر الحزمة في القائمة المنبثقة، يمكنك تحديث قائمة الحزم من خلال النقر فوق زر Refresh الموجود بالقرب من القائمة المنبثقة.
تأكد من تحميل مكونات CFC إلى خادم الاختبار أولاً. يتم عرض مكونات CFC فقط الموجودة على خادم الاختبار.
3.حدد مكوناً من المكونات المحددة في الحزمة المحددة حالياً.
إذا لم تكن القائمة المنبثقة Component تحتوي على أي مكونات، أو في حالة عدم ظهور أي من المكونات المنشأة مسبقًا في القائمة، فإنه يجب أن تحمل ملفات CFC إلى خادم الاختبار.
4.(اختياري) لإنشاء مكون، انقر فوق زر إنشاء مكون جديد.
أ.في مربع Name، أدخل اسمًا لمكون CFC الجديد. يجب أن يحتوي الاسم فقط على حروف أبجدية رقمية وشرطة سفلية (_).
ب.في مربع دليل المكون، أدخل الموقع لـ CFC الخاص بك، أو تصفح لتحديد موقع المجلد.
ملاحظة
يجب أن يكون المجلد المسار النسبي إلى مجلد جذر الموقع.
5.من القائمة المنبثقة Function، حدد الوظيفة التي تحتوي على تعريف مجموعة السجلات.
تحتوي القائمة المنبثقة Function فقط على الدوال المعرفة في المكون المحدد حاليًا. في حالة عدم ظهور أي دوال في هذه القائمة المنبثقة، أو إذا لم تنعكس التغييرات الأخيرة التي قمت بها في الدوال المسرودة حاليًا، تأكد من أنه قد تم حفظ هذه التغييرات وتحميلها إلى الخادم.
ملاحظة
يكون مربعا Connection و SQL للقراءة فقط.
6.عدّل كل معامل (النوع والقيمة والقيمة الافتراضية) الذي يجب تمريره كوسيطة وظيفة عن طريق النقر على زر Edit.
أ.أدخل قيمة للمعلمة الحالية من خلال تحديد نوع القيمة من القائمة المنبثقة Value وإدخال قيمة في المربع الموجود على اليمين. يمكن أن يكون نوع القيمة معلمة URL أو متغير نموذج أو ملف تعريف ارتباط أو متغير جلسة أو متغير تطبيق أو قيمة مدخلة.
ب.أدخل قيمة افتراضية للمعلمة في مربع Default Value. في حالة عدم إرجاع قيمة وقت التشغيل، فإنه يتم استخدام قيمة المعلمة الافتراضية.
c.انقر فوق OK.
لا يمكنك تعديل اتصال قاعدة البيانات واستعلام SQL لمجموعة السجلات. تكون هذه الحقول معطلة دائمًا - إذ يتم عرض الاتصال واستعلام SQL لمعلوماتك فقط.
7.انقر فوق Test للاتصال بقاعدة البيانات وإنشاء مثيل من مجموعة السجلات.
إذا كانت عبارة SQL تحتوي على معلمات صفحة، فتأكد من احتواء عمود Default Value في مربع Parameters على قيم اختبار صالحة قبل النقر فوق Test.
إذا تم تنفيذ الاستعلام بنجاح، يعرض الجدول مجموعة السجلات. يحتوي كل صف على سجل ويمثل كل عمود حقلاً في ذلك السجل.
انقر فوق OK لمسح تحديد CFC Query.
8. انقر فوق موافق.
قم بإنشاء مواقع ويب جميلة في Dreamweaver
قم بتصميم مواقع الويب الديناميكية وبرمجتها وإدارتها في أداة قوية متكاملة.
