در این صفحه میتوانید قابلیتهای جدیدی که به ماژول باتی تیمیار اضافه شده است را به تفکیک تاریخ هر بهروزرسانی از ابتدا تا کنون مشاهده کنید. برای دیدن تمام قابلیتها، ویژگیها و مزایای این ماژول نیز میتوانید از دکمه زیر استفاده کرده و وارد کاتالوگ ماژول بات شوید.
تاریخ بروزرسانی: 1402.11.29
نسخه 4.41.5152.768(4.41) تیمیار.
قابلیت جدید
✔️task manager برای بات
تاریخ بروزرسانی: 1402.11.01
نسخه 4.40.5131.728(4.40) تیمیار.
قابلیت جدید
✔️ ثبت خطای اجرای بات در تاریخچه:
تغییر
✔️ تغییر دسترسی ها:
تاریخ بروزرسانی: 1402.10.10
نسخه 4.39.5111.700(4.39) تیمیار.
قابلیت جدید
✔️ ست کردن هدر در بات
رفع باگ
✔️ حذف دستور از تمامی رده ها با حذف یک رده:
هنگام حذف بخش یا رده فقط دستوراتی که پیش فرض آنها رده مربوطه باشد حذف می شوند.
تاریخ بروزرسانی: 1402.09.19
نسخه 4.38.5092.665(4.38) تیمیار.
قابلیت جدید
✔️ امکان تعریف شناسه یکتا برای بخش و رده:
این شناسه تنها می تواند حروف و اعداد انگلیسی باشد. کاراکتر اول می بایست حرف باشد.
شناسه یکتا در حال حاضر تنها برای آپدیت شدن بات های تیم یار در سرور مشتری کاربرد دارد.
✔️ قابلیت max execution time برای دستورات
✔️ دریافت فایل از باتی های وابسته با get_attachment
✔️ ذخیره فایل های باتی در اسناد
تغییر
✔️ ورودی و خروجی table برای توابع بات و حذف پارامتر context از ورودی توابع
✔️ مشکل پاک شدن تگ های html از سند متصل به دستور بات
تابع آپدیت برای حذف شناسه سند برای همه بات ها
updating module bot to version 634 started.
updating module bot to version 634 finished.
با یکبار ویرایش دستورات، برای بات هایی که قبلا در اسناد ذخیره شده اند فایل جدید ایجاد خواهد شد. (فایل های قدیمی که به فرمت tyhtm می باشند باید توسط کاربر حذف شوند)
تاریخ بروزرسانی: 1402.08.28
نسخه 4.37.5075.625(4.37) تیمیار.
قابلیت جدید
✔️ import و export دستورات مرتبط:
جایگزینی مسیر به جای شناسه
اضافه شدن دستورات مرتبط در import و export دستورات : فقط اطلاعات دستورات مرتبط منتقل میشود و خود دستورات باید بصورت جداگانه انتقال داده شوند
تاریخ بروزرسانی: 1402.08.14
نسخه 4.36.5059.602(4.36) تیمیار.
قابلیت جدید
✔️ امکان انتخاب prefix مقصد برای مسیر در import:
بدین منظور در پنجره درون ریزی گزینه "جایگزین کردن پیشوند مسیر اجرای دستور با پیشوند مقصد " اضافه شده است.
تغییر
✔️ تعریف prefix برای دستورات
✔️ حذف ty_run از دستورات
و ست شدن context و form_param بصورت پارامتر global
✔️ ورودی و خروجی table برای توابع db
قابلیت جدید
✔️ تعریف دستورات مرتبط برای هر دستور:
✔️ امکان انتخاب دستورات بات برای نمایش در لیست ویجت:
✔️ api های ماژول بات
1. get_commands گرفتن لیست دستورات
خروجی در کنترل selectDirectory استفاده میشود
teamyar.call_api(context,[[{}]],[[{"module_id":"26","path":"/api/get_commands"}]])
خروجی:
[{"id":,"name":"","disabled":"disable_name","hascheck":false,"items":[{"id":,"name":"","run_path":""},..]},...]
2. get_commands_name گرفتن نام دستور با مسیر
teamyar.call_api(context,[[{"run_path":["path1","path2",...]}]],[[{"module_id":"26","path":"/api/get_commands_name"}]])
خروجی:
[{"id":,"name":"","run_path":""},...]
3. check_crm_perm چک کردن دسترسی روی دستور برای مشتری
teamyar.call_api(context,[[{"crm_id": ,"run_path":"" }]],[[{"module_id":"26","path":"/api/check_crm_perm"}]])
خروجی: {"perm":true}
4. get_commands_crm گرفتن لیست دستوراتی که مشتری دسترسی دارد
teamyar.call_api(context,[[{"crm_id":}]],[[{"module_id":"26","path":"/api/get_commands_crm"}]])
خروجی:
[{"id":,"name":"","run_path":""},..]
5. delete_command حذف دستور
teamyar.call_api(context,[[{"run_path":""}]],[[{"module_id":"26","path":"/api/delete_command"}]])
6. set_perm_crm اضافه کردن دسترسی برای مشتری
دسترسی روی رده با cat_id
teamyar.call_api(context,[[{"cat_id": ,"crm_ids":[]}]],[[{"module_id":"26","path":"/api/set_perm_crm"}]])
دسترسی روی دستور با run_path
teamyar.call_api(context,[[{"run_path":"" ,"crm_ids":[]}]],[[{"module_id":"26","path":"/api/set_perm_crm"}]])
حذف مسیر های get_commands و get_command_name از مسیر های messageProcess و جایگزینی آن با مسیر های api/get_commands و api/get_commands_name
حذف شدن شناسه دستور از همه api ها و جایگزینی آن با run_path
تغییر در پارامتر های ورودی api های delete_command و set_perm_crm
تفییر
✔️ اجرای ویجت بات با مسیر به جای شناسه: (تمام ویجت ها که قبلاً آدرس دهی شده بودند مجدد باید انجام شوند)
bot/run/Path
✔️ اجرای دستور بات در منوی پورتال با مسیر به جای شناسه
تغییر نام و مسیر منوهای بات در پورتال ( شناسه به مسیر تغییر کرده است)
BOT_COMMAND_CommandId -> BOT_COMMAND_RunPath
/bot/portal_command?id=CommandId -> /bot/portal_command?path=RunPath
✔️ اجرای دستور run_command با مسیر به جای شناسه
گرفتن مسیر اجرای دستور به جای شناسه
teamyar.run_command (context,"run_path","{params}");
✔️ ست شدن دیتابیس پیش فرض 0000000 برای دستورات db
✔️ حذف کاربر بات از تنظیمات رده و ارسال در دستور call_api
اضافه شدن پارامتر user_id با پارامتر های ورودی تابع call_api
teamyar.call_api (context,form_param,[[{"module_id":"","path":"","user_id":}]]);
قابلیت جدید
✔️ قراردادن بات در داشبورد ماژول ها:
ویجت بات به داشبورد ماژول های زیر اضافه شد
✔️ نمایش مدت اجرای دستورات در تاریخچه:
در تب تاریخچه ستون مدت زمان اجرای دستور اضافه شده است.
✔️ link to coustomer در ماژول بات
set_perm_crm
ورودی :
id شناسه دستور یا رده
crm_ids آرایه ای از شناسه مشتریان
perm_type مقدار 1 = دسترسی روی رده
مقدار 0 = دسترسی روی دستور
✔️ امکان ویرایش فایل ها در دستورات
✔️ امکان import و export فایل های image
✔️ اضافه شدن گزینه open source برای دستورات:
دستوراتی که در ماژول بات import میشوند آیکن قفل کنارشان نمایش داده میشود که نشان دهنده open یا close source بودن است
برای دستورات import شده امکان تغییر گزینه open source در تنظیمات وجود ندارد
در صورتی که دستور import شده باشد و close source باشد، تب منبع نمایش داده نمیشود و امکان تغییر در محتوای دستور وجود ندارد
در هنگام export
✔️ اضافه شدن دستور use_db (در میان ورژن 1402.07.12 ارائه شد):
db.use_db(context,"0000000")
تغییر
✔️ تغییر نحوه نمایش دستورات به selectDirectory در تنظیمات ویجت
قابلیت جدید
✔️ امکان تعریف کاربر بات در هر رده:
✔️ string to file time برای شمسی و میلادی:
✔️ ثبت زیر سیستم ها برای هر ماژول - برای دستورات بات:
اضافه شدن تنظیمات برای انتخاب زیر سیستم های هر دستور در ماژول بات
✔️ اضافه شدن لایبرری odbc:
برای مشاهده توابع لایبرری nanodbc پیاده سازی شده در lua راهنمای odbc مطالعه شود.
✔️ ایجاد ابزارها در ماژول بات
در این قسمت ماژول های دارای زیر سیستم به همراه زیر سیستم ها و دستوراتی که در آنها تعریف شده اند نمایش داده می شود.
✔️ api برای حذف (delete) دستورات:
اضافه شدن api در مسیر api/delete_command ورودی: command_id
✔️ ارسال پارامتر async هنگام اجرای دستور:
public/bot/run/path?async=1
public/bot/run/path?async=0
run/path?async=1
run/path?async=0
/bot/run/path?async=1
/bot/run/path?async=0
در صورتی که این پارامتر ست نشده باشه این مقدار از تنظیمات دستور خوانده میشود
✔️ ایجاد قابلیت ارسال profile ID , license ID تیمیار به bot تیمیار دیگر:
اضافه شدن پارامتر profile_id و license_id به انتهای مسیر آموزش:
مثال:
https://erp.teamyar.com/public/bot/run_path?profile_id= &license_id=
✔️ امکان disable/enable دستورات:
✔️ فراخوانی بات در ماژول ها
قابلیت جدید
✔️ save data in db table
check_table , query_immediate , start , commit , rollback , query , query_fetch , query_free
این دستورات در دیتابیس بات bot_0000000_ استفاده میشوند.
در صورت تغییر پیشوند و یا حذف دستور، تمامی جداول در دیتابیس bot_0000000 با این پیشوند حذف میشوند.
✔️ ورژنینگ+SAVE IN DOCUMENT
✔️ async run
قابلیت جدید
✔️ اضافه شدن تابع get_attachment:
این تابع برای نمایش محتوای فایل های متصل شده به دستور استفاده می شود.
teamyar.get_attachment(context,filename)
✔️ تعریف مسیر یکتا برای دستورات و اجرای دستورات با مسیر:
مقدار این فیلد اجباری می باشد و امکان استفاده از کاراکترهای فارسی و فاصله وجود ندارد. از این مسیر برای اجرای دستورات به روش های ذیل می توان استفاده نمود:
از طریق message (ارسال پارامتر با فرمت جیسون): (دسترسی در این حالت چک نمیشود)
run/commandPath
✔️ امکان تعریف فایل در هر دستور و گرفتن فایل ها از طریق مسیر:
تبی با نام "فایل ها" در دستور اضافه شده است که امکان افزودن فایل ها را میسر می سازد. فراخوانی این فایل ها به روش های زیر امکانپذیر می باشد:
* fileName : نام فایل می بایست کامل به همراه پسوند نوشته شود.
✔️ امکان import/export فایل ها:
قرار گرفتن اطلاعات فایل های هر دستور در import , export
✔️ نمایش تاریخچه و تعداد دفعات اجرا برای دستورات:
تبی با نام "تاریخچه" در صفحه دستور اضافه شده است که در آن تاریخچه اجرای انواع دستور و اجرا کننده به همراه پیام نمایش داده می شود.
اطلاعات این تب به صورت خودکار پس از سه ماه حذف می شوند.
✔️ امکان تعریف آیکون و رنگ آیکون برای دستورات:
زمان ایجاد و ویرایش دستور امکان انتخاب آیکون و رنگ برای دستورات قرار داده شد.
✔️ تعریف شرکت ایجاد کننده:
✔️ افزودن شناسه مجوز در import/export:
{"command_id": ,"license_id": }
✔️ اضافه شدن تابع call_sp
این تابع برای فراخوانی sp هایی که delete, insert, update انجام میدهند
teamyra.call_sp(context,[[{"query":"call spname(?,?,...)","params":[param1,param2,...]}]])
این تابع خروجی ندارد.
* برای sp هایی که select انجام میدهند میتوان از همان دستور teamyar.query استفاده کرد (خروجی باید بصورت یک string باشد)
teamyar.query (context,[[{"query":"CAL ADMIN_checkLicense(?,?)","params":[17,130680480273650255]}]]);
تغییر
✔️ تغییر در ساختار دستورات و فرم های بات
رفع باگ
✔️ مشکلات بات و ویجت:
قابلیت جدید
✔️ اضافه شدن ویجت بات در پورتال :
امکان تعریف ویجت بات در تنطیمات گروه در پورتال (گروه های عمومی و تعریف شده)
توجه نمائید دستوراتی در ویجت نمایش داده می شوند که گروه پورتال مورد نظر در ماژول بات به رده دستور دسترسی داشته باشد.
✔️ افزودن تابع jwt جهت تولید JSON Web Token :
از این تابع برای تولید توکن برای استفاده از webservice هایی مانند گوگل استفاده می شود.
✔️ امکان ارسال فایل در call_url:
تغییر در پارامترهای ارسالی
teamyar.call_url(context,[[{"domain":"www.teamyar.com","port":443,"url":"/fa/","ssl":true,"secure":false"header":[{"name":"Content-Type","value":"application/json"},{"name":"Authorization","value":"Bearer"}],"data":[{"name":"symbol","value":"EAUUSD"},{"name":"flag","value":1}],"src_file_module_id": ,"files":[{"name":"2.jpg","size":400706,"path":"00000600","mime":"image\/jpeg"},..]}]]);
✔️ اضافه شدن دستور self(ارائه در میان ورژن 02.03.09)
تغییر
✔️ تغییر در تسک های دوره ای بات:
اضافه شدن جزئیاتی مانند ساعت و دقیقه به بازه های زمانی
✔️ تغییر نحوه ست کردن public access در bot (ارائه در میان ورژن 02.03.09):
ورژن 4.27.4885.182(4.27) تیمیار
تغییر
✔️ تغییر در کش بات (ارائه در میان ورژن 02.02.28):
سایز نامحدود برای get , set data
قابلیت جدید
✔️ تنظیمات برای عمومی بودن دستورات bot و اجرای دستورات از طریق مسیر public:
✔️ امکان نمایش و اجرای دستورات بات در پورتال:
✔️ تغییر در دستور ty_call_url:
اضافه شدن data_str در صورتی که دیتای ورودی خارج از فرمت نام و مقدار باشد.
رفع باگ
✔️ رفع مشکلات ماژول بات: (ارائه در میان ورژن 02.02.01)
قابلیت جدید
✔️ دریافت لیست دستورات bot با کنترل acl:
استفاده از api های ماژول بات
get_commands // گرفتن لیست دستورات
ورودی :
{"search":"","from": ,"count": }
خروجی:
[{"id": ,"name":""},{"id": ,"name":""},...]
=======================================================
get_command_name // گرفتن نام دستور با شناسه
ورودی :
{"commands_id":}// در صورتی که بیشتر از 1 دستور باشد با , جدا میشود
خروجی:
[{"id": ,"name":""},{"id": ,"name":""},...]
==============================================
run_? // اجرای دستور. به جای علامت سوال شناسه دستور مورد نظر قرار میگیرد
✔️ ایجاد کاربر مختص bot:
اضافه شدن کاربر بات در تنظیمات بخش (در زمان ویرایش)
قرار گرفتن آن در context در اجرای دستور call_api
✔️ امکان اساین مشتری ها به هر دستور:
اضافه شدن امکان اساین کردن مشتری ها (crm) در بالای صفحه
✔️ تابع برای تبدیل json به csv و برعکس:
local params=[=[[{"module_id":63,"name":"sdkhelp","status":true},{"module_id":1,"name":"home","status":true},{"module_id":5,"name":"profile","status":false}]]=];
local a=teamyar.json_to_csv(context,params)
teamyar.write_result(context,a); => module_id,name,status\r\n63,sdkhelp,true\r\n1,home,true\r\n5,profile,false
========================================================
local params="module_id,name,status\r\n63,sdkhelp,true\r\n1,home,true\r\n5,profile,false";
local a=teamyar.csv_to_json(context,params)
teamyar.write_result(context,a); => [{"module_id":"63","name":"sdkhelp","status":"true"},{"module_id":"1","name":"home","status":"true"},{"module_id":"5","name":"profile","status":"false"}]
✔️ امکان دانلود خروجی
✔️ امکان ارسال فایل در دستورات bot:
حذف پارامتر IFileManager از تابع checkCustomFormValidate
TYRESULT checkCustomFormValidate(Context* context, char* data, int data_size, char* schema, FileInfo* file_info = NULL);
در صورتی که file_info = NULL اطلاعات فایل های ارسالی در فرم فقط در جیسون اضافه میشود و در filemanager آن ماژول ذخیره نمیشود
"attaches":[{"id": ,"size": ,"type": ,"name":"","path":"","mime":""},...],"src_file_module_id": }
path=مسیر فایل در پوشه temp\upload و id=0
در صورتی که file_info != NULL اطلاعات فایل های ارسالی در فرم هم در جیسون اضافه میشود و هم در filemanager آن ماژول ذخیره میشود
"attaches":[{"id": ,"size": ,"type": ,"name":"","root_folder_id": ,"mime":""},...],"src_file_module_id": }
id=شناسه فایل ذخیره شده و root_folder_id=پوشه روت که فایل در آن ذخیره شده
راهنمای استفاده از فرم های bot در ماژول سایت نیز مطالعه شود.
✔️ امکان دانلود دستورات از طریق public بات (توابع برای هش کردن اطلاعات) :(ارائه در میان ورژن 01.12.22 )
teamyar.get_license_info(context) => {"domain":"","id":}
coding.sha1(context,txt)
coding.sha256(context,txt)
coding.md5(context,txt)
coding.sign(context,txt)
تابع sign کلید مجوز را به انتهای رشته دریافتی اضافه میکند و با sha256 هش میکند و برمیگرداند.
تغییر
✔️ تغییر پارامتر های ورودی header , data در دستور call_url :
teamyar.call_url(context,[[{"header":[{"name":"Content-Type","value":"application/json"},{"name":"Authorization","value":"Bearer"}],
"data":[{"name":"symbol","value":"EAUUSD"},{"name":"flag","value":1}]}]]);
رفع باگ
✔️ جابجایی رده هنگام تغییر تنظیمات:
زمانیکه در بخش یا رده ای به جز بخش اول تغییرات (چه در تنظیمات و یا افزودن رده) داشتیم، پس از ذخیره نشانگر به اولین رده در بخش اول منتقل میشد.
قابلیت جدید
✔️ ایجاد ویجت برای بات:
ویجت بات تنها از دستوراتی که نوعشان html باشد میتوان استفاده کرد.
همچنین پس از انتخاب دستور در ویجت فرم تعریف شده برای آن دستور نیز نمایش داده میشود و میتوانیم آنرا مقدار دهی کنیم.
✔️ ایجاد تابع برای دریافت اطلاعات کاربر در bot:
teamyar.get_user_info(context)
✔️ اضافه شدن امکان import , export برای دستورات در bot:
✔️ امکان تعریف دستورات دوره ای در ماژول bot:
پس از ایجاد دستور، در صفحه گزینه تایمر قرار داده شده است که با انتخاب آن امکان تعریف بازه زمانی (ساعتی، روزانه، هفتگی و ماهانه) برای اجرای دستور قرار دارد.
✔️ کش اطلاعات در bot:
در صفحه نمایش اطلاعات دستور در منوی تنظیمات میتوانیم بصورت دستی مقادیر کش شده برای آن دستور را پاک کنیم
✔️ ایجاد lib time در lua:(ارائه در میان ورژن 01.11.24 )
قابلیت جدید
✔️ توسعه و آماده سازی ماژول بات: