5.6 دمج APEX مع تطبيقات Fusion

5.6 دمج APEX مع تطبيقات Fusion #

يمكن دمج APEX مع تطبيقات Fusion – استخدم Oracle APEX لبناء ملحقات لتطبيقات Fusion.

5.6.1 حول متطلبات دمج APEX مع تطبيقات Fusion #

تعرف على متطلبات دمج Oracle APEX مع Fusion Applications. تتضمن متطلبات دمج Oracle APEX مع Fusion Applications ما يلي:

• اشتراك في تطبيق Fusion.
• قاعدة بيانات مستقلة Autonomous Database بنوع أحمال العمل الخاص بمستودع البيانات Data Warehouse أو المعالجة المعاملاتية Transactional Processing.
• اتصالات SQLNet بقاعدة بيانات Oracle في نفس الإيجار.

ملحوظة: لا يدعم Oracle APEX Application Development, APEX Service تكاملات Fusion Application نظرًا لأن أحمال عمل APEX لا تتضمن اتصالات SQLNet.

حول عملية الدمج #

إن دمج APEX مع Fusion Applications عبارة عن عملية مكونة من ثلاث مراحل:

• إنشاء اتصال Create a Connection – قم بتشغيل معالج دمج أدوات قاعدة البيانات لإنشاء اتصال بين مثيل Oracle Fusion Applications وقاعدة بيانات Oracle حيث يوجد APEX. راجع دمج Oracle APEX مع تطبيقات Fusion في وثائق البنية الأساسية لـ Oracle Cloud.
• إنشاء تطبيق نموذجي مبدئي Create a Starter Sample Application – شغّل معالج إنشاء التطبيق في مُنشئ التطبيقات لإنشاء تطبيق نموذجي مبدئي مع تكامل مُهيأ مسبقًا مع مثيل Oracle Fusion Applications. راجع إنشاء تطبيق مع تكاملات مع Fusion Applications .

5.6.2 حول تطبيق Fusion Integration Starter #

تعرف على تطبيق بدء التشغيل Create Fusion Integration.

عند تشغيل معالج إنشاء التطبيق Create Application Wizard وتحديد خيار إنشاء اندماج فيوجن Create Fusion Integration، يقوم المعالج بإنشاء تطبيق بدء التشغيل واستكمال مهام إعداد قاعدة البيانات التالية:

• الخادم البعيد Remote Server – يُنشئ خادمًا بعيدًا على مستوى مساحة العمل، مُسمّى وفقًا للاتفاقية APEX_FA_FUSION_INSTANCE_REST_APIS حيث Fusion Applications هو اسم النظام والذي يمكن إيجاده في سحابة Fusion Applications Cloud Console الخاصة بك. هذا الخادم البعيد مُهيأ مسبقًا للإشارة إلى عنوان URL الأساسي لنقاط نهاية واجهة برمجة تطبيقات الخاصة بك Fusion REST API.
• بيانات اعتماد الويب Web Credential – يُنشئ بيانات اعتماد ويب باسم حسب التنسيق APEX_FA_FUSION_INSTANCE_DBMS_CRED الذي يستخدم بيانات اعتماد قاعدة البيانات التي أنشأها معالج دمج أدوات قاعدة البيانات Database Tools Fusion Integration Wizard. تُستخدم هذه البيانات من قِبل كل من نظام المصادقة المُهيأ مسبقًا pre-configured Authentication Scheme ومصدر بيانات REST النموذجي.
• مخطط المصادقة Authentication Scheme – يُنشئ مخطط مصادقة مُهيأ مسبقًا باسم بالتنسيق APEX_FA_FUSION_INSTANCE_OAUTH. يمكنك نسخ مخطط المصادقة هذا والاشتراك فيه في تطبيقات Fusion الأخرى المُدمجة لتمكين تسجيل الدخول الموحد فيها بسهولة أيضًا. يحتوي مخطط المصادقة هذا على عناصر نائبة تُشير إلى معلمات التكوين المُحددة على مستوى المثيل بواسطة معالج دمج Fusion لأدوات قاعدة البيانات Database Tools Fusion Integration Wizard.
• مصدر بيانات REST – يُنشئ مصدر بيانات REST نموذجيًا باسم HCM Self Details يشير إلى الخادم البعيد Remote Server على مستوى مساحة العمل وبيانات اعتماد الويب Web Credentials للحصول على تفاصيل حول المستخدم المُسجّل دخوله حاليًا. يمكنك دراسة إعدادات مصدر البيانات هذا لإنشاء مصدر بيانات خاص بك لنقاط نهاية واجهة برمجة تطبيقات Fusion REST API الأخرى.

5.6.3 إنشاء تطبيق مع دمج APEX مع تطبيقات Fusion #

إنشاء تطبيق مبدئي مع تكاملات تم تكوينها مسبقًا لتطبيقات Fusion.

