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

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

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

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

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

2. نامی واضح و معنادار به قانون خودکارسازی بدهید که هدف آن را مشخص کند.

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

4. روی افزودن اقدام در تب اقدامات برای انجام کلیک کنید.

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

6. روی ذخیره و بستن یا برای تعریف اقدامات اضافی، روی ذخیره و جدید کلیک کنید.

Example

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

نکته

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

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

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

  

راه‌انداز

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

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

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

• شرایط زمانی

• سفارشی

• خارجی

افزودن شرایط

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

نکته

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

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

• دامنه قبل از به‌روزرسانی شرایطی را تعریف می‌کند که رکورد باید قبل از وقوع رویداد محرک داشته باشد، مثلاً رکورد باید دارای نوع = فاکتور مشتری و وضعیت = ارسال شده باشد.

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

• دامنه اعمال روی شرایطی را تعریف می‌کند که رکورد باید بعد از وقوع رویداد محرک داشته باشد، مثلاً فاکتور مشتری باید دارای وضعیت پرداخت = تا حدی پرداخت شده باشد.

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

  نکته

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

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

Example

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

توجه

دامنه قبل از به‌روزرسانی هنگام ایجاد رکورد بررسی نمی‌شود.

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

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

محرک را انتخاب کنید، سپس در صورت نیاز مقداری را انتخاب نمایید.

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

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

شرایط زمانی

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

• بر اساس فیلد تاریخ: اقدام در دوره زمانی مشخص قبل یا بعد از تاریخ فیلد تاریخ انتخاب شده فعال می‌شود، مثلاً ۳۰ روز قبل از تاریخ پایان قرارداد.

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

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

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

1. محرک مناسب را از دسته شرایط زمانی انتخاب کنید. اگر محرک بر اساس فیلد تاریخ را انتخاب کردید، فیلد تاریخ مربوطه را انتخاب کنید.

2. تأخیر را پیکربندی کنید تا *زمان تاریخ اجرا*ی اقدام(ها) تعیین شود. برای این کار، تعداد دقیقه، ساعت، روز، یا ماه را که پس از آن اقدام باید فعال شود، وارد کنید. اگر محرک بر اساس فیلد تاریخ را انتخاب کرده‌اید، اقدام می‌تواند بعد یا قبل از فیلد تاریخ انتخاب شده فعال شود.

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

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

5. روی اقدام زمان‌بندی شده کلیک کنید تا اقدام زمان‌بندی شده قوانین خودکارسازی: بررسی و اجرا باز شود.

   توجه

   این اقدام زمان‌بندی شده زمان‌های تاریخ اجرا را که از آخرین اجرای آن فرا رسیده‌اند بررسی می‌کند و اقدام(های) مربوطه را در صورت لزوم اجرا می‌کند. به‌طور پیش‌فرض، اقدام زمان‌بندی شده روی اجرا هر ۴ ساعت تنظیم شده است، که معمولاً برای تأخیرهایی مانند ۳ ماه پس از تاریخ سفارش یا ۷ روز پس از آخرین به‌روزرسانی کافی است.

   اگر هر قانون خودکارسازی دارای محرک مبتنی بر زمان با تأخیری کمتر از معادل ۴۰ ساعت باشد، مثلاً ۳ ساعت قبل از زمان تاریخ شروع رویداد، فرکانس اقدام زمان‌بندی شده به‌طور خودکار افزایش می‌یابد، مثلاً به اجرا هر ۱۸ دقیقه. این اجازه می‌دهد تا اقدام نزدیک‌تر به زمان تاریخ اجرای برنامه‌ریزی شده آن اجرا شود.

6. روی اجرای دستی در بالا سمت چپ کلیک کنید.

   هشدار

   این مرحله برای جلوگیری از اجرای قانون به صورت عطف‌به‌ماسبق روی رکوردهای تاریخی حیاتی است. اجرای دستی اقدام زمان‌بندی شده، مهر زمانی *آخرین اجرا*ی آن را در قانون خودکارسازی مقداردهی اولیه می‌کند، که عنصر کلیدی از :ref:`منطق اجرا <studio/automated-actions/trigger-timing-conditions-logic>`ی قانون است.

