31 تكوين العنصر

تعليمات WebCenter Sites

يُستخدم نموذج "العنصر" (CS Element) في تكوين عنصر CSElement وتعريف نوع ملف العنصر (XML أو JSP أو HTML) وتوفير منطق العنصر وتسمية العنصر. على سبيل المثال:

• يعرض الحقل تكوين عنصر الاختيار من بين أنواع الملفات XML أو JSP أو HTML لمنطق العنصر، ويُستخدم في تزويد حقل "منطق العنصر" بتعليمة برمجية قياسية للبرنامج الفرعي (التي يجب أن تضمنها في أي عنصر تقوم بتكوينه).

• عند استخدام الحقل تكوين عنصر لتكوين، على سبيل المثال، ملف .jsp، يضيف WebCenter Sites جمل taglib الخاصة بصفحة JSP وعلامة render.logdep إلى حقل منطق العنصر بصورة افتراضية لكي يتم تسجيل التبعية التركيبية بين الأصل CSElement هذا والصفحات التي يتم تصييرها من هذا العنصر. أما فيما يتعلق بأنواع الملفات الأخرى، يضيف WebCenter Sites تعليمة برمجية خاصة بنوع الملف. وأنت تضيف التعليمات البرمجية الخاصة بك إلى الحقل منطق العنصر.

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

• يسمّي الحقل مسار/اسم ملف تخزين العناصر الملف الذي يشتمل على منطق العنصر ويحدد المسار إلى الملف.

عند حفظ CSElement، تتم كتابة قيم الحقول الموجودة بشاشة "العنصر" في صف (يمثل العنصر) في جدول ElementCatalog.

ملاحظة:

حول تحديد عنصر موجود

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

لتحديد عنصر موجود

• (اختياري). في حقل وصف كتالوج العناصر ElementCatalog، اكتب وصفًا للعنصر.

• في حقل مسار/اسم ملف تخزين العناصر، أدخل قيمة وفقًا للاصطلاح الوارد في تسمية CSElement.

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

• احفظ أصل CSElement وأعد فتحه.

يبحث WebCenter Sites عن وجود عنصر بالاسم الصحيح:

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

إذا كان العنصر المسمى غير موجود (أو تمت تسميته بصورة غير صحيحة)، لا يفعل WebCenter Sites. وعند فحص أصل CSElement أو تحريره، يعرض WebCenter Sites رسالة تشير إلى عدم وجود عنصر أولي في النموذج. وبمجرد أن تنتهي من برمجة العنصر ومنحه الاسم الصحيح، فإن نظام WebCenter Sites يكتشفه ويقرنه بأصل CSElement.

لتكوين عنصر جديد، أكمل الحقول في نموذج عنصر CSElement.

1. في الحقل تكوين عنصر، نفّذ أحد الخيارات التالية:

   • لتكوين ملف .xml، انقر على XML. مصدر التعليمة البرمجية التي يتم لصقها هو العنصر OpenMarket\Xcelerate\AssetType\CSElement\modelXML.xml ويمكن تعديلها لاستخدام منطق افتراضي مخصص.

   • لتكوين ملف .jsp، انقر على JSP. مصدر التعليمة البرمجية التي يتم لصقها هو العنصر OpenMarket\Xcelerate\AssetType\CSElement\modelJSP.xml ويمكن تعديلها لاستخدام منطق افتراضي مخصص.

   • لتكوين ملف .html، انقر على HTML. مصدر التعليمة البرمجية التي يتم لصقها هو العنصر OpenMarket\Xcelerate\AssetType\CSElement\modelHTML.xml ويمكن تعديلها لاستخدام منطق افتراضي مخصص.

   يقوم نظام WebCenter Sites بملء الحقول التالية:

   • الحقل مسار/اسم ملف تخزين العناصر. يجب عدم تغيير قيمة هذا الحقل.

     يعرض هذا الحقل اسم ملف العنصر مسبوقًا بالمسار إلى ملف العنصر. يأخذ الملف بصورة افتراضية اسم أصل CSElement (الذي تم إدخاله في الخطوة ) متبوعًا بامتداد الملف:

     CSElementName.xml_أو_jsp_أو_html

     عند حفظ الأصل CSElement، تتم كتابة القيمة الموجودة بهذا الحقل في عمود url في جدول ElementCatalog، للصف الذي يمثل العنصر.

   • الحقل منطق العنصر برأس ومعلومات أخرى.

     على سبيل المثال، إذا نقرت على زر JSP، يقوم WebCenter Sites بتعيين توجيه مكتبة علامات لبعض مكتبات علامات JSP الشائعة في WebCenter Sites (asset، siteplan، render). يقوم WebCenter Sites أيضًا بتعيين علامات بداية ونهاية cs:ftcs وعلامة RENDER.LOGDEP (render:logdep) لتحديد التبعية التركيبية بين أصل CSElement وأي صفحة أو صُفيحة يتم تصييرها بواسطة العنصر.

