View Categories

3.8 فهم بناء جملة عنوان URL

الوقت المقدّر للقراءة: 13 دقيقة

3.8 فهم بناء جملة عنوان URL #

تدعم تطبيقات Oracle APEX نوعين من بناء جملة URL: بناء جملة URL سهلة الاستخدام Friendly URL Syntax وبناء جملة f?p Syntax,

نصيحة: تستخدم التطبيقات المُنشأة باستخدام إصدار Application Express 20.1 أو أحدث صيغة عناوين URL سهلة الاستخدام. يمكنك تغيير التطبيقات الحالية لاستخدام عناوين URL سهلة الاستخدام بتعديل سمة عناوين URL سهلة الاستخدام في تعريف التطبيق.

3.8.1 فهم بناء جملة عنوان URL سهلة الاستخدام #

ينشئ بناء جملة URL سهلة الاستخدام بنية URL تحدد عنوان Oracle APEX والتطبيق والصفحة، ويستخدم بناء جملة معلمات الويب القياسية.

ملحوظة: يختلف بناء جملة عنوان URL سهلة الاستخدام الموضح في هذا القسم عن عنوان URL الافتراضي أو اسم النطاق المخصص. عادةً ما يتم تكوين عنوان URL الافتراضي (أو اسم النطاق المخصص) لنسخة APEX على مستوى خادم الويب أو موازن التحميل، وهو أمر غير مذكور في هذا الكتاب.

نصيحة: التطبيقات المُنشأة باستخدام إصدار Application Express 20.1 أو أحدث تستخدم صيغة عناوين URL المألوفة أو سهلة الاستحدام. يمكنك العودة إلى صيغة f?p بتعطيل سمة عناوين URL المألوفة.

3.8.1.1 حول بناء جملة عنوان URL الودود #

يستخدم بناء جملة عنوان URL المألوفة تسلسلًا هرميًا قياسيًا لعناوين URL ويمرر المعلمات بطريقة مماثلة لتطبيقات الويب الأخرى.

التسلسل الهرمي Hierarchy والبنية النحوية Syntax لعنوان URL

يقوم بناء جملة URL المألوفة بإنشاء عنوان URL باستخدام التسلسل الهرمي والدليل التالي:

https://hostname:port/ords/r/path_prefix/app_alias/page_alias?parameters

مثال على عنوان URL سهل الاستخدام:

https://hostname:port/ords/r/mycompany/hr-app/update-employees?session=13766599855150

حيث:

  • https: اختصار لـ Hyper Text Transfer Protocol ويعمل على طبقة التطبيق.
  • hostname هو اسم نطاق الخادم. ويمكن أن يتضمن أيضًا رقم منفذ أو عنوان IP.
  • port هو رقم المنفذ المخصص عند تكوين Oracle REST Data Services.
  • ords هو اسم الخدمة المحدد عند تكوين Oracle REST Data Services.
  • r هو اختصار جهاز التوجيه. هذه القيمة ثابتة ولا يجب تغييرها أبدًا.
  • mycompany هو path_prefix بادئة مسار URI المستخدمة للوصول إلى خدمات RESTful. عند إنشاء مساحة عمل، تكون هذه القيمة الافتراضية هي اسم مساحة العمل. يمكنك تخصيص بادئة مسار URI بتعديل سمة بادئة المسار في “الإدارة”، “إدارة الخدمة”، “تفضيلات مساحة العمل”، و”ورشة عمل SQL”.
  • hr-app في تطبيق جديد، يكون app_alias الاسم المستعار للتطبيق افتراضيًا هو اسم التطبيق. يمكنك تعديل الاسم المستعار للتطبيق في تعريف التطبيق. يجب أن يكون الاسم المستعار للتطبيق فريدًا ضمن مساحة العمل.
  • update-employees في تطبيق جديد، يكون page_alias اسم الصفحة المستعار افتراضيًا هو اسم الصفحة. يمكنك تعديل اسم الصفحة المستعار في مصمم الصفحات. يجب أن تكون أسماء الصفحات المستعارة فريدة داخل التطبيق. عند إنشاء صفحة جديدة، إذا كان اسم الصفحة مستخدمًا بالفعل كاسم بديل، فسيتم إضافة قيمة عددية إلى اسم الصفحة المستعار الجديد لجعله فريدًا.
  • ?session=13766599855150 يُحدد مُعرِّف الجلسة. عند تشغيل تطبيق، يُولِّد مُحرِّك Oracle APEX رقم جلسة يُمثِّل مفتاحًا لحالة جلسة المستخدم.

