کار با ابزارک‌ها

پیش‌نیازها

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

مقدمه

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

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

انواع ابزارک‌ها

پنج نوع ابزارک وجود دارد:

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

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

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

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

افزودن ابزارک به داشبورد

برای افزودن ابزارک جدید به داشبورد، باید مراحل زیر را دنبال کنید:

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

تنظیمات ابزارک

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

نکته مهم

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

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

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

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

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

تنظیمات داده‌ها

بازه زمانی ابزارک

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

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

انواع منابع داده

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

سه نوع اصلی منبع داده وجود دارد: دستگاه، موجودیت، و تابع.

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

در ادامه، هر یک از این انواع را بررسی می‌کنیم.

استفاده از دستگاه به عنوان منبع داده

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

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

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

لطفاً توجه داشته باشید

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

موجودیت به عنوان منبع داده

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

برای آشنایی بیشتر با این ویژگی، یک مثال ساده را بررسی می‌کنیم که در آن تمامی دستگاه‌های موجود را در ویجت نمایش می‌دهیم.

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

تابع به عنوان منبع داده

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

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

شمارش موجودیت‌ها

ویژگی شمارش موجودیت‌ها به شما امکان می‌دهد تعداد موجودیت‌ها را با نمایش آن‌ها در یک ویجت مشاهده کرده و به این ترتیب تعداد دستگاه‌ها، دارایی‌ها و موارد دیگر را تعیین کنید.

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

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

شمارش هشدارها

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

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

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

کلیدهای داده

کلید داده، سری زمانی، ویژگی یا فیلد موجودیتی را که قصد دارید در ویجت استفاده کنید، تعریف می‌کند. تعریف کلید داده شامل نوع (سری زمانی، ویژگی یا فیلد موجودیت) و کلید اصلی است.

فهرست کلیدهای ویژگی موجود شامل تمامی ویژگی‌های کلاینت، سرور و اشتراکی دستگاه یا سایر موجودیت‌ها است.

فهرست کلیدهای سری زمانی موجود بستگی به داده‌های سری زمانی دارد که دستگاه‌های شما به ThingsConnect ارسال کرده‌اند یا داده‌های سری زمانی که از طریق موتور قوانین یا REST API ذخیره کرده‌اید.

فهرست فیلدهای موجودیت به نوع موجودیت بستگی دارد و ممکن است در آینده گسترش یابد:

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

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

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

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

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

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

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

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

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

 

پیکربندی پایه کلید داده
بیایید تنظیمات پایه کلید داده را با یک مثال از ویجت "جدول موجودیت‌ها" از بسته "جداول" بررسی کنیم:

  • کلید: شما می‌توانید نام کلید را تغییر دهید. در این صورت، داده‌های کلیدی که نام آن را در خط "کلید" مشخص کرده‌اید، نمایش داده می‌شود. نام کلید را تغییر داده و روی "ذخیره" کلیک کنید.

توجه داشته باشید:

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

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

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

تجمیع کلید
به‌طور پیش‌فرض، ویجت‌های «آخرین مقادیر» دارای پنجره زمانی نیستند. اگر برای هر کلید داده در ویجت‌های «آخرین مقادیر» تجمیع را فعال کنید، کنترل پنجره زمانی ظاهر خواهد شد. شما می‌توانید تجمیع را به‌طور جداگانه برای هر کلید تلمتری که می‌خواهید نمایش داده شود تنظیم کنید و در عین حال نیازی به ذخیره آن در پایگاه داده ندارید. پیکربندی پنجره زمانی به بازه‌های واقعی زمان (ساعت/روز/ماه جاری) و بازه‌های زمانی «تاریخ» محدود است. بازه‌های زمانی واقعی مانند «۳۰ دقیقه گذشته» یا «۲۴ ساعت گذشته» به دلایل عملکرد پشتیبانی نمی‌شوند. اگر نیاز به ذخیره تجمیع به‌عنوان تلمتری دارید، برای جزئیات بیشتر به لینک مراجعه کنید.

