قوانین اتوماسیون

قوانین اتوماسیون برای ایجاد تغییرات خودکار بر اساس اقدامات کاربر (مثلاً ایجاد یک تغییر با تنظیم یک فیلد به مقداری مشخص)، رویدادهای ایمیل، شرایط زمانی (مثلاً بایگانی یک رکورد 7 روز پس از آخرین به‌روزرسانی آن) یا رویدادهای خارجی استفاده می‌شوند.

برای ایجاد یک قانون اتوماسیون با استودیو، به شرح زیر عمل کنید:

1. استودیو را باز کنید و اتوماسیون‌ها را کلیک کنید، سپس جدید را بزنید.

2. راه‌انداز را انتخاب کنید و در صورت لزوم، فیلدهایی که بر اساس راه‌اندازهای انتخاب شده روی صفحه نمایش داده می‌شوند را پر کنید.

3. روی افزودن یک عمل کلیک کنید، سپس نوع عمل را انتخاب کنید و فیلدهایی که بر اساس عمل انتخابی نمایش داده می‌شوند را پر کنید.

4. روی ذخیره و بستن یا ذخیره و جدید کلیک کنید.

Example

نکته

• برای تغییر مدل قانون خودکار، قبل از کلیک روی اتوماسیون‎‌ها در استودیو مدل‌ها را تغییر دهید، یا حالت توسعه‌دهنده را فعال کنید، یک قانون اتوماسیون ایجاد یا ویرایش کنید و مدل را در فرم قوانین اتوماسیون انتخاب کنید.

• همچنین می‌توانید قوانین اتوماسیون را از هر مرحله کانبان با کلیک بر روی آیکون چرخ‌دنده (⚙) در کنار نام مرحله کانبان و سپس انتخاب اتوماسیون‌ها ایجاد کنید. در این حالت، راه‌انداز به طور پیش‌فرض روی مرحله تنظیم شده به تنظیم می‌شود، اما در صورت لزوم می‌توانید آن را تغییر دهید.

  

راه‌انداز

راه‌انداز برای تعیین زمان اعمال قانون اتوماسیون استفاده می‌شود. راه‌اندازهای موجود به مدل بستگی دارند. به طور کلی پنج دسته تریگر وجود دارد:

• مقادیر به‌روزرسانی شده

• رویدادهای ایمیل

• شرایط زمانی

• سفارشی

• خارجی

نکته

همچنین می‌توانید یک دامنه قبل از به‌روزرسانی را برای تعیین شرایطی که باید قبل از فعال شدن قانون اتوماسیون برقرار باشند، تعریف کنید. در مقابل، شرایط تعریف شده با استفاده از فیلترهای شرایط بیشتر و اعمال روی در حین اجرای قانون اتوماسیون بررسی می‌شوند.

برای تعریف دامنه قبل از به‌روزرسانی، حالت توسعه‌دهنده را فعال کنید، یک قانون اتوماسیون ایجاد یا ویرایش کنید، روی ویرایش دامنه کلیک کنید، سپس روی قانون جدید کلیک کنید.

به عنوان مثال، اگر می‌خواهید اقدام خودکار زمانی اتفاق بیفتد که یک آدرس ایمیل روی یک مخاطب تنظیم شود که قبلاً آدرسی نداشته است (نه تغییر آدرس موجود آن‌ها)، دامنه قبل از به‌روزرسانی را به ایمیل تنظیم نشده و دامنه اعمال روی را به ایمیل تنظیم شده تعریف کنید.

مقادیر به‌روزرسانی شده

تریگرهای موجود در این دسته به مدل بستگی دارند و بر اساس تغییرات رایج فیلدها هستند، مانند افزودن یک برچسب خاص (مثلاً به یک وظیفه) یا تنظیم فیلد کاربر. راه‌انداز را انتخاب کنید، سپس در صورت نیاز یک مقدار انتخاب کنید.

رویدادهای ایمیل

