قواعد الأتمتة¶

تسمح قواعد الأتمتة بتنفيذ إجراء واحد أو أكثر محدد مسبقاً استجابة لمشغل معين، مثل إنشاء نشاط عند تعيين حقل لقيمة معينة، أو أرشفة سجل بعد 7 أيام من آخر تحديث له.

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

لإنشاء قاعدة تلقائية باستخدام الاستوديو، اتبع ما يلي:

افتح الاستوديو وانقر فوق الأتمتة، ثم جديد.
أعط قاعدة الأتمتة اسماً واضحاً وذا معنى يحدد غرضها.
حدد المُشغِّل وإذا لزم الأمر، املأ الحقول التي تظهر على الشاشة بناءً على المُشغِّل المختار.
انقر على إضافة إجراء، ثم حدد النوع الخاص بـ:ref:الإجراء <studio/automated-actions/action> واملأ الحقول التي تظهر على الشاشة بناءً على الإجراء الذي اخترته.
انقر على حفظ وإغلاق أو حفظ وجديد.

Example

لضمان المتابعة مع العملاء الأقل رضا، تنشئ قاعدة الأتمتة هذه نشاطاً بعد 3 أشهر من إنشاء أمر بيع للعملاء الذين تقل نسبة رضاهم عن 30%.

نصيحة

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

المشغّل¶

يُستخدم المشغل لتحديد نوع الحدث الذي يجب أن يحدث لتشغيل قاعدة الأتمتة. تعتمد المشغلات المتاحة على النموذج. هناك خمس فئات من المشغلات متاحة بشكل عام:

تم تحديث القيم
فعاليات البريد الإلكتروني
شروط التوقيت
مُخصص
خارجي

إضافة الشروط¶

تسمح مرشحات النطاق بتحديد السجلات التي يجب أن تستهدفها قاعدة الأتمتة أو تستثنيها. يعزز الترشيح الفعال الأداء العام لأنه يتجنب المعالجة غير الضرورية للسجلات التي لا تتأثر بالقاعدة.

نصيحة

قم بتفعيل وضع المطور قبل إنشاء قاعدة أتمتة للحصول على أقصى قدر من المرونة في إضافة مرشحات النطاق.

اعتمادًا على المشغل المختار، من الممكن تحديد شرط واحد أو أكثر يجب أن يستوفيه السجل قبل و/أو بعد حدوث المشغل.

نطاق ما قبل التحديث يحدد الشروط التي يجب أن يستوفيها السجل قبل حدوث المشغل، على سبيل المثال، يجب أن يكون السجل النوع = فاتورة العميل و الحالة = منشورة.

مع تنشيط وضع المطور، انقر فوق تحرير النطاق، إن كان متاحًا، ثم قاعدة جديدة.
شروط إضافية، أو في بعض الحالات مُرشحات تطبيق على، تحدد الشروط التي يجب أن يستوفيها السجل بعد حدوث حدث المُشغِّل، على سبيل المثال، يجب أن تكون فاتورة العميل حالة الدفع = مدفوعة جزئيًا.

مع تنشيط وضع المطور إذا لزم الأمر، انقر فوق إضافة شروط أو تحرير النطاق، حسب الصلة، ثم قاعدة جديدة.

عندما يحدث مشغل، على سبيل المثال، يتم تحديث حالة الدفع لفاتورة عميل منشورة، تفحص قاعدة الأتمتة الشروط المحددة وتنفذ الإجراء فقط إذا كان السجل يطابق تلك الشروط.

Example

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

ملاحظة

نطاق ما قبل التحديث لا يتم فحصه عند إنشاء سجل.

تم تحديث القيم¶

قم بتشغيل الإجراءات الآلية عند حدوث تغييرات محددة في قاعدة البيانات. تعتمد المشغلات المتاحة في هذه الفئة على النموذج وتستند إلى التغييرات الشائعة، مثل إضافة علامة محددة (على سبيل المثال، إلى مهمة) أو تعيين قيمة حقل (على سبيل المثال، تعيين حقل المستخدم).

حدد المشغل، ثم حدد قيمة إذا لزم الأمر.

فعاليات البريد الإلكتروني¶

