پیکربندی انبوه

مروری بر پیکربندی انبوه

ThingsConnect گزینه تأمین انبوه را با استفاده از فایل CSV برای انواع مختلف موجودیت‌ها فراهم می‌کند:

  • دستگاه‌ها
  • دارایی‌ها

موجودیت‌های مختلف ممکن است دارای پارامترهای زیر باشند:

  • ویژگی‌ها: جفت‌های کلید-مقدار ایستا و نیمه‌ایستا مرتبط با موجودیت‌ها. به عنوان مثال، شماره سریال، مدل، نسخه نرم‌افزار؛
  • داده‌های تلمتری: نقاط داده‌های زمانی که برای ذخیره‌سازی، پرس‌وجو و تجسم در دسترس هستند. به عنوان مثال، دما، رطوبت، سطح باتری؛
  • اعتبارات: برای اتصال دستگاه به سرور ThingsConnect توسط برنامه‌هایی که بر روی دستگاه اجرا می‌شوند، استفاده می‌شود.

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

برای ایجاد چندین موجودیت به صورت هم‌زمان، شما نیاز دارید یک فایل CSV ایجاد کنید که در آن هر خط مسئول ایجاد یک موجودیت با پارامترهای داده شده باشد. اگر نیازی به افزودن برخی تنظیمات برای یک موجودیت خاص ندارید، این سلول را خالی بگذارید.

سه نام پارامتر رزرو شده وجود دارد: Name، Type و Label که دارای نوع ستون از پیش تعیین شده هستند.

گام ۱: انتخاب فایل

فایل CSV را به سیستم بارگذاری کنید.

گام ۲: پیکربندی واردات

برای فایل بارگذاری شده، نیاز به تنظیم پارامترهای زیر دارید:

  • جداکننده CSV: کاراکتر جداسازی بین مقادیر در خط داده؛
  • خط اول شامل نام ستون‌ها است: اگر این گزینه فعال شود، خط اول فایل به عنوان مقادیر پیش‌فرض برای نام پارامترها در مرحله بعد استفاده می‌شود؛
  • به‌روزرسانی ویژگی‌ها/تلمتری: اگر این پارامتر فعال شود، برای تمام موجودیت‌هایی که نام آن‌ها با موجودیت‌های موجود در سیستم ThingsConnect مطابقت دارد، مقادیر پارامترها به‌روزرسانی خواهند شد. در غیر این صورت، برای تمام موجودیت‌هایی که نام آن‌ها در سیستم ThingsConnect از قبل وجود دارد، یک پیام خطا نمایش داده می‌شود.

گام ۳: انتخاب نوع ستون‌ها

در این مرحله، باید یک تطابق بین ستون‌های فایل بارگذاری شده و نوع داده در پلتفرم ThingsConnect تعریف کنید. همچنین می‌توانید نام پیش‌فرض برای کلید ویژگی‌ها/تلمتری را تنظیم یا تغییر دهید.

گام ۴: ایجاد موجودیت‌های جدید

پردازش داده‌های ورودی در حال انجام است.

گام ۵: پایان

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

موارد استفاده

فرض کنیم می‌خواهیم به‌طور همزمان ۱۰ دستگاه ایجاد کنیم و به آن‌ها یک توکن دسترسی اختصاص دهیم.

فایل نمونه:

				
					name,type,Data1,Data2,Data3,Data4,Data5,Data6,Data7,Data8,Data9,Data10
Device 1,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF45
Device 2,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF46
Device 3,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF47
Device 4,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF48
Device 5,testImport,123,,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF49
Device 6,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF50
Device 7,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF51
Device 8,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF52
Device 9,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF53
Device 10,testImport,123,test,TRUE,FALSE,123.55,test,test,test,test,AbfdgrRetGF54
				
			

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

فایل با استفاده از ویرایشگر فایل CSV ایجاد شده و شامل داده‌هایی برای ۱۰ دستگاه است. همچنین، پارامتر Data2 برای دستگاه ۵ حذف شده است و برای این دستگاه ایجاد نخواهد شد.

بارگذاری فایل

به مسیر Devices -> Import device بروید.

فایل نمونه را بارگذاری کنید: test-import-device.csv

image

پیکربندی واردات

  • جداکننده CSV: نماد جداساز فایل خود را انتخاب کنید. در فایل نمونه، جداکننده "," است؛
  • خط اول شامل نام ستون‌ها است: از آنجا که فایل نمونه دارای نام ستون‌هاست، این گزینه فعال باقی می‌ماند؛
  • به‌روزرسانی ویژگی‌ها/تلمتری: این گزینه را غیرفعال کنید، زیرا قصد داریم دستگاه‌های جدید اضافه کنیم و نه پارامترهای دستگاه‌های موجود در پلتفرم ThingsConnect را به‌روزرسانی کنیم.

انتخاب نوع ستون‌ها

ستون اول جدول، اولین خط فایل را که شامل داده‌ها است، نمایش می‌دهد. از آنجایی که در مرحله قبلی گزینه «خط اول شامل نام ستون‌ها» فعال شده است، مقادیر ستون سوم بر اساس خط اول سند قبلاً مقداردهی شده‌اند.
بیایید برخی از ویژگی‌ها را تغییر دهیم. نوع ستون در ردیف سوم را به نوع «زمان‌سری» (Timeseries) تغییر دهید و مقدار کلید ویژگی/تلمتری را تنظیم کنید، به عنوان مثال، «دما» (Temperature).
آخرین ردیف در جدول زیر مسئول توکن است، بنابراین ویژگی «سرور» (Server) را به «توکن دسترسی» (Access Token) تغییر دهید.

image

توجه: نوع‌های ستونی مانند «نام» (Name)، «نوع» (Type) و «توکن دسترسی» (Access Token) تنها می‌توانند برای یک ردیف انتخاب شوند.

واردات به پایان رسید

پس از اتمام فرآیند ایجاد، اطلاعات آماری نمایش داده خواهد شد. در مثال زیر، مشاهده می‌کنید که ۸ دستگاه با موفقیت ایجاد شدند و در هنگام ایجاد ۲ دستگاه خطا رخ داده است. دلیل این خطا این است که دستگاه ۱، دستگاه ۲ و دستگاه ۳ در فایل نمونه داده شده، توکن یکسانی دارند. سیستم ThingsConnect از استفاده توکن‌های تکراری جلوگیری می‌کند.

image

عناوین هر بخش