هنگام دریافت یا ارسال ایمیل‌ها، عملیات خودکار راه‌اندازی کنید.

شرایط زمانی

بر اساس یک فیلد تاریخ اقدامات خودکار را فعال کنید. راه‌اندازهای زیر در دسترس هستند:

• بر اساس فیلد تاریخ: فیلدی که باید استفاده شود را در کنار فیلد تأخیر انتخاب کنید.

• پس از ایجاد: عمل زمانی فعال می‌شود که یک رکورد ایجاد و ذخیره شود.

• پس از آخرین به‌روزرسانی: عمل زمانی فعال می‌شود که یک رکورد موجود ویرایش و ذخیره شود.

سپس می‌توانید تعریف کنید:

• تأخیر: تعداد دقیقه‌ها، ساعت‌ها، روزها یا ماه‌ها را مشخص کنید. برای فعال کردن عمل قبل از تاریخ راه‌انداز، یک عدد منفی مشخص کنید. اگر راه‌انداز بر اساس فیلد تاریخ را انتخاب کرده‌اید، باید فیلد تاریخی را که برای تعیین تأخیر استفاده می‌شود را نیز انتخاب کنید.

• شرایط بیشتر: روی افزودن شرط کلیک کنید، سپس شرایطی را که باید برای فعال کردن قانون اتوماسیون برقرار باشند، مشخص کنید. روی قانون جدید کلیک کنید تا شرط دیگری اضافه کنید.

عمل زمانی فعال می‌شود که تأخیر به پایان برسد و شرایط برقرار باشند.

Example

اگر می‌خواهید یک ایمیل یادآوری 30 دقیقه قبل از شروع یک رویداد تقویم ارسال کنید، شروع (رویداد تقویم) را برای تاریخ راه‌اندازی انتخاب کنید و تأخیر را روی -30 دقیقه تنظیم کنید.

توجه

به طور پیش‌فرض، ابزار زمان‌بندی هر 4 ساعت یک‌بار تاریخ‌های راه‌انداز را بررسی می‌کند؛ که یعنی ممکن است همیشه دقت کمتر در اتوماسیون‌های مبتنی بر زمان رعایت نشود.

سفارشی

فعال کردن عملیات خودکار:

• هنگام ذخیره: زمانی که رکورد ذخیره می‌شود؛

• هنگام حذف: زمانی که یک رکورد حذف می‌شود؛

• هنگام تغییر رابط کاربری: زمانی که مقدار یک فیلد در نمای فرم تغییر می‌کند، حتی قبل از ذخیره رکورد.

برای راه‌اندازهای هنگام ذخیره و هنگام تغییر رابط کاربری، باید فیلد(هایی) که برای فعال کردن قانون اتوماسیون استفاده می‌شوند را در فیلد هنگام به‌روزرسانی انتخاب کنید.

هشدار

اگر فیلدی در فیلد هنگام به‌روزرسانی انتخاب نشود، عمل خودکار ممکن است برای هر رکورد چند بار اجرا شود.

به‌صورت اختیاری، می‌توانید شرایط بیشتری را نیز برای فعال کردن قانون اتوماسیون در فیلد اعمال روی تعریف کنید.

توجه

راه‌انداز هنگام تغییر رابط کاربری را فقط می‌توان با عمل اجرای کد استفاده کرد و تنها زمانی کار می‌کند که تغییر به صورت دستی اعمال شود. اگر فیلد از طریق یک قانون اتوماسیون دیگر تغییر کند، عمل اجرا نخواهد شد.

خارجی

با استفاده از وب‌هوک، عملیات خودکار را بر اساس یک رویداد خارجی فعال کنید. وب‌هوک روشی برای ارتباط بین دو سیستم است که در آن سیستم مبدأ یک درخواست HTTP(S) را بر اساس یک رویداد خاص به سیستم مقصد ارسال می‌کند. این درخواست معمولاً شامل داده حاوی اطلاعات مربوط به رویداد اتفاق‌افتاده است.

برای پیکربندی راه‌انداز وب‌هوک، URL تولید شده توسط سازمان‌یار را در سیستم مقصد (یعنی سیستمی که درخواست را دریافت می‌کند) کپی کنید. سپس در فیلد رکورد هدف، کدی را وارد کنید که برای تعیین رکورد(های) مورد نظر برای به‌روزرسانی با استفاده از قانون اتوماسیون اجرا شود.

هشدار

URL باید به عنوان محرمانه در نظر گرفته شود؛ اشتراک‌گذاری آن به صورت آنلاین یا بدون احتیاط ممکن است سیستم شما را در معرض افراد مخرب قرار دهد. در صورت لزوم، برای تغییر رمز URL، روی دکمه چرخش رمز کلیک کنید.

توجه

• کدی که به طور پیش‌فرض در فیلد رکورد هدف تعریف شده است، برای وب‌هوک‌های ارسال شده از یک پایگاه داده سازمان‌یار دیگر کار می‌کند. این کد برای تعیین رکورد(های) مورد نظر برای به‌روزرسانی با استفاده از اطلاعات موجود در payload استفاده می‌شود.

• اگر می‌خواهید محتوای وب‌هوک را برای هدفی غیر از یافتن رکورد(ها) (مثلاً ایجاد یک رکورد) استفاده کنید، تنها گزینه شما استفاده از عمل اجرای کد است. در این حالت، فیلد رکورد هدف باید شامل کد معتبری باشد، اما نتیجه آن تأثیری بر خود عملیات خودکار ندارد.

• محتوای وب‌هوک در زمینه عملیات سرور به عنوان یک متغیر payload در دسترس است (یعنی یک دیکشنری که شامل پارامترهای GET یا بدنه JSON درخواست ورودی است).

همچنین می‌توانید ثبت سوابق فراخوانی‌ها را برای ثبت payloadهای دریافت شده فعال کنید. این کار می‌تواند برای اطمینان از اینکه داده‌های ارسال شده توسط سیستم مبدأ با فرمت و محتوای مورد انتظار مطابقت دارند کاربرد دارد. همچنین این کار به شناسایی و تشخیص هرگونه مشکل احتمالی کمک می‌کند. برای دسترسی به لاگ‌ها، روی دکمه هوشمند سوابق در بالای فرم قوانین اتوماسیون کلیک کنید.

همچنین ملاحظه نمائید

وب‌هوک‌ها

عمل‌ها

پس از تعریف راه‌انداز قانون اتوماسیون، روی افزودن عمل کلیک کنید تا عملی که باید اجرا شود را تعریف کنید.

نکته

می‌توانید چند اکشن برای یک راه‌انداز/قانون اتوماسیون تعریف کنید. عمل‌ها به ترتیبی که تعریف شده‌اند اجرا می‌شوند. این بدان معناست که مثلاً اگر یک عمل به‌روزرسانی رکورد و سپس یک عمل ارسال ایمیل تعریف کنید، ایمیل از مقادیر به‌روزرسانی شده استفاده می‌کند. با این حال، اگر عمل ارسال ایمیل قبل از اکشن به‌روزرسانی رکورد تعریف شود، ایمیل از مقادیر تنظیم شده قبل از اجرای عمل به‌روزرسانی استفاده می‌کند.

به‌روزرسانی رکورد

این عمل به شما امکان می‌دهد یکی از فیلدهای (مرتبط) رکورد را به‌روزرسانی کنید. روی فیلد به‌روزرسانی کلیک کنید و در لیستی که باز می‌شود، فیلد مورد نظر برای به‌روزرسانی را انتخاب یا جستجو کنید؛ در صورت نیاز، روی فلش سمت چپ کنار نام فیلد کلیک کنید تا به لیست فیلدهای مرتبط دسترسی پیدا کنید.

اگر یک فیلد چندبه‌چند انتخاب کرده‌اید، انتخاب کنید که آیا فیلد باید با افزودن، حذف کردن، یا تنظیم مقدار به مقدار انتخاب شده یا با پاک کردن آن به‌روز شود.

Example

اگر می‌خواهید عمل خودکار، یک برچسب را از رکورد مشتری حذف کند، فیلد به‌روزرسانی را به مشتری > برچسب‌ها تنظیم کنید، با حذف را انتخاب کنید، سپس برچسب مورد نظر را انتخاب کنید.

نکته

به‌طور جایگزین، می‌توانید فیلد یک رکورد را به‌صورت پویا با استفاده از کد پایتون تنظیم کنید. برای انجام این کار، به جای به‌روزرسانی، محاسبه را انتخاب کنید، سپس کدی را که برای محاسبه مقدار فیلد استفاده می‌شود وارد کنید. برای مثال، اگر می‌خواهید قانون اتوماسیون یک فیلد تاریخ و زمان سفارشی را هنگامی که اولویت یک وظیفه روی بالا تنظیم می‌شود (با ستاره‌دار کردن وظیفه) محاسبه کند، می‌توانید محرک اولویت تنظیم شده به را روی بالا تعریف کرده و اقدام به‌روزرسانی رکورد را به شرح زیر تعریف کنید:

ایجاد فعالیت

این عمل برای برنامه‌ریزی یک فعالیت جدید مرتبط با رکورد استفاده می‌شود. نوع فعالیت را انتخاب کنید، عنوان و توضیحات وارد کنید، سپس در فیلد تاریخ سررسید در مشخص کنید که می‌خواهید فعالیت در چه زمانی برنامه‌ریزی شود و یک نوع کاربر انتخاب کنید:

• برای اختصاص همیشگی فعالیت به یک کاربر مشخص، کاربر مشخص را انتخاب کرده و کاربر را در فیلد مسئول اضافه کنید؛

• برای هدف‌گیری پویای کاربر مرتبط با رکورد، کاربر پویا (بر اساس رکورد) را انتخاب کرده و در صورت نیاز فیلد کاربر را تغییر دهید.

Example

پس از تبدیل سرنخ به فرصت، می‌خواهید عمل خودکار تماس برای کاربر مسئول سرنخ تنظیم شود. برای این کار، نوع فعالیت را به تماس و نوع کاربر را به کاربر پویا (بر اساس رکورد) تنظیم کنید.

ارسال ایمیل و ارسال پیامک

این عمل‌ها برای ارسال ایمیل یا پیامک به مخاطب مرتبط با یک رکورد خاص استفاده می‌شوند. برای این کار، یک قالب ایمیل یا قالب پیامک انتخاب یا ایجاد کنید، سپس در فیلد ارسال ایمیل به عنوان یا ارسال پیامک به عنوان، نحوه ارسال ایمیل یا پیامک را انتخاب کنید:

• ایمیل: برای ارسال پیام به عنوان ایمیل به دریافت‌کنندگان قالب ایمیل.

• پیام: برای ارسال پیام روی رکورد و اطلاع‌رسانی به دنبال‌کنندگان رکورد.

• یادداشت: برای ارسال پیام به شکل یک یادداشت داخلی که برای کاربران داخلی در کادر گفتگو قابل مشاهده است.

• پیامک (بدون یادداشت): برای ارسال پیام به شکل پیامک به گیرندگان قالب پیامک.

• پیامک (با یادداشت): برای ارسال پیام به شکل پیامک به گیرندگان قالب پیامک و ارسال آن به شکل یک یادداشت داخلی در کادر گفتگو.

• فقط یادداشت: برای ارسال پیام فقط به شکل یادداشت داخلی در کادر گفتگو.

ارسال از واتس‌اپ

مهم

برای اتوماسیون ارسال پیام‌های واتس‌اپ، باید یک یا چند قالب واتس‌اپ ایجاد شود.