حول معلمات URL

الجزء من عنوان URL بعد /? القائمة يمكن أن يحتوي على معلمات parameters.

http://hostname:port/ords/r/path_prefix/app_alias/page_alias?parameters (Such as —
p7_customer_id=377&clear=7&session=1247058356345&cs=3MdkfQa9NLmkyHAbwGPg3U-nmA7XIw5sWjU2rMzSvOy_wP1_z7BBI-Gbh2JgvffARgcYJy8id4VtL3d0l1tYm0w)

المعلمات المدعومة تشمل:

  • session
  • request
  • clear
  • debug
  • application/page items
  • printerFriendly
  • trace
  • timezone
  • lang
  • territory
  • cs
  • dialogCs
  • x01

3.8.1.2 تمكين أو تعطيل بناء جملة عنوان URL الودود #

قم بتحديد ما إذا كان التطبيق يستخدم صيغة URL المألوفة أو صيغة f?p عن طريق تمكين أو تعطيل سمة عناوين URL المألوفة.

التطبيقات المُنشأة باستخدام Oracle APEX الإصدار 20.1 أو أحدث تستخدم صيغة عناوين URL المألوفة. يمكنك العودة إلى صيغة f?p بتعطيل سمة عناوين URL المألوفة.

لتفعيل صيغة عنوان URL المألوفة:

  • في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder
  • حدد التطبيق. تظهر الصفحة الرئيسية للتطبيق.
  • انتقل إلى صفحة تعديل تعريف التطبيق. تتضمن خيارات التنقل ما يلي:
    • انقر فوق زر تحرير تعريف التطبيق Edit Application Definition.
    • من المكونات المشتركة:
      • انقر فوق المكونات المشتركة Shared Components.
      • تحت منطق التطبيق، انقر فوق تعريف التطبيق Application Definition.
    تظهر صفحة التعريف.
  • ضمن الخصائص، قم بتكوين سمة عناوين URL المألوفة :
    • تشغيل On – إذا تم ضبطه على تشغيل، يستخدم التطبيق صيغة عناوين URL المألوفة حيث يتكون عنوان URL من بنية دليل تعتمد على الاسم المستعار للتطبيق والاسم المستعار للصفحة وصيغة معلمات الويب القياسية.
    • إيقاف التشغيل Off – إذا تم ضبطه على إيقاف التشغيل، يستخدم التطبيق f?p= Syntax.
  • انقر فوق تطبيق التغييرات Apply Changes لحفظ التغييرات.

3.8.1.3 تخصيص عنوان URL سهل الاستخدام #

قم بتخصيص عنوان URL المألوف عن طريق تحرير بادئة المسار أو الاسم المستعار للتطبيق أو الاسم المستعار للصفحة.

يقوم بناء جملة URL المألوف بإنشاء عنوان URL باستخدام التسلسل الهرمي والدليل التالي:

https://hostname:port/ords/r/path_prefix/app_alias/page_alias?parameters

يمكنك تخصيص الأجزاء التالية من عنوان URL المألوف:

  • بادئة المسار – path_prefix هي بادئة مسار URI المُستخدمة للوصول إلى خدمات RESTful. عند إنشاء مساحة عمل، تُصبح هذه القيمة افتراضيًا اسم مساحة العمل. يمكنك تخصيص بادئة مسار URI بتعديل سمة بادئة المسار في إدارة مساحة العمل.
  • الاسم المستعار للتطبيق – app_alias هو مُعرّف تطبيق أبجدي رقمي بديل يُسمى الاسم المستعار للتطبيق. في التطبيق الجديد، يكون الاسم المستعار للتطبيق افتراضيًا هو اسم التطبيق. يمكنك تعديل الاسم المستعار للتطبيق في تعريف التطبيق.
  • اسم الصفحة المستعار – page_alias اسم أبجدي رقمي لهذه الصفحة. في التطبيقات الجديدة، يكون اسم الصفحة المستعار افتراضيًا هو اسم الصفحة. يمكنك تعديل اسم الصفحة المستعار في مصمم الصفحات.

