استخدام أوامر ASP لتعديل قاعدة البيانات في Dreamweaver

تاريخ آخر تحديث 25‏/04‏/2024

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

ملاحظة

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

مقدمة عن كائنات أمر ASP

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

يمكن أن يكون كائن الأمر قابلاً لإعادة الاستخدام، بمعنى أن خادم التطبيق يمكنه إعادة استخدام نسخة مترجمة واحدة من الكائن لتنفيذ الأمر عدة مرات. تجعل الأمر قابلاً لإعادة الاستخدام بتعيين خاصية Prepared لكائن الأمر إلى true، كما في عبارة VBScript التالية:

mycommand.Prepared = true

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

ملاحظة

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

يتم إنشاء كائن الأمر بواسطة نصوص برمجية في صفحة ASP، لكن Dreamweaver يتيح لك إنشاء كائنات أوامر بدون كتابة سطر واحد من كود ASP.

استخدام أوامر ASP لتعديل قاعدة البيانات

يمكنك استخدام Dreamweaver لـ إنشاء كائنات أوامر ASP التي تدرج أو تحدث أو تحذف سجلات في قاعدة بيانات. تزود كائن الأمر بعبارة SQL أو الإجراء المخزن الذي ينفذ العملية على قاعدة البيانات.

في Dreamweaver، افتح صفحة ASP التي ستنفذ الأمر.
افتح لوحة Server Behaviors (Window > Server Behaviors)، وانقر على زر Plus (+)، وحدد Command.
أدخل اسماً للأمر، وحدد اتصالاً بـ قاعدة البيانات التي تحتوي على السجلات التي تريد تعديلها، وحدد عملية التعديل التي تريد من الأمر تنفيذها—Insert أو Update أو Delete.

يبدأ Dreamweaver عبارة SQL، استناداً إلى نوع العملية التي تحددها. على سبيل المثال، إذا حددت Insert، فإن مربع الحوار يبدو مثل المثال التالي:

إدخال الأمر ASP
إدخال الأمر ASP

أكمل عبارة SQL.

للحصول على معلومات حول كتابة عبارات SQL التي تعدل قواعد البيانات، راجع دليل Transact‑SQL.

استخدم مساحة Variables لتحديد أي متغيرات SQL. قدم الاسم والقيمة وقت التشغيل. تحديد نوع وحجم كل متغير يمنع هجمات الحقن.

المثال التالي يوضح عبارة Insert التي تحتوي على ثلاثة متغيرات SQL. يتم توفير قيم هذه المتغيرات بواسطة معاملات URL التي يتم تمريرها إلى الصفحة، كما هو محدد في عمود Run‑Time Value في منطقة Variables.

عبارة Insert تحتوي على ثلاثة متغيرات SQL.
عبارة Insert تحتوي على ثلاثة متغيرات SQL.

للحصول على قيمة Size، استخدم لوحة Databases في Dreamweaver.ابحث عن قاعدة بياناتك في لوحة قواعد البيانات ووسّعها.بعد ذلك، ابحث عن الجدول الذي تعمل عليه وقم بتوسيعه. يعرض الجدول قيم الحقول الخاصة بك. على سبيل المثال، قد يقول ADDRESS (WChar 50). في هذا المثال، 50 هو الحجم. يمكنك أيضاً العثور على الحجم في تطبيق قاعدة البيانات الخاص بك.

ملاحظة

أنواع البيانات الرقمية والمنطقية والتاريخ/الوقت تستخدم دائماً -1 كقيمة للحجم.

لتحديد قيمة النوع، راجع الجدول التالي:

الكتابة في قاعدة البيانات

الكتابة في Dreamweaver

Size

بيانات رقمية (MS Access, MS SQL Server, MySQL)

Double

-1

منطقي، نعم/لا (MS Access، MS SQL Server، MySQL)

Double

-1

التاريخ/الوقت (MS Access, MS SQL Server, MySQL)

DBTimeStamp

-1

جميع الأنواع الأخرى من حقول النص، بما في ذلك أنواع بيانات MySQL النصية char وvarchar وlongtext

LongVarChar

تحقق من جدول قاعدة البيانات

نص (MS Access) أو nvarchar، nchar (MS SQL Server)

VarWChar

تحقق من جدول قاعدة البيانات

مذكرة (MS Access)، ntext (MS SQL Server)، أو الحقول التي تدعم كميات كبيرة من النص

LongVarWChar

1073741823

لمزيد من المعلومات حول نوع وحجم متغيرات SQL، راجع www.adobe.com/go/4e6b330a.

أغلق مربع الحوار.

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

بشكل افتراضي، يضبط الكود خاصية Prepared لكائن Command على true، مما يجعل خادم التطبيق يعيد استخدام إصدار مترجم واحد من الكائن في كل مرة يتم تشغيل الأمر فيها. لتغيير هذا الإعداد، انتقل إلى عرض الكود وغيّر خاصية Prepared إلى false.

أنشئ صفحة بنموذج HTML حتى يتمكن المستخدمون من إدخال بيانات السجل. في نموذج HTML، أدرج ثلاثة حقول نص (txtCity، txtAddress، و txtPhone) وزر إرسال. يستخدم النموذج طريقة GET ويرسل قيم حقول النص إلى الصفحة التي تحتوي على أمرك.

مقدمة عن الأوامر المخزّنة

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

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

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

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

