إنشاء ارتباطات التطبيق في التطبيقات الخارجية

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

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

  • location=<مفتاح التنقل> - إذا كانت الصفحة المحددة المراد تشغيلها معروفة، يمكن أن تكون قيمة مفتاح التنقل لهذه الصفحة جزءًا من عنوان URL باستخدام 'location='. على سبيل المثال، إذا قامت عملية الموافقة بإرسال رسالة بريد إلكتروني إلى مستخدم للموافقة على تسوية، يمكن أن يتضمن الرابط الذي تم تكوينه في رسالة البريد الإلكتروني مفتاح التنقل للتسوية.
  • script=< اسم سكريبت مساعد عمليات الأعمال > - في كل حالة استخدام تقريبًا، يلزم سكريبت للمساعدة على التنقل إلى الصفحة الصحيحة وعرض المعلومات الصحيحة. حتى إذا كان الموقع معروفًا وتم إدخاله في عنوان URL، إذا كانت هناك بيانات سياق مدخلة كمعلمة، فمن مسؤولية السكريبت نقل بيانات المعلمة هذه من عنوان URL إلى نموذج بيانات الصفحة، حتى تتمكن الصفحة من الوصول إلى المعلومات وعرض السجل الصحيح. في الحالات التي تكون فيها الصفحة الهدف ديناميكية استنادًا إلى المعلومات المقدمة بواسطة المعلمات، يمكن استخدام السكريبت لتحديد الصفحة المطلوب تشغيلها.
  • portal=true - عند استخدام معلمة الموقع حيث الصفحة الهدف هي صفحة بوابة وبيانات السياق المدخلة، استخدم هذه المعلمة. يسمح للنظام بمعرفة أنه يجب إدخال بيانات المعلمة إلى سياق البوابة.
  • initNav=false - وفقًا للإعدادات الافتراضية، في حالة إدخال سكريبت، لكن لم يتم إدخال سمة الموقع، فسينتقل النظام إلى الصفحة الرئيسية للمستخدم قبل تنفيذ السكريبت. إذا تضمن السكريبت نفسه خطوة للتنقل إلى صفحة هدف كإحدى الخطوات الأولية الخاصة به، التنقل إلى الصفحة الرئيسية غير ضروري ويمكن أن يؤدي إلى تدهور الأداء. يمكن تضمين هذه السمة الاختيارية في عنوان URL لتجاوز الصفحة الرئيسية.
    ملاحظة: لا يزال النظام يتطلب صفحة ليتم تشغيلها لأسباب فنية. يتم استخدام بوابة فارغة بدون مناطق لهذا الغرض. يمكن أن يتم عرض هذه البوابة (التي تسمى تشغيل التطبيق) للمستخدمين بإيجاز قبل بدء التنقل بواسطة السكريبت. بالإضافة إلى ذلك، هذه هي البوابة التي سيلجأ إليها المستخدم في حالة وجود أي أخطاء في السكريبت أو في حالة عدم تنقل السكريبت إلى أي مكان.
  • minDashboard=true - يعمل هذا الخيار على تصغير منطقة لوحة المعلومات كجزء من تشغيل التطبيق. (سيتمكن المستخدم من تكبير لوحة المعلومات نفسها إذا لزم الأمر). يمكنك استخدام هذا الخيار لتحسين سرعة تشغيل التطبيق. ويعتمد مدى فائدة ذلك على حالة الاستخدام. إذا كان سبب تشغيل التطبيق هو نقل المستخدم إلى سجل محدد لعرض تفاصيل هذا السجل، فقد تعمل لوحة المعلومات على توفير معلومات قيِّمة حول السجل. في هذه الحالة، قد يكون صحيحًا عرض لوحة المعلومات افتراضيًا (وليس تضمين هذه المعلمة في عنوان URL). من ناحية أخرى، إذا كانت حالة الاستخدام هي وجود مستخدم بالفعل في التطبيق والنقر فوق ارتباط يفتح علامة تبويب مستعرض جديدة لإظهار التفاصيل الخاصة بالمستخدم حول سجل محدد، مع إبقاء الصفحة الأصلية مفتوحة في علامة التبويب الأولى، فقد تحتوي لوحة المعلومات على نفس المعلومات المرئية بالفعل في علامة التبويب الأصلية. في هذه الحالة، قد يكون تصغير لوحة المعلومات مفيدًا.

على سبيل المثال، يوضح عنوان URL التالي بدء تشغيل السكريبت CM-StopAutoPay لحساب محدد، بافتراض أن عنوان URL الخاص بالتطبيق لبدء تشغيل النظام هو http://system-server:1234/cis.jsp:

  • http://system-server:1234/cis.jsp?script=CM-StopAutoPay&ACCT_​ID=1234512345&location=accountMaint

لن يكون من الضروري مراعاة الترتيب عند إضافة المعلمات. حيث يقوم النظام بمعالجتها بالترتيب الصحيح. على سبيل المثال، يقوم النظام بمعالجة الأمثلة التالية بنفس الترتيب:

  • http://system-server:1234/cis.jsp?ACCT_​ID=1234512345&script=CM-StopAutoPay&location=accountMaint
  • http://system-server:1234/cis.jsp?ACCT_​ID=1234512345&location=accountMaint&script=CM-StopAutoPay

يتم حفظ هذه المعلمات في منطقة عامة يمكن الوصول إليها من جانب أي سكريبت وذلك بهدف استمرار عمل الجلسة. لاستخدام هذه المعلمات في أحد السكريبتات يمكنك الإشارة إلى %PARM-<name> المتغيرات العامة المتوافقة. في هذا المثال، بعد بدء تشغيل النظام، يمكن لأي سكريبت الوصول إلى قيمة معلمة معرف الحساب السابقة من خلال المتغير العام %PARM-ACCT_ID. لاحظ أيضًا أن هذه المعلمات يتم تحميلها في التخزين المؤقت (لمتابعة المثال، سوف يكون هناك أيضًا متغير تخزين مؤقت يسمى ACCT_​ID والذي يحتفظ بالقيمة المدخلة).

تحديد عنوان URL الخاص بالتطبيق

عند إنشاء الارتباط من داخل منطق التطبيق، يمكن استخدام سكريبت الخدمة F1-EnviURL لاسترجاع معلومات عنوان URL للتطبيق وإنشائها.

التنقل إلى بوابة صيانة السجل المحدد

يوفر المنتج سكريبت F1-GotoPrtl (تنقل إلى البوابة لكائن صيانة وقيم المفاتيح) الذي يمكن استخدامه لأي حالة استخدام تنتقل ببساطة إلى صفحة الصيانة لسجل محدد وتعرض هذا السجل. هذا السكريبت غير قابل للتطبيق إلا على السجلات التي يتم التحكم فيها بواسطة كائن عمل (وحدد خيار تنقل كخيار كائن عمل (BO)). يتطلب المعلمات mo= برمز كائن الصيانة للسجل والمعلمات pkValue1= من خلال pkValue5= لتوفير قيم المفاتيح. يتم البحث عن خيار تنقل البوابة المناسب من كائن عمل السجل وملء المفاتيح في "نموذج بيانات الصفحة" والتنقل إلى البوابة.

كما يوصى أيضًا بتضمين السمة initNav=false عند إنشاء عنوان URL بهذا السكريبت. يقوم المثال أدناه بالتنقل إلى بوابة مجموعة بيانات الترحيل المناسبة لكائن عمل المعرف المحدد.

  • http://system-server:1234/cis.jsp?script=F1-GotoPrtl&pkValue1=1234512345&mo=F1-MIGRDS&initNav=false