ارسال ایمیل به مشتری
این آموزش به شما نشان میدهد که چگونه از طریق موتور قوانین (Rule Engine) به مشتری ایمیل ارسال کنید.
کاربرد
فرض کنید دستگاه شما از حسگر DHT22 برای جمعآوری و ارسال دادههای دما به ThingsConnect استفاده میکند. حسگر DHT22 مناسب اندازهگیری دما بین -40 تا 80 درجه سانتیگراد است. هدف ما ایجاد هشدار زمانی است که دما خارج از محدوده مجاز باشد و ارسال ایمیل در زمان ایجاد هشدار.
در این آموزش، موتور قوانین Thingsconnect را برای موارد زیر پیکربندی خواهیم کرد:
- ارسال ایمیل به مشتری دستگاه اختصاص دادهشده اگر دما خارج از محدوده باشد؛ یعنی کمتر از -40 یا بیشتر از 80 درجه.
- اضافه کردن ویژگیهای منبع پیام به پیام.
- اضافه کردن دادههای اضافی به بدنه ایمیل با استفاده از گره "تبدیل اسکریپت" (Script Transform) از پیام ورودی.
پیشنیازها
فرض بر این است که شما راهنماها و مقالات زیر را بهطور کامل مطالعه کردهاید:
- راهنمای شروع به کار.
- مرور کلی موتور قوانین.
- راهنمای ایجاد و پاکسازی هشدارها.
- راهنمای ارسال ایمیل در زمان هشدار.
ایجاد مشتری و اختصاص دستگاه
در ابتدا باید یک مشتری ایجاد کرده و دستگاهی را به او اختصاص دهیم. تصاویر زیر نشان میدهد چگونه این کار انجام میشود:
مشتری ایجاد شد. حالا باید دستگاه "Thermostat Home" (که ایجاد آن در آموزش "ایجاد و پاکسازی هشدارها" توضیح داده شده است) را به مشتری اختصاص دهیم.
به صفحه مدیریت دستگاهها در صفحه مشتری بروید و دستگاه موردنظر را انتخاب کنید.
اکنون باید ویژگی ایمیل با محدوده سرور (server scope) را برای مشتری تعریف کنیم. توجه داشته باشید که ایمیل به این آدرس ارسال خواهد شد، بنابراین برای آزمایش، ایمیل خودتان را وارد کنید.
همچنین باید ویژگی آدرس را به دستگاه "Thermostat Home" اضافه کنیم. برای انجام این کار:
- به بخش Devices بروید.
- دستگاه Thermostat Home را انتخاب کنید.
- وارد بخش Attributes شوید.
- در بخش Server attributes، دکمه "+" را فشار دهید تا ویژگی آدرس اضافه شود.
جریان پیام
در این بخش، هدف هر گره (Node) که در زنجیره قوانین اولیه در این آموزش اضافه یا اصلاح شده است را توضیح میدهیم:
- Node A: گره ویژگیهای مشتری
- این گره برای دریافت ویژگی ایمیل مشتری و ذخیره آن در خاصیت متادیتای پیام با نام customerEmail استفاده میشود.
- Node B: گره ویژگیهای مبدأ
- این گره برای دریافت ویژگی آدرس با محدوده سرور از مبدأ (که دستگاه، مبدأ پیام ورودی است) استفاده میشود و آن را در متادیتای پیام ذخیره میکند.
- Node C: گره ارسال به ایمیل
- این گره ایمیل نهایی را بر اساس الگوی پیکربندی شده میسازد.
- Node D: گره زنجیره قوانین
- این گره پیام ورودی را به زنجیره قوانین تعیین شده، یعنی زنجیرهای برای "ایجاد/پاکسازی هشدار و ارسال ایمیل به مشتری" ارسال میکند.
پیکربندی زنجیره قوانین
در این آموزش از زنجیره قوانین موجود در آموزش "ارسال ایمیل در زمان هشدار" استفاده شده است. ما زنجیره قانون "ایجاد/پاکسازی هشدار و ارسال ایمیل" را با افزودن گرههایی که در بخش "جریان پیام" توضیح داده شد، تغییر داده و نام آن را به "ایجاد/پاکسازی هشدار و ارسال ایمیل به مشتری" تغییر دادهایم.
تصاویر زیر نشان میدهند که زنجیره قوانین باید به چه شکلی تنظیم شوند:
- ایجاد/پاکسازی هشدار و ارسال ایمیل به مشتری:
- زنجیره قانون اصلی
فایل json پیوستشده برای زنجیره قوانین "ایجاد/حذف هشدار و ارسال ایمیل به مشتری" را دانلود کنید. در زنجیره قوانین ریشهای، گره D را همانطور که در تصویر بالا نشان داده شده است، ایجاد کنید تا دادههای تلمنری به زنجیره قوانین واردشده منتقل شود.
بخش زیر نحوه اصلاح این زنجیره قوانین را به شما نشان میدهد. به طور خاص: گرههای A و B را اضافه کنید و گره C را اصلاح کنید.
اصلاح ایجاد و حذف هشدارها با جزئیات
گرههای مورد نیاز را اصلاح کنید.
در این زنجیره قوانین، دو گره اضافه خواهید کرد و یک گره را مطابق توضیحات زیر اصلاح خواهید نمود.
گره A: ویژگیهای مشتری
- گره "ویژگیهای مشتری" را اضافه کنید و آن را با نوع رابطه "True" به گره "فیلتر اسکریپت" متصل کنید. این گره برای دریافت ویژگی ایمیل مشتری و ذخیره آن در ویژگی متادیتای پیام با نام customerEmail استفاده خواهد شد.
- فیلدها را با دادههای ورودی که در جدول زیر نشان داده شده است، پر کنید:
برای تغییر این متن بر روی دکمه ویرایش کلیک کنید. لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ و با استفاده از طراحان گرافیک است.
گره B: ویژگیهای منبع
- گره "ویژگیهای منبع" را اضافه کنید و آن را بین گرههای "ویژگیهای مشتری" و "ایجاد هشدار" با نوع رابطه "Success" قرار دهید. این گره برای دریافت ویژگی دامنه سرور منبع (Thermostat Home) استفاده خواهد شد و این ویژگی در ویژگی متادیتای پیام با نام ss_address ذخیره خواهد شد.
- فیلدها را با دادههای ورودی که در جدول زیر نشان داده شده است، پر کنید:
برای تغییر این متن بر روی دکمه ویرایش کلیک کنید. لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ و با استفاده از طراحان گرافیک است.
گره C: به ایمیل
- گره "به ایمیل" را اصلاح کنید. برای این کار، لازم است برخی فیلدها را در جزئیات این گره تغییر دهید، به ویژه:
- قالب "To"
- قالب "Body"
- فیلدها را با دادههای ورودی که در جدول زیر نشان داده شده است، پر کنید:
برای تغییر این متن بر روی دکمه ویرایش کلیک کنید. لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ و با استفاده از طراحان گرافیک است.
ارسال تلمتری و تأیید
برای ارسال تلمنری دستگاه، از APIهای Rest و APIهای بارگذاری تلمنری استفاده خواهیم کرد. برای این منظور، باید توکن دسترسی دستگاه را از دستگاه Thermostat Home کپی کنیم.
بیایید دما را ۹۹ تنظیم کنیم. ایمیل باید ارسال شود:
curl -v -X POST -d '{"temperature":99}' http://localhost:8080/api/v1/$ACCESS_TOKEN/telemetry --header "Content-Type:application/json"
**you need to replace $ACCESS_TOKEN with actual device token**
توجه داشته باشید که پیام تنها در صورتی ارسال خواهد شد که آلارم ایجاد شود و نه صرفاً در صورت بهروزرسانی آلارم.
در نهایت میبینیم که ایمیل با مقادیر صحیح دریافت شده است. (در صورتی که ایمیلی دریافت نکردهاید، لطفاً پوشه هرزنامه خود را بررسی کنید.)
همچنین، میتوانید اطلاعات بیشتری درباره موارد زیر مشاهده کنید:
- تعریف منطقهای اضافی برای پردازش آلارم، مانند ارسال اعلان به اپلیکیشن تلگرام از طریق ربات تلگرام.
- پیکربندی تابع جزئیات آلارم در گرههای ایجاد و پاک کردن آلارم و پیکربندی داشبورد با افزودن ویجت آلارم برای نمایش آلارمها.
- ایجاد آلارم در صورتی که دستگاه آفلاین باشد.
لطفاً به لینکهای موجود در بخش "همچنین ببینید" مراجعه کنید تا نحوه انجام این موارد را بیاموزید.
همچنین ببینید
- راهنمای اعلانها و آلارمها روی تلفن همراه با استفاده از ربات تلگرام
- راهنمای ایجاد آلارم با جزئیات
- راهنمای ایجاد آلارم هنگامی که دستگاه آفلاین است
مراحل بعدی
- راهنماهای شروع به کار - این راهنماها مروری سریع بر ویژگیهای اصلی Thingsconnect ارائه میدهند. طراحی شدهاند تا در 15 تا 30 دقیقه کامل شوند.
- اتصال دستگاه شما - یاد بگیرید چگونه دستگاههای خود را براساس فناوری یا راهحل اتصال خود متصل کنید.
- بصریسازی دادهها - این راهنماها شامل دستورالعملهایی برای پیکربندی داشبوردهای پیچیده Thingsconnect است.
- تحلیل دادههای IoT - یاد بگیرید چگونه از موتور قوانین برای انجام وظایف اولیه تحلیل دادهها استفاده کنید.
- نمونههای سختافزاری - یاد بگیرید چگونه پلتفرمهای مختلف سختافزاری را به Thingsconnect متصل کنید.
- ویژگیهای پیشرفته - درباره ویژگیهای پیشرفته Thingsconnect بیاموزید.
- مشارکت و توسعه - درباره مشارکت و توسعه در Thingsconnect آگاهی کسب کنید.