مثال لتخصيص عنوان URL سهل الاستخدام #

افترض أن لديك تطبيقًا يحتوي على عنوان URL التالي:

http://hostname:port/ords/r/example/355/2?session=13766599855150

افترض أنك تريد إجراء التغييرات التالية:

  • path_prefix -تغيير example إلى mycompany.
  • app_alias – تغيير 355 إلى myapp.
  • page_alias – تغيير 2 إلى myinfo.

سيتم عرض عنوان URL المنقح على النحو التالي:

http://hostname:port/ords/r/mycompany/myapp/myinfo?session=13766599855150

لتخصيص عنوان URL سهل الاستخدام عن طريق تحرير بادئة المسار أو الاسم المستعار للتطبيق أو الاسم المستعار للصفحة:

  1. تسجيل الدخول إلى Oracle APEX .
  2. لتغيير بادئة المسار:
    1. انتقل إلى صفحة إدارة مساحة العمل. في أعلى الصفحة الرئيسية لمساحة العمل، انقر على قائمة الإدارة Administration وحدد “الإدارة” Administration.
    2. في الصفحة الرئيسية لإدارة مساحة العمل، انقر فوق إدارة الخدمة Manage Service، ثم انقر فوق تعيين تفضيلات مساحة العمل Set Workspace Preferences.
    3. انتقل إلى الأسفل إلى SQL Workshop.
    4. في بادئة المسار Path Prefix، أدخل بادئة مسار جديدة. في مساحة العمل الجديدة، تكون بادئة المسار افتراضيًا هي اسم مساحة العمل. على سبيل المثال، غيّر بادئة المسار إلى mycompany. نصيحة: يتم عرض بادئة المسار فقط إذا تم تعيين خدمات Enabled RESTful Services الممكّنة على نعم Yes.
    5. انقر فوق تطبيق التغييرات Apply Changes لحفظ التغييرات. تظهر صفحة إدارة الخدمة.
    6. ارجع إلى الصفحة الرئيسية لمساحة العمل. انقر على شعار APEX (صفحة Oracle APEX الرئيسية) في الزاوية العلوية اليسرى.
  3. لتغيير الاسم المستعار للتطبيق:
    1. في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
    2. حدد التطبيق.
    3. في الصفحة الرئيسية للتطبيق، انقر فوق زر تحرير تعريف التطبيق Edit Application Definition. تظهر صفحة تعريف التطبيق.
    4. تحت الاسم، عدّل سمة الاسم المستعار للتطبيق Application Alias. على سبيل المثال، أدخل myapp.
    5. انقر فوق تطبيق التغييرات Apply Changes لحفظ التغييرات.
  4. لتغيير الاسم المستعار للصفحة:
    1. عرض الصفحة في مصمم الصفحات Page Designer.
    2. في علامة التبويب “العرض”، حدد اسم الصفحة.
    3. في محرر الخصائص Property Editor، ابحث عن مجموعة التعريف.
    4. ضمن “التعريف”، سمة اسم الصفحة المستعار – أدخل اسمًا أبجديًا رقميًا لهذه الصفحة. على سبيل المثال، أدخل myinfo.
    5. لحفظ التغييرات، انقر فوق حفظ Save أو حفظ وتشغيل الصفحة Save and Run Page.
  5. قم بتشغيل الصفحة. انقر فوق حفظ وتشغيل الصفحة Save and Run Page. يتم عرض عنوان URL المنقح على النحو التالي:

http://hostname:port/ords/r/mycompany/myapp/myinfo?session=13766599855150