2. يتم ملء حقل عنصر أولي Rootelement باسم ملف العنصر (CSElementName.xml_or_jsp_or_html) بصورة مسبقة. يجب عدم تغيير قيمة هذا الحقل.

   يتم عرض العنصر الأولي بهذا الاسم في جدول ElementCatalog. وعند تكوين تعليمة برمجية تستدعي هذا العنصر (RENDER.CALLELEMENT)، فهذا هو الاسم الذي يجب استخدامه. فهو يستخدم اسم أصل CSElement حسب الإعداد الافتراضي.

3. (اختياري). في حقل وصف كتالوج العناصر ElementCatalog، اكتب وصفًا للعنصر.

   عند حفظ أصل CSElement، تتم كتابة المعلومات الموجودة بهذا الحقل في عمود description الخاص بإدخال العنصر في جدول ElementCatalog.

4. (مطلوب). في حقل منطق العنصر، اكتب التعليمة البرمجية للعنصر. تأكد من إدخال التعليمة البرمجية بالكامل قبل علامة نهاية cs:ftcs.

   إذا كنت تستخدم JSP، فأزل التعليقات من توجيهات taglib والتي تصف عائلات العلامات التي تستخدمها.

   للحصول على مساعدة بشأن هذه الخطوة، راجع برمجة العناصر للقوالب وCSElement.

   ملاحظة:

   ضمان مشاركة الأصل أو استنساخه: لمشاركة CSElement أو لجعل الأصل الحالي قابلاً للاستنساخ، فتأكد من أن منطق عنصر CSElement لا يشير مباشرةً إلى الأصول أو أنواع الأصول أو أسماء السمات أو أسماء القوالب. ولكن استخدم بدلاً من ذلك علامة render:lookup والمفاتيح المحددة كما هو موضح في in مشاركة القالب واستنساخ الموقع. In تكوين التخطيط ستقوم بتخطيط المفاتيح إلى معلومات الأصل التي يجب الوصول إليها لاستخدامها في منطق العنصر.

   استدعاء قالب: يجب دائمًا استدعاء القوالب بواسطة العلامة render:calltemplate وليس العلامة render:callelement أو العلامة render:satellitepage.

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

   • حقل معلمات العناصر. يقوم WebCenter Sites بملء هذا الحقل بمعرف CSElement (eid) المنشأ بواسطة WebCenter Sites كمعرف فريد لأصل CSElement asset. يجب عدم تغيير هذه القيمة أو حذفها.

     يقابل هذا الحقل عمود resdetails1 في جدول ElementCatalog. عند حفظ CSElement، يكتب WebCenter Sites معرف CSElement ID في عمود resdetails1 في الصف الذي يمثل CSElement.

   • حقل معلمات عناصر إضافية. يترك WebCenter Sites هذا الحقل فارغًا.

     يقابل هذا الحقل عمود resdetails2 في جدول ElementCatalog.

   إذا احتاج تصميم الموقع أن تستخدم المتغيرات إضافة إلى معرف eid، فأدخل المتغيرات في أحد الحقول السابقة. أدخلها في صورة أزواج name=value مع فصل الوسائط المتعددة بحرف علامة الإضافة (&). على سبيل المثال:

   MyArgument=value1&YourArgument=value2
   

   يدعم كل حقل ما يصل إلى 255 حرفًا.

   لمزيد من المعلومات عن متغيرات WebCenter Sites، بما في ذلك المجال والأسبقية، راجع تطوير مواقع الويب باستخدام تقنيات العلامات.

6. انقر على متابعة لفتح شاشة "التخطيط".