ثبت نام و ورود
با ورود به صفحه ثبت نام و ورود محیط کاربری رباتساز پیشرفته برای اولین بار، نیاز است شماره تماس خود را جهت دریافت کد یکبار مصرف و فعالسازی حساب کاربری وارد نمایید. لطفا قبل از تایید شماره تماس حتما قوانین و مقررات صهبات را با دقت خوانده و گزینه قبول را انتخاب نمایید. پس از تایید شماره، به صفحه ویرایش اطلاعات کاربری هدایت میشوید تا در صورت نیاز اطلاعات ثبت نام خود را تکمیل کنید.
اگر قبلا ثبت نام کردهاید، میتوانید با شماره تماس یا نام خود وارد محیط کاربری شوید.
توجه داشته باشید که چند نمونه از رباتهای قابل ساخت در سایت اصلی معرفی شدهاند. همچنین میتوانید در محیط کاربری صهبات، از بلوکهای فرآیند پیشرفته کپی کنید. در آینده امکان کپی برداری از رباتهای نمونه نیز فراهم خواهد شد.
الماس ها و امتیازها (واحد درونبرنامهای)
الماسها و امتیازها دو واحد جدید درونبرنامهای هستند که برای آسان کردن محاسبه هزینههای رباتها ایجاد شدهاند. به طور کلی الماس برای ایجاد فرآیند و امکانات خاص استفاده میشود (مانند تغییر گیرنده پیام، که در صورت استفاده از آن به طور خودکار مقدار مشخصی از الماس صرف خواهد شد). امتیاز هم در طور زمان برای مداومت کارکرد ربات بر اساس مصرف منابع سرور صهبات استفاده میشود (مثلا برای تعداد مشخص پیام ارسالی در روز، مقدار مشخصی امتیاز مصرف میشود).
اما نگران محاسبه الماس و امتیاز برای کارکرد روزانه ربات خود نباشید! صهبات به صورت خودکار الماس و امتیاز مورد نیاز بنابر منابع و امکانات مصرفی ربات دلخواه شما را محاسبه و در قسمت رباتها نشان میدهد. همچنین تاریخ پیشبینی شده برای افزایش موجودی را نیز میتوانید مشاهده کنید. مصرف الماس به صورت روزانه و امتیاز هنگام مصرف از جمع موجودی کسر میشوند تا اگر در حال ساخت ربات هستید، مشکلی ایجاد نشود. در انتهای روز هم امتیاز مصرفی پیامها، فایلها و ... نگهداری شده محاسبه و از جمع موجود کسر خواهد شد.
جدول اختصاری مصرف واحدهای درونبرنامهای نیز به این شکل است:
ردیف | امکانات/مصرف منابع | واحد | مقدار |
---|---|---|---|
1 | پل ارتباطی | الماس | 20 |
2 | پایگاه داده | الماس | 30 |
3 | هر 5 ستون در پایگاه داده | الماس | 5 |
4 | هر محصول/مطلب | الماس | 1 |
5 | پیام پرداخت محصول/مطلب | الماس | 2 |
6 | حذف تبلیغات | الماس | 10 |
7 | شرط | الماس | 2 |
8 | درگاه پرداخت | الماس | 30 |
9 | هر زیرفرآیند در فرآیند منوی ساده | الماس | 2 |
10 | هر زیرفرآیند در فرآیند فرم دریافت اطلاعات | الماس | 3 |
11 | هر زیرفرآیند در انتقال پست | الماس | 20 |
12 | انتقال پست گروهی | الماس | 500 |
13 | مدیر گروه | الماس | 30 |
14 | هر گروه افزوده شده در مدیر گروه | الماس | 20 |
15 | دسترسی به تنظیمات مدیر گروه از گروه | الماس | 20 |
16 | استفاده Regex در مدیر گروه | الماس | 5 |
17 | افزودن زیرفرآیند در مدیر گروه | الماس | 10 |
18 | گرفتن خروجی اطلاعات | الماس | 40 |
19 | هر زیرفرآیند در عملیات زماندار (کرون جاب) | الماس | 40 |
20 | فرآیند وبلاگ/فروشگاه | الماس | 40 |
21 | فرآیند پیشرفته | الماس | مطابق جدول زیر |
22 | کدنویسی سفارشی | الماس | توافقی (براساس امکانات درخواستی) |
23 | هر پلاگین | الماس | 2 |
24 | پل ارتباطی بله (GetUpdates) | الماس | 50 |
25 | پل ارتباطی تلگرام (GetUpdates) | الماس | 50 |
26 | صهبات در بله | الماس | 40 |
27 | صهبات در آیگپ | الماس | 40 |
28 | صهبات در تلگرام | الماس | 40 |
برای فرآیند پیشرفته نیز هزینه بلوکهای ایجاد شده به شکل زیر هستند:
ردیف | امکانات/مصرف منابع | واحد | مقدار |
---|---|---|---|
1 | عمومی | الماس | 1 |
2 | نگهداری وضعیت دستور | الماس | 2 |
3 | ذخیره چند فیلد در پایگاه داده | الماس | 2 |
4 | دریافت رکورد پایگاه داده | الماس | 3 |
5 | شمارش ورودی در پایگاه داده | الماس | 2 |
6 | جستجو در اکسل | الماس | 5 |
7 | تعداد رکوردهای اکسل | الماس | 4 |
8 | اتصال به API | الماس | 20 |
9 | اتصال به API تحریمی | الماس | 40 |
10 | جستجو در JSON | الماس | 3 |
11 | دریافت مطالب | الماس | 3 |
12 | دریافت مجموعهها | الماس | 3 |
13 | دریافت تراکنش | الماس | 3 |
14 | for | الماس | 8 |
15 | for each | الماس | 8 |
16 | continue, break | الماس | 4 |
17 | repeat | الماس | 8 |
18 | repeat ext | الماس | 8 |
19 | while until | الماس | 8 |
20 | سایر بلوکها | الماس | 1 |
جدول مصرف امتیازها:
ردیف | امکانات/مصرف منابع | واحد | مقدار |
---|---|---|---|
1 | ارسال پیام | امتیاز | 1 |
2 | دریافت پیام | امتیاز | 1 |
3 | فایل ارسالی از پل (1 عدد) | امتیاز | 5 |
4 | فایل (1 مگابایت) | امتیاز | 5 |
5 | انجام عملیات زماندار (کرون جاب) | امتیاز | 3 |
6 | هر ورودی پایگاه داده | امتیاز | 2 |
7 | هر خروجی از پایگاه داده | امتیاز | 150 |
8 | هر رمز یکبار مصرف | امتیاز | 300 |
9 | ذخیره پیام (هر روز) | امتیاز | 4 |
10 | بروزرسانی یک رکورد در نسخه متناظر | امتیاز | 1 |
11 | بروزرسانی هر صد رکورد در صهبات براساس نسخه متناظر (طبق زمانبندی تعیین شده در تنظیمات نسخه متناظر) | امتیاز | 1 |
12 | هر بار کارکرد API متصل شده | امتیاز | 2 |
13 | هر بار کارکرد API تحریمی متصل شده | امتیاز | 3 |
محیط کاربری رباتساز
پس از ورود به ناحیه کاربری رباتساز چهار گزینه اصلی پیش روی شما خواهند بود که عبارتند از:
- میزکار
- رباتها
- گفتگوها
- درگاههای پرداخت
در ادامه به شرح این موارد خواهیم پرداخت.
میز کار
این قسمت به صورت پیشفرض به هنگام ورود به محیط کاربری نمایش داده خواهد شد. در میز کار علاوه بر امکان ورود به بخشهای دیگر، میتوانید آمار رباتهای خود را به صورت نموداری مشاهده کنید. قابلیت نمایش متغیرهایی مانند الماس، پیامهای دریافتی، پیامهای ارسالی، پیامکهای یکبار رمز، خروجیهای پایگاههای داده و اجراهای کرون را با امکان شخصی سازی آنها وجود دارد. همچنین میتوانید در صورت نیاز، از نمودار خود خروجی svg، png و csv بگیرید. میتوانید با انتخاب آیکن پشتیبانی در سمت چپ میزکار، درخواست ساخت ربات، گزارش خطاها، گزارش محتوای نامناسب، مشکلات تراکنش و حساب مالی و پیشنهادات و انتقادات خود را مطرح کنید.
رباتها
قسمت رباتها، بخش اصلی راهاندازی رباتهای دلخواه است. با ورود برای اولین بار نیاز است یک ربات جدید ایجاد کنید. قسمت های ستارهدار اجباری هستند. توجه داشته باشید تعیین میزان دسترسی افراد برای استفاده از ربات به این صورت است که عمومی برای مشاهده ربات توسط همه از جمله کاربران مهمان، کاربری برای مشاهده ربات تنها توسط کاربران صهبات و خصوصی برای مشاهده تنها توسط خود کاربر است. پیشنهاد میشود این مورد را روی عمومی قرار دهید.
پس از ساختن ربات، فهرستی از امکانات مختلف مربوط به ربات در اختیار شما قرار میگیرد که به صورت مفصل در ادامه توضیح داده خواهند شد. در مقابل عنوان ربات، سه آیکن مجزا مشاهده میشوند که عبارتند از:
- امتیاز
- الماس
- صفحه گفتگوی ربات
اطلاعات ربات
در این قسمت میتوانید اطلاعات ثبت شده ربات مورد نظر را ویرایش یا تکمیل کنید.
پلهای ارتباطی
در این قسمت به طور پیش فرض برای حساب کاربری شما یک پل صهبات وجود خواهد داشت. این به این معنی ست که حتی اگر شما تمایلی به اتصال ربات مورد نظرتان در پیامرسان نداشته باشید، میتوانید ربات خود را به صورت نسخه وب در صهبات با تمام امکانات و صفحههای گفتگو داشته باشید.
پس از وارد کردن اطلاعات ضروری ربات خود در پیامرسان (برای مثال در بله و تلگرام botfather)، اگر اطلاعات درست وارد شده باشند اتصال بین صهبات و ربات پیامرسان ایجاد میشود. سپس می توانید فرآیندهای متنوع خود را به راحتی ایجاد و از ربات بهره ببرید. فایلهای دریافت شده و یا ارسالی از طریق این پل نیز در اطلاعات پل قابل مشاهده هستند. همچنین میتوانید به صورت دستی کاربران را به این پل اضافه یا حذف کنید. ممکن است به دلیل بروز خطا ارتباط دچار مشکل شود. میتوانید با کلید بازیابی اتصال، اقدام به رفع مشکل کنید.
فرآیندها
یکی از مهمترین بخشهای رباتساز که ساختار کلی عملکرد ربات در آن تنظیم میشود فرآیندها است. با ورود به فرآیندها دو گزینه اصلی ایجاد برچسب جدید (که برای تمایز فرآیندهای مختلف به کار میرود) و ایجاد فرآیند جدید مشاهده میشود.
برای عملکردهای مختلف ربات، انواع فرآیندها در نظر گرفته شدهاند که به اختصار شرح داده میشوند:
منو ساده
این فرآیند به صورت یک متن ساده یا متن با پیوست فایلها، موقعیت مکانی، اطلاعات مخاطب و یا استیکر عمل میکند. میتوانید به انتهای پیام کلیدهای متنوعی نیز اضافه نمایید که کاربر را به فرآیند یا دستور دیگر هدایت نماید. یا از کاربر درخواست شماره تماس و موقعیت مکانی بکند. پس از تکمیل قسمتهای ستارهدار، فرآیند را ذخیره نمایید.
فرم دریافت اطلاعات
با این فرآیند میتوانید به راحتی فرمهای ثبتنام طراحی کنید. همچنین امکان ساخت فرم آزمون نیز ممکن است. اطلاعات ثبت شده میتوانند در قالب فایل اکسل یا HTML خروجیگیری شوند.
انتقال پست
این فرآیند معمولا برای انتقال پستها از یک کانال به کانال دیگر استفاده میشود. توجه داشته باشید که ربات باید در مبدا و مقصد به عنوان ادمین تعیین شده باشد. پس از تعیین ربات به عنوان ادمین و ارسال یک پیام آزمایشی در کانال، باید با انتخاب آیکن تیک، شناسه کاربری مربوط به مبدا یا مقصد نشان داده شوند. انتقال پست به صورت آنی انجام میگیرد. امکان تعویض قسمتهای خاصی از متن کانال مبدا مانند آیدی کانال مبدا نیز با استفاده از پلاگینهای مربوطه ممکن است.
کد سفارشی
کدنویسی سفارشی بدین معناست که اگر شما عزیزان نیاز به امکانات اختصاصی در ربات خود داشتید و این نیاز از طریق امکانات عمومی صهبات قابل رفع نبود، پس از هماهنگی با تیم فنی صهبات، کدنویسی سفارشی برای شما انجام و در این قسمت به ربات شما اضافه میگردد. کدنویسی سفارشی ممکن است با هزینه بسیار کم و حتی رایگان انجام گیرد، برآورد هزینه پس از ثبت درخواست کدنویسی سفارشی، توسط تیم فنی مجرب صهبات انجام میشود.
کرون جاب
برای زماندار کردن فرآیند دلخواه، از کرون جاب استفاده نمایید که برای تعیین ارسال پیامهای خاص در زمان خاص، بسیار کاربردی هستند. کافیست زمان شروع و پایان فرآیند و تعداد دفعات تکرار را تعیین نمایید. یکی از مثالهای پرکاربرد این فرآیند، ارسال تبلیغات در کانال یا به کاربرهای ربات است.
وبلاگ/فروشگاه
فرآیندی بینظیر و ساده برای ایجاد فروشگاه اینترنتی در داخل ربات است. در این فرآیند تنظیمات اصلی فروشگاه و یا وبلاگ خود را مدیریت کنید. توجه داشته باشید که مطالب وبلاگ یا فروشگاه خود را باید در قسمت مجموعهها (اطلاعات تفصیلی و اختصاری به همراه فایل و عکس و ... در صورت نیاز، در مورد محصول یا مطلب) در فهرست امکانات کلی ربات ایجاد و تکمیل کنید. در فرآیند فروشگاه با یک کلیک، مجموعه مطالب را فراخوانی میکنید. این فرآیند امکانات ایجاد سبد خرید، اتصال به درگاه پرداخت برای خرید مشتریان و تنظیمات جامع دیگری دارد که همه نیازهای فروشندگان و تولیدکنندگاه محتوا را برطرف میکند.
پیشرفته
با فرآیند پیشرفته میتوانید به صورت دستی، دستورها و فرآیندهای مختلف را به هم مرتبط کنید. API های متنوع را به فرآیند متصل کنید و دنیایی از امکانات بینظیر مشابه بلوکهای اسکرچ به سادگی در اختیار شما قرار دارد. توجه داشته باشید برخی بلوکهای فرآیند پیشرفته ممکن است در آینده امتیاز هم مصرف کنند.
لیست و امکانات دقیق بلوک های فرآیند پیشرفته در انتهای مستندات اضافه شده اند.
برای مشاهده این قسمت، می توانید همین جا کلیک کنید.
مدیر گروه
فرآیند مدیر گروه، یک دستیار هوشمند با بسیاری از امکانات مدیریتی است. تعدادی از دستورهای مهم که میتوانید با نوشتن آنها فرمان مدنظر را صادر کنید در جدول زیر ارائه شده اند:
علامت قبل از فرمان | متن فرمان | جزئیات فرمان | واحد | نحوه ارجاع | عملکرد |
! یا . | پیکربندی | - | - | پیام مستقل | بروزرسانی اطلاعات مالک و مدیران |
! یا . | سکوت | - | ساعت | ریپلای به پیام | محدودیت ارسال پیام |
! یا . | اخراج (بن) | - | ساعت | ریپلای به پیام | محدودیت دسترسی کاربر مورد نظر |
! یا . | آزاد | - | - | ریپلای به پیام | پاک شدن همه بنها، اخطارها و برداشته شدن محدودیتها |
! یا . | ریست | - | - | ریپلای به پیام | فقط پاک شدن اخطارها |
! یا . | گروه | آزاد/قفل | - | پیام مستقل | آزاد یا قفل کردن گروه |
! یا . | اضافه به | لیست سفید/لیست سیاه | - | ریپلای به پیام | افزودن کاربر به لیست سفید یا سیاه |
! یا . | حذف از | لیست سفید/لیست سیاه | - | ریپلای به پیام | حذف کردن کاربر از لیست سفید یا سیاه |
! یا . | پاکسازی | کل/از اینجا/x ساعت | - | متنوع | پاکسازی پیامها |
مسیرساز
با فرآیند مسیرساز شما مسیر اجرای فرآیند و دستورهای مختلف را تعیین میکنید. اگر شروطی در این مسیر نیاز به بررسی داشت نیز به آن اضافه مینمایید. ساخت عملکرد جوین اجباری کانال با این فرآیند بسیار ساده است.
پلاگینها
گاهی اوقات نیاز دارید در پیام ارسالی به کاربر (یا حتی در مقداری که می خواهید در پایگاه داده ذخیره کنید و ...) متن متفاوتی را استفاده کنید که ممکن است برای هر کاربر، یا هر وضعیت متفاوت و ... مقدار متفاوتی داشته باشد.
به عنوان مثال، فرض کنید می خواهید در متن پیام ابتدایی ربات، از اسم کاربر هم استفاده کنید. مثلا اگر اسم فرد، محمد است ربات پیام بدهد «سلام محمد عزیز». در این صورت به جای «محمد» باید پلاگین مناسب آن را استفاده کنید:
سلام <peer>title</peer> عزیز زمان: <date></date>
در این صورت، به جای تگ peer که در متن اضافه کردیم، عنوان (نام) فرد که در پیامرسان برای خود تعیین کرده نمایش داده می شود و به جای تگ date، زمان نمایش داده می شود:
سلام محمد عزیز
زمان: 1403/12/06 12:17:23
در صورتی که قصد دارید تنها بخش مشخصی از تاریخ نشان داده شود میتوانید داخل پلاگین date نمایش آن را محدود نمایید. مانند:
تاریخ امروز: <date>y/m/d</date>
که به صورت زیر نشان داده خواهد شد:
تاریخ امروز: 04/01/12
اگر میخواهید از ربات در گروه استفاده نمایید دیگر پلاگین peer برای نشان دادن نام کاربر به درستی عمل نخواهد کرد. پس باید از پلاگین author که فرستنده پیام را شناسایی میکند استفاده کرد. مانند پیام خوشآمد زیر:
سلام <author>title</author> عزیز! به گروه ما خوش اومدی
یا اگر می خواهیم از متن خود کاربر در متن رباتمان استفاده کنیم می توانیم از تگ msg استفاده کنیم:
متن ارسالی شما: <msg>text</msg>
یا اگر فرد قبلا از طریق فرآیند فرم، اطلاعاتش را ذخیره کرده، می توانیم با استفاده از تگ dbentry، آنها را در متن های خود اضافه کنیم. مثلا در پیام انتهای ثبت نام بنویسیم:
<dbentry>name</dbentry> عزیز شماره موبایل <dbentry>mobile</dbentry> برای شما ثبت شد. هم اکنون می توانید از امکانات ربات ما استفاده کنید.
یعنی اگر فرد در فرم ثبت نام، نام «محمد» و شماره موبایل «09111111111» را ثبت کرده باشد، پیام به این صورت برایش ارسال خواهدشد:
محمد عزیز
شماره موبایل 09111111111 برای شما ثبت شد.
هم اکنون می توانید از امکانات ربات ما استفاده کنید.
همانطور که مشخص است، در نحوه نوشته شدن تگها از قوانین عمومی که در html و xml وجود دارد پیروی می شود. یعنی هر تگ با علامتهای < و > ساخته می شود و از 2 بخش شروع و پایان تشکیل می شود. در بخش شروع، نام تگ اضافه (مثلا <msg>) و در بخش پایانی، یک اسلش نیز قبل از نام تگ قرار می گیرد (مثل </msg>). متن ها و ویژگیهای بین این دو بخش، توسط پلاگینی که نام آن در تگ تعیین شده است تحلیل و در صورت نیاز، تغییر داده خواهندشد.
*توجه داشته باشید که با اضافه شدن هر پلاگین به متنهای شما، میزان الماس مصرفی ربات شما نیز افزایش پیدا خواهدکرد.
چند نکته درباره پلاگین ها وجود دارد:
1. امکان استفاده از چندین ویژگی یک پلاگین به طور همزمان داخل یک تگ وجود دارد. در این صورت، باید آنها را داخل {} بنویسیم
<dbentry> {name} عزیز شماره موبایل {mobile} برای شما ثبت شد. هم اکنون می توانید از امکانات ربات ما استفاده کنید. کد رهگیری شما: {$id} </dbentry>
یا به عنوان مثال برای تگ peer می توانیم بنویسیم:
<peer>
سلام {title} عزیز
نام کاربری شما @{username} است.
</peer>
2. امکان استفاده از تگهای پلاگین در داخل یکدیگر وجود دارد. در این صورت ابتدا تگی در داخل قرار دارد اجرا می شود و متن خود را جایگزین می کند و بعد تگ بیرونی اجرا می شود.
مثلا اگر می خواهیم تاریخ را با کاراکترهای فارسی نمایش دهیم می توانیم آن را در تگ fanum قرار دهیم:
<fanum><date></date></fanum>
در این صورت ابتدا تاریخ توسط پلاگین date تولید می شود و سپس اعداد آن توسط پلاگین fanum به کاراکترهای فارسی تبدیل می شود.
برای تگهای تو در تو هم هر تعداد تگ که در داخل هم استفاده شوند به همین ترتیب اجرا خواهندشد و محدودیتی از لحاظ تعداد تگهای تودرتو وجود ندارد.
حال که به طور اجمالی با نحوه استفاده از پلاگینها آشنا شدیم، بهتر است ببینیم چه پلاگینهایی را میتوانیم استفاده کنیم و هر پلاگین، چه ویژگیهایی دارد:
-اطلاعات حساب کاربری (peer,author)
برای استفاده از نام یا شناسه عددی و یا نام کاربری مخاطب ربات از پلاگین peer برای استفاده در گفتگوی خصوصی کاربر با ربات و از پلاگین author برای استفاده در گروه (مانند پیام خوشآمدگویی، اخطار و ...) استفاده میشود.
ویژگی | عنوان |
---|---|
title | نام نمایشی حساب کاربری فرد |
username | نام کاربری در پیامرسان |
sys_id | شناسه عددی در صهبات |
id | شناسه عددی در پیامرسان |
-تاریخ و زمان (date)
همانطور که در مثالهای قبل نمایش داده شد، تاریخ و زمان با پلاگین date فراخوانی میشود.
پلاگین date، تاریخ جاری یا تاریخ تعیین شده توسط شما را با قالب دلخواه نمایش میدهد.
قالب دلخواه در داخل تگ تعیین میشود و میتوانید نحوه ارائه را با نوشتن حروف مربوطه شخصیسازی کنید.
سال/ماه/روز ساعت:دقیقه:ثانیه
تگ داخلی | عنوان |
---|---|
value | تعیین تاریخ دلخواه |
modify | (مثلا افزودن یا کاستن زمان از تاریخ مورد نظر)مدیریت تاریخ مورد نظر |
value-sec | تعیین تاریخ به صورت عدد UNIX به صورت ثانیههای شمارش شده از سال 1970 |
value-milisec | تعیین تاریخ به صورت عدد UNIX به صورت میلی ثانیههای شمارش شده از سال 1970 |
value-microsec | تعیین تاریخ به صورت عدد UNIX به صورت میکرو ثانیههای شمارش شده از سال 1970 |
عبارت داخل پلاگین | عنوان و توضیح | نمونه (بازه) خروجی |
---|---|---|
Y | سال به صورت چهار رقمی | 1404 |
y | سال به صورت دو رقمی | 04 |
m | ماه به صورت دو رقمی | 01-12 |
M | ماه | 1-12 |
d | روز به صورت دو رقمی | 01-31 |
j | روز | 1-31 |
W | هفته از سال | 1-52 |
w | روز هفته با اعداد 0 تا 6 (صفر برای یکشنبه) | 0-6 |
N | روز هفته با اعداد 1 تا 7 (یک برای دوشنبه) | 1-7 |
D | روز از هفته به صورت سه حرفی | پنج |
l | روز از هفته به صورت کامل | پنجشنبه |
H | ساعت به صورت دو رقمی 24 ساعته | 00-23 |
i | دقیقه با رقم یکان و دهگان | 00-59 |
s | ثانیه با رقم یکان و دهگان | 00-59 |
در مثال زیر فقط روز و ساعت در زمان تعیین شده به طور دلخواه فراخوانی میشوند:
روز و ساعت: <date><value>1404/01/01 19:30:00</value>d/H</date>
روز و ساعت: 01/19
برای زمان به صورت UNIX نیز میتوان از سه تگ ذکر شده در جدول فوق به صورت زیر استفاده نمود
تاریخ شروع ثبت نام: <date><value-sec>1738355400</value-sec>Y/m/d</date>
تاریخ شروع ثبت نام: 1403/11/11
در صورت نیاز به ویرایش تاریخ به انحا مختلف نیز از تگ modify استفاده میشود. در مثال زیر 3 روز به تاریخ حال اضافه و نمایش میدهد:
تاریخ اتمام گردش کار: <date><modify>+3 days</modify>Y/m/d</date>
اگر تاریخ امروز 1403/01/17 باشد متن نمایش داده شده به صورت زیر خواهد بود.
تاریخ اتمام گردش کار: 1404/01/20
-پیام کاربر (msg)
این پلاگین که با تگ msg تعیین می شود اطلاعات پیام دریافتی از کاربر (مثل متن، نوع پیام و ...) را در اختیار ما قرار می دهد.
ویژگیها:
ویژگی | عنوان | واحد | نمونه خروجی |
---|---|---|---|
type | نوع پیام | - | image |
text | ورودی به صورت پیام متنی | - | سلام، من درخواست پشتیبانی خدمات دارم. |
id | شناسه پیام دریافتی | - | 123456789 |
file_token | توکن ثبت شده برای فایل دریافتی | - | qwerty1234-uiop |
file_unique_id | شناسه یکتای ثبت شده برای فایل دریافتی | - | asdfg9876-hjkl |
file_name | نام فایل دریافتی | - | عکس کارت ملی |
file_mime | نوع دقیق فایل براساس محتوا | - | application/pdf |
file_mime_general | نوع عمومی فایل براساس محتوا | - | application |
file_size | حجم فایل دریافتی | بایت | 10000 |
file_duration | طول زمان پخش فایل (فیلم و صوت) | ثانیه | 60 |
file_height | ارتفاع قاب فایل (عکس و فیلم) | پیکسل | 1080 |
file_width | پهنای قاب فایل (عکس و فیلم) | پیکسل | 1920 |
location_latitude | عرض جغرافیایی (لوکیشن) | درجه | 35.67767765092822 |
location_longitude | طول جغرافیایی (لوکیشن) | درجه | 51.36976853777408 |
contact_fname | نام مخاطب (اشتراک گذاری مخاطب) | - | محمد |
contact_lname | نام و نام خانوادگی مخاطب (اشتراک گذاری مخاطب) | - | ایراننژاد |
contact_nname | نام مستعار مخاطب (اشتراک گذاری مخاطب) | - | ایرانی |
contact_phone | شماره تماس مخاطب (اشتراک گذاری مخاطب) | - | 09121111111 |
contact_email | ایمیل مخاطب (اشتراک گذاری مخاطب) | - | mohammad@sahbaa.com |
به عنوان مثال اگر می خواهید متن ارسالی کاربر را به خودش (یا به فرد یا کانال دیگری ...) ارسال کنید می توانید در متن پیام ارسالی بنویسید:
پیام ارسالی شما: <msg>text</msg>
-اطلاعات ثبت شده توسط کاربر (dbentry,dbentries)
بهترین روش دریافت اطلاعات کاربران از طریق ساخت پایگاه داده و فرآیند فرم دریافت اطلاعات است. حال اگر در نظر دارید این اطلاعات را در خود پیام های استفاده شده در فرم و یا در دیگر فرآیندها استفاده نمایید میتوانید با پلاگین مربوطه به راحتی آنها را فراخوانی کنید.
تگ داخلی | عنوان |
---|---|
db | مشخص کردن شناسه دیتابیس مورد نظر جهت فراخوانی داده |
entrypeer | مشخص کردن شناسه کاربر در صهبات جهت فراخوانی داده |
eid | مشخص کردن شناسه عددی رکورد ثبت شده در پایگاه داده جهت فراخوانی داده |
notfound | مشخص کردن پیام ارسالی در صورت عدم وجود داده مورد نظر |
فراخوانی داده در پیامهای خود فرم ثبت اطلاعات آسانتر است. برای مثال پیامی که پس از ثبت نام به کاربر ارسال میشود میتواند به این شکل باشد:
<dbentry> اطلاعات شما ثبت شد {name} عزیز! شماره تماس ثبت نامی شما: {phone} </dbentry>
که به صورت زیر به کاربر ارسال خواهد شد:
اطلاعات شما ثبت شد محمد عزیز!
شماره تماس ثبت نامی شما: 09111111111
یا در مثال زیر اگر کاربر خارج از فرآیند فرم با پایگاه داده مدنظر شماست، میتوانید با تگ <db> شناسه پایگاه داده خود را مشخص و داده مورد نظر را فراخوانی کنید.
<dbentry><db>9876543</db> از خرید شما متشکریم {name} عزیز </dbentry>
پیام به این صورت ظاهر خواهد شد:
از خرید شما متشکریم محمد عزیز
برای دیگر پلاگینهای ذکر شده در جدول فوق نیز به همین شکل میتوانید شناسه کاربر، شناسه رکورد و همچنین پیام عدم وجود داده در پایگاه داده صهبات را مشخص و سپس اطلاعات فیلد مورد نظر را فراخوانی نمایید.
برای نمایش و فراخوانی چندین داده از رکوردها از پلاگین dbentries استفاده میشود.
تگ داخلی | عنوان |
---|---|
db | مشخص کردن شناسه دیتابیس مورد نظر جهت فراخوانی دادهها |
entry | برای نمایش اطلاعات داخل هر رکورد استفاده میشود. عملکرد و نحوه نمایش آن دقیقا مثل تگ dbentry میباشد و به تعداد رکوردهای تکرار شده پشت سر هم تکرار خواهد شد |
noentries | مشخص کردن پیام ارسالی در صورت عدم وجود دادههای مورد نظر |
limit | تعداد رکوردهای خروجی (حداکثر 20 مورد و امکان تعیین شروع رکوردها از این بخش نیز وجود دارد (offset)) |
lastrows | فقط در صفحه آخر رکوردها دیده میشود |
nonlastrows | غیر از صفحه آخر رکوردها دیده میشود |
query | کوئری جستجو |
jsonoutput | برای دریافت خروجی به صورت JSON |
متغیر سراسری
متغیرهای سراسری در قسمت به خصوص خود در محیط کاربری ایجاد و ویرایش میشوند. تفاوت این متغیرها با متغیرهای موقت، محدود نبودن متغیر به گفتگوی تک تک کاربران و امکان اعمال آن در هر جایی از فرآیندهای ربات است. اگر مقادیر این متغیرها تغییری بکنند، در همه بخشهایی که استفاده شده اند این تغییرات اعمال خواهند شد. متغیرهای سراسری با پلاگین gvar فراخوانی میشوند.
در این مثال اگر شماره تماس و اطلاعات دیگر ادمین به عنوان یک متغیر با عنوان دلخواه contact تنظیم شده باشد، میتوان آن را به این شکل فراخوانی کرد:
شماره تماس ما: <gvar>contact</gvar>
شماره تماس ما: 09111111111
آدرس: تهران - میدان ولیعصر
روزهای کاری: شنبه تا پنجشنبه 8 تا 16
متغیر فرآیند پیشرفته
با این پلاگین که با تگ var تعریف می شود می توانید مقدار متغیری که در فرآیند پیشرفته تعیین کرده اید را در متن خود استفاده کنید. بنابراین این پلاگین فقط در آیتمهایی قابل استفاده است که در فرآیند پیشرفته اضافه شده اند. مهمترین استفاده آن در بلوک ارسال پیام در فرآیند پیشرفته است. فرض کنید کاربر نمره درس را فرستاده و قرار است شما بگویید این نمره، خوب است، متوسط است یا ضعیف. می توانید بر اساس عملگرهای فرآیند پیشرفته، در متغیری به نام range، خوب، متوسط یا ضعیف بودن نمره را تعیین کنید:
سپس با بلوک ارسال پیام، این متن را به کاربر بفرستید:
سطح نمره شما <var>range</var> می باشد.
اگر نمره متوسط باشد، متن نهایی به این صورت به کاربر فرستاده خواهدشد:
سطح نمره شما متوسط می باشد.
-شروط (if,else)
زمانی که نیاز به فراخوانی شرط و انجام کاری در صورت تحقق یا عدم تحقق آن وجود دارد، از پلاگین if و else استفاده میشود. شروط ربات بخش مخصوصی در تنظیمات هر ربات دارد و امکان ایجاد و ویرایش انواع شرطها فراهم شده است. شروط در فرآیندها و پیامهای آنها به صورت تنظیمات فرآیند یا پلاگین قابل فراخوانی هستند. پس از ایجاد هر شرط، شناسهای برای آن تعیین میشود که در پلاگینها به عنوان cid شناخته میشود و امکان
در مثال زیر اگر شرط با شناسه مشخص محقق شود (بررسی نمره) پیام متنی مورد نظر ارسال و اگر محقق نشود پیام متفاوتی ارسال خواهد شد. فرض کنید:
شما در این درس <if cid="82444263097366">قبول<else>مردود</if> شده اید.
اگر نمره ارسالی کاربر بالای 10 بوده باشد پیغام زیر ارسال خواهد شد:
شما در این درس قبول شده اید.
-اطلاعات پل ارتباطی مورد استفاده (bridge)
امکان استخراج اطلاعات و وضعیت پل ارتباطی با پلاگینهای مربوط به آن وجود دارد.
ویژگی | عنوان |
---|---|
sys_id | شناسه عددی پل ارتباطی در صهبات |
id | شناسه عددی پل ارتباطی در پیامرسان |
type | نام پیامرسان |
username | شناسه ربات در پیامرسان |
title | نام پل ارتباطی در صهبات |
webhook_status | وضعیت اتصال پل ارتباطی |
به عنوان مثال اگر متن پیام به این صورت باشد:
<bridge> شناسه عددی پل ارتباطی در پیامرسان {id} و وضعیت پل {webhook_status} است. </bridge>
به این شکل نمایش داده خواهد شد
شناسه عددی پل ارتباطی در پیامرسان 987654 و وضعیت پل active است.
نقل قول (quote)
پلاگین نقل قول، میتواند مقادیر مختلف مانند JSON را در میان "" ارسال نماید.
فیلترها
فیلترها از جمله امکاناتی هستند که در کنار پلاگینها میتوانند به شخصیسازی هر چه بیشتر محتوای نمایش داده شده توسط ربات کمک کنند.
قالب کلی پلاگینها به همراه فیلترها به شکل زیر است:
<plugin>property|filter</plugin>
یا در صورت استفاده تجمیعی از پلاگینها:
<plugin> ....
... {property1|filter} ...
... {property2|filter} ...
... </plugin>
همچنین امکان استفاده از چندین فیلتر روی یک ویژگی مشخص وجود دارد. مانند:
<plugin>property|filter1|filter2</plugin>
در جدول زیر فهرست فیلترهای مختلف ارائه گردیده است:
فیلتر | عنوان | نمونه خروجی |
---|---|---|
num | عدد را از سمت راست سه رقم سه رقم با ویرگول جدا میکند | 123,456,789 |
date | تبدیل UNIX (تعداد ثانیههای شمارش شده از ابتدای 1970 پیش تاکنون) به تاریخ عادی | 1403/12/06 12:20:36 |
fanum | کلیه اعداد، فارسی نمایش داده شوند | mohammad۱۲۳۴ |
ennum | کلیه اعداد، انگلیسی نمایش داده شوند | mohammad1234 |
q | ویژگی/محتوای مشخص شده در بین "" نمایش داده شود. ممکن است از مقادیر json نیز استفاده گردد که در ادامه توضیح داده میشود | "mohammad" |
ممکن است تعدادی از فیلترهای ذکر شده به صورت پلاگین هم قابل استفاده باشند. اما باید توجه داشت که نحوه نوشتار و جایگاه استفاده پلاگینها و فیلترها تفاوتهایی دارند.
در بخش پلاگینها، با پلاگین fanum مثالهایی آورده شده بود. فیلتر fanum نیز دقیقا همان کارایی را دارد اما طرز اعمال فیلتر و نوشتار متفاوت است مانند:
نام ثبت شده:<dbentry>name|fanum</dbentry>
در این مثال، فیلد name ثبت شده در پایگاه داده برای کاربر نمایش، و اعداد آن به صورت فارسی خواهند بود. اگر نام ثبت شده
mohmmad1234
بوده باشد به صورت زیر نمایش داده میشود:
نام ثبت شده: mohammad1234
کاربران
در این قسمت اطلاعات مختلف کاربران ربات قابل مشاهده هستند. اگر به شناسه کاربر، کانال و یا گروهی نیاز دارید میتوانید از بخش کاربران به تفکیک پلهای ارتباطی آنها را بررسی و استفاده نمایید. همچنین امکان افزودن کاربر و ایجاد گروههای کاربری جدید دلخواه (مثل ادمین، خریدار، فروشنده و ...) وجود دارد.
پایگاههای داده
پایگاههای داده در قسمت فرآیندها نیز اشاره شده بودند. اگر نیاز به ایجاد فرم و یا دریافت اطلاعات مختلف از کاربران دارید، در این قسمت به سادگی پایگاههای داده خود را ایجاد و مدیریت نمایید. امکان مشاهده موارد ثبت شده به همراه دریافت خروجی اکسل نیز وجود دارد.
شروط
در هر کجا از فرآیندهای ربات خود نیاز به شروط خاصی داشتید، شرط را اینجا ایجاد کنید تا در قسمتهای مختلف به راحتی فراخوانی کنید. شروط قابل اعمال بسیار گسترده هستند، که امکان استفاده از پلاگینها (شبیه تگهای HTML) نیز در آنها وجود دارد.
سبد خرید
سبد خرید گزارشی جامع از وضعیت ثبت سفارشات، پرداختها و تراکنشها ارائه میدهد.
مدیران
در صورت نیاز مدیران دیگری برای ربات خود تعیین کنید تا آنها نیز به قسمتهای مختلف محیط مدیریت دسترسی داشته باشند.
مجموعهها
همانطور که در توضیحات بخش فرآیندها اشاره شده بود، شما میتوانید با ایجاد مجموعه و در صورت نیاز زیرمجموعه (مجموعه والد و فرزند)، مطالب و یا محصولات فروشگاهی اعم از پولی و رایگان را در اختیار کاربران ربات قرار دهید. قابلیت ایجاد سبد خرید و ثبت سفارش نیز وجود دارد.
در ستون عملیات میتوانید مجموعه را به صورت سریع یا با جزئیات ویرایش نمایید.
مطالب
پس از ساخت مجموعه، مطالب و محصولات خود را در این بخش با جزئیاتی از قبیل توضیح درباره محصول، عکس، فایل و ... به همراه قیمتهایی با قابلیت محدودسازی برای کاربران خاص ایجاد مینمایید. امکان افزودن محصولات/ مطالب پولی و غیرپولی با ارسال پیام سفارش به صورت آنی به ادمین وجود دارد.
فایلها
فایلهای دریافت شده از طریق ربات، در این بخش نمایش داده میشوند. میتوانید فایلها را در فرآیندهای مختلف فراخوانی کنید و در کانال، گروه و برای کاربران ارسال نمایید.
صهباتفایلها
امکان بارگذاری انواع فایل در این بخش وجود دارد. میتوانید فایلها را در فرآیندهای مختلف فراخوانی کنید و در کانال، گروه و برای کاربران ارسال نمایید.
متغیرهای سراسری
اگر متغیری عمومی (شناسه کاربر) برای ربات خود مدنظر دارید، در بخش متغیرهای سراسری تعیین میکنید که مثلا متغیر id به هنگام فراخوانی همواره معادل مقدار خاصی باشد. و دیگر نیازی نیست برای هر فرآیند خود مقدار نوشته شود.
آمار
آمار مصرف منابع و امتیاز ربات به صورت نموداری در این بخش نمایش داده میشود.
پرداخت
ربات شما برای تداوم عملکرد از دو واحد درونبرنامهای «امتیاز» و «الماس» استفاده میکند. تعداد الماس مصرفی و تاریخ انقضای الماس به صورت خودکار در فهرست ربات قابل مشاهده هست.
در صورت نیاز به خریداری الماس یا امتیاز بیشتر، به راحتی میتوانید از بخش پرداخت ربات مقدار واحد درونبرنامهای مورد نیاز برای تعداد روز مشخص را خریداری نمایید.
در بخش پرداخت میتوانید براساس مصرف روزانه ربات، تعداد امتیاز و الماس مورد نیاز برای بازه زمانی مشخص خریداری فرمایید.
بلوک های فرآیند پیشرفته
قبل تر در بخش فرآیندهای ربات، با فرآیند پیشرفته آشنا شدیم.
در این بخش می خواهیم لیست تمامی بلوک های موجود در این فرآیند را به طور کامل داشته باشیم تا کاربران بتوانند به عنوان مرجع، از آن استفاده کنند.
همانطور که در تصویر می بینید، این بلوک ها دسته بندی شده اند و با انتخاب هر دسته، در سمت چپ، بلوک های مربوط به آن دسته نمایش داده می شوند:
توجه داشته باشید که در طول زمان و با به روزسانی ها و افزایش امکانات صهبات، ممکن است این دسته بندی ها یا بلوک ها تغییر کنند که البته این تغییرات در اسرع وقت، در صفحه مستندات نیز اعمال خواهندشد.
در حال حاضر، این دسته بندی ها در بخش فرآیند پیشرفته وجود دارند:
- دستورها و فرآیندها
- پیامها
- ذخیره و فراخوانی دادهها
- کاربران
- فایلها
- مطالب و مجموعهها
- پرداخت و تراکنشها
- ابزارها
- تصاویر
- عملگرها
- حلقهها
- عملیات ریاضی
- متن (رشته ها)
- لیست ها
- رنگها
- متغیرها
- متغیرها (با تعیین نوع)
- متغیرهای سراسری
- توابع
دستورها و فرآیندها
این دسته شامل بلوکهایی برای کنترل جریان اجرای دستورها و فرآیندهای ربات است.
ورود با دریافت
commands_start
این بلوک نقطه شروع یک فرآیند را بر اساس دستوری که کاربر وارد میکند، مشخص مینماید.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | CMD | ورود با دریافت | TextInput |
SIMPLEENABLED | امکان ورود بدون دستور | Checkbox | |
ID | شناسه بلوک | TextButton (برای نمایش/پنهان کردن شناسه) | |
BLOCKID | شناسه بلوک | TextInput (در حالت نمایش) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
انتقال به دستور
commands_gotocmd
اجرای فرآیند فعلی را متوقف کرده و کاربر را به یک دستور دیگر منتقل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | CMD | انتقال به دستور | String |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
OPT | اطلاعات بیشتر | String (اختیاری) | |
خروجی | خروجی | ندارد (این بلوک پایانی است) |
تعیین دستور
commands_setcmd
دستور بعدی کاربر را بدون اجرای فوری آن، تنظیم میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | CMD | تعیین دستور | String |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
اجرای دستور
commands_runcmd
یک دستور را به صورت یک زیرفرآیند اجرا کرده و پس از اتمام آن، به فرآیند فعلی بازمیگردد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | CMD | اجرای دستور | String |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
OPT | اطلاعات بیشتر | String (اختیاری) | |
فیلدها | CHANGEUSERCMD | تعیین به عنوان دستور جاری کاربر | Checkbox (اختیاری) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
انتقال به فرآیند
commands_gotoprocess
اجرای فرآیند فعلی را متوقف کرده و به یک فرآیند دیگر بر اساس شناسه آن منتقل میشود.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PID | انتقال به فرآیند | Number |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
OPT | اطلاعات بیشتر | String (اختیاری) | |
خروجی | خروجی | ندارد (این بلوک پایانی است) |
تعیین فرآیند
commands_setprocess
فرآیند بعدی کاربر را بر اساس شناسه، بدون اجرای فوری، تنظیم میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PID | تعیین فرآیند | Number |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
اجرای فرآیند
commands_runprocess
یک فرآیند دیگر را به صورت یک زیرفرآیند اجرا کرده و پس از اتمام، به فرآیند فعلی بازمیگردد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PID | اجرای فرآیند | Number |
SUBPROCESS | شناسه زیرفرآیند | Number (اختیاری) | |
OPT | اطلاعات بیشتر | String (اختیاری) | |
فیلدها | CHANGEUSERCMD | تعیین به عنوان دستور فعلی کاربر | Checkbox (اختیاری) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
وضعیت تعیینشده در کلید
commands_statekeyset
مقدار یا دادهای که از طریق یک کلید شیشهای (Callback Query) به ربات ارسال شده را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | وضعیت تعیینشده در کلید | String |
نگهداری وضعیت دستور
commands_statekeep
وضعیت فعلی دستور را برای دریافت پیام بعدی از کاربر حفظ میکند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | WAIT | ادامه با پیام بعدی کاربر | Checkbox |
ID | شناسه بلوک | TextButton (برای نمایش/پنهان کردن شناسه) | |
BLOCKID | شناسه بلوک | TextInput (در حالت نمایش) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
وضعیت فعلی دستور
commands_statecurr
وضعیت یا داده ذخیرهشده در یک دستور را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | وضعیت فعلی دستور | String |
حذف وضعیت دستور
commands_statedelete
وضعیت ذخیرهشده برای دستور فعلی کاربر را حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
کاربر با دستور وارد شده است؟
commands_enteredwithcommand
بررسی میکند که آیا کاربر از طریق یک دستور مستقیم (مانند /start) وارد فرآیند فعلی شده است یا خیر.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | کاربر با دستور وارد شده است؟ | Boolean |
پیامها
این دسته شامل بلوکهایی برای ارسال، دریافت و مدیریت پیامها است.
ارسال پیام
msgs_sendmsg
یک پیام به یک یا چند گیرنده ارسال میکند. با کلیک روی آیکون ⚙️ میتوان به تنظیمات پیشرفته پیام دسترسی داشت.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PEERS | تغییر گیرندگان (اختیاری) | Peers (اختیاری) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
ارسال یکباررمز
msgs_sendotp
یک کد یکبار مصرف (OTP) را از طریق پل ارتباطی مشخص شده به شماره همراه مقصد ارسال میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | OTP | ارسال یکباررمز | String |
MOBILE | به شماره همراه | Number | |
BRIDGEID | از پل ارتباطی خودم استفاده شود | Number | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
حذف پیام
msgs_deletemsg
یک پیام مشخص را بر اساس شناسهی آن حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | MSG | حذف پیام | String, Message |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
[داده پیام]
msgs_msgdata
یکی از ویژگیهای یک پیام مشخص را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | MSG | در [پیام] | Message |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [متن، کپشن یا مقدار، توکن فایل در صهبات، شناسه پیام در صهبات، شناسه برنامک در صهبات، شناسه پیام ریپلایشده در صهبات، شناسه پیام فورواردشده در صهبات، شناسه کاربر (گفتگوی) پیام در صهبات، شناسه فرستنده پیام در صهبات، لوکیشن ارسال شده، شناسه کاربر (گفتگوی) بازارسال در صهبات، نوع پیام، نوع فایل، نگهداری پیام]) |
TR | فارسی | Checkbox (فقط برای نوع پیام و نوع فایل) | |
خروجی | خروجی | [وابسته به فیلد TYPE] | String یا Boolean (برای "نگهداری پیام") |
نوع پیام
msgs_msgtype
یکی از انواع پیامهای ممکن را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع پیام | Dropdown (گزینهها: [متن، فایل، مکان، لاگ، مخاطب، پرداخت، استیکر، جوین، انتخاب کلید، اینلاین کوئری، نتیجه پرداخت]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع پیام | String |
پیام جاری
msgs_msgcurr
پیام فعلی که باعث اجرای این فرآیند شده است را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | پیام جاری | Message |
پیام با شناسه
msgs_msg
یک پیام را بر اساس شناسه کامل آن (شامل شناسه پل، شناسه کاربر و شناسه پیام) بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | پیام با شناسه | String |
خروجی | خروجی | پیام | Message |
فرستنده پیام جاری
peers_sendercurr
کاربری که پیام فعلی را ارسال کرده است، برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | فرستنده پیام جاری | Peer |
ذخیره و فراخوانی دادهها
بلوکهای این دسته برای کار با پایگاه داده، APIهای خارجی و فایلهای Excel استفاده میشوند.
شناسه آخرین رکورد پایان یافته بین همه کاربران در پایگاه داده
database_lastentryidfromall
شناسه آخرین رکوردی که ویرایش آن برای کاربر مشخصی به اتمام رسیده است را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
خروجی | خروجی | شناسه رکورد | Number |
شناسه آخرین رکورد پایان یافته در پایگاه داده
database_lastentryid
شناسه آخرین رکوردی که ویرایش آن برای کاربر مشخصی به اتمام رسیده است را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
PEER | برای کاربر | Peer | |
فیلدها | CREATENEW | ایجاد در صورت عدم وجود | Checkbox |
خروجی | خروجی | شناسه رکورد | Number |
شناسه رکورد در حال ویرایش در پایگاه داده
database_editingentryid
شناسه رکوردی که در حال ویرایش برای کاربر مشخصی است را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
PEER | برای کاربر | Peer | |
فیلدها | CREATENEW | ایجاد در صورت عدم وجود | Checkbox |
خروجی | خروجی | شناسه رکورد | Number |
اتمام ویرایش رکورد جاری در پایگاه داده
database_finishentry
وضعیت ویرایش یک رکورد را برای کاربر مشخصی به حالت "پایانیافته" تغییر میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
PEER | برای کاربر | Peer | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
حذف رکورد از پایگاه داده
database_removeentries
یک یا چند رکورد را از جدول پایگاه داده مشخص شده حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
ENTRYIDS | رکورد یا رکوردها | Number, Number[] | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
[داده رکورد]
database_entrydata
یکی از ویژگیهای یک رکورد پایگاه داده را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ENTRY | در [رکورد] | Entry |
FIELDNAME | نام فیلد | String (فقط برای "مقدار فیلد") | |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [شناسه رکورد، شناسه کاربر، زمان شروع، زمان پایان، تعداد فیلدها، مقدار فیلد]) |
خروجی | خروجی | [وابسته به فیلد TYPE] | Number (برای شناسه و تعداد فیلدها)، String (برای شناسه کاربر و مقدار فیلد)، DateTime (برای زمانها) |
دریافت رکورد پایگاه داده
database_entry
یک رکورد خاص را با استفاده از شناسه رکورد و شناسه جدول بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
ENTRYID | شناسه رکورد | Number | |
خروجی | خروجی | رکورد | Entry |
دریافت رکوردهای پایگاه داده
database_entries
رکوردهایی را از یک جدول پایگاه داده بر اساس کوئری جستجو، فیلتر و مرتبسازی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
SEARCHQUERY | کوئری جستجو | String | |
OFFSET | شماره ردیف | Number | |
LIMIT | تعداد رکورد خروجی | Number | |
RECORDSORDER | ترتیب رکوردها | String | |
FIELDNAMES | با دریافت این فیلدها JSON تبدیل به | String, String[] | |
PEER | برای کاربر (اختیاری) | Peer | |
خروجی | خروجی | لیست رکوردها | Entry[], Json |
تعداد رکوردهای پایگاه داده
database_entriescount
تعداد رکوردهای یک جدول را که با کوئری جستجو مطابقت دارند، برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
SEARCHQUERY | کوئری جستجو | String | |
PEER | فقط رکوردهای این کاربر | Peer | |
خروجی | خروجی | تعداد رکوردها | Number |
ذخیره یک فیلد در پایگاه داده
database_savefield
مقدار یک فیلد خاص را در یک رکورد مشخص، ذخیره یا بهروزرسانی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
ENTRYID | شناسه رکورد | Number | |
FIELDNAME | نام فیلد | String | |
NEWVALUE | مقدار برای ذخیره | String | |
PEER | برای کاربر (اختیاری) | Peer | |
فیلدها | FINISH | اتمام ویرایش | Checkbox |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
ذخیره چند فیلد در پایگاه داده
database_savefields
مقادیر چندین فیلد را به صورت یکجا در یک رکورد مشخص ذخیره میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
ENTRYID | شناسه رکورد | Number | |
PEER | برای کاربر (اختیاری) | Peer | |
element_i | [نام فیلد i] | String | |
فیلدها | FINISH | اتمام ویرایش | Checkbox |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
ایجاد رکورد جدید در پایگاه داده
database_insertnewrow
یک رکورد جدید در جدول مشخص شده ایجاد کرده و شناسه آن را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATABASEID | نام یا شناسه عددی پایگاه داده | Number, String |
PEER | برای کاربر | Peer | |
خروجی | خروجی | شناسه رکورد جدید | Number |
اتصال به API
database_connectiontoapi
یک درخواست HTTP به یک API خارجی ارسال کرده و پاسخ را در فرمت مشخص شده برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | APIURL | API اتصال به | String |
DATATOSEND | دادههای ارسالی | String, Json | |
HEADERS | هدرها | String, String[], Array | |
فیلدها | METHOD | نوع درخواست | Dropdown (گزینهها: [POST, GET, DELETE, PUT, PATCH, HEAD, MERGE, OPTIONS, COPY]) |
CONTENTTYPE | نوع دادهها | Dropdown (گزینهها: [application/json, text/plain, application/x-www-form-urlencoded, multipart/form-data, text/xml]) | |
OUTPUTTYPE | نوع خروجی | Dropdown (گزینهها: [JSON, XML (یا Html), متن خام, فایل خام]) | |
خروجی | خروجی | پاسخ API | Json, Xml, String, RawFile (بسته به فیلد OUTPUTTYPE) |
اتصال به API تحریمشده
database_connectiontoapi_nosanc
مشابه "اتصال به API" است، اما برای سرویسهایی که ممکن است تحریم شده باشند، از سرور واسط استفاده میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | APIURL | تحریمشده API اتصال به | String |
DATATOSEND | دادههای ارسالی | String | |
HEADERS | هدرها | String, String[], Array | |
فیلدها | METHOD | نوع درخواست | Dropdown (گزینهها: [POST, GET, DELETE, PUT, PATCH, HEAD, MERGE, OPTIONS, COPY]) |
CONTENTTYPE | نوع دادهها | Dropdown (گزینهها: [application/json, text/plain, application/x-www-form-urlencoded, multipart/form-data, text/xml]) | |
OUTPUTTYPE | نوع خروجی | Dropdown (گزینهها: [JSON, XML (یا Html), متن خام, فایل خام]) | |
خروجی | خروجی | پاسخ API | Json, Xml, String, RawFile (بسته به فیلد OUTPUTTYPE) |
جستجو در اکسل
database_excel
دادههایی را از یک فایل اکسل بر اساس ستونها و کوئری جستجو استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | جستجو در اکسل | SFile |
COLUMNS | انتخاب ستونها | String, StringArray | |
SEARCHQUERY | کوئری جستجوی ردیفها | String | |
RECORDSORDER | ترتیب رکوردها | String | |
RESULTOFFSET | تعداد پرش رکوردها از ابتدا | Number | |
RESULTLIMIT | تعداد رکورد خروجی | Number | |
OFFSETBEFORE | تعداد حذف ردیف قبل از جستجو | Number | |
فیلدها | HASHEADERS | عناوین در ردیف اول هستند | Checkbox |
خروجی | خروجی | نتیجه جستجو | Json |
تعداد رکوردهای اکسل
database_excelcount
تعداد ردیفهایی را که با کوئری جستجو در یک فایل اکسل مطابقت دارند، برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | تعداد رکوردهای اکسل | SFile |
SEARCHQUERY | کوئری جستجو | String | |
OFFSETBEFORE | تعداد حذف ردیف قبل از جستجو | Number | |
خروجی | خروجی | تعداد رکوردها | Number |
کاربران
بلوکهای این دسته برای مدیریت اطلاعات کاربران، گروههای کاربری و پلهای ارتباطی به کار میروند.
نوع پل ارتباطی
peers_bridgetype
یکی از انواع پلهای ارتباطی موجود را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع پل ارتباطی | Dropdown (گزینهها: [بله، آیگپ، ربات فرستنده ایتا، تلگرام، بله (GetUpdates)، تلگرام (GetUpdates)، صهبات در تلگرام، صهبات در بله، صهبات در گپ، صهبات]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع پل | String |
عنوان گروه کاربری
peers_usergrouptitle
عنوان فارسی یک گروه کاربری را بر اساس شناسه آن برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | عنوان گروه کاربری | String |
خروجی | خروجی | عنوان گروه | String |
کاربر (گفتگوی) جاری
peers_peercurr
کاربر یا گفتگوی فعلی (که فرآیند برای او اجرا میشود) را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | کاربر جاری | Peer |
کاربر (گفتگو) با شناسه
peers_peer
یک کاربر یا گفتگو را بر اساس شناسه کامل آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | کاربر (گفتگو) با شناسه | String |
خروجی | خروجی | کاربر | Peer |
کاربران
peers_peers
مجموعهای از کاربران را برای استفاده در بلوک "ارسال پیام" ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | کاربران | String, Peers |
JOIN | و افزودن | String, Peers (اختیاری) | |
خروجی | خروجی | لیست کاربران | Peers |
گروه های کاربری
peers_peersbyusergroup
مجموعهای از کاربران متعلق به گروههای کاربری مشخص را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | گروه های کاربری | String |
JOIN | و افزودن | Peers (اختیاری) | |
خروجی | خروجی | لیست کاربران | Peers |
تعیین گروه کاربر
peers_setusergroup
یک کاربر را به یک گروه کاربری اضافه میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PEER | کاربر | String, Peer |
ID | گروه کاربری | String, Number | |
فیلدها | DELETECURRENT | حذف گروههای کاربری فعلی | Checkbox |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
حذف از گروه های کاربر
peers_unsetusergroup
یک کاربر را از یک گروه کاربری مشخص حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PEER | کاربر | String, Peer |
ID | گروه کاربری | String, Number | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
[داده کاربر]
peers_peerdata
یکی از ویژگیهای یک کاربر یا گفتگوی مشخص را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | PEER | در [کاربر] | Peer |
CHANNEL | کانال (یا گروه) | Peer (فقط برای "عضو کانال است" و "ادمین است") | |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [شناسه در صهبات، نوع، نام کاربری، شناسه در برنامه، شناسه پل ارتباطی، عنوان پل ارتباطی، نوع پل ارتباطی، عنوان، گروههای کاربری، عناوین گروههای کاربری، ادمین است، ربات است، عضو کانال است، عضو پل ارتباطی است]) |
TR | فارسی | Checkbox (برای برخی گزینهها) | |
خروجی | خروجی | [وابسته به فیلد TYPE] | String, String[], Boolean (بسته به ویژگی انتخابی) |
نوع کاربر(گفتگو)/فرستنده
peers_peertype
یکی از انواع موجودیتهای یک گفتگو (کاربر، ربات، گروه، کانال) را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع کاربر(گفتگو)/فرستنده | Dropdown (گزینهها: [خصوصی، ربات، گروه، کانال]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع کاربر | String |
جستجو بین کاربران ربات
peers_peerssearch
کاربران را بر اساس یک کوئری جستجو، فیلتر کرده و لیستی از آنها را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SEARCHQUERY | جستجو بین کاربران ربات | String |
OFFSET | شماره ردیف | Number | |
LIMIT | تعداد رکورد خروجی | Number | |
خروجی | خروجی | لیست کاربران | Peer[] |
فایلها
بلوکهای این دسته برای مدیریت فایلها در سیستم (File, SFile, RawFile) استفاده میشوند.
فایل جاری
files_filecurr
فایلی که در پیام فعلی ارسال شده است را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | فایل جاری | File |
فایل با توکن
files_file
یک فایل موقت (که هنوز در سیستم صهبات ذخیره دائمی نشده) را بر اساس توکن آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | فایل با توکن | String |
خروجی | خروجی | فایل موقت | File |
صهباتفایل با توکن
files_sfile
یک فایل ذخیرهشده در صهبات (SFile) را بر اساس توکن آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | صهباتفایل با توکن | String |
خروجی | خروجی | فایل صهبات | SFile |
فایل خام با توکن
files_rawfile
یک فایل خام (معمولاً خروجی عملیات پردازش تصویر) را بر اساس توکن آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | فایل خام با توکن | String |
خروجی | خروجی | فایل خام | RawFile |
[داده فایل]
files_filedata
یکی از ویژگیهای یک فایل موقت (File) را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | در [فایل] | File |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [حجم فایل، لینک مستقیم، انقضای لینک مستقیم، آخرین استفاده، توکن فایل، توکن صهباتفایل (در صورت وجود)، نوع فایل، فرمت فایل، مدت، عرض، ارتفاع، نام فایل، تصویر بندانگشتی، نگهداری فایل]) |
TR | فارسی | Checkbox (فقط برای "نوع فایل") | |
خروجی | خروجی | [وابسته به فیلد TYPE] | Number, String, DateTime, Float, Boolean |
[داده صهباتفایل]
files_sfiledata
یکی از ویژگیهای یک فایل ذخیرهشده (SFile) را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | در صهباتفایل | SFile |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [حجم فایل، لینک مستقیم، انقضای لینک مستقیم، آخرین استفاده، توکن فایل، نوع فایل، فرمت فایل، مدت، عرض، ارتفاع، نام فایل، تصویر بندانگشتی، نگهداری فایل]) |
TR | فارسی | Checkbox (فقط برای "نوع فایل") | |
خروجی | خروجی | [وابسته به فیلد TYPE] | Number, String, DateTime, Float, Boolean |
[داده فایل خام]
files_rawfiledata
یکی از ویژگیهای یک فایل خام (RawFile) را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | در فایل خام | RawFile |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [حجم فایل، آخرین استفاده، توکن فایل، حجم دانلودشده فایل، نام فایل]) |
خروجی | خروجی | [وابسته به فیلد TYPE] | Number, String, DateTime |
نوع فایل
files_filetype
یکی از انواع فایل (تصویر، ویدیو، ...) را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع فایل | Dropdown (گزینهها: [تصویر، ویدیو، صوت، صدا، گیف، فایل ساده]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع فایل | String |
ذخیره فایل در صهبات
files_filesave
یک فایل موقت یا خام را در سیستم فایل صهبات ذخیره کرده و یک SFile برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | ذخیره فایل در صهبات | File, RawFile |
فیلدها | STORE | نگهداری بیش از 24ساعت | Checkbox |
خروجی | خروجی | فایل ذخیرهشده | SFile |
ویرایش فایل
files_fileedit
اطلاعات یک فایل موقت را ویرایش میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | ویرایش فایل | File |
NAME | نام جدید فایل | String | |
STORE | نگهداری بیش از 24ساعت | Boolean | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
ویرایش صهباتفایل
files_sfileedit
اطلاعات یک فایل ذخیرهشده در صهبات را ویرایش میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | ویرایش صهباتفایل | File |
NAME | نام جدید فایل | String | |
STORE | نگهداری بیش از 24ساعت | Boolean | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
مطالب و مجموعهها
این دسته برای کار با سیستم مدیریت محتوای داخلی (مطالب و مجموعهها) طراحی شده است.
مطلب با شناسه
articles_article
یک مطلب خاص را بر اساس شناسه آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | مطلب با شناسه | Number |
خروجی | خروجی | مطلب | Article |
مجموعه با شناسه
articles_category
یک مجموعه خاص را بر اساس شناسه آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | مجموعه با شناسه | Number |
خروجی | خروجی | مجموعه | Category |
[داده مطلب]
articles_articledata
یکی از ویژگیهای یک مطلب را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARTICLE | در [مطلب] | Article |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [شناسه مطلب، عنوان مطلب، توضیحات، کد مطلب، زمان ایجاد، زمان آخرین ویرایش، زمان شروع انتشار، زمان پایان انتشار، ترتیب، تعداد بازدیدها، وضعیت، نوع، قیمتها، مجموعهها]) |
TR | فارسی | Checkbox (فقط برای "نوع" و "وضعیت") | |
خروجی | خروجی | [وابسته به فیلد TYPE] | String, Number, Json, Category[], DateTime |
[داده مجموعه]
articles_categorydata
یکی از ویژگیهای یک مجموعه را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | CATEGORY | در [مجموعه] | Category |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [شناسه مجموعه، عنوان مجموعه، توضیحات، کد مجموعه، نوع، والد، وضعیت، زمان ایجاد، زمان آخرین ویرایش، زیر مجموعهها، تعداد زیر مجموعهها]) |
TR | فارسی | Checkbox (فقط برای "نوع" و "وضعیت") | |
خروجی | خروجی | [وابسته به فیلد TYPE] | Number, String, DateTime, Category, Category[] |
دریافت مطالب
articles_articles
لیستی از مطالب را بر اساس کوئری جستجو و فیلترهای دیگر بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SEARCHQUERY | کوئری جستجو | String |
OFFSET | شماره ردیف | Number | |
LIMIT | تعداد رکورد خروجی | Number | |
CATEGORIES | مجموعهها | Number, Number[], Array | |
خروجی | خروجی | لیست مطالب | Article[] |
دریافت مجموعهها
articles_categories
لیستی از مجموعهها را بر اساس کوئری جستجو و فیلترهای دیگر بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SEARCHQUERY | کوئری جستجو | String |
OFFSET | شماره ردیف | Number | |
LIMIT | تعداد رکورد خروجی | Number | |
خروجی | خروجی | لیست مجموعهها | Category[] |
دریافت تعداد مطالب
articles_articlescount
تعداد مطالبی که با شرایط جستجو مطابقت دارند را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SEARCHQUERY | کوئری جستجو | String |
CATEGORIES | مجموعهها | Number, Number[] | |
خروجی | خروجی | تعداد مطالب | Number |
نوع مطلب
articles_articletype
یکی از انواع مطلب را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع مطلب | Dropdown (گزینهها: [ساده]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع مطلب | String |
وضعیت مطلب
articles_articlestatus
یکی از وضعیتهای ممکن برای یک مطلب را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | وضعیت مطلب | Dropdown (گزینهها: [غیرفعال، تعلیقشده، فعال]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | وضعیت مطلب | String |
نوع مجموعه
articles_articlecategorytype
یکی از انواع مجموعه را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع مجموعه | Dropdown (گزینهها: [ساده]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع مجموعه | String |
وضعیت مجموعه
articles_articlecategorystatus
یکی از وضعیتهای ممکن برای یک مجموعه را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | وضعیت مجموعه | Dropdown (گزینهها: [غیرفعال، تعلیقشده، فعال]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | وضعیت مجموعه | String |
پرداخت و تراکنشها
این دسته برای ایجاد و مدیریت تراکنشهای مالی و پرداختها به کار میرود.
تراکنش با شناسه
payment_transaction
یک تراکنش مالی را بر اساس شناسه آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ID | تراکنش با شناسه | String |
خروجی | خروجی | تراکنش | Transaction |
[داده تراکنش]
payment_transactiondata
یکی از ویژگیهای یک تراکنش مالی را استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TRANSACTION | در [تراکنش] | Transaction |
فیلدها | TYPE | [ویژگی] | Dropdown (گزینهها: [شناسه تراکنش، نوع تراکنش، مبلغ تراکنش، وضعیت تراکنش، کد رهگیری تراکنش، شناسه درگاه پرداخت، لینک پرداخت، زمان بروزرسانی، زمان ایجاد تراکنش]) |
TR | فارسی | Checkbox (فقط برای "نوع" و "وضعیت") | |
خروجی | خروجی | [وابسته به فیلد TYPE] | String, DateTime |
ایجاد تراکنش به مبلغ (ریال)
payment_transactionset
یک تراکنش جدید با مبلغ و درگاه پرداخت مشخص ایجاد کرده و آن را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | AMOUNT | ایجاد تراکنش به مبلغ (ریال) | Number |
GATEWAYID | شناسه درگاه پرداخت | Number | |
خروجی | خروجی | تراکنش | Transaction |
دریافت تراکنشها
payment_transactions
لیستی از تراکنشها را بر اساس کوئری جستجو و فیلترهای دیگر بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SEARCHQUERY | کوئری جستجو | String |
OFFSET | شماره ردیف | Number | |
LIMIT | تعداد رکورد خروجی | Number | |
خروجی | خروجی | لیست تراکنشها | Transaction[] |
نوع تراکنش
payment_transactiontype
یکی از انواع تراکنشهای مالی را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | نوع تراکنش | Dropdown (گزینهها: [افزایش اعتبار، خرید، پرداخت]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | نوع تراکنش | String |
وضعیت تراکنش
payment_transactionstate
یکی از وضعیتهای ممکن برای یک تراکنش مالی را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TYPE | وضعیت تراکنش | Dropdown (گزینهها: [پرداخت نشده، پرداخت شده، لغو شده، خطا]) |
TR | فارسی | Checkbox | |
خروجی | خروجی | وضعیت تراکنش | String |
ابزارها
این دسته شامل بلوکهای کاربردی عمومی برای کار با تاریخ، اعداد، رشتهها و JSON است.
تولید کد تصادفی
tools_randomcode
یک کد تصادفی با طول و کاراکترهای مشخص تولید میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | CHARACTERS | با کاراکترهای | String |
MINCOUNT | حداقل تعداد کاراکترها | Number | |
MAXCOUNT | حداکثر تعداد کاراکترها | Number | |
خروجی | خروجی | کد تصادفی | String |
زمان جاری
tools_datecurr
زمان و تاریخ فعلی سرور را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | زمان جاری | DateTime |
دریافت زمان
tools_dateget
یک رشته یا عدد (Unix Timestamp) را به یک شیء زمان تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATESTR | دریافت زمان | String, Number |
فیلدها | TYPE | بر اساس تقویم | Dropdown (گزینهها: [شمسی، میلادی]) |
خروجی | خروجی | زمان | DateTime |
فرمت زمان
tools_dateformat
یک شیء زمان را به رشته متنی با فرمت دلخواه تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATE | فرمت زمان | DateTime |
FORMAT | فرمت | String | |
فیلدها | TYPE | بر اساس تقویم | Dropdown (گزینهها: [شمسی، میلادی]) |
خروجی | خروجی | زمان فرمتبندیشده | String |
زمان به UNIX
tools_datetounix
یک شیء زمان را به معادل Unix Timestamp (تعداد ثانیههای گذشته از مبدأ) تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DATE | UNIX زمان به | DateTime |
خروجی | خروجی | Unix Timestamp | Number |
JSON تعداد فرزندان
tools_jsonchildrencount
تعداد فرزندان (آیتمهای آرایه یا کلیدهای شیء) یک شیء JSON را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | JSON | JSON تعداد فرزندان | Json |
خروجی | خروجی | تعداد | Number |
تبدیل متن به عدد
tools_texttonumber
یک رشته متنی را به نوع عددی تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | تبدیل متن به عدد | String |
خروجی | خروجی | عدد | Number |
تبدیل عدد به متن
tools_numbertotext
یک عدد را به رشته متنی تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | NUMBER | تبدیل عدد به متن | Number, Float |
خروجی | خروجی | متن | String |
به متن JSON تبدیل
tools_jsontotext
یک شیء JSON را به نمایش رشتهای آن تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | JSON | به متن JSON تبدیل | Json |
خروجی | خروجی | متن | String |
JSON به XML تبدیل
tools_xmltojson
یک شیء XML را به یک شیء JSON معادل تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | XML | JSON به XML تبدیل | Xml |
خروجی | خروجی | JSON | Json |
JSON تبدیل متن به
tools_texttojson
یک رشته متنی معتبر را به یک شیء JSON تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | JSON تبدیل متن به | String |
خروجی | خروجی | JSON | Json |
JSON دریافت یک مقدار از
tools_jsonvalue
یک مقدار خاص را از داخل یک شیء JSON با استفاده از یک مسیر (Path) استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | JSON | JSON دریافت یک مقدار از | Json |
VALUE | مقدار | String | |
فیلدها | OUTPUTTYPE | نوع خروجی | Dropdown (گزینهها: [متن، عدد، JSON]) |
خروجی | خروجی | مقدار استخراجشده | String, Number, Json (بسته به فیلد OUTPUTTYPE) |
JSON جستجو در
tools_jsonsearch
یک یا چند مقدار را از داخل یک شیء JSON با استفاده از کوئری JSONPath جستجو میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | JSON | JSON جستجو در | Json |
SEARCHQUERY | کوئری جستجو | String | |
خروجی | خروجی | نتایج جستجو | Json[] |
اسکِیپ متن
tools_escapetext
کاراکترهای خاص در یک رشته را برای استفاده امن در فرمتهای مختلف (مانند JSON, URL) اِسکِیپ میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | اسکِیپ متن | String |
فیلدها | ESCAPETYPE | برای | Dropdown (گزینهها: [JSON, URL, REGEX, HTML]) |
QUOTATIONTYPE | بر اساس | Dropdown (گزینهها: [دابل کوتیشن, تک کوتیشن]) | |
خروجی | خروجی | متن اِسکیپشده | String |
تصاویر
این دسته برای ایجاد، ویرایش و پردازش تصاویر به کار میرود.
وارد کردن تصویر از فایل
image_import
یک فایل (File, SFile, RawFile) را به یک شیء تصویر قابل پردازش تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FILE | وارد کردن تصویر از فایل | SFile, File, RawFile |
خروجی | خروجی | تصویر | Image |
ایجاد تصویر خالی
image_blank
یک تصویر خالی با ابعاد و رنگ پسزمینه مشخص ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | WIDTH | عرض تصویر | Number |
HEIGHT | ارتفاع تصویر | Number | |
COLOR | رنگ تصویر | Colour | |
خروجی | خروجی | تصویر | Image |
ایجاد تصویر از متن
image_fromtext
یک تصویر حاوی متن دلخواه با فونت، رنگ و موقعیت مشخص ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | متن | String |
SIZE | سایز فونت | Number | |
FONT | فونت | SFile, File, RawFile | |
BCOLOR | رنگ پس زمینه | Colour | |
COLOR | رنگ متن | Colour | |
WIDTH | عرض تصویر | Number | |
HEIGHT | ارتفاع تصویر | Number | |
فیلدها | POSITION | موقعیت متن | Dropdown (گزینهها: [وسط وسط، بالا چپ، بالا وسط، بالا راست، وسط چپ، وسط راست، پایین چپ، پایین وسط، پایین راست]) |
WEIGHT | ضخامت متن | Dropdown (گزینهها: [چهار، یک، دو، سه، پنج، شش، هفت، هشت، نُه]) | |
RTL | راست به چپ | Checkbox | |
خروجی | خروجی | تصویر | Image |
ترکیب دو تصویر
image_composite
یک تصویر را روی تصویر دیگر در موقعیت مشخصی قرار میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IMAGEBASE | تصویر زیرین | Image |
IMAGETOP | تصویر رویین | Image | |
X | موقعیت از چپ | Number | |
Y | موقعیت از بالا | Number | |
فیلدها | POSITION | موقعیت تصویر رویین | Dropdown (گزینهها: [وسط وسط، بالا چپ، بالا وسط، بالا راست، وسط چپ، وسط راست، پایین چپ، پایین وسط، پایین راست]) |
خروجی | خروجی | تصویر ترکیبشده | Image |
خروجی گرفتن از تصویر
image_export
یک شیء تصویر را به یک فایل خام (RawFile) قابل ذخیرهسازی یا ارسال تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IMAGE | خروجی گرفتن از تصویر | Image |
NAME | نام فایل | String | |
خروجی | خروجی | فایل خام | RawFile |
تغییر مقیاس تصویر
image_scale
اندازه یک تصویر را به عرض و ارتفاع جدید تغییر میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IMAGE | تغییر مقیاس تصویر | Image |
WIDTH | عرض تصویر | Number, String | |
HEIGHT | ارتفاع تصویر | Number, String | |
فیلدها | RATIO | حفظ نسبت طول به عرض | Checkbox |
خروجی | خروجی | تصویر تغییر مقیاسیافته | Image |
برش تصویر
image_crop
قسمتی از یک تصویر را بر اساس موقعیت و ابعاد مشخص برش میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IMAGE | برش تصویر | Image |
X | نقطه شروع از چپ | Number | |
Y | نقطه شروع از بالا | Number | |
WIDTH | به عرض | Number | |
HEIGHT | به ارتفاع | Number | |
فیلدها | POSITION | موقعیت | Dropdown (گزینهها: [وسط وسط، بالا چپ، بالا وسط، بالا راست، وسط چپ، وسط راست، پایین چپ، پایین وسط، پایین راست]) |
RATIO | حفظ نسبت طول به عرض | Checkbox | |
خروجی | خروجی | تصویر برشخورده | Image |
عملگرها
این دسته شامل بلوکهای منطقی استاندارد برای ایجاد شرطها و مقایسههاست.
اگر ... آنگاه ...
controls_if
یک یا چند شرط را بررسی کرده و در صورت درست بودن، کد مربوطه را اجرا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IF0 | اگر | Boolean |
DO0 | آنگاه | Statement (دستورات) | |
IF... | در غیر این صورت اگر | Boolean (اختیاری) | |
DO... | آنگاه | Statement (اختیاری) | |
ELSE | در غیر این صورت | Statement (اختیاری) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
مقایسه
logic_compare
دو مقدار را با یکدیگر مقایسه میکند و نتیجه را به صورت درست/نادرست برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | A | (مقدار اول) | Any |
B | (مقدار دوم) | Any | |
فیلدها | OP | (عملگر) | Dropdown (گزینهها: [=، ≠، <، ≤، >، ≥]) |
خروجی | خروجی | نتیجه مقایسه | Boolean |
عملیات منطقی
logic_operation
دو شرط بولی را با عملگر 'و' یا 'یا' ترکیب میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | A | (شرط اول) | Boolean |
B | (شرط دوم) | Boolean | |
فیلدها | OP | (عملگر) | Dropdown (گزینهها: [و، یا]) |
خروجی | خروجی | نتیجه ترکیب | Boolean |
نقیض
logic_negate
نتیجه یک شرط بولی را معکوس میکند (درست را به نادرست و بالعکس).
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | BOOL | نقیض | Boolean |
خروجی | خروجی | نتیجه معکوس | Boolean |
بولی
logic_boolean
یک مقدار ثابت درست یا نادرست را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | BOOL | (مقدار) | Dropdown (گزینهها: [درست، نادرست]) |
خروجی | خروجی | مقدار بولی | Boolean |
پوچ
logic_null
مقدار پوچ (null) را برمیگرداند که نشاندهنده نبودِ مقدار است.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | پوچ | null |
عملیات سهتایی
logic_ternary
یک شرط را بررسی میکند؛ اگر درست باشد مقدار اول و در غیر این صورت مقدار دوم را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | IF | اگر | Boolean |
THEN | آنگاه | Any | |
ELSE | در غیر این صورت | Any | |
خروجی | خروجی | مقدار منتخب | Any |
حلقهها
این دسته شامل بلوکهای استاندارد برای ایجاد حلقههای تکرار است.
تکرار کن
controls_repeat_ext
دستورات داخل خود را به تعداد دفعات مشخصی تکرار میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TIMES | تکرار کن | Number |
DO | (دستورات) | Statement | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
تا زمانی که / تا وقتی که
controls_whileUntil
دستورات داخل خود را تا زمانی که یک شرط برقرار باشد (while) یا تا وقتی که یک شرط برقرار شود (until)، تکرار میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | BOOL | (شرط) | Boolean |
DO | (دستورات) | Statement | |
فیلدها | MODE | (حالت) | Dropdown (گزینهها: [تا زمانی که، تا وقتی که]) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
شمارش با
controls_for
با یک متغیر شمارنده از عددی تا عدد دیگر با گام مشخص حرکت کرده و در هر مرحله دستورات را اجرا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FROM | از | Number |
TO | تا | Number | |
BY | با گام | Number | |
DO | (دستورات) | Statement | |
فیلدها | VAR | شمارش با | Variable (متغیر) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
برای هر مورد در لیست
controls_forEach
به ازای هر یک از موارد موجود در یک لیست، دستورات داخل خود را یک بار اجرا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | در لیست | Array |
DO | (دستورات) | Statement | |
فیلدها | VAR | برای هر مورد | Variable (متغیر) |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
خروج از حلقه
controls_flow_statements
جریان اجرای یک حلقه را کنترل میکند. میتواند از حلقه خارج شود (break) یا به تکرار بعدی برود (continue).
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | FLOW | (فرمان) | Dropdown (گزینهها: [خروج از، ادامه با تکرار بعدی]) |
خروجی | خروجی | ندارد (این بلوک پایانی یک شاخه است) |
عملیات ریاضی
این دسته شامل بلوکهای استاندارد برای انجام عملیات ریاضی است.
عدد
math_number
یک مقدار عددی ثابت را نمایش میدهد.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | NUM | (مقدار عددی) | Number |
خروجی | خروجی | مقدار عددی | Number |
عملیات حسابی
math_arithmetic
یکی از عملیات اصلی ریاضی (جمع، تفریق، ضرب، تقسیم، توان) را روی دو عدد انجام میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | A | (عدد اول) | Number |
B | (عدد دوم) | Number | |
فیلدها | OP | (عملگر) | Dropdown (گزینهها: [+, -, ×, ÷, ^]) |
خروجی | خروجی | نتیجه عملیات | Number |
توابع ریاضی (یک ورودی)
math_single
یک تابع ریاضی پیشرفته (مانند جذر، قدر مطلق، لگاریتم) را روی یک عدد اجرا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | NUM | (عدد ورودی) | Number |
فیلدها | OP | (تابع) | Dropdown (گزینهها: [جذر، قدر مطلق، -، ln، log10، e^، 10^]) |
خروجی | خروجی | نتیجه تابع | Number |
توابع مثلثاتی
math_trig
یکی از توابع مثلثاتی (سینوس، کسینوس، تانژانت و معکوس آنها) را روی یک زاویه (بر حسب درجه) محاسبه میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | NUM | (زاویه) | Number |
فیلدها | OP | (تابع) | Dropdown (گزینهها: [sin, cos, tan, asin, acos, atan]) |
خروجی | خروجی | نتیجه تابع | Number |
ثابتهای ریاضی
math_constant
یکی از ثابتهای معروف ریاضی را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | CONSTANT | (ثابت) | Dropdown (گزینهها: [π, e, φ, sqrt(2), sqrt(1/2), ∞]) |
خروجی | خروجی | مقدار ثابت | Number |
ویژگی عدد
math_number_property
یک ویژگی خاص یک عدد را بررسی میکند (مانند زوج، فرد، اول، صحیح، مثبت، منفی، قابل تقسیم بر...).
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | NUMBER_TO_CHECK | (عدد) | Number |
DIVISOR | (مقسوم علیه) | Number (فقط برای "قابل تقسیم بر") | |
فیلدها | PROPERTY | (ویژگی) | Dropdown (گزینهها: [زوج است، فرد است، اول است، صحیح است، مثبت است، منفی است، قابل تقسیم بر]) |
خروجی | خروجی | نتیجه بررسی | Boolean |
گرد کردن
math_round
یک عدد اعشاری را به نزدیکترین عدد صحیح گرد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | NUM | (عدد) | Number |
فیلدها | OP | (عملیات) | Dropdown (گزینهها: [گرد کردن، گرد کردن به بالا، گرد کردن به پایین]) |
خروجی | خروجی | عدد گرد شده | Number |
عملیات روی لیست
math_on_list
یک عملیات آماری (مانند جمع، میانگین، میانه، انحراف معیار) را روی تمام اعداد یک لیست انجام میدهد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | در لیست | Array |
فیلدها | OP | (عملیات) | Dropdown (گزینهها: [جمع، کوچکترین، بزرگترین، میانگین، میانه، مُد، انحراف معیار، تصادفی]) |
خروجی | خروجی | نتیجه عملیات | Number |
باقیمانده
math_modulo
باقیمانده تقسیم عدد اول بر عدد دوم را محاسبه میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | DIVIDEND | باقیمانده | Number |
DIVISOR | تقسیم بر | Number | |
خروجی | خروجی | باقیمانده | Number |
محدود کردن عدد
math_constrain
یک عدد را بررسی میکند و اگر خارج از محدوده مشخصی باشد، آن را به نزدیکترین کران (بالا یا پایین) منتقل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | محدود کردن | Number |
LOW | بین | Number | |
HIGH | و | Number | |
خروجی | خروجی | عدد محدود شده | Number |
عدد صحیح تصادفی
math_random_int
یک عدد صحیح تصادفی در یک محدوده مشخص (شامل ابتدا و انتها) تولید میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FROM | از | Number |
TO | تا | Number | |
خروجی | خروجی | عدد تصادفی | Number |
عدد اعشاری تصادفی
math_random_float
یک عدد اعشاری تصادفی بین ۰.۰ (شامل) و ۱.۰ (شامل نمیشود) تولید میکند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | عدد تصادفی | Number |
Atan2
math_atan2
آرکتانژانت نقطه (X, Y) را بر حسب درجه از ۱۸۰- تا ۱۸۰ محاسبه میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | X | X | Number |
Y | Y | Number | |
خروجی | خروجی | زاویه | Number |
متن (رشته ها)
این دسته شامل بلوکهای استاندارد برای کار با رشتههای متنی است.
متن
text
یک رشته متنی ثابت را ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TEXT | (مقدار متنی) | String |
خروجی | خروجی | متن | String |
متن چندخطی
text_multiline
یک رشته متنی ثابت چندخطی ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | TEXT | (مقدار متنی) | String |
خروجی | خروجی | متن | String |
الحاق متن
text_join
چندین رشته متنی را به یکدیگر متصل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ADD0, ADD1, ... | (متنها) | String |
خروجی | خروجی | متن الحاقشده | String |
افزودن به متن
text_append
یک رشته متنی را به انتهای یک متغیر متنی اضافه میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | متن | String |
فیلدها | VAR | افزودن به متغیر | Variable |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
طول متن
text_length
تعداد کاراکترهای یک رشته متنی را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | طول | String |
خروجی | خروجی | طول | Number |
متن خالی است؟
text_isEmpty
بررسی میکند که آیا یک رشته متنی خالی است یا خیر.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | خالی است | String |
خروجی | خروجی | نتیجه بررسی | Boolean |
یافتن در متن
text_indexOf
موقعیت (اندیس) اولین یا آخرین رخداد یک زیررشته را در یک متن پیدا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | در متن | String |
FIND | یافتن | String | |
فیلدها | END | (موقعیت) | Dropdown (گزینهها: [اولین، آخرین]) |
خروجی | خروجی | اندیس | Number |
گرفتن حرف در متن
text_charAt
کاراکتر موجود در یک موقعیت مشخص از یک رشته متنی را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | در متن | String |
AT | (موقعیت) | Number | |
فیلدها | WHERE | گرفتن حرف | Dropdown (گزینهها: [اول، آخر، از ابتدا، از انتها، تصادفی]) |
خروجی | خروجی | کاراکتر | String |
گرفتن زیررشته
text_getSubstring
بخشی از یک رشته متنی را بین دو موقعیت مشخص استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | STRING | در متن | String |
AT1 | (موقعیت شروع) | Number | |
AT2 | (موقعیت پایان) | Number | |
فیلدها | WHERE1 | گرفتن زیررشته از | Dropdown (گزینهها: [اول، از ابتدا، از انتها]) |
WHERE2 | تا | Dropdown (گزینهها: [آخر، از ابتدا، از انتها]) | |
خروجی | خروجی | زیررشته | String |
تغییر حالت حروف
text_changeCase
تمام حروف یک رشته متنی را به حروف بزرگ، کوچک یا عنوان (ابتدای هر کلمه بزرگ) تبدیل میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | به حالت | String |
فیلدها | CASE | (حالت) | Dropdown (گزینهها: [حروف بزرگ، حروف کوچک، حالت عنوان]) |
خروجی | خروجی | متن تبدیلشده | String |
حذف فاصلهها
text_trim
فاصلههای خالی (space) را از ابتدا، انتها یا هر دو طرف یک رشته متنی حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | حذف فاصلهها از | String |
فیلدها | MODE | (جهت) | Dropdown (گزینهها: [هر دو طرف، سمت چپ، سمت راست]) |
خروجی | خروجی | متن بدون فاصله | String |
شمارش
text_count
تعداد دفعاتی که یک زیررشته در یک متن تکرار شده است را میشمارد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | SUB | شمارش | String |
TEXT | در متن | String | |
خروجی | خروجی | تعداد | Number |
جایگزینی
text_replace
تمام رخدادهای یک زیررشته را با یک رشته دیگر در متن جایگزین میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | FROM | جایگزینی | String |
TO | با | String | |
TEXT | در متن | String | |
خروجی | خروجی | متن جایگزینشده | String |
معکوس کردن
text_reverse
ترتیب کاراکترهای یک رشته متنی را معکوس میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | TEXT | معکوس کردن | String |
خروجی | خروجی | متن معکوسشده | String |
لیست ها
این دسته شامل بلوکهای استاندارد برای ایجاد و کار با لیستها (آرایهها) است.
تبدیل به لیست عادی
lists_convert_from
لیستهای با نوع خاص (مانند Peer[]
, Article[]
) را به لیستهای عمومی Blockly تبدیل میکند تا بتوان در حلقهها و عملیات لیست استاندارد از آنها استفاده کرد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARRAY | تبدیل به لیست عادی | String[], Number[], Json[], Transaction[], Category[], Article[], Peer[], Entry[] |
خروجی | خروجی | لیست عادی | Array |
ایجاد لیست با
lists_create_with
یک لیست جدید با موارد مشخص شده ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ADD0, ADD1, ... | (موارد) | Any |
خروجی | خروجی | لیست | Array |
ایجاد لیست با تکرار
lists_repeat
یک لیست با تکرار یک مورد به تعداد دفعات مشخص ایجاد میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ITEM | ایجاد لیست با مورد | Any |
NUM | تکرار شده | Number | |
خروجی | خروجی | لیست | Array |
طول لیست
lists_length
تعداد موارد موجود در یک لیست را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | طول | Array |
خروجی | خروجی | طول | Number |
لیست خالی است؟
lists_isEmpty
بررسی میکند که آیا یک لیست هیچ موردی ندارد یا خیر.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | خالی است | Array |
خروجی | خروجی | نتیجه بررسی | Boolean |
یافتن در لیست
lists_indexOf
موقعیت (اندیس) اولین یا آخرین رخداد یک مورد را در یک لیست پیدا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | در لیست | Array |
FIND | یافتن | Any | |
فیلدها | END | (موقعیت) | Dropdown (گزینهها: [اولین، آخرین]) |
خروجی | خروجی | اندیس | Number |
گرفتن مورد از لیست
lists_getIndex
موردی را از یک موقعیت مشخص در لیست دریافت، کپی یا حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | در لیست | Array |
AT | (موقعیت) | Number | |
فیلدها | MODE | (عملیات) | Dropdown (گزینهها: [گرفتن، گرفتن و حذف، گرفتن و کپی]) |
WHERE | (از) | Dropdown (گزینهها: [اول، آخر، از ابتدا، از انتها، تصادفی]) | |
خروجی | خروجی | مورد | Any |
تنظیم مورد در لیست
lists_setIndex
مقدار یک مورد را در یک موقعیت مشخص از لیست تنظیم (جایگزین) یا درج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | در لیست | Array |
TO | به | Any | |
AT | (موقعیت) | Number | |
فیلدها | MODE | (عملیات) | Dropdown (گزینهها: [تنظیم، درج]) |
WHERE | (در) | Dropdown (گزینهها: [اول، آخر، از ابتدا، از انتها، تصادفی]) | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
گرفتن زیرلیست
lists_getSublist
بخشی از یک لیست را بین دو موقعیت مشخص به عنوان یک لیست جدید استخراج میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | در لیست | Array |
AT1 | (موقعیت شروع) | Number | |
AT2 | (موقعیت پایان) | Number | |
فیلدها | WHERE1 | گرفتن زیرلیست از | Dropdown (گزینهها: [اول، از ابتدا، از انتها]) |
WHERE2 | تا | Dropdown (گزینهها: [آخر، از ابتدا، از انتها]) | |
خروجی | خروجی | زیرلیست | Array |
تبدیل متن به لیست و بالعکس
lists_split
یک رشته متنی را بر اساس یک جداکننده به لیستی از زیررشتهها تبدیل میکند، یا لیستی از موارد را با یک جداکننده به یکدیگر متصل کرده و یک رشته متنی واحد میسازد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | INPUT | (متن یا لیست) | String یا Array |
DELIM | با جداکننده | String | |
فیلدها | MODE | (عملیات) | Dropdown (گزینهها: [ساختن لیست از متن، ساختن متن از لیست]) |
خروجی | خروجی | لیست یا متن | Array یا String |
مرتبسازی لیست
lists_sort
موارد یک لیست را بر اساس نوع (عددی، متنی) و جهت (صعودی، نزولی) مرتب میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | مرتبسازی لیست | Array |
فیلدها | TYPE | (نوع) | Dropdown (گزینهها: [عددی، متنی، متنی بدون در نظر گرفتن حروف بزرگ/کوچک]) |
DIRECTION | (جهت) | Dropdown (گزینهها: [صعودی، نزولی]) | |
خروجی | خروجی | لیست مرتبشده | Array |
معکوس کردن لیست
lists_reverse
ترتیب موارد یک لیست را معکوس میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | LIST | معکوس کردن لیست | Array |
خروجی | خروجی | لیست معکوسشده | Array |
رنگها
این دسته شامل بلوکهای استاندارد برای انتخاب و ترکیب رنگها است.
انتخابگر رنگ
colour_picker
یک رنگ را از یک پالت رنگی انتخاب میکند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | COLOUR | (رنگ) | Colour |
خروجی | خروجی | رنگ | Colour |
رنگ تصادفی
colour_random
یک رنگ تصادفی تولید میکند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | رنگ | Colour |
بدون رنگ
colour_transparent
یک مقدار شفاف (بدون رنگ) را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
خروجی | خروجی | بدون رنگ | Colour |
رنگ با RGB
colour_rgb
یک رنگ را بر اساس مقادیر قرمز (R)، سبز (G) و آبی (B) میسازد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | RED | قرمز | Number |
GREEN | سبز | Number | |
BLUE | آبی | Number | |
خروجی | خروجی | رنگ | Colour |
رنگ با RGBA
colour_rgba
یک رنگ را بر اساس مقادیر قرمز (R)، سبز (G)، آبی (B) و شفافیت (Alpha) میسازد.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | RED | رنگ با قرمز | Number |
GREEN | سبز | Number | |
BLUE | آبی | Number | |
ALPHA | شفافیت | Number | |
خروجی | خروجی | رنگ | Colour |
ترکیب رنگها
colour_blend
دو رنگ را با یک نسبت مشخص با یکدیگر ترکیب میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | COLOUR1 | رنگ ۱ | Colour |
COLOUR2 | رنگ ۲ | Colour | |
RATIO | با نسبت | Number | |
خروجی | خروجی | رنگ ترکیبشده | Colour |
متغیرها
این دسته به شما اجازه میدهد متغیرهایی برای ذخیره اطلاعات در طول اجرای فرآیند ایجاد کنید. پس از ایجاد متغیر، دو بلوک اصلی در اختیار شما قرار میگیرد.
تنظیم متغیر
variables_set
مقدار یک متغیر را تنظیم یا به روز رسانی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | به | Any |
فیلدها | VAR | تنظیم | Variable |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
خواندن متغیر
variables_get
مقدار فعلی ذخیره شده در یک متغیر را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | VAR | (نام متغیر) | Variable |
خروجی | خروجی | مقدار متغیر | Any |
متغیرها (با تعیین نوع)
این دسته مشابه دسته "متغیرها" است، اما به شما اجازه میدهد متغیرهایی با نوع داده مشخص (مانند Number, String, Peer) ایجاد کنید. این کار به جلوگیری از خطاها کمک کرده و سازگاری دادهها را تضمین میکند.
تنظیم متغیر (با نوع)
variables_set
مقدار یک متغیر با نوع مشخص را تنظیم میکند. Blockly از تخصیص نوع داده ناسازگار جلوگیری میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | به | (نوع مشخص شده متغیر) |
فیلدها | VAR | تنظیم | Typed Variable |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
خواندن متغیر (با نوع)
variables_get
مقدار فعلی یک متغیر با نوع مشخص را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
فیلدها | VAR | (نام متغیر) | Typed Variable |
خروجی | خروجی | مقدار متغیر | (نوع مشخص شده متغیر) |
متغیرهای سراسری
این دسته برای تعریف و استفاده از متغیرهایی است که در تمام فرآیندها و برای تمام کاربران به صورت مشترک قابل دسترسی هستند.
تعیین [متغیر سراسری]
globalvars_setglobalvar
مقدار یک متغیر سراسری را تنظیم میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VALUE | تعیین | String |
VARIABLENAME | برای متغیر سراسری | String | |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
مقدار متغیر سراسری
globalvars_getglobalvar
مقدار یک متغیر سراسری را بر اساس نام آن بازیابی میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VARIABLENAME | مقدار متغیر سراسری | String |
خروجی | خروجی | مقدار | String |
حذف متغیر سراسری
globalvars_deleteglobalvar
یک یا چند متغیر سراسری را بر اساس نام آنها حذف میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | VARIABLENAME | حذف متغیر سراسری | String, String[] |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
توابع
این دسته به شما امکان میدهد قطعه کدهایی را که به طور مکرر استفاده میشوند، در قالب یک تابع تعریف کنید تا بتوانید آنها را در نقاط مختلف برنامه خود فراخوانی کنید.
تعریف تابع (بدون خروجی)
procedures_defnoreturn
یک تابع جدید تعریف میکند که مجموعهای از دستورات را اجرا میکند اما مقداری را برنمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARGS | (پارامترها) | Variable (اختیاری) |
STACK | (دستورات) | Statement | |
فیلدها | NAME | تعریف تابع | String |
خروجی | خروجی | ندارد |
تعریف تابع (با خروجی)
procedures_defreturn
یک تابع جدید تعریف میکند که پس از اجرای دستورات، یک مقدار را به عنوان خروجی برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARGS | (پارامترها) | Variable (اختیاری) |
STACK | (دستورات) | Statement | |
RETURN | بازگرداندن | Any | |
فیلدها | NAME | تعریف تابع | String |
خروجی | خروجی | ندارد |
فراخوانی تابع (بدون خروجی)
procedures_callnoreturn
یک تابع تعریف شده (که خروجی ندارد) را اجرا میکند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARG0, ARG1, ... | (آرگومانها) | Any |
فیلدها | NAME | (نام تابع) | String |
خروجی | خروجی | ندارد (فقط به بلوک بعدی متصل میشود) |
فراخوانی تابع (با خروجی)
procedures_callreturn
یک تابع تعریف شده (که خروجی دارد) را اجرا کرده و مقدار بازگشتی آن را برمیگرداند.
نام | عنوان | نوع | |
---|---|---|---|
ورودیها | ARG0, ARG1, ... | (آرگومانها) | Any |
فیلدها | NAME | (نام تابع) | String |
خروجی | خروجی | مقدار بازگشتی | Any |