این اقدام برای ارسال پیام واتس‌اپ به مخاطبی که به یک رکورد خاص پیوند داده شده است استفاده می‌شود. برای انجام این کار، قالب واتس‌اپ مناسب را از منوی کشویی انتخاب کنید.

افزودن دنبال‌کنندگان و حذف دنبال‌کنندگان

از این عمل‌ها برای اشتراک یا لغو اشتراک مخاطبان موجود در رکورد استفاده کنید.

ایجاد رکورد

این عمل برای ایجاد رکورد جدید در هر مدلی استفاده می‌شود.

مدل مورد نیاز را در فیلد رکورد برای ایجاد انتخاب کنید؛ به طور پیش‌فرض مدل فعلی را شامل می‌شود. یک نام برای رکورد مشخص کنید و سپس اگر می‌خواهید رکورد را در مدل دیگری ایجاد کنید، یک فیلد در فیلد لینک انتخاب کنید تا رکوردی که ایجاد رکورد جدید را فعال کرده است، لینک داده شود.

توجه

لیست کشویی مربوط به فیلد لینک فقط شامل فیلدهای یک‌به‌چند موجود در مدل فعلی است که به یک فیلد چندبه‌یک در مدل هدف پیوند داده شده‌اند.

نکته

می‌توانید یک قانون اتوماسیون دیگر با عمل‌های به‌روزرسانی رکورد ایجاد کنید تا در صورت نیاز فیلدهای رکورد جدید را به‌روزرسانی کنید. به عنوان مثال، می‌توانید از عمل ایجاد رکورد برای ایجاد یک وظیفه در پروژه جدید استفاده کنید و سپس آن را با استفاده از عمل به‌روزرسانی رکورد به یک کاربر مشخص اختصاص دهید.

اجرای کد

این عمل برای اجرای کد پایتون استفاده می‌شود. می‌توانید کد خود را در تب کد با استفاده از متغیرهای زیر بنویسید:

• env: محیطی که عمل در آن فعال می‌شود

• model: مدل رکوردی که عمل در آن فعال می‌شود؛ یک رکوردست (recordset) خالی است

• record: رکوردی که عمل در آن فعال می‌شود؛ ممکن است خالی باشد

• records: رکوردست تمام رکوردهایی که عمل در حالت چندگانه در آنها فعال می‌شود؛ ممکن است خالی باشد

• time, datetime, dateutil, timezone: کتابخانه‌های مفید پایتون

• float_compare: تابع کمکی برای مقایسه اعداد اعشاری بر اساس دقت خاص

• log(message, level='info'): تابع ثبت برای ثبت اطلاعات دیباگ در جدول ir.logging

• _logger.info(message): لاگر ارسال پیام‌ها در لاگ‌های سرور

• UserError: کلاس استثناء برای ایجاد پیام‌های هشدار به کاربر

• Command: فضای نام دستورات x2many

• action = {...}: برای بازگرداندن یک عمل

نکته

متغیرهای موجود در هر دو تب کد و راهنما توضیح داده شده‌اند.

ارسال اعلان وب‌هوک

این عمل امکان ارسال یک درخواست POST با مقادیر فیلدها به آدرس URL مشخص شده در فیلد URL را فراهم می‌کند.

نمونه داده پیش‌نمایشی از داده‌های موجود در درخواست را با استفاده از داده‌های یک رکورد تصادفی یا داده‌های ساختگی در صورت عدم وجود رکورد ارائه می‌دهد.

اجرای عملیات موجود

این عمل برای فعال‌سازی چند اقدام (مرتبط با مدل فعلی) به طور همزمان استفاده می‌شود. برای این کار، روی افزودن سطر کلیک کنید، سپس در پنجره بازشو افزودن: عملیات زیرمجموعه، یک عمل موجود را انتخاب کنید یا روی جدید کلیک کنید و یک عمل جدید ایجاد کنید.

• وب‌هوک‌ها