گزینه‌های تجمیع:

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

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

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

  • بازه قبلی (پیش‌فرض) - به عنوان گزینه پیش‌فرض تعیین شده است، در هنگام محاسبه، نه تنها زمان، بلکه نوع بازه (روز جاری یا روز جاری تا به حال و غیره) نیز در نظر گرفته می‌شود.
    مثال: گزینه تاریخ - ماه جاری تا به حال، فرض کنید بازه 1.09.22 تا 25.09.22 باشد، در این صورت بازه قبلی 1.08.22 تا 25.08.22 خواهد بود.

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

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

  • هفته گذشته - بازه‌ای معادل یک هفته (۱۶۸ ساعت) قبل از بازه تاریخی را در نظر می‌گیرد.
    به عنوان مثال، در محاسبه میانگین، اگر بازه تاریخی "روز جاری" باشد و از دلتا "هفته گذشته" استفاده شود، نتایج به ما امکان می‌دهد تا تفاوت‌های میانگین داده‌ها را بین روز جاری و هفته گذشته مقایسه کنیم. این مقایسه می‌تواند به شناسایی الگوها و روندهای تغییرات در داده‌ها کمک کند.
  • ماه گذشته - این گزینه همان بازه زمانی (به روز) را به عنوان بازه تاریخی در نظر می‌گیرد و آن را از بازه تاریخی کنونی کسر می‌کند. به عنوان مثال، اگر ماه جاری فوریه (۲۸ روز) باشد، گزینه "ماه گذشته" به ۲۸ روز گذشته از آن زمان اشاره دارد و نه به کل ماه قبلی.
    برای مثال، در محاسبه مجموع آب مصرفی، اگر بازه تاریخی "روز جاری" باشد و از دلتا "ماه گذشته" استفاده شود، ما مجموع آب مصرفی را در روز جاری با مجموع آب مصرفی در ۲۸ روز گذشته مقایسه خواهیم کرد. این مقایسه می‌تواند به درک تغییرات مصرف آب کمک کند و روندهای طولانی‌مدت‌تری را نشان دهد.
  • سال گذشته - این گزینه بازه‌ای را نشان می‌دهد که ۳۶۵ روز قبل از بازه تاریخی کنونی بوده است.
    به عنوان مثال، اگر بخواهید در مورد مجموع آب مصرفی، میانگین دما یا هر داده دیگری که برای ماه گذشته جمع‌آوری شده است، با میانگین آن در ماه مشابه سال گذشته مقایسه کنید، می‌توانید از این گزینه استفاده کنید. این مقایسه به شناسایی الگوها و روندهای طولانی‌مدت کمک می‌کند و به شما امکان می‌دهد تغییرات مهم را در طول سال‌ها درک کنید.
  • بازه سفارشی - این گزینه به شما امکان می‌دهد بازه‌های دلخواه را تنظیم کنید. حداکثر مقدار مجاز به نوع صحیح (int) محدود می‌شود. به عنوان مثال، ۴۳۲۰۰۰۰۰ برابر با ۱۲ ساعت است. با استفاده از این گزینه می‌توانید تنظیمات دقیقتری را برای تجزیه و تحلیل داده‌ها بر اساس نیازهای خاص خود انجام دهید.

نتیجه محاسبات دلتا:

این گزینه به شما اجازه می‌دهد مشخص کنید که نتیجه چگونه نمایش داده شود:

  • مقدار قبلی - مقدار تجمعی دوره مقایسه (نه دوره تاریخ فعلی) را نمایش می‌دهد.
  • دلتا (مطلق) - تفاوت بین دوره‌های مقایسه شده را نمایش می‌دهد. این گزینه به طور پیش‌فرض تنظیم شده است.
  • دلتا (درصد) - نتیجه را به عنوان درصدی نسبت به دوره قبلی نمایش می‌دهد. فرمول:(مقدار دوره−مقدار دوره قبلی)/مقدار دوره قبلی×100 (مقدار دوره−مقدار دوره قبلی)/مقدار دوره قبلی×100

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

تنظیمات پیشرفته کلید داده

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

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

فیلتر آلارم

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

ظاهر

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

image

بیایید از تنظیمات پایه ویجت برای سفارشی‌سازی ویجت استفاده کنیم. ما نشان خواهیم داد که هر تنظیم چگونه بر روی ویجت تأثیر می‌گذارد.

تنظیمات داده

شما می‌توانید نمادی را که می‌خواهید در کنار مقدار و تعداد ارقام بعد از عدد اعشاری نمایش داده شود، انتخاب کنید. این تنظیمات زمانی مفید هستند که بخواهید همین تنظیمات را برای تمامی محورهای نمودار اعمال کنید. به عنوان مثال، اگر شما خوانش‌های دما را برای چندین دستگاه نشان می‌دهید، می‌توانید نماد «°C» یا «°F» را اضافه کنید. اما اگر هم دما و هم رطوبت را نمایش می‌دهید، باید این کلیدهای داده را به‌طور جداگانه با استفاده از تنظیمات کلید داده پیکربندی کنید.

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

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

تنظیمات عمومی

حالت انباشت

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

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

تنظیمات نشان

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

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

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

شما ممکن است متوجه شوید که نشان نام کلید داده را برای هر کلید داده پیکربندی شده نمایش می‌دهد. زمانی که داده‌ها از چندین دستگاه در یک ویجت وجود دارد، شناسایی این که کدام دستگاه با کدام رکورد در نشان یا در نکات ابزار (Tooltip) مطابقت دارد دشوار است. به منظور واضح‌تر کردن نشان و نکات ابزار، باید از ${entityName} یا ${entityLabel} در پیکربندی کلید داده استفاده کنید.

تنظیمات محور

پارامترهای مورد نظر محور را پیکربندی کنید.

عنوان‌های محور عمودی و افقی را مشخص کرده و مقادیر حداقل و حداکثر مقیاس را تنظیم کنید.

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

تنظیمات محور عمودی:

تنظیمات محور افقی:

تابع فرمت‌کننده علامت‌ها، f(value)

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

				
					return value.toExponential(1) + " C";
				
			

تنظیمات پس‌زمینه نمودار

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

تنظیمات Tooltip

پرش بر روی نقاط منفرد. زمانی که گزینه «پرش بر روی نقاط منفرد» تیک‌خورده باشد، نقاط مقدار بر روی خطوط نمایش داده نخواهند شد.

  • نمایش مقادیر تجمعی در حالت انباشته. در حالت انباشته، با تیک زدن گزینه «مقادیر تجمعی»، نمودار قادر خواهد بود مجموع مقادیر تمامی واحدها را نمایش دهد.

تابع فرمت مقدار Tooltip، f(value, latestData) زمانی استفاده می‌شود که نیاز دارید Tooltip را به‌صورت دستی سفارشی‌سازی کنید.

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

در نمودار حالت (State Chart)، می‌توانید وضعیت واحدها را با توجه به مقادیر آن‌ها در Tooltip نمایش دهید.

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

				
					let celsiusValue = parseFloat(value).toFixed(2);
let farenheitValue = parseFloat(celsiusValue*1.8 + 32).toFixed(2);
return celsiusValue + ' °C (' + farenheitValue + ' °F)';
				
			
  • در قسمت Tooltip value format function، تابع مورد نظر خود را برای فرمت مقدار Tooltip وارد کنید و سپس تغییرات را اعمال کنید؛
  • ماوس خود را بر روی ویجت حرکت دهید تا Tooltip با تابع فرمت مقدار اعمال‌شده نمایش داده شود.

تنظیمات مقایسه

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

  • به تب Appearance بروید، گزینه Enable comparison را فعال کنید و از منوی کشویی، بازه زمانی‌ای که قصد مقایسه با آن را دارید انتخاب کنید.
  • در بخش Comparison X axis settings، موقعیت محور مقایسه را در ویجت تعیین کنید. همچنین می‌توانید عنوان محور را وارد کرده و برچسب‌های تیک محور را نمایش دهید.
  • به تب Data بروید و روی آیکون مداد کنار کلید داده کلیک کنید.
  • در پنجره تنظیمات کلید داده، به تب Advanced بروید و رنگ خط مقایسه را انتخاب کنید. پس از پیکربندی تنظیمات مقایسه، تغییرات را اعمال کنید.
  • از آنجا که تنظیمات مقایسه تنها در حالت History فعال است، در نوار ابزار داشبورد روی آیکون Edit time window کلیک کنید، به تب History بروید و بازه زمانی موردنظر برای مقایسه با داده فعلی را انتخاب کنید. سپس روی Update کلیک کنید تا تغییرات اعمال شود.
  • اکنون می‌توانید مقدار دقیقه جاری را با مقدار پنج دقیقه قبل مقایسه کنید.