تشغيل إجراءات تلقائية عند تلقي أو إرسال رسائل البريد الإلكتروني.

شروط التوقيت¶

قم بتشغيل الإجراءات الآلية في نقطة زمنية نسبة إلى حقل تاريخ أو إلى إنشاء أو تحديث سجل. المشغلات التالية متاحة:

بناءً على حقل التاريخ: يتم تشغيل الإجراء في فترة زمنية محددة قبل أو بعد تاريخ حقل التاريخ المحدد.
بعد الإنشاء: يتم تشغيل الإجراء بعد فترة زمنية محددة من إنشاء السجل وحفظه.
بعد آخر تحديث: يتم تشغيل الإجراء بعد فترة زمنية محددة من تحرير سجل موجود وحفظه.

يمكنك بعد ذلك تحديد:

التأخير: حدد عدد الدقائق أو الساعات أو الأيام أو الأشهر. لتنفيذ إجراء قبل تاريخ المُشغِّل، حدد رقمًا سالبًا. إذا حددت مُشغِّل بناءً على حقل التاريخ، فيجب عليك أيضًا تحديد حقل التاريخ الذي سيتم استخدامه لتحديد التأخير.

ملاحظة
بشكل افتراضي، يتحقق المُجدول من قواعد التشغيل التلقائي المُشغَّلة بالوقت كل 240 دقيقة، أو 4 ساعات. هذا التكرار كافٍ عمومًا لفترات التأخير مثل 3 أشهر بعد تاريخ الطلب أو 7 أيام بعد آخر تحديث.

بالنسبة لفترات التأخير الأقل من ما يعادل 2400 دقيقة، أو 40 ساعة، يعيد النظام حساب تكرار هذا الفحص للتأكد من أن فترات التأخير الأكثر دقة، على سبيل المثال، ساعة واحدة قبل تاريخ ووقت بدء الحدث، أو 30 دقيقة بعد الإنشاء، يمكن احترامها بأقرب ما يكون.

تشير رسالة على الشاشة إلى التأخير المحتمل بعد التشغيل المجدول للقاعدة.

لعرض أو تحرير تكرار المُجدول يدويًا، مع تنشيط وضع المطور، انتقل إلى الإعدادات ‣ التقنية ‣ الإجراءات المجدولة لمشاهدة جميع الإجراءات المجدولة لقاعدة البيانات الخاصة بك.

أدخل Automation في شريط البحث، ثم في قائمة النتائج، انقر فوق قواعد التشغيل التلقائي: التحقق والتنفيذ. إذا رغبت، حدّث قيمة حقل تنفيذ كل. انقر فوق تشغيل يدويًا في أي وقت لتشغيل هذا الإجراء المجدول يدويًا.
شروط إضافية: انقر فوق إضافة شرط، ثم حدد الشروط الواجب استيفاؤها لتشغيل قاعدة التشغيل التلقائي. انقر فوق قاعدة جديدة لإضافة شرط آخر.

يتم تنفيذ الإجراء عند الوصول إلى التأخير واستيفاء الشروط.

Example

لإرسال رسالة تذكير بالبريد الإلكتروني قبل 30 دقيقة من بدء حدث في التقويم، حدد البدء (حدث في التقويم) كحقل التاريخ لـ المُشغِّل واضبط التأخير على -30 دقيقة.

مُخصص¶

تشغيل إجراءات تلقائية:

عند الحفظ: عند حفظ السجل.
عند الحذف: عندما يتم حذف سجل.
عند التغيير في الواجهة: عندما يتم تغيير قيمة حقل في عرض النموذج، حتى قبل حفظ السجل.

بالنسبة لمحفزات عند الحفظ و:guilabel:عند تغيير واجهة المستخدم، يجب عليك بعد ذلك تحديد الحقل (الحقول) المراد استخدامها لتشغيل قاعدة الأتمتة في حقل عند التحديث.

تحذير

إذا لم يتم تحديد حقل في حقل عند التحديث، فقد يتم تنفيذ الإجراء التلقائي عدة مرات لكل سجل.

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

Example

