استخدام مكونات ColdFusion في Dreamweaver

تسمح لك ملفات مكون ColdFusion (CFC) بتغليف التطبيق ومنطق تسلسل العمل في وحدات ذاتية قابلة لإعادة الاستخدام. كما توفر ملفات CFC أيضًا طريقة سريعة وسهلة لإنشاء خدمات على الويب.

ملف CFC عبارة عن وحدة برمجية قابلة لإعادة الاستخدام مكتوبة بلغة تمييز ColdFusion (CFML)، مما يجعل من السهل إعادة استخدام التعليمات البرمجية والاحتفاظ بها.

يمكنك استخدام Dreamweaver للعمل مع ملفات CFC. لمزيد من المعلومات حول علامات CFC وبناء جملها، انظر وثائق ColdFusion من داخل Dreamweaver (Help > Using ColdFusion).

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

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

افترض قيام متجر على الإنترنت بحساب مصاريف الشحن بناءً على سعر الطلبات. بالنسبة إلى الطلبات التي تقل عن 20 دولارًا، تبلغ مصاريف الشحن 4 دولارات، وبالنسبة إلى الطلبات التي تتراوح بين 20 إلى 40 دولارًا، تبلغ مصاريف الشحن 6 دولارات، وما إلى ذلك. يمكنك إدراج منطق لحساب مصاريف الشحن في كل من صفحة عربة التسوق وصفحة السداد مع الخروج، ولكن يمكن أن يؤدي هذا إلى مزج التعليمات البرمجية للعرض التقديمي HTML والتعليمات البرمجية لمنطق CFML مما يجعل من الصعب بشكل عام الاحتفاظ بالتعليمات البرمجية وإعادة استخدامها.

لذا، قم بإنشاء ملف CFC يطلق عليه Pricing يحتوي، من بين عناصر أخرى، على دالة تسمى ShippingCharge. تقوم الدالة بالتعامل مع السعر على أساس أنه وسيطة وترجع مصاريف الشحن. على سبيل المثال، إذا كانت قيمة الوسيطة 32.80، فإن الدالة تنتج 6.

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

مؤخرًا، يعلن المتجر عن عرض ترويجي خاص: الشحن مجاني لجميع الطلبات التي تزيد عن 100 دولار. يمكنك بناءً على ذلك أن تقوم بتغيير أسعار الشحن في مكانٍ واحد - دالة ShippingCharge الخاصة بمكون Pricing - وستحصل جميع الصفحات المستخدمة للدالة على مصاريف شحن دقيقة بشكل تلقائي.

مقدمة عامة إلى لوحة Components ‏(ColdFusion)

يمكنك استخدام لوحة Components‏ (Window > Components) لعرض مكونات ColdFusion وتحريرها وإضافة تعليمات برمجية في الصفحة تستدعي الدالة عند طلب صفحة CFM.

إنشاء ملف CFC أو حذفه في Dreamweaver

يمكنك استخدام Dreamweaver لكي تحدد بشكل مرئي ملف CFC ودواله. يقوم Dreamweaver بإنشاء ملف .cfc وإدراج علامات CFML الضرورية بالنسبة إليك.

عرض ملفات CFC في Dreamweaver

يوفر Dreamweaver طريقة لإجراء فحص مرئي لمكونات ColdFusion (CFC) الموجودة في مجلد موقعك أو على الخادم بصفة كلية. يقرأ Dreamweaver ملفات CFC ويعرض معلومات عنها في عرض شجري سهل التنقل خلاله في لوحة Components.

يبحث Dreamweaver عن المكونات على خادم الاختبار لديك (راجع الاتصال بقاعدة البيانات في Dreamweaver). إذا قمت بإنشاء ملفات CFC أو إجراء تغييرات على ملفات CFC الموجودة، فتأكد من تحميل ملفات CFC إلى خادم الاختبار بحيث تنعكس بدقة في لوحة Components.

لعرض المكونات الموجودة على خادم آخر، قم بتغيير إعدادات خادم الاختبار.

يمكنك عرض أي من المعلومات التالية حول مكونات CF:

• قائمة بكل مكونات ColdFusion المعرفة على الخادم.

• إذا كنت تقوم بتشغيل ColdFusion MX 7 أو إصدار أحدث، قم بتصفية القائمة كي تعرض فقط ملفات CFC الموجودة في مجلد موقعك.

• استكشف الدوال والوسيطات الخاصة بكل مكون.

• افحص خصائص الدوال التي تعمل بمثابة خدمات الويب.

لعرض ملفات CFC في Dreamweaver، اتبع الخطوات التالية:

تحرير ملفات CFC في Dreamweaver

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

لاستخدام هذه الميزة، يجب أن يتم إعداد بيئة التطوير لديك على النحو التالي:

• يجب أن يعمل ColdFusion محليًا.

• في مربع الحوار Site Definition المتقدم في Dreamweaver، يجب أن يكون نوع Access المحدد في فئة 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 يعرض حزم المكونات على القرص الثابت لديك.

استخدم الإجراء التالي لتحرير المكونات.

إنشاء صفحات ويب تستخدم ملفات CFC

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

تحديد مجموعة سجلات في ملف CFC

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

استخدام مجموعة سجلات CFC بمثابة مصدر لمحتوى ديناميكي

يمكنك استخدام مكون ColdFusion(CFC) بمثابة مصدر لمحتوى ديناميكي على صفحاتك إذا كان المكون يحتوي على دالة تحدد مجموعة سجلات.

تحديد محتوى ديناميكي باستخدام CFC

يمكنك تحديد مجموعة سجلات بمثابة مصدر محتوى ديناميكي في Dreamweaver باستخدام ملف CFC يحتوي على تعريف مجموعة سجلات.

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

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

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

2.حدد حزمة من الحزم المعرفة بالفعل على الخادم.

إذا لم تظهر الحزمة في القائمة المنبثقة، يمكنك تحديث قائمة الحزم من خلال النقر فوق زر Refresh الموجود بالقرب من القائمة المنبثقة.

تأكد من تحميل مكونات CFC إلى خادم الاختبار أولاً. يتم عرض مكونات CFC فقط الموجودة على خادم الاختبار.

3.حدد مكونًا من المكونات المعرفة في الحزمة المحددة حاليًا.

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

4.(اختياري) لإنشاء مكون، انقر فوق الزر Create New Component.

أ.في مربع Name، أدخل اسمًا لمكون CFC الجديد. يجب أن يحتوي الاسم فقط على حروف أبجدية رقمية وشرطة سفلية (_).

ب.في مربع Component Directory، أدخل موقع مكون CFC لديك أو استعرض وصولاً إلى موقع المجلد.

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

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

6.قم بتحرير كل معلمة (النوع والقيمة والقيمة الافتراضية) يجب تمريرها بمثابة وسيطة دالة من خلال النقر فوق الزر Edit.

أ.أدخل قيمة للمعلمة الحالية من خلال تحديد نوع القيمة من القائمة المنبثقة Value وإدخال قيمة في المربع الموجود على اليمين. يمكن أن يكون نوع القيمة معلمة URL أو متغير نموذج أو ملف تعريف ارتباط أو متغير جلسة أو متغير تطبيق أو قيمة مدخلة.

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

ج.انقر فوق OK.

لا يمكنك تعديل اتصال قاعدة البيانات واستعلام SQL لمجموعة السجلات. تكون هذه الحقول معطلة دائمًا - إذ يتم عرض الاتصال واستعلام SQL لمعلوماتك فقط.

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

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

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

انقر فوق OK لمسح تحديد CFC Query.

8.انقر فوق OK.