تكوين تكامل العملية بين Oracle Integration وOracle Content Management

قبل أن تتمكن أنت أو أي مستخدم من الوصول إلى ميزات المحادثة والمستندات، يجب على المسئول تكوين الإعدادات في كل من Oracle Content Management وOracle Integration.

يمكن للمستخدم الذي يمتلك امتيازات المسئول فقط تأسيس اتصال بين خدمتي الخدمة.

بالنسبة لتطبيقات العمليات التي تم تكوينها قبل تكوين الاتصال بـ Oracle Content Management، يتم تعطيل ميزات المحادثات والمستندات بشكل افتراضي. يمكن للمطورين تمكين هذه الميزات يدويًا في تطبيقاتهم الحالية.

متطلبات الوصول لتكامل ناجح

لاحظ متطلبات الوصول هذه لتكامل ناجح:

• يجب أن يتمتع مستخدم Oracle Content Management الذي تم تكوينه في Oracle Integration بصلاحية وصول كاملة للمجلد (أي مجلد المستند الوارد) الذي تم تكوينه في Oracle Content Management حتى يتمكن من بدء عملية.

• بالنسبة للعملية التي يتم بدؤها بواسطة مجلد (أي عملية ذات حدث بدء المجلد)، يجب أن يكون لمستخدم Oracle Content Management الذي تم تكوينه في Oracle Integration صلاحية وصول المدير إلى المجلد حتى يتمكن من الوصول إلى مجلده في Oracle Integration. على سبيل المثال، يلزم وصول المدير لرؤية المجلد في صفحة تفاصيل المهمة وصفحة تعقب العملية، للوصول إلى المجلد عند تضمين مكونات واجهة مستخدم العملية في تطبيق خارجي، أو الاطلاع على المجلد في تطبيق الأجهزة المتنقلة للعملية.

• لرؤية عملية في قائمة العمليات لمجلد، ولتتمكن من بدء طبعة عملية عند وصول مستند جديد، يجب منح مستخدم Oracle Integration الذي تم تكوينه في Oracle Content Management دور بادئ العملية.

استخدام المستندات أو المرفقات في تطبيق معالجة

يشتمل Oracle Integration تلقائيًا على وظيفة مرفق الملف القياسية في تطبيقات العمليات الخاصة بك. يمكنك تحميل الملفات وإرفاقها بعملية. عند استخدام Oracle Content Management مع Oracle Integration، تحصل أيضًا على وظيفة المستندات، التي تتيح لك تحميل الملفات وتنظيم الملفات في مجلدات وإدارة الوصول إلى كل مجلد، وحتى بدء عملية عن طريق تحميل مستند. بالإضافة إلى ذلك، يكون لكل تطبيق عملية خيار استخدام مستندات أو مرفقات.

يمكنك التحكم فيما إذا كانت العملية تستخدم مستندات أو مرفقات على مستوى التطبيق. يتم تمكين المستندات بشكل افتراضي. يكون الإعداد في جزء "معلومات" للتطبيق.

وصف الشكل التوضيحي enable-docs-app-level-cb.png

يمكن للتطبيق الذي تم تمكين تكامل المستندات له استخدام المستندات (والمستندات فقط). يمكن للتطبيق الذي يحتوي على تكامل المستندات معطل استخدام المرفقات فقط. بشكل أساسي، عن طريق تعطيل المستندات لأحد التطبيقات، يمكنك تمكين المرفقات لهذا التطبيق.

تذكر أن الإعداد ينطبق على التطبيق. يمكنك استخدام المستندات أو المرفقات في تطبيق، لكن ليس كليهما.

بالنسبة للمرفقات، تأكد من إلغاء تحديد الخيار إخفاء المرفقات في شاشة تخصيص واجهة المستخدم. في حالة تحديد الخيار إخفاء المرفقات، لن تتمكن من رؤية المرفقات في تفاصيل المهمة ونماذج البدء.

إذا كنت تستخدم واجهات REST API للتفاعل مع Oracle Integration، فتأكد من استخدام واجهة برمجة التطبيقات المناسبة وفقًا لما إذا كان تطبيق المعالجة يستخدم المستندات أو المرفقات أم لا:

• بالنسبة للمستندات، تأكد من استخدام /folders REST API.

• بالنسبة للمرفقات، تأكد من استخدام الواجهات البرمجية للتطبيق لخدمة REST للمرفقات.

في حالة استخدام واجهة برمجة تطبيقات خاطئة، يقوم التطبيق إما بإرجاع رسالة خطأ أو ينتهي في حالة عدم إجراء عملية.

