دليل المستخدم إلغاء

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

 

 

ملاحظة:

تمت إزالة دعم ColdFusion في Dreamweaver CC والإصدارات اللاحقة.

مقدمة إلى مكونات ColdFusion

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

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

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

ملاحظة:

يمكنك استخدام ملفات CFC فقط مع إصدار ColdFusion MX والإصدارات الأحدث. لا يتوفر دعم لملفات CFC في ColdFusion 5.

يتمثل الهدف من ملفات 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.

ملاحظة:

تكون لوحة Components متوفرة فقط عند عرض صفحة ColdFusion في Dreamweaver.

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

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

ملاحظة:

بناءً على المكون، قد تضطر لإكمال بعض التعليمات البرمجية بنفسك.

  1. افتح أي من صفحات ColdFusion في Dreamweaver.

  2. في لوحة Components (Window > Components)، حدد CF Components من القائمة المنبثقة.

  3. انقر فوق زر الإضافة (+) وأكمل خطوات مربع الحوار Create Components وانقر فوق OK.

    أ.في قسم Components، أدخل التفاصيل الخاصة بالمكون. فيما يلي قائمة جزئية:

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

    Component Directory  يحدد مكان حفظ المكون. حدد مجلد الجذر لتطبيق الويب (مثل \Inetpub\wwwroot\myapp\) أو أي من مجلداته الفرعية.  

    ب.لتحديد دالة أو أكثر للمكون، حدد Functions من قائمة Section، وانقر فوق زر الإضافة (+) وأدخل تفاصيل الدالة الجديدة.

    تأكد من تحديد نوع القيمة التي ترجعها الدالة في خيار Return Type.

    ملاحظة:

    إذا قمت بتحديد remote من قائمة Access، فإن الدالة تصبح متوفرة بمثابة خدمة ويب.

    ج.لتحديد وسيطة أو أكثر للدالة، حدد Arguments من قائمة Section وحدد الدالة من القائمة المنبثقة ثم انقر فوق زر الإضافة (+) وأدخل تفاصيل الوسيطة الجديدة على اليمين.

  4. إذا كنت تستخدم خادم تطوير بعيد، قم بتحميل ملف CFC وأي ملفات تابعة (مثل تلك الملفات المستخدمة لتنفيذ دالة أو تضمين ملفات) إلى الخادم البعيد.

    فتحميل الملفات يضمن عمل ميزات Dreamweaver مثل عرض Live وPreview In Browser بشكل سليم.

    يكتب Dreamweaver ملف CFC ويحفظه في المجلد الذي قمت بتحديده. كما يظهر المكون الجديد أيضًا في لوحة Components (بعد النقر فوق Refresh).

  5. إذا كنت تستخدم خادم تطوير بعيد، قم بتحميل ملف CFC وأي ملفات تابعة (مثل تلك الملفات المستخدمة لتنفيذ دالة أو تضمين ملفات) إلى الخادم البعيد.

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

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

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

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

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

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

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

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

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

ملاحظة:

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

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

  1. افتح أي من صفحات ColdFusion في Dreamweaver.
  2. في لوحة Components (Window > Components)، حدد CF Components من القائمة المنبثقة.
  3. انقر فوق زر Refresh في اللوحة لاسترداد المكونات.

    يتم عرض حزمة المكونات على الخادم. حزمة المكونات عبارة عن مجلد يحتوي على ملفات CFC.

    إذا لم تظهر حزم المكونات الموجودة، انقر فوق زر Refresh في شريط أدوات اللوحة.

  4. لعرض ملفات CFC فقط الموجودة في مجلد موقعك، انقر فوق زر Show Only Current Site's CFCs في شريط أدوات لوحة Components.
    ملاحظة:

    تكون هذه الميزة متوفرة فقط إذا قمت بتعريف كمبيوتر يقوم بتشغيل ColdFusion MX 6 أو إصدار أحدث بمثابة خادم اختبار لـ. Dreamweaver

    ملاحظة:

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

  5. انقر فوق زر الإضافة (+) الموجود بجانب اسم الحزمة لعرض المكونات المخزنة في الحزمة.
    • لسرد دوال المكون، انقر فوق زر الإضافة (+) الموجود بجانب اسم المكون.

    • لرؤية الوسيطات التي تأخذها الدالة، بالإضافة إلى عرض نوعها وما إذا كانت مطلوبة أم اختيارية، افتح تفرع الدالة في عرض الشجرة.

      لا يوجد زر الإضافة (+) بجانب الدوال التي لا تأخذ وسيطات.

    • لعرض تفاصيل وسيطة أو دالة أو مكون أو حزمة بشكل سريع، حدد العنصر في عرض الشجرة وانقر فوق زر Get Details في شريط أدوات اللوحة.

      يمكنك أيضًا النقر بزر الماوس الأيمن (Windows) أو الضغط على Control - النقر بالماوس (Macintosh) فوق العنصر وتحديد Get Details من القائمة المنبثقة.

      يتم عرض التفاصيل الخاصة بالعنصر في مربع رسالة.

