26 تكوين عنصر القالب

رجوع إلى تعليمات WebCenter Sites

يتم استخدام شاشة العنصر في تكوين عنصر القالب، وتعريف نوع ملف العنصر (XML أو JSP أو HTML)، وتقديم منطق العنصر وإدخال اسمه. على سبيل المثال:

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

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

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

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

ملاحظة:

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

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

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

  1. في حقل وصف كتالوج العناصر ElementCatalog، اكتب وصفًا للعنصر.

  2. في حقل مسار/اسم ملف تخزين العناصر، أدخل قيمة وفقًا لأسلوب التسمية في جدول "أساليب التسمية باستخدام TemplateName" المبين في موضوع "تسمية أصل قالب" ضمن Developing with Oracle WebCenter Sites.

  3. في حقل معلمات العناصر، حدد المتغيرات أو الوسائط التي يمكن تمريرها إلى العنصر.

  4. احفظ أصل القالب وأعد فتحه.

    WebCenter Sites يتحقق من وجود العنصر المحدد:

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

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

في شاشة العنصر:

  1. ضمن حقل الاستخدام، حدد الاستخدام المقصود من هذا القالب، من خلال المعلومات الموجودة في الجدول كدليل.

    خيار الاستخدام الوصف

    الاستخدام غير محدد

    تحديد قالب ينشئ HTML. من غير المعروف ما إذا كان القالب لنص (اطلع على الصف 2 من هذا الجدول) أو عنوان url (اطلع على الصف 3 من هذا الجدول).

    يُستخدم العنصر في صفحة HTML

    تحديد قالب يستخدم ضمن علامة <BODY>...</BODY> في صفحة HTML. يميز هذا الخيار القالب بوصفه قالب نص.

    يتم استخدام العنصر كنسق.

    تحديد قالب نسق ينشئ صفحة HTML كاملة، ويُستخدم في تصيير الأصول في وضع الويب.

    يعرِّف العنصر صفحة HTML كاملة ويمكن استدعاؤه خارجيًا

    تحديد قالب ينشئ صفحة HTML كاملة، ويمكن استخدامه في عنوان url. يميز هذا الخيار القالب بوصفه قالب عنوان url.

    يتم تدفق العنصر كبيانات أولية

    تحديد قالب ينشئ بيانات ثنائية أولية من نوع غير معروف ليس HTML.

  2. في حقل القوالب المستدعاة، حدد القالب (القوالب) الذي سيستدعيه هذا القالب (إن وجد).

  3. في حقل تكوين عنصر قالب، قم بأحد الإجراءات التالية:

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

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

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

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

    • حقل منطق العنصر مع رأس أو تعليمات برمجية أخرى يتم إنشاؤها تلقائيًا.

      على سبيل المثال، في حالة النقر على زر JSP، يقوم WebCenter Sites بإدخال توجيه مكتبة علامات لكل مكتبة من مكتبات علامات WebCenter Sites JSP. كما يقوم WebCenter Sites بتعيين علامة RENDER.LOGDEP (render:logdep) لتمييز تبعية تركيبية بين أصل القالب وأية صفحة أو صُفيحة تم تصييرها باستخدام القالب.

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

      يعرض هذا الحقل اسم ملف العنصر مسبوقًا بالمسار إلى ملف العنصر.

      عند حفظ أصل القالب، تتم كتابة القيمة الموجودة في حقل مسار/اسم ملف تخزين العناصر في عمود url ضمن جدول ElementCatalog، للصف الذي يمثل العنصر.

  4. يتم ملء حقل Rootelement بشكل مسبق بالقيمة المحددة في جدول "أساليب التسمية باستخدام TemplateName". يجب عدم تغيير قيمة هذا الحقل. في حالة تغير القيمة الافتراضية، فإن بعض العلامات التي تتوقع القيمة الافتراضية، مثل علامة render:calltemplate المشتملة على سمة النمط المعينة إلى عنصر، سوف تفشل.

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

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

    في حالة استخدام JSP، قم بإزالة التعليقات من توجيهات taglib التي تصف مكتبات العلامات التي تستخدمها.

    ملاحظة:

    التأكد من مشاركة قالب أو موقع قالب للاستنساخ

    للتمكن من مشاركة أصل القالب أو جعل الموقع الحالي قابلاً للاستنساخ، تأكد أن المنطق الخاص بعنصر القالب لا يشير مباشرة إلى الأصول أو أنواع الأصول أو أسماء السمات أو أسماء القوالب. ولكن استخدم بدلاً من ذلك علامة render:lookup ومفاتيح محددة كما هو موضح في “مشاركة القالب واستنساخ الموقع” في Developing with Oracle WebCenter Sites. في تكوين التخطيط تقوم بتخطيط نفس المفاتيح إلى معلومات الأصل التي يجب الوصول إليها للاستخدام في منطق العنصر.

    استدعاء قالب

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

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

    • حقل معلمات العناصر مناظر لعمود resdetails1 في ElementCatalog. عند حفظ القالب، يقوم WebCenter Sites بكتابة معرف القالب (tid) في هذا الحقل (أي في عمود resdetails1).

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

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

    MyArgument=value1&YourArgument=value2

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

    للحصول على مزيد من المعلومات حول المتغيرات، يرجى الاطلاع على :تطوير موقع ويب باستخدام تقنيات العلامات" في Developing with Oracle WebCenter Sites

  8. انقر على متابعة لفتح شاشة SiteEntry.