دليل تكامل monday.com لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط لوحات monday.com بـ SkyPlanner APS. يتيح التكامل تبادل البيانات بين SkyPlanner وmonday.com في الاتجاهين:
- تُرسل عناصر الطلبات إلى SkyPlanner مع بيانات المنتج والكمية وتاريخ الاستحقاق والأولوية والحالة.
- يُكتب موعدا البدء والانتهاء المخططان في عمود Timeline، وتُسجّل محطة العمل في عمود مستقل.
- يُحدَّث عمود Status بناءً على تقدم عمل المشغّلين في صالة الإنتاج.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل ليتوافق مع لوحاتك خلال مرحلة الإعداد، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطوّرين الذين يرغبون في المشاركة، أو تطوير حلول بأنفسهم اعتمادًا على REST API الموثّقة من SkyPlanner (مرجع API).
واجهة API لمنصة monday.com
توفّر monday.com واجهة GraphQL API واحدة على العنوان POST https://api.monday.com/v2. تصدر نسخة منها كل ثلاثة أشهر، ويمكنك تثبيت النسخة المستخدمة عبر الترويسة API-Version. ويُعلَن عن إيقاف دعم الميزات قبل ستة أشهر على الأقل. (إصدارات API)
يستخدم تكامل الجدولة الكائنات التالية:
- Boards وgroups، وتُستخدم غالبًا لتنظيم المراحل أو الأسابيع.
- Items وsubitems. يمثّل العنصر عادةً طلبًا أو مهمة إنتاج، وتُسجّل العمليات في العناصر الفرعية.
- Column values: Status وDate وTimeline وNumbers وPeople وDependency وTime Tracking وConnect Boards وMirror.
- Webhooks لأحداث التغيير.
تستخدم عمليات القراءة items_page ضمن لوحة أو مجموعة. تحتوي الصفحة افتراضيًا على 25 عنصرًا، و”the maximum is 500.” (وهو الحد الأقصى لعدد العناصر). وتتابع القراءة باستخدام next_items_page، مع مراعاة أن “each cursor will expire 60 minutes after the first request.” (أي تنتهي صلاحية كل مؤشر بعد المدة المذكورة من الطلب الأول). استخدم query_params للتصفية وقراءة الطلبات المفتوحة فقط. (items_page)
تستخدم عمليات الكتابة create_item وcreate_subitem وchange_column_value وchange_multiple_column_values. يحدّث الاستدعاء الأخير عدة أعمدة لعنصر واحد في استدعاء واحد، وهو ما تحتاجه إعادة كتابة بيانات الجدول إلى monday.com.
لتحميل كميات كبيرة من البيانات، يضيف إصدار API 2026-07 والإصدارات اللاحقة ingest_items وbackfill_items. ترفع ملف CSV إلى عنوان URL موقّع مسبقًا، ثم تستعلم دوريًا عن حالة مهمة الاستيراد. (الاستيراد الجماعي)
المصادقة
تدعم monday.com ثلاثة أنواع من الرموز:
- رمز API شخصي. “Each token is unique to a user” (كل رمز مخصّص لمستخدم بعينه)، ويحمل صلاحيات ذلك المستخدم. وهو مناسب لإثبات المفهوم.
- رمز تطبيق مع نطاقات للصلاحيات، لاستخدامه في تطبيق التكامل.
- OAuth عبر
auth.monday.com/oauth2/authorizeو/oauth2/token، بنطاقات مثلboards:readوboards:writeوwebhooks:readوwebhooks:write.
استخدم رمز تطبيق أو رمز OAuth في بيئة التشغيل الفعلي. يتوقف الرمز الشخصي عن العمل عندما يعيد مالكه توليده. (المصادقة)
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة بصيغة Swagger/OpenAPI. يكفي رمز API للبدء، ويشرح دليل التكامل التطبيقي كيفية إجراء الاستدعاءات الأولى.
خطافات الويب ومطابقة البيانات
أنشئ اشتراكًا باستخدام create_webhook(board_id, url, event, config). يحتاج تكامل الجدولة إلى الأحداث التالية:
create_itemوcreate_subitemللطلبات والعمليات الجديدة.change_column_valueأوchange_specific_column_valueلتغييرات تاريخ الاستحقاق أو الكمية أو الأولوية.change_status_column_valueلتغييرات الحالة التي يجريها المستخدمون.item_archivedوitem_deletedوitem_moved_to_specific_groupللطلبات الملغاة أو المكتملة.
يجب أن يستجيب عنوان URL المستقبِل لرمز التحقق عند إنشاء خطاف الويب. عند فشل التسليم، تنص الآلية على “retry once a minute for 30 minutes,” (أي إعادة المحاولة مرة كل دقيقة طوال المدة المذكورة)، ثم تتوقف المحاولات. لذلك يجري التكامل أيضًا قراءة دورية لمطابقة البيانات باستخدام items_page مع تصفية العناصر التي حُدّثت مؤخرًا. (خطافات الويب)
وفي الاتجاه المعاكس، يرسل SkyPlanner إشعارات عبر خطافات الويب عند تغيّر الحالة أو الجدول. تستقبلها خدمة التكامل وتكتب المواعيد الجديدة في monday.com، فتُحدَّث البيانات فيه استجابةً لهذه الأحداث.
ربط البيانات
لا تتضمن monday.com كائنًا قياسيًا للطلبات، لذا يُضبط ربط معرّفات الأعمدة لكل حساب على حدة. فيما يلي الإعداد المعتاد:
| الكائن في monday.com | الكائن في SkyPlanner | اتجاه النقل | وتيرة النقل |
|---|---|---|---|
| عنصر في لوحة الإنتاج: Name وNumbers (الكمية) وDate (تاريخ الاستحقاق) وStatus أو Dropdown (الأولوية) | طلب يتضمن المنتج والكمية وتاريخ الاستحقاق والأولوية | monday.com → SkyPlanner | خطاف ويب عند الإنشاء والتغيير، إلى جانب مطابقة البيانات |
| عناصر فرعية، أو عناصر في لوحة مرتبطة عبر Connect Boards | خطوات العملية ومددها | monday.com → SkyPlanner | مع الطلب |
| عناصر في لوحة المنتجات (Mirror لبيانات المنتج) | المنتجات وبنية المنتج | monday.com → SkyPlanner | تحميل أولي، ثم عند التغيير |
| عناصر في لوحة المخزون أو المواد، إن كانت بياناتها محفوظة في monday.com | المواد وأرصدة المخزون | monday.com → SkyPlanner | قراءة مجدولة |
| عناصر في لوحة أوامر الشراء تتضمن تاريخ التسليم المتوقع | مواد واردة، متاحة في تاريخ التسليم | monday.com → SkyPlanner | خطاف ويب أو قراءة مجدولة |
| People وteams | العاملون، إذا كانت أعمال المشغّلين تُجدول | monday.com → SkyPlanner | تحميل أولي |
| غير محفوظة في monday.com | محطات العمل، والورديات، ومصفوفة أزمنة التجهيز، والأدوات، والآلات البديلة | تُدار في SkyPlanner | تُضبط خلال مرحلة الإعداد |
| عمود Timeline | موعدا البدء والانتهاء المخططان | SkyPlanner → monday.com | عند تغيّر الجدول، عبر خطاف ويب من SkyPlanner |
| عمود Status أو Dropdown أو Text | محطة العمل المعيّنة | SkyPlanner → monday.com | عند تغيّر الجدول |
| عمود Status (مثل قيد الإنتاج، مكتمل) | تقدم مهمة الإنتاج من Mobile Confirmations | SkyPlanner → monday.com | مع كل تأكيد |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأ المنتجات والمواد والطلبات المفتوحة باستخدام items_page. أنشئ محطات العمل والورديات والقيود في SkyPlanner، أو استوردها من Excel. وحدّد مبكرًا ما إذا كانت العمليات ستُسجّل كعناصر فرعية أم في لوحة مرتبطة.
2. مزامنة الطلبات. ترسل خطافات الويب في لوحة الإنتاج العناصر الجديدة والمعدّلة إلى SkyPlanner بوصفها طلبات. إذا كنت تتابع أوامر الشراء في لوحة، فسيعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ التسليم، ويحدّث المخزون عند وضع علامة «تم التسليم» على أمر الشراء.
3. إعادة كتابة الجدول. يستدعي التكامل change_multiple_column_values لكل طلب أدرجه المحرّك في الجدول أو غيّر موضعه فيه. ويضبط عمود Timeline على موعدَي البدء والانتهاء المخططين، ويملأ عمود محطة العمل. يساهم الاكتفاء باستدعاء واحد لكل عنصر في إبقاء عدد الطلبات منخفضًا.
4. تقدم العمل في صالة الإنتاج. يسجّل المشغّلون أعمالهم باستخدام Mobile Confirmations أو Production Timer أو Quick Log Mode. تحافظ سجلات الوقت على تحديث الجدول، وتُرسل تسمية Status المقابلة إلى اللوحة، ليطّلع فريق المبيعات على التقدم دون الحاجة إلى السؤال.
5. قواعد ملكية البيانات وحل التعارضات. وثّق هذه القواعد قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الطلب، والعميل، والكمية، وتاريخ الاستحقاق، والأولوية | monday.com |
| تسلسل العمليات، وموعدا البدء والانتهاء، ومحطة العمل | SkyPlanner |
| الورديات، وعمليات التجهيز، والأدوات، والآلات البديلة | SkyPlanner |
| تسميات Status التي تبيّن تقدم العمل | يكتبها SkyPlanner وتعرضها monday.com |
التعديل اليدوي لعمود Timeline هو المصدر الرئيسي للتعارضات. اتفقوا على أن تكون الكتابة في هذا العمود حصرًا على SkyPlanner، أو تعاملوا مع التعديل اليدوي بوصفه طلب تغيير، واتركوا إعادة الجدولة لـ SkyPlanner. يعيد Autopilot الجدولة تلقائيًا عند حدوث تغييرات في الإنتاج.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة الإعداد. وقبل ذلك، يمكنك استخدام بياناتك الفعلية في التجربة المجانية التي تستمر 30 يومًا: صدّر لوحة الإنتاج إلى Excel، ثم استوردها إلى SkyPlanner.
- مراجعة اللوحات. احصر اللوحات والمجموعات ومعرّفات الأعمدة وتسميات الحالة وحدّد علاقات الربط بينها، وتحقّق من خطة monday.com المستخدمة.
- الربط وملكية البيانات. اعتمد جدول الربط وقواعد ملكية البيانات ومعدلات تكرار المزامنة.
- إعداد القيود في SkyPlanner. محطات العمل، وورديات العمل، ومصفوفة أزمنة الإعداد، والأدوات، والآلات البديلة.
- مزامنة الطلبات. إشعارات الويب، وقراءة البيانات لمطابقتها، وإدارة رموز الوصول.
- إعادة كتابة البيانات. أعمدة Timeline ومحطة العمل والحالة.
- الاختبار بالتوازي. شغّل SkyPlanner بالتوازي مع اللوحة الحالية، وقارن التواريخ وصحّح البيانات.
- بدء التشغيل الفعلي. فعّل إعادة كتابة البيانات بمجرد تطابق التواريخ.
ما يجب مراعاته عند التخطيط للتكامل مع monday.com
- تختلف طريقة تمثيل الطلبات من حساب إلى آخر. فقد تُخصَّص لوحة لكل عميل، وتُمثَّل العمليات بعناصر أو عناصر فرعية، والآلات بأعمدة People أو Status. اربط البيانات بمعرّفات الأعمدة الخاصة بكل حساب، ولا تعتمد أبدًا على عناوين الأعمدة.
- حدود الباقات. تتيح باقات Free وBasic وStandard إجراء 1,000 استدعاء API يوميًا، وباقة Pro إجراء 10,000، وباقة Enterprise إجراء 25,000. استخدم إشعارات الويب لرصد التغييرات، وأعِد كتابة البيانات على دفعات باستخدام
change_multiple_column_values. (حدود معدل الاستدعاءات) - عدد اللوحات المتصلة محدود. تتيح باقة Basic اتصالًا بلوحة واحدة، وباقة Standard اتصالات بخمس لوحات، مما يحدّ من عدد لوحات العمليات أو المنتجات التي يمكن ربطها. (حدود Connect Boards)
- ثبّت إصدار API المستخدم. تتغير الإصدارات كل ربع سنة. وقبل الإصدار 2026-04، كانت اللوحات متعددة المستويات مستبعدة من استعلام اللوحات الافتراضي.
- انتهاء صلاحية مؤشر التصفح. يظل مؤشر
items_pageصالحًا لمدة 60 دقيقة. ويجب أن تتمكن عمليات مطابقة البيانات الطويلة من البدء مجددًا دون أخطاء. - حدود إشعارات الويب. يجب ألا يتجاوز طول عنوان URL عدد 255 حرفًا، وتتوقف محاولات إعادة الإرسال بعد 30 دقيقة. ويجب ألا تؤدي معالجة الإشعار نفسه أكثر من مرة إلى تغيير النتيجة لدى الجهة المستقبِلة.
- الوحدات والمدد. لا تتضمن أعمدة Numbers وحدة قياس. اتفقوا على ما إذا كانت المدة بالدقائق أو بالساعات قبل أول استيراد.
التكامل مع monday.com: من يتولى إعداده ودعمه؟
يشمل العمل تحديد الربط بين لوحاتك وأعمدتك، وإعداد القيود التي لا يحتفظ بها monday.com: محطات العمل، وورديات العمل، ومصفوفة أزمنة الإعداد، والأدوات، والآلات البديلة.
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية، ودعمه بعد بدء التشغيل الفعلي. لكل شركة طريقتها في بناء اللوحات، وهنا يوظّف الفريق خبرته.
- يمكن لشريك monday.com الذي تتعامل معه المشاركة. فهو يعرف لوحاتك وإجراءاتك المؤتمتة، ويمكنه مراجعة ربط الأعمدة وإعداد رمز الوصول.
- يمكن لمطوّريك البناء على هذا التكامل باستخدام REST API الموثّقة من SkyPlanner ورمز وصول API. يكفي رمز وصول API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تجد وثائق المنتج المتاحة للجميع في وثائق SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم لك مسبقًا عرض سعر للتكامل يناسب إجراءات عملك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء. اطّلع على مقارنة مع طرق العرض المتاحة في monday.com في صفحة تخطيط الإنتاج مع monday.com وفق الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة على صفحة monday.com، والأنظمة الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةتوفير كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
كالي كاليومّاكي، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة المهام الجديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
عبدول روسيينغا، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
6 أشهريرى فريق المبيعات الطاقة المتاحة خلالها مسبقًا
“يوفّر SkyPlanner أساسًا موثوقًا لجميع أعمال تخطيط الإنتاج.”
آنو يارفينن، مديرة الإنتاج
Fredman Operations · أوراق تغليف آمنة لملامسة الأغذية
يرى فريق المبيعات الطاقة المتاحة لستة أشهر مقبلة، ويُردّ في ثوانٍ على طلبات تعديل الجدول التي كان الرد عليها يستغرق ساعة أو أكثر.
الأسئلة الشائعة
أي API من monday.com يستخدمها التكامل؟
يستخدم API الخاصة بمنصة monday.com، وهي GraphQL API على العنوان api.monday.com/v2، مع تثبيت الإصدار في ترويسة API-Version. تستخدم عمليات القراءة items_page، وعمليات الكتابة change_multiple_column_values، وتُبلّغ إشعارات الويب عن التغييرات.
ما الذي نحتاج إلى إعداده في monday.com؟
صلاحية الوصول وعمودان. يعتمد مسؤول monday.com لديك رمز OAuth أو رمز تطبيق بصلاحيات محددة مرة واحدة، ويُضاف إلى اللوحة عمود Timeline وعمود لمحطة العمل لكتابة البيانات الواردة من التكامل فيهما. وتبقى لوحاتك وإجراءاتك المؤتمتة كما هي.
أي باقة من monday.com نحتاج إليها؟
يزداد الحد اليومي لاستدعاءات API بحسب الباقة: 1,000 في Standard والباقات الأدنى منها، و10,000 في Pro، و25,000 في Enterprise. تناسب Pro أو Enterprise المزامنة في الاتجاهين مع تغييرات متكررة. يراجع فريق SkyPlanner باقتك وحجم البيانات والاستدعاءات أثناء مراجعة اللوحات.
هل يستطيع monday.com إرسال التغييرات في الوقت الفعلي؟
نعم. تُرسَل إشعارات الويب عند إنشاء عنصر أو تغيير الأعمدة أو الحالة. وتُجرى قراءة دورية لمطابقة البيانات وتدارك الإشعارات التي لم تصل بعد انتهاء مهلة إعادة المحاولة في monday.com، ومدتها 30 دقيقة.
كيف تُكتب التواريخ المخططة في monday.com بعد التخطيط؟
باستخدام change_multiple_column_values لكل عنصر. يُكتب تاريخا البدء والانتهاء المخططان في عمود Timeline، وتُحدَّث أعمدة محطة العمل والحالة في الاستدعاء نفسه.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، باستخدام بيانات لوحتك المصدّرة إلى Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع فريق المبيعات لتحديد نطاق التكامل.