ملاحظة

قواعد البيانات MySQL و Microsoft Access لا تدعم الإجراءات المخزنة.

إضافة إجراء مخزن (ColdFusion) (CS6)

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

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

في Dreamweaver، افتح الصفحة التي ستُشغِّل الإجراء المخزن.
في لوحة Bindings (Window > Bindings)، انقر على الزر Plus (+)، ثم حدد Stored Procedure.
في قائمة Data Source المنبثقة، حدد اتصالاً بقاعدة البيانات التي تحتوي على الإجراء المخزن.
أدخل اسم مستخدم ColdFusion Data Source وكلمة المرور.
حدد إجراءً مخزناً من قائمة Procedures المنبثقة.

يقوم Dreamweaver تلقائياً بملء أي معاملات.

حدد معاملاً، وانقر على Edit إذا كنت بحاجة إلى إجراء تغييرات.

يظهر مربع الحوار Edit Stored Procedure Variable. يظهر اسم المتغير الذي تقوم بتحريره في مربع Name.

ملاحظة

يجب أن تدخل قيم اختبار لأي معاملات إدخال للإجراء المخزن.

قم بإجراء تغييرات وفقًا لما هو ضروري:
  • حدد Direction من القائمة المنبثقة. قد يحتوي الإجراء المخزن على قيم إدخال، أو قيم إخراج، أو كلاً من قيم الإدخال والإخراج.

  • حدد نوع SQL من القائمة المنبثقة. أدخل متغير إرجاع، وقيمة وقت التشغيل، وقيمة اختبار.

إذا كان الإجراء المخزن يأخذ معاملاً، انقر على زر Plus (+) لإضافة معامل صفحة.
ملاحظة

يجب أن تدخل معاملات صفحة مقابلة لكل قيمة إرجاع معامل الإجراء المخزن. لا تضف معاملات صفحة ما لم تكن هناك قيمة إرجاع مقابلة.

انقر فوق الزر Plus (+) مرة أخرى لإضافة معامل صفحة آخر، إذا لزم الأمر.

حدد معامل صفحة، وانقر على زر Minus (-) لحذف المعامل إذا لزم الأمر أو انقر على Edit لإجراء تغييرات على المعامل.
حدد خيار Returns Recordset Named، ثم أدخل اسماً لمجموعة السجلات؛ إذا كان الإجراء المخزن يرجع مجموعة سجلات، انقر على زر Test لرؤية مجموعة السجلات التي يرجعها الإجراء المخزن.

يشغل Dreamweaver الإجراء المخزن ويعرض مجموعة السجلات، إن وجدت.

ملاحظة

إذا كان الإجراء المخزن يرجع مجموعة سجلات ويأخذ معاملات، يجب أن تدخل قيمة في عمود Default Value في مربع Variables لاختبار الإجراء المخزن.

ملاحظة

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

حدد خيار Returns Status Code Named، وأدخل اسمًا لرمز الحالة، إذا كان الإجراء المخزن يُرجع قيمة إرجاع لرمز الحالة.انقر فوق OK.

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

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

تشغيل إجراء مخزن (ASP) (CS6)

مع صفحات ASP، يجب إضافة كائن أمر إلى صفحة لتشغيل إجراء مخزن.للمزيد من المعلومات حول كائنات الأوامر، راجع حول كائنات أوامر ASP.

في Dreamweaver، افتح الصفحة التي ستقوم بتشغيل الإجراء المخزن.
في لوحة Bindings (Window > Bindings)، انقر على زر Plus (+)، ثم حدد Command (Stored Procedure).

يظهر مربع الحوار Command.

أدخل اسمًا للأمر، وحدد اتصالاً بقاعدة البيانات التي تحتوي على الإجراء المخزن، ثم حدد Stored Procedure من القائمة المنبثقة Type.
حدد إجراءك المخزن عن طريق توسيع فرع Stored Procedures في مربع Database Items، وتحديد الإجراء المخزن من القائمة، والنقر على زر Procedure.
أدخل أي معلمات مطلوبة في جدول Variables.

لست في حاجة لإدخال أي معلمات لأي متغير RETURN_VALUE.

انقر فوق OK.

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

افتراضيًا، يضع الرمز خاصية Prepared لكائن Command على true، مما يجعل خادم التطبيق يُعيد استخدام نسخة مُجمعة واحدة من الكائن في كل مرة يتم تشغيل الإجراء المخزن.إذا كنت تعرف أن الأمر سيتم تنفيذه أكثر من بضع مرات، فإن وجود نسخة مجمعة واحدة من الكائن يمكن أن يحسن كفاءة عمليات قاعدة البيانات.ومع ذلك، إذا كان الأمر سيتم تنفيذه مرة أو مرتين فقط، فقد يؤدي استخدامه فعليًا إلى إبطاء تطبيق الويب الخاص بك لأن النظام يجب أن يتوقف مؤقتًا لتجميع الأمر.لتغيير الإعداد، انتقل إلى طريقة عرض Code وغيّر خاصية Prepared إلى false.

ملاحظة

ليس جميع موفري قواعد البيانات يدعمون الأوامر المُعدة مسبقًا.إذا كانت قاعدة بياناتك لا تدعم ذلك، قد تحصل على رسالة خطأ عند تشغيل الصفحة.انتقل إلى طريقة عرض Code وغيّر خاصية Prepared إلى false.

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