لاحظ أنه في حالة تعذر عرض المرفقات في تفاصيل المهمة، قم بفحص الخيارات في شاشة تخصيص واجهة المستخدم. تأكد من إلغاء تحديد مربع الاختيار إخفاء المرفقات لعرض المرفقات.

تكوين إعدادات Oracle Integration في Oracle Content Management

تمكين Oracle Integration للمستندات في Oracle Content Management.

1. قم بتسجيل الدخول إلى Oracle Content Management كمسئول.
2. من القائمة إدارة، اختر عمليات التكامل.
3. ضمن التطبيقات، حدد Oracle Integration لتمكين الخدمة، ثم قم بتعيين هذه القيم:
   • عنوان URL للخدمة: عنوان URL لخدمة REST التي يمكن للمستخدمين الوصول إليها لتطبيقاتهم، تنتهي بـ bpm/api/4.0/processes (على سبيل المثال، https://servicename/bpm/api/4.0/processes).
   • مستخدم الخدمة: أدخل عنوان البريد الإلكتروني للمستخدم الذي يمتلك العملية المطلوب استخدامها في Oracle Content Management.
   • كلمة مرور الخدمة: أدخل كلمة مرور المستخدم.

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

عندما يبدأ Oracle Content Management عملية، يتم إرسال الحمولة التالية لتشغيل العملية:

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

بصفتك مطورًا، يجب أن تكون على دراية بالمتطلبات التالية للعملية التي تقوم بتطويرها:

• يجب أن تكون عملية تستخدم حدث بداية مستند Oracle Content Management.
• عند نشر العملية، يجب مشاركتها مع المستخدم المحدد لتمكين التكامل حتى يكون للمستخدم حقوق إطلاق العملية،
• بالنسبة للمستخدم الذي قام بتحميل الملف لإظهاره كمستخدم قام ببدء المهمة، يجب أن تستخدم العملية القيمة التي تم إدخالها في الحقل بدء بواسطة كاسم عرض للبادئ.

تكوين إعدادات المستندات في Oracle Integration

بصفتك المسئول، يجب تكوين الاتصال بين Oracle Integration وOracle Content Management. يجب إدخال معلومات مثل عنوان URL وبيانات اعتماد تسجيل الدخول لـ Oracle Content Management.

لتكوين الإعدادات في Oracle Integration:

1. في جزء التنقل Oracle Integration، انقر على المهام الخاصة بي، وانقر على مساحة العمل، ثم انقر على الإدارة.
2. انقر على الخدمات.
3. في قسم Oracle Content Management، أدخل المعلومات التالية:
   • عنوان URL: عنوان الويب الخاص بـ Oracle Content Management. يستقبل مسئول الخدمة مرحبًا بك في بريد Oracle Cloud الإلكتروني عندما تكون الخدمة جاهزة للاستخدام. يشتمل البريد الإلكتروني على عنوان URL لـ Oracle Content Management. على سبيل المثال، https://your_service_name.com/documents.
   • نطاق الهوية: اسم نطاق الهوية الذي ينتمي إليه Oracle Content Management. يمكنك تكوين اتصال بنجاح بـ Oracle Content Management (لخاصية المستندات) دون توفير نطاق هوية.
   • المستخدم وكلمة السر: صلاحيات الحساب لمستخدم لديه صلاحية الوصول إلى Oracle Content Management. يتم استخدام حساب المستخدم هذا لاختبار الاتصال بين الخدمات. كما يُستخدم أيضًا أثناء وقت التشغيل للاتصال بالخدمات وتنفيذ كل عمليات وقت التشغيل، مثل تكوين المجلدات.

   هام:

   إذا كنت تريد التعاون باستخدام المحادثات، فيجب تعيين الدور التالي للمستخدم الذي تحدده هنا:

   service_instance_name.CECIntegrationUser

   استخدم تطبيق Oracle Cloud My Services لتعيين أدوار لمستخدميك.

4. انقر على اختبار.

   كلما قمت بإجراء أي تغييرات على إعدادات التكوين، فمن الأفضل التحقق من صحة القيم التي قمت بإدخالها. تريد تأكيد إنشاء اتصال ناجح باستخدام Oracle Content Management.

   راجع نتائج الاختبار التي قد تتضمن رسائل وأخطاء وتحذيرات.

5. حدد أحد الخيارات التالية للاستمرار:
   • في حالة وجود أية أخطاء أو تحذيرات، قم بإجراء التغييرات اللازمة ثم انقر على اختبار مرة أخرى للتحقق من القيم الجديدة. كرر الاختبار في كل مرة تقوم فيها بتغيير الإعدادات.
   • إذا نجح اختبار الاتصال، فانقر على حفظ لحفظ إعدادات التكوين.
   • إذا أردت الإلغاء والرجوع إلى آخر قيم محفوظة، انقر على تراجع.