تنظیمات سفارشی راهنما

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

  • به تب Appearance بروید و گزینه Enable custom legend را فعال کنید تا از مقادیر ویژگی یا سری زمانی به‌عنوان برچسب کلیدها استفاده کنید.
  • روی گزینه + Add new key کلیک کنید. در منوی کشویی ظاهر شده، نام کلید را وارد کرده و نوع کلید را انتخاب کنید.
  • به تب Data بروید و روی آیکون مداد کنار کلید داده کلیک کنید تا پنجره تنظیمات کلید داده باز شود.
  • در خط label، الگوی ${} را وارد کنید و نام کلید داده را داخل براکت‌ها قرار دهید.
  • روی Save کلیک کنید تا نام برچسب جدید تنظیم و تمام تغییرات اعمال شود.
  • اکنون، زمانی که ویجت را مشاهده می‌کنید، تنظیمات سفارشی راهنما اعمال شده‌اند و می‌توانید داده‌های سفارشی‌ شده را مشاهده کنید.

کارت ویجت

تنظیمات عنوان ویجت

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

سبک عنوان از صفحه‌ی بالا:

				
					{
  "fontSize": "15px",
  "fontWeight": 600
}
				
			

تنظیمات سبک ویجت

شما می‌توانید سبک شخصی خود را برای ویجت با استفاده از ویژگی‌های CSS سفارشی‌سازی کنید. این سبک بر عنصر اصلی (div) ویجت اعمال می‌شود.

همچنین می‌توانید سایه ویجت را با غیرفعال‌کردن گزینه «سایه‌افکنی» و حالت تمام‌صفحه را با غیرفعال‌کردن گزینه «فعال‌سازی تمام‌صفحه» خاموش کنید. این تنظیمات به‌طور پیش‌فرض فعال هستند.

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

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

سبک ویجت از صفحه‌ی بالا:

				
					{
  "border": "3px solid #2E86C1",
  "cursor": "pointer"
}
				
			

تنظیمات دکمه‌های ویجت

فعال‌سازی حالت تمام‌صفحه

شما می‌توانید حالت تمام‌صفحه را با غیرفعال‌کردن گزینه «فعال‌سازی تمام‌صفحه» غیرفعال کنید. این تنظیم به‌طور پیش‌فرض فعال است.

تمامی این تنظیمات به‌طور پیش‌فرض فعال هستند.

عملیات ویجت

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

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

تنظیمات حالت موبایل

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

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

تنظیمات حالت موبایل شامل دو گزینه است:

  • ترتیب - که یک عدد صحیح است و اولویت نمایش ویجت‌ها در حالت موبایل را مشخص می‌کند (توجه داشته باشید که در حالت موبایل، تمام ویجت‌ها در یک ستون عمودی نمایش داده می‌شوند). اگر نیاز دارید ویجت‌ها را در این ستون به‌طور دلخواه مرتب کنید، می‌توانید مقادیر ترتیب متفاوتی برای هر ویجت تنظیم کنید.
  • ارتفاع - که یک مقدار صحیح از ۱ تا ۱۰ می‌گیرد. این مقدار ارتفاع ویجت را در حالت موبایل در بازه‌ای از ۷۰ پیکسل (۱) تا ۷۰۰ پیکسل (۱۰) تنظیم می‌کند و ارتفاع اصلی آن را نادیده می‌گیرد. به عنوان مثال، با مقدار ۵، ارتفاع ویجت ۳۵۰ پیکسل خواهد بود. (۷۰ * ۵) اگر مقداری مشخص نشود، از ارتفاع اصلی آن استفاده خواهد شد.

ورودی و خروجی ویجت

ورودی ویجت

شما می‌توانید یک ویجت را از یک فایل JSON وارد کنید.

برای وارد کردن ویجت، باید:

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

خروجی ویجت

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

گام‌های بعدی

  • اتصال دستگاه خود - بیاموزید چگونه دستگاه‌ها را بر اساس فناوری یا راه‌حل اتصال خود متصل کنید.
  • تصویربرداری داده - این راهنماها شامل دستورالعمل‌هایی برای پیکربندی داشبوردهای پیچیده ThingsConnect هستند.
  • پردازش و عملیات داده - بیاموزید چگونه از موتور قوانین ThingsConnect استفاده کنید.
  • تحلیل داده‌های IoT - بیاموزید چگونه از موتور قوانین برای انجام وظایف تحلیلی پایه استفاده کنید.
  • نمونه‌های سخت‌افزاری - بیاموزید چگونه پلتفرم‌های سخت‌افزاری مختلف را به ThingsConnect متصل کنید.
  • ویژگی‌های پیشرفته - با ویژگی‌های پیشرفته ThingsConnect آشنا شوید.
  • مشارکت و توسعه - بیاموزید چگونه در ThingsConnect مشارکت و توسعه انجام دهید.

عناوین هر بخش