7. روی نام قانون خودکارسازی در مسیر راهنما (breadcrumbs) کلیک کنید تا به تنظیمات قانون خودکارسازی بازگردید.

8. اقدام(های) مورد نظر برای اجرا را اضافه کنید، سپس زمانی که تمام اقدامات تعریف شدند، روی ذخیره دستی کلیک کنید.

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

منطق اجرا

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

آخرین اجرا --> زمان و تاریخ اجرا --> اجرای فعلی

توجه

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

Example

صبح روز ۱۵ اکتبر، شما یک قانون خودکارسازی ایجاد می‌کنید که ارسال ایمیلی را ۳۰ روز قبل از تاریخ پایان قرارداد فعال می‌کند؛ قراردادها در ساعت ۱۱:۵۹ شب در تاریخ پایان خود به اتمام می‌رسند. در حین ایجاد قانون، اقدام زمان‌بندی شده قوانین خودکارسازی: بررسی و اجرا به‌صورت دستی در ساعت ۱۱:۰۰ صبح اجرا شد و تنظیم شده است تا پس از آن هر چهار ساعت اجرا شود.

این قانون خودکارسازی جدید برای قراردادهایی اعمال می‌شود که تاریخ پایان آن‌ها حداقل ۳۰ روز بعد از ایجاد قانون باشد، یعنی تاریخ پایان ۱۴ نوامبر یا بعد از آن.

برای قراردادی با تاریخ پایان ۱۴ نوامبر، زمان تاریخ اجرای اقدام ساعت ۱۱:۵۹ شب در ۱۵ اکتبر است. بنابراین، اقدام اولین باری که اقدام زمان‌بندی شده قوانین خودکارسازی: بررسی و اجرا پس از گذشت آن تاریخ و زمان اجرا شود، اجرا خواهد شد، یعنی:

• آخرین اجرای اقدام زمان‌بندی شده: ۱۱:۰۰ شب در ۱۵ اکتبر

• زمان تاریخ اجرا: ۱۱:۵۹ شب در ۱۵ اکتبر

• اجرای فعلی اقدام زمان‌بندی شده: ۳:۰۰ صبح در ۱۶ اکتبر

سفارشی

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

• هنگام ایجاد: زمانی که رکورد برای اولین بار ذخیره می‌شود.

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

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

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

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

هشدار

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

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

توجه

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

خارجی

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

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

هشدار

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

توجه

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

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

مستندات وب‌هوک

عمل‌ها

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

نکته

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

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

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

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

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

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

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

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

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

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

برای تعریف اقدام:

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

2. اطلاعات مربوطه را بر اساس گزینه انتخاب شده ارائه دهید.

به‌روزرسانی

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

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

Example

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

به‌روزرسانی با هوش مصنوعی

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

Example

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

توالی

یک توالی موجود را انتخاب کنید یا برای ایجاد یک توالی جدید:

1. روی جستجوی بیشتر، سپس روی جدید کلیک کنید.

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

3. در تب توالی، توالی را پیکربندی کنید:

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

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

   • اندازه توالی: تعداد ارقام در هر شماره از توالی را تعیین می‌کند. در صورت نیاز، صفرهای ابتدایی قبل از شماره اضافه می‌شوند تا به اندازه توالی مشخص شده برسند، مثلاً برای اندازه توالی 5، اولین شماره در توالی 00001 است.

   • گام: گام‌های افزایش بین شماره‌ها در توالی را تعیین می‌کند.

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

   نکته

   • از متغیرهای پویا مانند %(year)s یا %(month)s به عنوان پیشوند و/یا پسوند استفاده کنید تا توالی‌هایی با عناصری مانند سال جاری، ماه و غیره ایجاد کنید. متغیرهای ممکن در پایین پنجره نمایش داده می‌شوند.

   • برای استفاده از زیرتوالی‌ها، مثلاً برای شروع مجدد توالی در هر سال یا هر ماه، گزینه استفاده از زیرتوالی‌ها بر اساس date_range را فعال کنید، سپس برای هر بازه زمانی افزودن یک سطر را بزنید و شماره بعدی را برای آن بازه مشخص کنید.