تحرير ملفات 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 يعرض حزم المكونات على القرص الثابت لديك.

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

  1. افتح أي من صفحات ColdFusion في Dreamweaver واعرض المكونات في لوحة Components (Window > Components).
  2. حدد CF Components من القائمة المنبثقة للوحة وانقر فوق زر Refresh على اللوحة.

    بما أن ColdFusion يعمل محليًا، فإن Dreamweaver يعرض حزم المكونات على القرص الثابت لديك.

    ملاحظة:

    لتحرير مجموعة سجلات CFC مرئيًا، انقر نقرًا مزدوجًا فوقها في لوحة Bindings.

  3. لتحرير ملف مكون بصفة عامة، افتح الحزمة وانقر نقرًا مزدوجًا فوق اسم المكون في عرض الشجرة.

    يتم فتح ملف المكون في عرض Code.

  4. لتحرير دالة أو وسيطة أو خاصية معينة، انقر نقرًا مزدوجًا فوقها في عرض الشجرة.
  5. قم بإجراء التغييرات يدويًا في عرض Code.
  6. احفظ الملف (File > Save).
  7. لرؤية أي دالة جديدة في لوحة Components، قم بتحديث العرض من خلال النقر فوق زر Refresh على شريط أدوات اللوحة.

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

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

ملاحظة:

للتعرف على طرق أخرى لاستخدام المكونات، انظر وثائق ColdFusion من داخل Dreamweaver (Help > Using ColdFusion).

  1. في Dreamweaver، افتح صفحة ColdFusion التي ستستخدم دالة المكون.
  2. التبديل إلى عرض Code (View > Code)
  3. افتح لوحة Components (Window > Components) وحدد CF Components من القائمة المنبثقة للوحة.
  4. ابحث عن المكون الذي تريده وأدرجه باستخدام إحدى التقنيات التالية:
    • اسحب دالة من عرض الشجرة إلى الصفحة. يتم إدراج تعليمات برمجية في الصفحة لاستدعاء الدالة.

    • حدد الدالة في اللوحة وانقر فوق زر Insert على شريط أدوات اللوحة (الزر الثاني على اليمين). يدرج Dreamweaver التعليمات البرمجية في الصفحة عند نقطة الإدراج.

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

    لمزيد من المعلومات، انظر وثائق ColdFusion من داخل Dreamweaver (Help > Using ColdFusion).

  6. احفظ الصفحة (File > Save).

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

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

ملاحظة:

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

 

  1. افتح ملف CFC موجود أو قم بإنشاء واحد في Dreamweaver.
  2. في لوحة Bindings (Window > Bindings)، انقر فوق زر الإضافة (+) وحدد Recordset (Query) من القائمة المنبثقة.

    يظهر مربع الحوار Recordset. يمكنك العمل في مربع الحوار Recordset البسيط أو المتقدم.

  3. لاستخدام الدالة الحالية في ملف CFC، حدد الدالة من القائمة المنبثقة Function وانتقل إلى الخطوة 5.

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

  4. لتحديد دالة جديدة في ملف CFC، انقر فوق الزر New Function وأدخل اسمًا للدالة في مربع الحوار الذي يظهر ثم انقر فوق OK.

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

  5. لتحديد مجموعة سجلات للدالة، أكمل خيارات مربع الحوار Recordset.

    يتم إدراج الدالة الجديدة في ملف CFC الذي يحدد مجموعة السجلات.

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

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

ملاحظة:

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

  1. افتح أي من صفحات ColdFusion في Dreamweaver.
  2. في لوحة Bindings (Window > Bindings)، انقر فوق زر الإضافة (+) وحدد Recordset (Query) من القائمة المنبثقة.

    يظهر مربع الحوار Recordset. يمكنك العمل في مربع الحوار Recordset البسيط أو المتقدم.

  3. انقر فوق الزر CFC Query.
  4. أكمل مربع الحوار CFC query وانقر فوق OK ثم انقر فوق OK مرةً أخرى لإضافة مجموعة سجلات CFC إلى قائمة مصادر المحتوى المتوفرة في لوحة Bindings.
  5. استخدم لوحة Bindings لربط مجموعة السجلات بعناصر صفحة متنوعة.

    لمزيد من المعلومات، راجع إضافة محتوى ديناميكي إلى الصفحات.

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

ملاحظة:

يكون مربعا Connection و SQL للقراءة فقط.

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

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

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

ج.انقر فوق OK.

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

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

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

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

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

8.انقر فوق OK.

احصل على مساعدة بشكل أسرع وأسهل

مستخدم جديد؟