لتشغيل إجراء تلقائي عند إنشاء سجل، على سبيل المثال، عند إنشاء جهة اتصال جديدة، حدد مُشغِّل عند الحفظ واستخدم ID is not set كـ نطاق قبل التحديث و`ID is set` كنطاق تطبيق على. تأكد من تحديد الحقل الصحيح في حقل عند التحديث.

عند حفظ جهة اتصال جديدة، يتم تعيين معرف قاعدة بيانات لها تلقائيًا، وبالتالي يتم تشغيل قاعدة التشغيل التلقائي.

ملاحظة

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

خارجي¶

تشغيل الإجراءات الآلية بناءً على حدث محدد في نظام أو تطبيق خارجي باستخدام webhook.

بعد تكوين webhook في أودو، حيث يتم إنشاء عنوان URL الخاص بـ webhook وتحديد السجل المستهدف، يجب تنفيذه في النظام الخارجي.

تحذير

من المستحسن بشدة التشاور مع مطور أو مهندس حلول أو دور تقني آخر عند اتخاذ قرار استخدام الـwebhooks وطوال عملية التنفيذ. إذا لم يتم تكوينها بشكل صحيح، قد تعطل الـwebhooks قاعدة بيانات Odoo ويمكن أن تستغرق وقتًا للتراجع.

ملاحظة

من الممكن أيضاً إعداد إجراء آلي يرسل بيانات إلى webhook لنظام خارجي عند حدوث حدث في قاعدة بيانات أودو الخاصة بك.

انظر أيضًا

توثيق Webhook

الإجراءات¶

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

نصيحة

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

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

لتغيير ترتيب الإجراءات المحددة، انقر على أيقونة (مقبض السحب) بجانب الإجراء واسحبه إلى الموضع المطلوب.

تحديث السجل¶

يقوم هذا الإجراء بتحديث أحد حقول السجل (أو الحقول المرتبطة به). انقر على حقل التحديث، وفي القائمة التي تفتح، حدد أو ابحث عن الحقل المطلوب تحديثه. إذا لزم الأمر، انقر على (السهم الأيمن) بجوار اسم الحقل للوصول إلى قائمة الحقول المرتبطة.

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

Example

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

نصيحة

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

حساب حقل تاريخ ووقت مخصص باستخدام تعبير بايثون

إنشاء نشاط¶

يُستخدم هذا الإجراء لجدولة نشاط جديد مرتبط بالسجل. حدد نوع النشاط، وأدخل عنوان ووصف، ثم حدد متى تريد جدولة النشاط في حقل تاريخ الاستحقاق في، وحدد نوع المستخدم:

لتعيين النشاط دائماً لنفس المستخدم، حدد مستخدم محدد، ثم أضف المستخدم في حقل المسؤول؛
لاستهداف مستخدم مرتبط بالسجل ديناميكيًا، حدد مستخدم ديناميكي (بناءً على السجل) وقم بتغيير حقل المستخدم إذا لزم الأمر.

Example

بعد تحويل العميل المحتمل إلى فرصة، تريد أن يقوم الإجراء التلقائي بإعداد مكالمة للمستخدم المسؤول عن العميل المحتمل. للقيام بذلك، عيّن نوع النشاط إلى مكالمة و:guilabel:نوع المستخدم إلى مستخدم ديناميكي (بناءً على السجل).

إرسال بريد إلكتروني وإرسال رسالة نصية قصيرة¶

تُستخدم هذه الإجراءات لإرسال بريد إلكتروني أو رسالة نصية إلى جهة اتصال مرتبطة بسجل معين. للقيام بذلك، حدد أو أنشئ قالب بريد إلكتروني أو قالب رسائل نصية، ثم في حقل إرسال البريد الإلكتروني كـ أو إرسال الرسائل النصية كـ، اختر كيف تريد إرسال البريد الإلكتروني أو الرسالة النصية:

بريد إلكتروني: لإرسال الرسالة كبريد إلكتروني إلى مستلمي قالب البريد الإلكتروني.
رسالة: لنشر الرسالة على السجل وإخطار متابعي السجل.
ملاحظة: لإرسال الرسالة كملاحظة داخلية مرئية للمستخدمين الداخليين في المحادثة.
رسالة نصية قصيرة (بدون ملاحظة): لإرسال الرسالة كرسالة نصية إلى مستلمي قالب الرسائل النصية القصيرة.
رسالة نصية قصيرة (مع ملاحظة): لإرسال الرسالة كرسالة نصية إلى مستلمي قالب الرسائل النصية القصيرة ونشرها كملاحظة داخلية في المحادثة.
ملاحظة فقط: لنشر الرسالة فقط كملاحظة داخلية في المحادثة.

