ویجت جدول موجودیتها
مرور کلی
ویجت جدول موجودیتها آخرین مقادیر را با فهرست موجودیتهایی که با نام مستعار و فیلتر انتخابی مطابقت دارند، نمایش میدهد و دارای قابلیت جستجوی متنی کامل و گزینههای صفحهبندی است. این ویجت بهطور کامل قابل تنظیم است و میتوان از سبکهای ویجت، کلیدهای منبع داده و اقدامات ویجت استفاده کرد.
راهاندازی ویجت جدول موجودیتها
برای شروع کار با ویجت جدول موجودیتها، ابتدا باید یک داشبورد ایجاد کرده و ویجتی به آن اضافه کنید.
ایجاد داشبورد
بنابراین بیایید یک داشبورد بسازیم که تلمتری را visualiz کند.
شما میتوانید از یک داشبورد موجود استفاده کنید یا یک داشبورد جدید برای یک مورد استفاده جدید ایجاد کنید. در مثال ما، ما یک داشبورد جدید به نام “Entity Table” برای اهداف آموزش خود ایجاد کردهایم.
افزودن ویجت به داشبورد
گام بعدی visualiz کردن تلمتری است. برای افزودن ویجت جدول موجودیتها به داشبورد خود، باید:
- وارد حالت ویرایش داشبورد شوید: با کلیک بر روی آیکون مداد در گوشه پایین سمت راست صفحه.
- بر روی علامت بزرگ در وسط صفحه یا آیکون "+" (افزودن ویجت جدید) در گوشه پایین سمت راست صفحه کلیک کنید. از منوی کشویی، Create new widget را انتخاب کنید.
- در پنجره انتخاب بسته ویجتها، Cards را انتخاب کنید.
- از بسته Cards، ویجت جدول موجودیتها را انتخاب کنید.
- برای پیوست کردن منبع داده به ویجت خود، روی Add کلیک کنید تا موجودیت را مشخص کنید که از آن دادههای تلمتری را دریافت خواهیم کرد.
- اگر قبلاً یک نام مستعار اضافه کردهاید، آن را از منوی کشویی انتخاب کنید. اگر نه، روی "Create a new one!" کلیک کنید.
- میتوانید نحوه افزودن یک نام مستعار و انواع نام مستعارها را با دنبال کردن لینک زیر بخش اسکرین شاتها بیاموزید. پس از پیکربندی تنظیمات نام مستعار، روی Add کلیک کنید.
- تلمتری را از منوی کشویی برای نمایش در ویجت انتخاب کنید.
هنگامی که پیکربندی منبع داده را به پایان رساندید، روی Add کلیک کنید. - لبههای ویجت را بکشید تا اندازه آن را تنظیم کنید و با کلیک بر روی علامت تیک در گوشه پایین سمت راست صفحه، تمام تغییرات اعمال شده را ذخیره کنید.
یاد بگیرید که چگونه یک نام مستعار به ویجت خود اضافه کنید.
تنظیمات
برای شروع سفارشیسازی ویجت خود، باید وارد حالت ویرایش ویجت شوید. برای این کار، در حالت ویرایش داشبورد، بر روی آیکون مداد در گوشه بالا سمت راست ویجت کلیک کنید.
1. سبک عنوان
شما میتوانید توضیحات و سبک عنوان ویجت را تغییر دهید. عنوان خود را باید از طریق تنظیمات پیشرفته عنوان تغییر دهید. همچنین میتوانید یک آیکون به عنوان اضافه کرده و رنگ، شفافیت و اندازه آن را تنظیم کنید. تنظیمات و نتایج مربوطه را در زیر مشاهده کنید.
- شما میتوانید تنظیمات عنوان، توضیحات آن را تغییر دهید و سبک عنوان را سفارشی کنید. علاوه بر این، میتوانید یک آیکون اضافه کرده و تنظیمات آن را تنظیم کنید.
- پس از تنظیم تمام پیکربندیهای دلخواه، تغییرات را با کلیک بر روی علامت تیک در گوشه بالا سمت راست صفحه اعمال کنید.
- همانطور که میبینید، سبک عنوان تغییر کرده و آیکون سفارشی در کنار آن اضافه شده است. برای ذخیره تمام تغییرات اعمال شده، بر روی علامت تیک در گوشه پایین سمت راست صفحه کلیک کنید.
جعبههای تیک مسئول نمایش/عدم نمایش عنوان ویجت، سایه ویجت و فعال/غیرفعال کردن حالت تمامصفحه هستند.
2. سبک ویجت
شما میتوانید سبک شخصی برای ویجت را با استفاده از خصوصیات CSS سفارشی کنید. این سبک به عنصر div اصلی ویجت اعمال خواهد شد. همچنین میتوانید رنگ پسزمینه، رنگ متن، پدینگ و حاشیه را تغییر دهید. تنظیمات و نتایج مربوطه را در زیر مشاهده کنید.
لطفاً توجه داشته باشید که سبک و رنگ پسزمینه تنها یک مثال است و بهطور قطع بخشی از دستورالعملهای ما نیست.
{
"border": "3px solid #2E86C1",
"cursor": "pointer"
}
- در فیلد سبک ویجت، تابعی را وارد کنید تا ظاهر ویجت را سفارشی کنید.
- شما میتوانید رنگهای پسزمینه و متن را بهصورت دستی با کلیک بر روی دایرههای مربوطه و حرکت اسلایدرها برای انتخاب رنگ مورد نظر خود تنظیم کنید. مقدار دلخواه را در خطوط پدینگ و حاشیه وارد کنید. پس از پیکربندی گزینههای مورد نظر، روی علامت تیک در گوشه بالا سمت راست صفحه کلیک کنید.
- همانطور که میبینید، ظاهر ویجت تغییر کرده است. برای ذخیره تمام تغییرات اعمال شده، بر روی علامت تیک در گوشه پایین سمت راست صفحه کلیک کنید.
3. نماد ویژه و تعداد ارقام پس از نقطه اعشاری
شما میتوانید یک نماد ویژه اضافه کنید که در کنار مقادیر موجودیتهای ویجت شما نمایش داده میشود. همچنین میتوانید تعداد ارقام نمایش داده شده پس از عدد اعشاری را سفارشی کنید. تنظیمات و نتایج مربوطه را در زیر مشاهده کنید.
- نماد مورد نظر را برای نمایش در کنار مقدار وارد کنید. تعداد ارقام نمایش داده شده پس از عدد اعشاری را وارد کنید. تغییرات را با کلیک بر روی علامت تیک در گوشه بالا سمت راست صفحه اعمال کنید.
- همانطور که میبینید، نماد ویژه اضافه شده و تعداد ارقام تغییر کرده است.
4. تنظیمات افسانه
تنظیمات افسانه تنها در ویجتهای سری زمانی منطقی است که این گزینه بهطور پیشفرض فعال است. شما میتوانید اطلاعات بیشتری در مورد تنظیمات افسانه در اینجا بخوانید.
تنظیمات پیشرفته
تنظیمات پیشرفته ویجت جدول موجودیتها اجازه میدهد تا عنوان ویجت را تنظیم کنید، دید اجزا در ویجت را تغییر دهید، ستونها را سفارشی کنید، صفحهبندی را تنظیم کنید، دادهها را مرتب کنید و سبک ردیفهای ویجت را تغییر دهید.
برای ورود به حالت پیشرفته و شروع به تنظیم تنظیمات فوق، باید:
بر روی آیکون مداد ("وارد حالت ویرایش شوید") در گوشه پایین سمت راست صفحه کلیک کنید.
بر روی آیکون مداد ("ویرایش ویجت") در گوشه بالا سمت راست خود ویجت جدول موجودیتها کلیک کنید.
به سلول پیشرفته بروید.
1. عنوان جدول موجودیتها
ThingsConnect هیچ محدودیتی برای نامگذاری، چه از نظر نمادها و چه از نظر تعداد کاراکترها، ندارد. با این حال، اگر عنوان بسیار طولانی باشد، بهطور کامل در ویجت جدول موجودیتها نمایش داده نخواهد شد و با سه نقطه قطع خواهد شد. با این وجود، پس از اعمال تغییرات و باز کردن ویجت در حالت تمامصفحه، میتوانید نام کامل ویجت را مشاهده کنید. بهعنوان مثال، بیایید از عنوان سادهای مانند “عنوان ویجت جدید” استفاده کنیم:
- عنوان مورد نظر را در نوار عنوان وارد کنید. بر روی علامت تیک نارنجی در گوشه بالا سمت راست کلیک کنید.
- عنوان ویجت تغییر کرده است.
2. تنظیمات جعبههای تیک
- فعال کردن جستجوی موجودیتها
اگر جعبه تیک فعال باشد، ذرهبین در گوشه بالا سمت راست ویجت به شما این امکان را میدهد که موجودیتهای ویجت را جستجو کنید.
- فعالسازی انتخاب ستونها برای نمایش
اگر جعبه تیک فعال باشد، نوارهای مشکی در گوشه بالا سمت راست ویجت به شما این امکان را میدهد که انتخاب کنید کدام ستونها را پنهان کنید و کدام ستونها را نمایش دهید.
- همیشه نمایش عنوان
اگر جعبه تیک فعال باشد، عنوان ویجت همیشه در هنگام پیمایش در لیست موجودیتها قابل مشاهده خواهد بود. اگر این جعبه تیک فعال نباشد، عنوان ویجت در بالای صفحه باقی میماند.
همیشه نمایش ستون اقدامات
اگر جعبه تیک فعال باشد، سلول اقدامات ردیف همیشه در هنگام پیمایش در تلمتری ویجت قابل مشاهده خواهد بود. وقتی جعبه تیک غیر فعال باشد، سلول اقدامات ردیف در انتهای ردیف باقی میماند.
نمایش ستون نام موجودیت
اگر جعبه تیک فعال باشد، ستون نام موجودیت قابل مشاهده است. اگر جعبه تیک غیر فعال باشد، این ستون پنهان خواهد شد.
3. تنظیمات ستونها
3.1. عنوان ستون موجودیت
برای تغییر عنوان ستون، باید:
- عنوان جدید را در خط مربوطه وارد کنید.
- بر روی علامت تیک نارنجی در گوشه بالا سمت راست کلیک کنید تا تغییرات اعمال شوند. عنوان ستون موجودیت تغییر کرده است.
3.2. نمایش ستون برچسب موجودیت
اگر جعبه تیک "نمایش ستون برچسب موجودیت" فعال باشد، میتوانید ستون برچسب را اضافه کرده و نام آن را تعیین کنید. پس از کلیک بر روی علامت تیک نارنجی در گوشه بالا سمت راست، ستون برچسب با نام سفارشی در ویجت نمایش داده خواهد شد.
3.3. نمایش ستون نوع موجودیت
جعبه تیک "نمایش ستون نوع موجودیت" مسئول نمایش نوع موجودیت در ویجت است (بهعنوان مثال، "دستگاه"). بهطور پیشفرض، ستون نوع موجودیت نمایش داده میشود، اما میتوانید آن را با غیر فعال کردن جعبه تیک پنهان کنید.
4. صفحهبندی
بهطور پیشفرض، ویجت نشان میدهد که چند آیتم در هر صفحه قابل مشاهده است و بهطور کلی چند صفحه وجود دارد. نمایش این اطلاعات اختیاری است و با فعال/غیر فعال کردن جعبه تیک "نمایش صفحهبندی" تغییر میکند. اگر این جعبه تیک غیرفعال باشد، اطلاعات مربوط به آیتمها در هر صفحه و تعداد صفحات نمایش داده نخواهد شد. برای اعمال تغییرات، بر روی علامت تیک نارنجی در گوشه بالا سمت راست کلیک کنید.
توجه:برای درک تنظیمات بعدی، باید جعبه تیک "نمایش صفحهبندی" را فعال کنید تا تعداد آیتمها در هر صفحه را مشاهده کنید.
بهطور پیشفرض، اندازه صفحه به ۱۰ آیتم در هر صفحه تنظیم شده است. اگر نیاز به تغییر این عدد دارید، باید:
5. مرتبسازی دادهها در ویجت جدول
بهطور پیشفرض، دادهها در ویجت جدول به صورت صعودی مرتبسازی میشوند. اگر مقادیر موجود در ستون عددی نباشند (بهعنوان مثال، نام و نوع)، مرتبسازی بر اساس قوانین ترتیب الفبایی انجام خواهد شد.
اگر بخواهید دادهها را، بهعنوان مثال، بر اساس نوع کلید داده تلمتری (دمای هوا، رطوبت و غیره) مرتبسازی کنید، میتوانید با وارد کردن نام مقدار خود در ردیف مرتبسازی پیشفرض این کار را انجام دهید. در این مثال، از دما استفاده میشود. اگر نیاز به ترتیب مرتبسازی نزولی دارید، باید:
- همانطور که گفته شد، ترتیب مرتبسازی پیشفرض صعودی است. نماد “-” (منفی) را در جلوی نام کلید داده در خط مرتبسازی پیشفرض وارد کنید.
- بر روی علامت تیک نارنجی در گوشه بالا سمت راست کلیک کنید تا تغییرات اعمال شوند.
- اکنون، دادههای تلمتری به ترتیب نزولی که نیاز داشتیم، مرتبسازی شدهاند.
6. تابع سبک ردیف
از نسخه 3.2.2 به بعد، امکان تغییر سبک ردیفهای ویجت بر اساس شرایط آنها فراهم شده است. بیایید ببینیم این قابلیت چگونه کار میکند با یک مثال ساده:
فرض کنیم میخواهیم مشاهده کنیم کدام دستگاه فعال است و کدام غیرفعال. برای آسانتر کردن کار، باید از تابع Row style استفاده کنیم.
مثالی از آن و نتایج مرتبط:
result = {background:"white"};
if (entity.active == "false") {
result.background = '#FF0000';
} else {
result.background = '#00FF00';
}
return result;
ذخیره تغییرات
برای اعمال و ذخیره تغییرات، باید روی علامت تیک نارنجی در گوشه پایین سمت راست داشبورد کلیک کنید.
سپس مطمئن خواهید بود که تغییرات در ویجت جدول به درستی اعمال و ذخیره شدهاند.