3.8.2 فهم بناء جملة عنوان URL الخاص بـ f?p #

f?p URL Syntax هو بناء جملة قديم ينشئ بنية URL فريدة تحدد عنوان Oracle APEX ومعرف التطبيق ورقم الصفحة ومعرف الجلسة.

3.8.2.1 حول بناء جملة عنوان URL لـ f?p #

ينشئ f?p URL Syntax بنية عنوان URL فريدة تحدد موقع وعنوان Oracle APEX ومعرف التطبيق ورقم الصفحة ومعرف الجلسة.

بنية وقواعد عنوان URL لـ f?p

يقوم f?p URL Syntax بإنشاء عنوان URL بالهيكل والنحو التاليين:

https://hostname:port/ords/f?p=app_id:page_number:session_id

مثال على عنوان URL لـ f?p

https://hostname:port/ords/f?p=392:3:13766599855150

يشير هذا المثال إلى:

  • https: اختصار لـ HyperText Transfer Protocol ويعمل على طبقة التطبيق.
  • hostname هو اسم نطاق الخادم. ويمكن أن يتضمن أيضًا رقم منفذ أو عنوان IP.
  • port هو رقم المنفذ المخصص عند تكوين Oracle REST Data Services.
  • ords هو اسم الخدمة المحدد عند تكوين Oracle REST Data Services.
  • f?p=هي البادئة التي يستخدمها Oracle APEX لتوجيه الطلب إلى عملية المحرك الصحيحة.
  • 392 هو مُعرِّف التطبيق المُستدعى. مُعرِّف التطبيق هو رقم فريد يُعرِّف كل تطبيق.
  • 3 هو رقم الصفحة داخل التطبيق. يجب أن يكون رقم الصفحة فريدًا داخل التطبيق.
  • 13766599855150 هو رقم الجلسة. عند تشغيل تطبيق، يُولّد مُحرّك APEX رقم جلسة يُستخدم كمفتاح لحالة جلسة المستخدم.

3.8.2.2 حول استخدام صيغة f?p لربط الصفحات #

إنشاء روابط بين صفحات التطبيق باستخدام f?p بناء الجملة.

يتضمن مُنشئ التطبيقات العديد من المعالجات التي تُنشئ هذه المراجع تلقائيًا. مع ذلك، قد تحتاج إلى إنشاء الصيغة بنفسك في بعض الحالات.

لإنشاء روابط بين الصفحات في تطبيق ما، استخدم f?pبناء الجملة التالي:

f?p=تطبيق:صفحة:جلسة:طلب:تصحيح:مسح ذاكرة التخزين المؤقت:أسماء العناصر:قيم العناصر:قابل للطباعة

يوضح الجدول التالي الوسائط التي يمكنك تمريرها عند استخدام f?pبناء الجملة.

الجدول 3-1 معلمات بناء الجملة f?p #