ملحوظة: قبل محاولة تنفيذ هذه المهمة، يجب تشغيل أدوات قاعدة البيانات، ومعالج دمج APEX مع Fusion Applications. راجع متطلبات دمج Oracle APEX مع Fusion Applications .

لإنشاء تطبيق مبدئي مع دمج مُهيأ مسبقًا مع مثيل Oracle Fusion Applications:

• في الصفحة الرئيسية لمساحة العمل، انقر فوق أيقونة “منشئ التطبيقات” App Builder.
• انقر فوق إنشاء Create. يطالبك المعالج باختيار طريقة إنشاء التطبيق الخاص بك.
• انقر فوق إنشاء اندماج فيوجن Create Fusion Integration. ملحوظة: إذا لم تقم بإنشاء اتصال بين مثيل Oracle Fusion Applications وقاعدة البيانات التي يوجد بها APEX، فستظهر رسالة تحذير. تظهر صفحة إنشاء تكامل الاندماج.
• خيارات التكوين Configuration Options:
  1. اسم نظام مثيلات Fusion أو Fusion Instance System Name – حدد مثيل Fusion الذي ترغب في دمج تطبيق البدء الجديد معه. تتوفر فقط مثيلات Fusion التي تم تكوينها باستخدام معالج دمج أدوات قاعدة البيانات.
  2. عنوان URL الأساسي لواجهات برمجة تطبيقات Base URL for the REST APIs – عنوان URL لنسخة Fusion التي يمكنك من خلالها العثور على نقاط نهاية واجهة برمجة تطبيقات REST. عادةً، يكون عنوان URL هو الجزء الذي تستخدمه للوصول إلى تطبيق Fusion في متصفحك.https://my.host.name/بمجرد تحديد اسم نظام Fusion Instance System Name، يتم حساب عنوان URL الأساسي استنادًا إلى المعلومات التي يوفرها معالج تكامل أدوات قاعدة البيانات. إذا لم يُقدِّم المعالج المعلومات، فسيتم حساب القيمة بناءً على معايير Oracle OCI. كأفضل ممارسة، توصي Oracle بالتحقق من تطابق أي قيمة مُقدَّمة مع بيئتك. إذا كان هذا الحساب لا يزال غير صحيح، فأدخل القيمة يدويًا.
  3. حالة واجهة برمجة التطبيقات API Status – بعد ملء عنوان URL الأساسي لواجهات برمجة تطبيقات REST، يحاول APEX الاتصال بالخادم في الموقع المحدد. تظهر حالة هذا الطلب هنا.إذا تم الاتصال بالخادم، يتم عرض هذه السمة: “200-OK“. إذا ظهرت أي حالة أخرى، فهناك مشكلة في تكوين الشبكة بين APEX ونسخة Fusion Applications. مع أنه يمكنك المتابعة وإنشاء تطبيق بدء تشغيل، إلا أنه قد لا تتمكن من تشغيله حتى يتم حل المشكلات. إذا كان تكوين الشبكة أو عنوان URL غير صحيح، فقد يستغرق هذا الفحص عدة دقائق حتى يكتمل. نصيحة: من بين المشاكل المحتملة تكوين قوائم التحكم بالوصول (ACLs) أو ACEs بشكل غير صحيح بين APEX ونسخة Fusion Applications. لمزيد من المعلومات، راجع “تمكين خدمات الشبكة في قاعدة بيانات Oracle” في دليل تثبيت Oracle APEX.
• الإعدادات المتقدمة Advanced Settings – يقوم المعالج بإنشاء السمات التالية في تطبيق البدء ويملأها مسبقًا بالقيم الافتراضية.
  • اسم التطبيق Application Name – أدخل الاسم المستخدم لتحديد التطبيق للمطورين.
  • اسم مستعار للتطبيق Application Alias – مُعرِّف أبجدي رقمي، فريد ضمن مساحة العمل، للتطبيق. يظهر هذا المُعرِّف في عنوان URL المُستخدَم للوصول إلى التطبيق.
  • معرف التطبيق Application ID – أدخل معرفًا رقميًا فريدًا لتطبيقك. يحتوي هذا الحقل على معرف مُولّد تلقائيًا افتراضيًا. معرفات التطبيقات بين 3000 و9000 محجوزة للاستخدام الداخلي من قِبل Oracle APEX. نصيحة: يمكنك تجاوز القيم الافتراضية لتوفير اسم تطبيقك واسم مستعار خاصين بك. توخَّ الحذر عند تجاوز معرف التطبيق، إذ يجب أن يكون فريدًا ضمن نسخة APEX بأكملها.
• انقر فوق إنشاء تطبيق Create Application. يُنشئ معالج إنشاء التطبيق تطبيقًا مبدئيًا ويُكمل عددًا من مهام إعداد قاعدة البيانات.