إرسال¶

مهم

لأتمتة إرسال رسائل واتساب، يجب إنشاء قالب واتساب واحد أو أكثر.

يُستخدم هذا الإجراء لإرسال رسالة واتساب إلى جهة اتصال مرتبطة بسجل معين. للقيام بذلك، حدد قالب الواتساب المناسب من القائمة المنسدلة.

إضافة متابعين وإزالة متابعين¶

يُستخدم هذا الإجراء لاشتراك/إلغاء اشتراك جهات الاتصال الموجودة في السجل/من السجل.

إنشاء سجل¶

يُستخدم هذا الإجراء لإنشاء سجل جديد على أي نموذج.

حدد النموذج المطلوب في حقل السجل المراد إنشاؤه؛ يحتوي على النموذج الحالي بشكل افتراضي. حدد اسم للسجل، ثم إذا كنت تريد إنشاء السجل على نموذج آخر، فحدد حقلاً في حقل حقل الربط لربط السجل الذي أدى إلى إنشاء السجل الجديد.

ملاحظة

تحتوي القائمة المنسدلة المرتبطة بحقل حقل الربط على حقول الواحد إلى العديد الموجودة في النموذج الحالي والمرتبطة بـ:ref:حقل العديد إلى الواحد <studio/fields/relational-fields-many2one> في النموذج المستهدف.

نصيحة

يمكنك إنشاء قاعدة أتمتة أخرى مع تحديث السجل إجراءات لتحديث حقول السجل الجديد إذا لزم الأمر. على سبيل المثال، يمكنك استخدام إجراء إنشاء سجل لإنشاء مهمة مشروع جديدة ثم تعيينها لمستخدم محدد باستخدام إجراء تحديث السجل.

تنفيذ الكود¶

مهم

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

يُستخدم هذا الإجراء لتنفيذ كود بايثون. يمكنك كتابة الكود الخاص بك في علامة التبويب الكود باستخدام المتغيرات التالية:

env: البيئة التي يتم تشغيل الإجراء عليها
model: نموذج السجل الذي يتم تشغيل الإجراء عليه؛ هو مجموعة سجلات فارغة
record: السجل الذي يتم تشغيل الإجراء عليه؛ قد يكون فارغًا
records: مجموعة سجلات لجميع السجلات التي يتم تشغيل الإجراء عليها في الوضع المتعدد؛ قد تُترك فارغة
time، datetime، dateutil، timezone: مكتبات بايثون مفيدة
float_compare: دالة مساعدة لمقارنة الأعداد العشرية بناءً على دقة محددة
log(message, level='info'): دالة تسجيل لحفظ معلومات التصحيح في جدول ir.logging
_logger.info(message): مسجل لإصدار الرسائل في سجلات الخادم
UserError: فئة استثناء لرفع رسائل تحذير موجهة للمستخدم
Command: مساحة أسماء أوامر x2many
action = {...}: لإرجاع إجراء

نصيحة

المتغيرات المتاحة موصوفة في كل من علامتي التبويب الكود و:guilabel:المساعدة.

انظر أيضًا

قدرات ORM في Odoo

أرسل إشعارات Webhook¶

يُستخدم هذا الإجراء لإرسال طلب API من نوع POST يحتوي على قيم الحقول المحددة إلى عنوان URL للـ webhook المحدد في حقل URL.

توفر حمولة العينة معاينة للبيانات المضمنة في الطلب باستخدام بيانات سجل عشوائي أو بيانات وهمية إذا لم يكن هناك سجل متاح.

ملاحظة

من الممكن أيضًا إعداد إجراء تلقائي يستخدم webhook لاستقبال البيانات من نظام خارجي عند حدوث حدث محدد مسبقًا في ذلك النظام.

تنفيذ الإجراءات الموجودة بالفعل¶

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

ويب هوكس

التحرير على GitHub