بناء الجملةالوصف
Appيشير إلى معرف التطبيق أو الاسم المستعار للتطبيق الأبجدي الرقمي. الاسم المستعار للتطبيق هو مُعرّف تطبيق أبجدي رقمي بديل فريد، يُمكن للمطورين استخدامه بدلاً من مُعرّف التطبيق. يُمكنك تحديد اسم مستعار للتطبيق من خلال تعديل تعريف التطبيق.
Pageيشير إلى رقم الصفحة أو الاسم البديل للصفحة الأبجدية الرقمية. الاسم المستعار للصفحة هو بديل أبجدي رقمي فريد لرقم الصفحة. يمكن للمطورين استخدام اسم مستعار للصفحة بدلاً من مُعرّف رقم الصفحة. يُمكنك تحديد اسم مستعار للصفحة بتعديل سمات الصفحة.
Sessionيُحدد مُعرِّف الجلسة. يمكنك الرجوع إلى مُعرِّف الجلسة لإنشاء روابط نصية تشعبية لصفحات أخرى تحافظ على حالة الجلسة نفسها، وذلك بتمرير رقم الجلسة. يمكنك الرجوع إلى مُعرِّف الجلسة باستخدام الصيغة التالية:سلسلة استبدال قصيرة: &SESSION.PL/SQL:V('SESSION')متغير الربط::APP_SESSION
Requestيُعيّن قيمة REQUEST. يُعيّن كل زر تطبيق قيمة REQUESTلاسم الزر، مما يُمكّن معالجة القبول من الإشارة إلى اسم الزر عند نقر المستخدم عليه. يمكنك REQUESTاستخدام الصيغة التالية للإشارة:سلسلة الاستبدال: &REQUEST.PL/SQL:V('REQUEST')متغير الربط::REQUEST
Debugيعرض تفاصيل معالجة التطبيق. القيم الصالحة لعلامة DEBUG تشمل:نعم.LEVELnلاضبط هذا العلم YESلعرض تفاصيل معالجة التطبيق. ضبط هذا العلم على LEVELn(حيث nيكون بين ١ و٩) يتحكم في مستوى تفاصيل التصحيح المعروضة. قيمة YES تساوي LEVEL4.يمكنك الرجوع إلى علم التصحيح باستخدام بناء الجملة التالي:سلسلة استبدال قصيرة: &DEBUG.PL/SQL: V('DEBUG')متغير الربط::DEBUG
ClearCacheمسح ذاكرة التخزين المؤقت. هذا يُعيِّن قيمة العناصر إلى قيمة فارغة.لمسح العناصر المخزنة مؤقتًا في صفحة واحدة، حدد رقم الصفحة الرقمي. لمسح العناصر المخزنة مؤقتًا في صفحات متعددة، استخدم قائمة أرقام صفحات مفصولة بفواصل. يؤدي مسح ذاكرة التخزين المؤقت للصفحة أيضًا إلى إعادة تعيين أي عمليات مرتبطة بالحالة على الصفحة. يمكن أن تتضمن القيم الفردية أو المفصولة بفواصل أسماء المجموعات المراد إعادة تعيينها أو الكلمة الأساسية ” RP،” التي تعيد تعيين ترقيم الصفحات حسب المنطقة في الصفحة المطلوبة. APPتمسح الكلمة الأساسية ذاكرة التخزين المؤقت لجميع الصفحات وجميع عناصر مستوى التطبيق في التطبيق الحالي، وتزيل تفضيلات الفرز للمستخدم الحالي. تحقق الكلمة الأساسية SESSIONنفس نتيجة APPالكلمة الأساسية، ولكنها تمسح العناصر المرتبطة بجميع التطبيقات التي تم استخدامها في الجلسة الحالية.
itemNamesقائمة مفصولة بفاصلة لأسماء العناصر المستخدمة لتعيين حالة الجلسة باستخدام عنوان URL.
itemValuesقائمة بقيم العناصر المستخدمة لتحديد حالة الجلسة ضمن عنوان URL. لإضافة فاصلة في قيمة عنصر، أحط الأحرف بشرطات مائلة عكسية. على سبيل المثال:\123,45\يمكن وضع علامة مائلة عكسية حول كل تسلسل أحرف باستثناء backslash comma( ).\,
PrinterFriendlyيُحدد ما إذا كانت الصفحة تُعرض في وضع الطباعة. إذا تم ضبط PrinterFriendly على “نعم”، فسيتم عرض الصفحة في وضع الطباعة. يمكن استخدام قيمة PrinterFriendly في شروط العرض لإزالة عناصر مثل المناطق من الصفحة لتحسين جودة الطباعة. يمكنك الرجوع إلى تفضيلات الطابعة الصديقة باستخدام بناء الجملة التالي:V('PRINTER_FRIENDLY')عند الإشارة إليها، تُعرض الصفحة باستخدام قالب قابل للطباعة. يعرض محرك APEX جميع النصوص داخل حقول نموذج HTML كنص. لا يحتاج القالب القابل للطباعة إلى استخدام الوسم #FORM_OPEN# أو #FORM_CLOSE#. الهدف هو عرض المعلومات بجداول قليلة وبتنسيق مناسب للطباعة.

