7.4 إدارة سمات الصفحة

7.4 إدارة سمات الصفحة Managing Page Attributes #

قم بتحرير سمات الصفحة Page Attributes للتحكم في المعلومات الأساسية والوظائف لصفحة معينة، بما في ذلك اسم الصفحة أو عنوانها، ونص الرأس والتذييل، وقوائم التنقل، وإدراج ملفات JavaScript أو CSS على مستوى الصفحة، ومعالجة الأخطاء، ونظام التفويض المحدد.

7.4.1 تحرير سمات الصفحة #

يمكنك تعديل سمات الصفحة عن طريق عرض الصفحة في مصمم الصفحات وتحديد اسم الصفحة.

لتحرير سمات الصفحة:

1. عرض الصفحة في مصمم الصفحات Page Designer:
   • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
   • حدد التطبيق.
   • حدد صفحة. يظهر مصمم الصفحة Page Designer.
2. في علامة التبويب “العرض” Rendering أو علامة التبويب “التخطيط” Layout، حدد اسم الصفحة.
3. قم بتعديل السمات المناسبة في محرر الخصائص Property Editor. نصيحة: لعرض المساعدة لسمة ما، حدد السمة في محرر الخصائص وانقر فوق علامة التبويب “تعليمات” Help في الجزء الأوسط.
4. لحفظ التغييرات، انقر فوق حفظ Save أو حفظ وتشغيل الصفحة Save and Run Page.

7.4.2 دمج JavaScript باستخدام مصمم الصفحات #

قم بتضمين JavaScript على الصفحة عن طريق تحرير سمات الصفحة في مجموعة JavaScript. يعد تضمين JavaScript في صفحة ما نهجًا جيدًا للوظائف التي تتعلق بصفحة معينة وطريقة ملائمة لاختبار وظيفة قبل تضمينها في ملف جافا بالامتداد .js.

لإضافة كود جافا سكريبت JavaScript إلى صفحة:

1. عرض الصفحة في مصمم الصفحات:
   • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
   • حدد التطبيق.
   • حدد صفحة. يظهر مصمم الصفحة age Designer.
2. في علامة التبويب “العرض” Rendering، حدد اسم الصفحة. يعرض محرر الخصائص Property Editor سمات الصفحة.
3. في محرر الخصائص، ابحث عن  مجموعة JavaScript.
4. تحت JavaScript، قم بتحرير السمات التالية:
   • عناوين URL للملفات – أدخل عناوين URL لملفات JavaScript لتحميل الكود على هذه الصفحة. يجب كتابة كل عنوان URL في سطر جديد. إذا وفّرت نسخة مصغّرة من ملفك، يمكنك استخدام سلسلة الاستبدال #MIN# لتضمين .minأو #MIN_DIRECTORY# لتضمين dignified/ في عنوان URL الخاص بملفك لعرض الصفحة العادي، وسلسلة فارغة إذا كانت الصفحة معروضة في وضع التصحيح. يمكنك أيضًا الوصول إلى سلسلة الاستبدال #APP_VERSION# إذا أردت تضمين إصدار التطبيق في عنوان URL الخاص بالملف.
   • إعلان الدوال والمتغيرات العامة Function and Global Variable Declaration – أدخل كود جافا سكريبت، مثل إعلانات الدوال أو المتغيرات العامة المشار إليها في هذه الصفحة. إذا كانت شفرة جافا سكريبت نفسها مطلوبة في صفحات متعددة، ففكّر في وضع الكود في ملف جافا سكريبت خارجي لتجنب التكرار والاستفادة من التخزين المؤقت للملفات الثابتة في المتصفح. يقوم الكود الذي تدخله هنا باستبدال سلسلة الاستبدال #PAGE_JAVASCRIPT# في قالب الصفحة. نصيحة: لا تُضمِّن علامات فتح أو إغلاق النص. فقط أضِف كود جافا سكريبت. للإشارة إلى اختصار، استخدم "SHORTCUTNAME".
   • تنفيذ عند تحميل الصفحة Execute When Page Loads – أدخل كود جافا سكريبت لتنفيذه عند تحميل الصفحة. يُنفَّذ الكود بعد كود جافا سكريبت المُولَّد بواسطة Oracle APEX .نصيحة: لمعرفة المزيد عن السمة وعرض الأمثلة، حدد السمة وانقر فوق علامة التبويب “تعليمات” Help  في الجزء الأوسط. على سبيل المثال، سيؤدي إضافة ما يلي إلى سمة الوظيفة وإعلان المتغير العالمي إلى إنشاء وظيفة تسمى test، والتي يمكنك استخدامها بعد ذلك من أي مكان في الصفحة الحالية:

function test(){
alert(‘This is a test.’);
}

• انقر فوق حفظ Save.

7.4.3 تكوين جلسات إعادة الانضمام لصفحة #

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

تتحكم سمة إعادة الانضمام إلى الجلسات Rejoin Sessions في دعم الانضمام إلى الجلسات الموجودة (على غرار الارتباط العميق) deep linking.

تحذير: قد يؤدي تفعيل جلسات إعادة الانضمام إلى الجلسات إلى تعريض تطبيقك لاختراقات أمنية محتملة، إذ قد يُمكّن المهاجمين من الاستيلاء على جلسات المستخدم النهائي الحالية. لمعرفة المزيد، راجع ” حول جلسات إعادة الانضمام” .

لاستخدام ميزة “إعادة الانضمام إلى الجلسات” Rejoin Sessions على مستوى الصفحة، يجب على المسؤولين تفعيلها على مستوى المثيل. يُلغي إعداد أكثر تقييدًا على مستوى المثيل إعدادات التطبيق والصفحة.

لتكوين جلسات إعادة الانضمام لصفحة ما:

1. عرض الصفحة في مصمم الصفحات Page Designer:
   • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
   • حدد التطبيق.
   • حدد صفحة. يظهر مصمم الصفحة Page Designer.
2. في علامة التبويب “العرض” Rendering، حدد اسم الصفحة. يعرض محرر الخصائص Property Editor سمات الصفحة.
3. في محرر الخصائص، ابحث عن  مجموعة الأمان Security Group.
4. تحت “الأمان” Security، “إعادة الانضمام إلى الجلسات” Rejoin Sessions، حدد أحد الخيارات:
   • افتراضي التطبيق Application Default– يرث الإعداد المحدد على مستوى التطبيق.
   • معطل Disabled – إذا كان عنوان URL لا يحتوي على معرف جلسة، يقوم Oracle APEX بإنشاء جلسة جديدة.
   • مُفعّل للجلسات العامة Enabled for Public Sessions – إذا كان عنوان URL يُشير إلى صفحة عامة ولا يحتوي على مُعرّف جلسة، فسيحاول APEX استخدام ملف تعريف ارتباط الجلسة المُنشأ لهذا التطبيق. ينضم APEX باستخدام ملف تعريف الارتباط فقط عندما لا تكون الجلسة مُصادق عليها بعد.
   • تفعيل الجلسات العامة Enabled for Public Sessions يتطلب ضبط “التضمين في الإطارات” على ” السماح من المصدر نفسه” Allow from same origin أو “الرفض” Deny. لا يرتبط هذا بشرط يتعلق بحمولة عنوان URL، بل ينطبق أيضًا على عناوين URL المحمية بحالة الجلسة.
   • مُمكّن لجميع الجلسات Enabled for All Sessions – إذا كان عنوان URL لا يحتوي على معرف جلسة، يحاول APEX استخدام ملف تعريف ارتباط الجلسة الحالي الذي تم إنشاؤه لهذا التطبيق، بشرط استيفاء الشروط التالية:
     • تم تفعيل حماية حالة الجلسة للتطبيق Session State Protection، ويتضمن عنوان URL مجموعًا اختباريًا صالحًا. بالنسبة للإشارات المرجعية العامة، يجب أن تكون حماية مستوى العنصر الأكثر تقييدًا إما “غير مقيد” Unrestricted أو مطلوب مجموع تحقق Checksum Required – مستوى التطبيق Application Level .لا يحتوي عنوان URL على حمولة (معلمة طلب أو مسح ذاكرة التخزين المؤقت أو أزواج قيمة البيانات). يتطلب هذا الإعداد أيضًا تعيين “التضمين في الإطارات” Embed In Frames على “السماح من نفس المصدر” Allow from same origin أو “الرفض” Deny للتطبيق. نصيحة: يرث خيار “افتراضي التطبيق” Application Default الإعداد المُحدد على مستوى التطبيق. راجع أمان المتصفح 
5. انقر فوق حفظ Save.

7.4.4 تكوين سمات صفحات الحوار #

تكوين سمات مربع الحوار Dialog Attributes في مصمم الصفحة.

نصيحة: إنشاء صفحة مربع حوار عملية متعددة الخطوات. لمعرفة المزيد، راجع موضوع إنشاء صفحات مربعات الحوار .

لتكوين سمات مربع الحوار Dialog Attributes:

1. عرض الصفحة في مصمم الصفحات:
   • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
   • حدد التطبيق.
   • حدد صفحة.يظهر مصمم الصفحة Page Designer.
2. في علامة التبويب “العرض” Rendering، حدد اسم الصفحة. يعرض محرر الخصائص Property Editor سمات الصفحة.
3. في محرر الخصائص، ابحث عن “المظهر” Appearance وتأكد من تعيين وضع الصفحة إما على مربع حوار منبثق Modal Dialog أو مربع حوار غير منبثق Non-Modal Dialog.
4. ابحث عن مربع الحوار Dialog وقم بتكوين السمات التالية:
   • العرض Width
   • الارتفاع Height
   • الحد الأقصى للعرض Maximum Width
   • سمات Attributes
   • فئات CSS Classes
   • متسلسلة Chained
5. لحفظ التغييرات، انقر فوق حفظ Save أو حفظ وتشغيل الصفحة Save and Run Page.

نصيحة: لعرض المساعدة لسمة ما، حدد السمة في محرر الخصائص وانقر فوق علامة التبويب “تعليمات” في الجزء الأوسط.

7.4.5 تكوين الصفحات لتحذير المستخدمين من التغييرات غير المحفوظة #

قم بتمكين سمة الصفحة “التحذير من التغييرات غير المحفوظة” Warn on Unsaved Changes لتحذير المستخدمين إذا انتقلوا بعيدًا عن الصفحة التي تحتوي على تغييرات غير محفوظة.

لتفعيل سمة صفحة التحذير من التغييرات غير المحفوظة:

1. عرض الصفحة في مصمم الصفحات Page Designer:
   • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
   • حدد التطبيق.
   • حدد صفحة. يظهر مصمم الصفحة Page Designer.
2. في علامة التبويب “العرض” Rendering، حدد اسم الصفحة. يعرض محرر الخصائص Property Editor سمات الصفحة.
3. في محرر الخصائص، ابحث عن مجموعة التنقل Navigation group.
4. بالنسبة لـ “التحذير من التغييرات غير المحفوظة” Warn on Unsaved Changes، حدد “تشغيل” On لتحذير المستخدمين إذا انتقلوا بعيدًا عن الصفحة التي تحتوي على تغييرات غير محفوظة.
5. انقر فوق حفظ Save.

نصيحة: يتم تنفيذ سمة التحذير من التغييرات غير المحفوظة باستخدام واجهة برمجة التطبيقات (API) التالية apex.page.warnOnUnsavedChanges.