التكاملات / ERP / Oracle Fusion Cloud
دليل تكامل Oracle Fusion Cloud لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Oracle Fusion Cloud للشركاء وفرق تقنية المعلومات كيفية ربط Oracle Fusion Cloud Manufacturing بـ SkyPlanner APS. يتكامل SkyPlanner مع Oracle Fusion Cloud في الاتجاهين باستخدام موارد REST التي توفرها Oracle:
- يستقبل SkyPlanner أوامر الإنتاج وعملياتها، وتعريفات العمل، ومراكز العمل، وموارد الإنتاج، والتقاويم، والأصناف، وهياكل الأصناف، وأرصدة المخزون الفعلي، وأوامر الشراء.
- تُعاد تواريخ البدء والإكمال المخططة إلى كل عملية في أمر الإنتاج.
- تُرسل تأكيدات المشغّلين إلى Oracle لتسجيلها كمعاملات عمليات ومعاملات موارد.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يناسب إعدادات Oracle Fusion Cloud لديكم خلال التهيئة الأولية، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل مخصص للشركاء والمطورين الراغبين في المشاركة أو بناء التكامل بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهات التكامل في Oracle Fusion Cloud
يوفر Oracle Fusion Cloud ثلاثة مسارات لتبادل البيانات مع نظام جدولة خارجي:
- REST API لـ Oracle Fusion Cloud SCM. المسار الأساسي هو
/fscmRestApi/resources/11.13.18.05/. يستخدم نظام الجدولة الموارد التالية:workOrders(وموارده الفرعيةWorkOrderOperationوWorkOrderOperationResourceوWorkOrderOperationMaterial)، وprocessWorkOrders، وworkDefinitions، وworkCenters، وproductionResources، وcalendars، وitemsV2، وitemStructures، وinventoryOnhandBalances. تُرسل بيانات تقدم التنفيذ إلىoperationTransactionsوresourceTransactionsوmaterialTransactions. وتُجلب أوامر الشراء منpurchaseOrdersعبر Procurement REST API. (نقاط نهاية REST) - File-Based Data Import (FBDI). تنشئ عملية Import Work Orders أوامر الإنتاج أو تحدّثها مع عملياتها وموارد العمليات انطلاقًا من قالب، بينما تحمّل عملية Import Work Order Resource Transactions قيود الموارد. وتوضح Oracle القيد الزمني صراحةً: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (هذا الخيار غير مناسب لاستيراد بيانات التصنيع في الوقت الفعلي.) (المصدر)
- Oracle Integration (OIC). تتولى منصة التكامل من Oracle نقل البيانات بين Fusion والأنظمة الأخرى. ويتوفر في Oracle Integration قالب تكامل يستمع إلى حدث Work Order Status Change في Oracle Fusion Cloud Manufacturing (المصدر). استخدموا هذا المسار إذا كانت شركتكم تستخدم OIC بالفعل.
REST هو المسار الرئيسي للجدولة المباشرة، أما FBDI فيناسب التحميل الأولي للبيانات الرئيسية.
المصادقة والوصول
- أمان REST في Oracle. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (تستخدم واجهات REST API في Fusion Applications سياسة أمان عامة من Oracle Web Services Manager (OWSM) تسمى Multi Token Over SSL RESTful Service Policy.) تقبل هذه السياسة المصادقة الأساسية عبر SSL والمصادقة القائمة على الرموز، مثل رمز حامل SAML 2.0. (دليل البدء السريع)
- مستخدم التكامل. أنشئوا مستخدمًا مخصصًا للتكامل في Oracle، وأسندوا إليه أدوارًا وظيفية تمنحه الصلاحيات اللازمة لأوامر الإنتاج وتعريفات العمل والمخزون والمعاملات، مع قصرها على مؤسسات التصنيع المشمولة بالنطاق.
- تقسيم النتائج إلى صفحات. تضع Oracle حدًا لعدد السجلات التي يعيدها استدعاء SCM REST الواحد، لذا استخدموا
limitوoffsetعند القراءة، مع تصفية النتائج حسب المؤسسة والحالة (المصدر)
في SkyPlanner، تستخدم REST API رمز API للمصادقة ضمن ترويسة Authorization-Token (إعدادات SkyPlanner > API)، وهي موثّقة في Swagger/OpenAPI. يشرح دليل التكامل التعليمي خطوات إجراء الاستدعاءات الأولى.
الأحداث والاستقصاء الدوري
تُجلب البيانات من Oracle بالاستقصاء الدوري. تلتقط استعلامات REST المصفّاة أوامر الإنتاج الجديدة والمعدّلة، وتغييرات الحالة إلى مُصدَر، وأرصدة المخزون الفعلي، وأوامر الشراء. يُضبط تكرار الاستقصاء لكل مصنع، من مرة كل بضع دقائق لأوامر الإنتاج إلى مرة كل ساعة للمخزون. وإذا كنتم تستخدمون Oracle Integration، فيمكن لحدث Work Order Status Change أن يطلق قراءة فورية.
يرسل SkyPlanner إشعارات webhook عند تغير الحالة أو الجدول، لذا تعتمد إعادة البيانات على الأحداث.
ربط البيانات
| كائن Oracle Fusion Cloud (مورد REST) | كائن SkyPlanner | الاتجاه | التكرار |
|---|---|---|---|
الأصناف (itemsV2)، ووحدات القياس | المنتجات والمواد | Oracle → SkyPlanner | تحميل أولي، ثم استقصاء دوري |
هياكل الأصناف (itemStructures) | هيكل المنتج، والمنتجات الفرعية، والمواد لكل منتج | Oracle → SkyPlanner | تحميل أولي، ثم عند التغيير |
تعريفات العمل (workDefinitions): العمليات، وموارد العمليات، والاستخدام، وBasis Type | خطوات العملية مع مددها وأوقات الإعداد والتفكيك | Oracle → SkyPlanner | تحميل أولي، ثم عند التغيير |
مراكز العمل (workCenters)، وموارد الإنتاج (productionResources) للمعدات والعمالة | محطات العمل، ومجموعات محطات العمل، والعاملون، ومعدلات الكفاءة | Oracle → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
التقاويم والورديات (calendars، واستثناءات الورديات) | الورديات وأيام عدم العمل | Oracle → SkyPlanner | يوميًا، أو إدارة الورديات مباشرةً في SkyPlanner |
| مؤسسات التصنيع | مجموعات محطات العمل لكل مصنع | Oracle → SkyPlanner | تحميل أولي |
أوامر الإنتاج (workOrders، processWorkOrders) مع WorkOrderOperation وWorkOrderOperationMaterial | الأوامر والمهام مع مواعيد استحقاقها واحتياجاتها من المواد | Oracle → SkyPlanner | استقصاء كل بضع دقائق |
أرصدة المخزون الفعلي (inventoryOnhandBalances) | أرصدة المخزون | Oracle → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
أوامر الشراء (purchaseOrders) مع مواعيد التسليم المتعهد بها | أوامر الشراء، والمواد الواردة حسب موعد التسليم | Oracle → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
WorkOrderOperation PlannedStartDate، PlannedCompletionDate (PATCH) | البدء والانتهاء المخططان لكل مهمة | SkyPlanner → Oracle | عند تغيير الجدول، عبر إشعار webhook من SkyPlanner |
تواريخ WorkOrderOperationResource (PATCH) | تعيين الموارد لكل مهمة | SkyPlanner → Oracle | عند تغيير الجدول، إذا اعتُمد هذا الخيار |
operationTransactions (POST) | الكميات المنجزة لكل عملية | SkyPlanner → Oracle | مع كل تأكيد |
resourceTransactions (POST) | سجلات الوقت: وقت العمالة والآلات | SkyPlanner → Oracle | مع كل تأكيد أو كل وردية، إذا اعتُمد هذا الخيار |
| غير موجود في Oracle Fusion Cloud | مصفوفة أوقات الإعداد، والأدوات كموارد ذات طاقة محدودة، والآلات والعاملون البدلاء | تُدار في SkyPlanner | تُضبط خلال التهيئة الأولية |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأوا الأصناف وهياكل الأصناف وتعريفات العمل ومراكز العمل وموارد الإنتاج والتقاويم عبر REST، أو حمّلوها مرة واحدة من مستخرجات FBDI. حدّدوا بعناية كيفية تمثيل مراكز العمل: يمكن تمثيل مركز عمل يضم أربع آلات من المورد نفسه بمجموعة واحدة لمحطات العمل أو بأربع محطات عمل. وتُمثَّل كل مؤسسة تصنيع بمجموعة لمحطات العمل، لتجتمع جميع المصانع في خطة واحدة.
2. مزامنة أوامر الإنتاج. اقرأوا أوامر الإنتاج المُصدَرة وغير المُصدَرة مع عملياتها وموادها، إضافةً إلى أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحةً في موعد تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered.
جدوِلوا أوامر الإنتاج، لا الأوامر المخططة في Supply Planning. يجب تحويل الأوامر المخططة إلى أوامر إنتاج في Oracle أولًا.
3. إعادة كتابة بيانات الجدول إلى Oracle. عندما يضع المحرك مهمة في الجدول أو ينقلها، يطلق إشعار webhook من SkyPlanner طلب PATCH إلى workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} يتضمن PlannedStartDate وPlannedCompletionDate. وتسري قاعدة Oracle التالية: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (يجب ألا يسبق تاريخ البدء المخطط تاريخ بدء أمر الإنتاج أو يتجاوز تاريخ انتهائه.) (المصدر) لذلك، إذا امتد الجدول الجديد خارج هذه التواريخ، يحدّث التكامل أولًا تواريخ رأس أمر الإنتاج بطلب PATCH، ثم يحدّث العمليات.
4. تأكيدات العمل في المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الوقت الجدول محدّثًا. تُرسل الكميات المنجزة إلى operationTransactions، ووقت العمالة والآلات إلى resourceTransactions. وإذا كان مصنعكم يسجّل تقدم التنفيذ في Oracle بالفعل، فإن SkyPlanner يقرأ هذه البيانات بدلًا من ذلك.
5. قواعد ملكية البيانات وحل التعارضات. دوّنها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، وهياكل الأصناف، وتعريفات العمل، والكميات، وحالة أمر الإنتاج | Oracle Fusion Cloud |
| تسلسل العمليات، وأوقات البدء والإكمال، وتعيين الموارد | SkyPlanner |
| مصفوفة أوقات التجهيز والانتقال بين المهام، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| الورديات وأيام عدم العمل | نظام واحد يُختار خلال تحديد النطاق |
| معاملات الموارد والعمليات والمواد | Oracle، بإدخالها فيه مباشرةً أو بإرسالها من سجلات الوقت في SkyPlanner |
حدّد نظامًا واحدًا لكتابة تواريخ العمليات. لا يحتاج SkyPlanner إلى مساحة عمل للجدولة في Oracle، لذا يحلّ محل Production Scheduling في كتابة التواريخ المخططة. وإذا استمر Production Scheduling في إصدار الجداول، فافصل المؤسسات التي يتولى جدولتها عن المؤسسات التي يجدولها SkyPlanner.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة، حتى في الشركات الكبيرة. وقبل ذلك، تحقّق من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام مراكز العمل وتعريفات العمل وأوامر الإنتاج المفتوحة المصدّرة من Oracle بصيغة CSV أو Excel.
- ربط البيانات. اعتمد جدول ربط البيانات، وقواعد ملكيتها، والمؤسسات المشمولة بالنطاق، ووتيرة المزامنة، وما إذا كانت المعاملات ستُرحّل إلى Oracle.
- الوصول إلى Oracle. أنشئ مستخدم التكامل والأدوار. اختبر أولًا في بيئة Oracle غير مخصصة للإنتاج الفعلي.
- التحميل الأولي. الأصناف، وهياكل الأصناف، وتعريفات العمل، ومراكز العمل، وموارد الإنتاج، والتقويمات.
- مزامنة أوامر الإنتاج وأوامر الشراء. استعلام دوري مع التصفية وتقسيم النتائج إلى صفحات وإعادة المحاولة.
- إعداد القيود في SkyPlanner. اضبط مصفوفة أوقات التجهيز والانتقال بين المهام، والأدوات، وعدد المشغّلين لكل مهمة، والآلات أو العاملين البدلاء.
- إعادة كتابة الجدول إلى Oracle. طلبات PATCH تنطلق من إشعارات الويب في SkyPlanner، مع ترحيل المعاملات إذا اخترت ذلك.
- الاختبار بالتوازي. شغّل SkyPlanner بالتوازي مع الخطة الحالية، وقارن التواريخ، وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة إلى Oracle في كل مصنع على حدة بعد تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Oracle Fusion Cloud
- سلوك محرك الجدولة الافتراضي. يعمل محرك Oracle الذي لا يراعي قيود الطاقة الاستيعابية عند الإنشاء وعند “certain update actions” (إجراءات تحديث معيّنة). اختبر في بيئتك أيّ التحديثات تعيد حساب التواريخ، واجعل SkyPlanner آخر نظام يكتب تواريخ العمليات.
- النطاق الزمني لأمر الإنتاج. يجب أن تقع تواريخ العمليات بين تاريخَي بدء أمر الإنتاج وإكماله. حدّث رأس الأمر باستخدام PATCH أولًا.
- Basis Type. يُحسب استخدام المورد لكل وحدة فقط عندما تكون قيمة Basis Type هي Variable. أما Fixed فيعني وقتًا ثابتًا لكل عملية. حوّل القيم عند الاستيراد، وإلا فستكون جميع المدد غير صحيحة.
- التصنيع المنفصل والتصنيع بالعمليات. تستخدم مصانع التصنيع المنفصل
workOrders، وتستخدم مصانع التصنيع بالعملياتprocessWorkOrders. أدرج الاثنين في ربط البيانات إذا كنت تستخدم نمطَي التصنيع. - تقسيم النتائج إلى صفحات. يضع Oracle حدًا لعدد السجلات في كل استدعاء REST. قسّم نتائج كل استعلام إلى صفحات، وصفِّها حسب المؤسسة والحالة.
- التحديثات ربع السنوية. تحدّث Oracle نظام Fusion كل ربع سنة. ثبّت إصدار REST في المسار، وأعد الاختبار بعد كل تحديث.
- قواعد الحالة. يجب ألا تُعيَّن تواريخ جديدة لأوامر الإنتاج التي تكون حالتها Pending Approval أو تكون مغلقة. استبعدها بالتصفية عند القراءة.
من يتولى إعداد التكامل مع Oracle Fusion Cloud ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي، ضمن موارد REST والمؤسسات المتفق عليها. تختلف طريقة استخدام Oracle Fusion Cloud من مصنع إلى آخر، وهنا تُوظَّف هذه الخبرة.
- يمكن لشريك Oracle الذي تتعامل معه المشاركة. فهو يعرف مؤسساتك وأدوارك وامتداداتك، ويمكنه إعداد مستخدم التكامل والأدوار وأي تدفقات في Oracle Integration بالتعاون مع فريق SkyPlanner.
- يمكن لمطوّريك البناء على هذا التكامل باستخدام REST API الخاص بـ SkyPlanner ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفر وثائق التكامل في وثائق تكامل SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا مع باقتك، وفقًا لعملياتك واحتياجاتك. اطّلع على الأسعار، وتخطيط الإنتاج مع Oracle Fusion Cloud بما يراعي الطاقة الفعلية للآلات والعاملين، وصفحة Oracle Fusion Cloud، ومركز تكاملات ERP. هل تستخدم NetSuite؟ راجع دليل التكامل مع NetSuite.
آراء المصنّعين في SkyPlanner
2 ساعةتُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة التوريد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج خلال ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · صناعة الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
99.2%الالتزام بمواعيد التسليم
“أتاح SkyPlanner رؤية أوضح لتحديد الاختناقات، وجعل إدارة الإنتاج أكثر وضوحًا.”
توني تووري، مدير الإنتاج
Piristeel · أنظمة السلامة على الأسطح وتصريف مياه الأمطار
بلغ الالتزام بمواعيد التسليم 99.2% هذا العام، وتوفّر الجدولة ما يصل إلى أربع ساعات من وقت العمل يوميًا.
1,000sمن أوامر الإنتاج تُجدول تلقائيًا
“أصبحت سيطرتنا على الإنتاج مختلفة، وانتقل فهمنا للطاقة الاستيعابية إلى مستوى مختلف تمامًا.”
هانو رينانن، الرئيس التنفيذي
Mamec · خلاطات صناعية ومضخات وتصنيع تعاقدي عالي التقنية
تُجدول آلاف أوامر الإنتاج تلقائيًا، مع إتاحة رؤية للإنتاج في الوقت الفعلي لجميع أقسام المؤسسة.
الأسئلة الشائعة
هل يوفّر Oracle Fusion Cloud واجهة API لأوامر الإنتاج؟
نعم. تتضمن REST API الخاصة بـ Oracle Fusion Cloud SCM المورد workOrders مع موارد فرعية للعمليات والموارد والمواد، إضافةً إلى processWorkOrders للتصنيع بالعمليات. وهي تدعم GET وPOST وPATCH.
كيف تُعاد التواريخ المخططة إلى Oracle Fusion Cloud وتُسجَّل فيه؟
باستخدام طلب PATCH على المورد الفرعي WorkOrderOperation التابع لأمر الإنتاج، لتعيين PlannedStartDate وPlannedCompletionDate. يجب أن تبقى تواريخ العمليات ضمن النطاق الزمني لأمر الإنتاج، لذا يُحدَّث رأس الأمر باستخدام PATCH أولًا عند الحاجة.
كيف تصل تأكيدات المشغّلين إلى Oracle؟
تُرحَّل الكميات المكتملة إلى operationTransactions، وأوقات عمل العاملين والآلات إلى resourceTransactions. وكلاهما مورد REST يدعم POST في Fusion Manufacturing.
هل يدعم Oracle Fusion Cloud إشعارات الويب؟
ينشر Fusion أحداث أعمال مثل Work Order Status Change، ويمكن لـ Oracle Integration الاشتراك فيها. ومن دون Oracle Integration، يستعلم التكامل دوريًا من REST API وفق جدول يُحدَّد لكل مصنع. أما إشعارات الويب الخاصة بـ SkyPlanner فترسل تغييرات الجدول فور حدوثها.
هل ينبغي لشريك Oracle اقتراح Oracle Production Scheduling أم SkyPlanner؟
SkyPlanner، عندما يريد العميل جدولًا واحدًا عبر المصانع يراعي الطاقة الاستيعابية الفعلية ويحدّث نفسه باستمرار. يُفعَّل Production Scheduling ضمن عرض Supply Chain Planning، ويحسب الجدول لكل مؤسسة جدولة على حدة، ولا يطبّق قواعد وقت التغيير إلا على المعدات ذات الوحدة الواحدة (وثائق Oracle). يتصل SkyPlanner عبر SCM REST API، ويعيد التخطيط تلقائيًا، ويخطط لأوقات التغيير والأدوات وفرق العمل والمواد، ويتيح عددًا غير محدود من المستخدمين، بسعر يبدأ من 199 € شهريًا.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Oracle بصيغة CSV أو Excel، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