4. روی ذخیره کلیک کنید.

Example

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

در مثال، هر مشتری جدید یک مرجع متوالی با پیشوند #-REF-%(year)s- دریافت می‌کند، که در آن %(year)s سال جاری شامل قرن است، و پسوند /CL، مثلاً #-REF-2025-00001/CL، #-REF-2025-00002/CL و غیره.

محاسبه

کد مورد نظر برای محاسبه مقدار فیلد را وارد کنید.

Example

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

ایجاد رکورد و تکرار رکورد

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

برای تعریف اقدام:

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

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

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

نکته

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

Example

اگر می‌خواهید قانون خودکارسازی یک پروژه، مثلاً قالب پروژه با وظایف از پیش تعریف شده را زمانی که فرصت روی برنده تنظیم می‌شود تکرار کند، یک فیلد سفارشی چندبه‌یک فرصت مرتبط در مدل پروژه و یک فیلد سفارشی یک‌به‌چند پروژه مرتبط در مدل سرنخ اضافه کنید، سپس جزئیات زیر را در مورد رکوردی که تکرار می‌شود ارائه دهید:

نکته

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

ایجاد فعالیت

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

برای تعریف اقدام:

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

2. یک عنوان وارد کنید.

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

4. یک نوع کاربر انتخاب کنید:

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

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

5. به‌صورت اختیاری، یادداشت اضافه کنید تا اطلاعات بیشتری درباره فعالیت ارائه دهید.

Example

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

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

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

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

برای تعریف اقدام:

1. با انتخاب ارسال ایمیل یا ارسال پیامک به عنوان نوع اقدام، بنا به مورد، قالب ایمیل یا قالب پیامک را انتخاب یا ایجاد کنید.

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

   برای ایمیل، انتخاب کنید:

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

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

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

   برای پیام متنی، انتخاب کنید:

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

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

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

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

مهم

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

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

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

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

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

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

• برای افزودن/حذف همیشه همان مخاطب(ها)، دنبال‌کنندگان خاص را انتخاب کنید سپس مخاطب(ها) را از منوی کشویی انتخاب کنید. چندین مخاطب می‌توانند اضافه/حذف شوند.

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

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 = {...}: برای بازگرداندن یک عمل

نکته

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

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

قابلیت‌های ORM سازمان‌یار

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

این اقدام برای ارسال درخواست API از نوع POST با مقادیر فیلدها`ی انتخاب شده به URL وب‌هوک مشخص شده در فیلد :guilabel:`URL استفاده می‌شود.

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

توجه

همچنین امکان تنظیم اقدام خودکاری وجود دارد که از وب‌هوک برای دریافت داده‌ها از سیستم خارجی استفاده می‌کند زمانی که رویداد از پیش تعریف شده در آن سیستم رخ می‌دهد.

چندین اقدام

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

برای تعریف اقدامات:

1. با انتخاب چندین اقدام به عنوان نوع اقدام، روی افزودن اقدام کلیک کنید.

2. در پنجره پاپ‌آپ افزودن: اقدامات فرزند:

   • یک یا چند اقدام موجود را انتخاب کرده و روی انتخاب کلیک کنید؛ یا

   • روی جدید کلیک کنید، اقدام مورد نظر برای اجرا را تعریف کنید، سپس روی ذخیره و بستن یا برای ایجاد اقدامات اضافی، روی ذخیره و جدید کلیک کنید.

3. به هر تعداد که لازم است تکرار کنید.

• وب‌هوک‌ها