3.8.2.3 استدعاء صفحة باستخدام اسم مستعار للتطبيق أو اسم مستعار للصفحة #

استخدم صيغة عنوان URL لاستدعاء صفحة باستخدام اسم مستعار للتطبيق و/أو اسم مستعار للصفحة.

يجب أن تتكون أسماء التطبيقات والصفحات من مُعرّفات أوراكل صالحة، وألا تحتوي على أي مسافات، وألا تكون حساسة لحالة الأحرف. المثال التالي يستدعي صفحة من داخل تطبيق باستخدام اسم تطبيق واسم صفحة بديل. يُشغّل هذا المثال صفحة home التطبيق myapp ويستخدم مُعرّف الجلسة الحالي.

f?p= myapp : home :&APP_SESSION.

يجب أن تكون أسماء التطبيقات المستعارة فريدة ضمن مساحة العمل. إذا كان لتطبيق في مساحة عمل مختلفة اسم تطبيق مستعار مماثل، فاستخدم &cالوسيطة لتحديد اسم مساحة العمل. على سبيل المثال:

يجب أن تكون أسماء التطبيقات المستعارة فريدة ضمن مساحة العمل. إذا كان لتطبيق في مساحة عمل مختلفة اسم تطبيق مستعار مماثل، فاستخدم &cالوسيطة لتحديد اسم مساحة العمل. على سبيل المثال:

f?p=common_alias:home:&APP_SESSION.&c=WORKSPACE_A

3.8.2.4 استدعاء صفحة من عنوان URL للزر #

استخدم صيغة URL لاستدعاء صفحة من عنوان URL للزر.

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

f?p=6000:6001:&APP_SESSION.

لاحظ أن هذه طريقة واحدة فقط لاستخدام الزر. تتجاوز هذه الطريقة إرسال الصفحة وتعمل كارتباط تشعبي على الصفحة. يمكنك أيضًا النقر على زر “إرسال صفحة” submit a page. في هذه الطريقة، يؤدي النقر على الزر إلى إرسال الصفحة للمعالجة، مما يسمح بإرسال النماذج وحفظ حالة الجلسة.

3.8.3 إخفاء معرف الجلسة على الصفحات العامة #

إخفاء معرف الجلسة session ID في عنوان URL عن طريق جعل الصفحة عامة.افتراضيًا، تتطلب جميع الصفحات مصادقة. مع ذلك، إذا كانت الصفحة عامة ولم يسجّل المستخدم دخوله، فلن يعرض عنوان URL للصفحة مُعرّف الجلسة.

نصيحة: لأسباب أمنية، توصي Oracles المسؤولين بتعطيل ميزة إعادة الانضمام إلى الجلسات ما لم يطبقوا عزل مساحة العمل من خلال تكوين سمة “السماح باسم المضيف” Allow Hostname على مستوى مساحة العمل أو المثيل.

لتحديد صفحة كعامة:

  1. في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
  2. حدد التطبيق.
  3. على مستوى التطبيق، قم بتحرير سمة إعادة الانضمام إلى الجلسة Rejoin Session:
    1. انقر فوق زر تحرير تعريف التطبيق Edit Application Definition. يظهر تعريف التطبيق.
    2. انقر فوق الأمان Security.
    3. إدارة الجلسات، إعادة الانضمام إلى الجلسات – حدد تمكين للجلسات العامة Enabled for Public Sessions.
    4. انقر فوق تطبيق التغييرات Apply Changes لحفظ التغييرات.
  4. على مستوى الصفحة، قم بتحرير سمة المصادقة:
    1. عرض الصفحة في مصمم الصفحات.يظهر تعريف التطبيق.
    2. في علامة التبويب “العرض”، حدد اسم الصفحة.
    3. الأمان والمصادقة – حدد الصفحة عامة Page is Public.
    4. انقر فوق تطبيق التغييرات Apply Changes لحفظ التغييرات.
حُدثت بتاريخ يونيو 19, 2025

ما هو شعورك؟

  • Happy
  • عادي
  • Sad
error: Content is protected !!
Scroll to Top