اتوماسیون هشدار سلامت تجهیزات با n8n و Google Sheets

هشدار در مورد مشکلات سلامت تجهیزات با ادغام Google Sheets و MS Teams

این Workflow داده‌های سلامت تجهیزات را با دریافت داده‌ها، ارزیابی پارامترهای حیاتی (دما و ولتاژ) و ارسال هشدار از طریق Microsoft Teams در صورت تجاوز از آستانه‌ها، نظارت می‌کند. همچنین با تبدیل داده‌ها به فایل اکسل و آپلود آن در Google Drive، داده‌ها را بایگانی می‌کند.

دسته‌بندی‌ها: DevOps

Nodes استفاده شده: Schedule Trigger, HTTP Request, If, Convert to File, Google Drive, Microsoft Teams

نمای کلی Workflow

این Workflow به سه بلوک منطقی اصلی تقسیم شده است:

1. بازیابی داده‌ها: یک تریگر زمان‌بندی شده فرآیند را آغاز می‌کند و داده‌های وضعیت تجهیزات را از یک API خارجی دریافت می‌کند.

2. ارزیابی شرط: داده‌های بازیابی شده در برابر آستانه‌های از پیش تعریف شده برای دما و ولتاژ بررسی می‌شوند.

3. بایگانی داده‌ها و هشدار: در صورت برآورده شدن شرایط هشدار، داده‌ها به یک فایل اکسل تبدیل شده، در Google Drive آپلود می‌شوند و یک اعلان از طریق Microsoft Teams ارسال می‌شود.

تجزیه و تحلیل دقیق Node ها

۱. بازیابی داده‌ها

این بلوک مسئول دریافت آخرین داده‌های تجهیزات در فواصل زمانی منظم است.

• Schedule Trigger for Every 15 Min

* نوع: Schedule Trigger

* نقش: هر ۱۵ دقیقه Workflow را آغاز می‌کند.

* پیکربندی: برای فعال شدن در بازه زمانی ۱۵ دقیقه تنظیم شده است.

* ورودی‌ها: ندارد.

* خروجی‌ها: به Node HTTP Request متصل می‌شود.

* موارد لبه‌ای: ممکن است Workflow در صورت خرابی سرویس n8n یا عدم همگام‌سازی زمان سرور فعال نشود.

• HTTP Request

* نوع: HTTP Request

* نقش: داده‌های تجهیزات را از یک API REST مشخص دریافت می‌کند.

* پیکربندی:

* URL: https://688c83a8cd9d22dda5cd6aec.mockapi.io/temperature_n8n/equipments

* متد: GET (پیش‌فرض)

* ورودی‌ها: توسط Node Schedule Trigger فعال می‌شود.

* خروجی‌ها: داده‌های JSON بازیابی شده را به Node If منتقل می‌کند.

* موارد لبه‌ای: خرابی API، عدم دسترسی به هاست، فرمت پاسخ غیرمنتظره، تغییرات در طرح داده‌ها، timeout های API یا محدودیت نرخ.

۲. ارزیابی شرط

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

• Condition check for Temp and voltage

* نوع: If

* نقش: رکوردهایی را که دما بالاتر از ۶۰ و ولتاژ بالاتر از ۲۰ است، فیلتر می‌کند.

* پیکربندی:

* ترکیب‌کننده شرط (Condition Combinator): AND

* شرایط:

* {{$json.temp}} > 60

* {{$json.voltage}} > 20

* ورودی‌ها: داده‌ها را از Node HTTP Request دریافت می‌کند.

* خروجی‌ها: داده‌های فیلتر شده (که در آن شرایط درست است) را به Node Convert to File منتقل می‌کند.

* موارد لبه‌ای: فیلدهای temp یا voltage گمشده یا بدشکل، یا عدم تطابق نوع داده (مثلاً رشته به جای عدد) می‌تواند باعث شکست ارزیابی شود.

۳. بایگانی داده‌ها و هشدار

این بلوک مسئول بایگانی داده‌ها و فرآیند اعلان است.

• Convert to File

* نوع: Convert to File

* نقش: داده‌های JSON فیلتر شده را به یک صفحه گسترده اکسل (فرمت .xls) تبدیل می‌کند.

* پیکربندی:

* عملیات (Operation): فرمت XLS

* نام فایل (File Name): equipment_list.xls

* ورودی‌ها: داده‌های فیلتر شده را از Node If دریافت می‌کند.

* خروجی‌ها: فایل اکسل تولید شده را به Node های Google Drive و Microsoft Teams ارسال می‌کند.

* موارد لبه‌ای: مجموعه داده‌های بزرگ ممکن است منجر به مشکلات حافظه یا timeout شود. داده‌های دارای کاراکترهای پشتیبانی نشده یا ساختارهای پیچیده ممکن است در تبدیل شکست بخورند.

• Upload file

* نوع: Google Drive

* نقش: فایل اکسل تولید شده را در پوشه ریشه Google Drive شما آپلود می‌کند.

* پیکربندی:

* درایو (Drive): My Drive

* پوشه (Folder): Root (/)

* نیاز به اعتبارنامه‌های احراز هویت شده Google Drive OAuth2 دارد.

* ورودی‌ها: فایل اکسل را از Node Convert to File دریافت می‌کند.

* خروجی‌ها: به Node Microsoft Teams متصل می‌شود.

* موارد لبه‌ای: توکن‌های OAuth منقضی شده یا نامعتبر، محدودیت‌های سهمیه API Google Drive، تداخل نام فایل یا مشکلات مجوز.

• Create chat message

* نوع: Microsoft Teams

* نقش: یک پیام هشدار به یک چت یا کانال Microsoft Teams مشخص ارسال می‌کند.

* پیکربندی:

* منبع (Resource): chatMessage

* پیام (Message): این فیلد باید با متن هشدار پویا یا ثابت پیکربندی شود.

* شناسه چت (Chat ID): نیاز به یک شناسه چت یا کانال معتبر دارد.

* نیاز به اعتبارنامه‌های احراز هویت شده Microsoft Teams OAuth2 دارد.

* ورودی‌ها: تأییدیه/داده‌ها را از Node Google Drive دریافت می‌کند.

* خروجی‌ها: ندارد (آخرین Node در این شاخه).

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

جدول خلاصه Workflow

بازتولید Workflow

1. Schedule Trigger: یک Node Schedule Trigger اضافه کنید و آن را برای اجرای هر ۱۵ دقیقه پیکربندی کنید.

2. HTTP Request:

* Node Schedule Trigger را به یک Node HTTP Request متصل کنید.

* متد را روی GET تنظیم کنید.

* URL را وارد کنید: https://688c83a8cd9d22dda5cd6aec.mockapi.io/temperature_n8n/equipments.

3. If Node (بررسی شرط):

* Node HTTP Request را به یک Node If متصل کنید.

* ترکیب‌کننده شرط (Condition Combinator) را روی AND تنظیم کنید.

* شرایط زیر را اضافه کنید:

* {{$json.temp}} > 60

* {{$json.voltage}} > 20

* اطمینان حاصل کنید که اعتبارسنجی نوع داده سخت‌گیرانه فعال است.

4. Convert to File:

* خروجی "true" Node If را به یک Node Convert to File متصل کنید.

* عملیات (Operation) را روی xls تنظیم کنید.

* نام فایل (File Name) را روی equipment_list.xls تنظیم کنید.

5. Google Drive:

* Node Convert to File را به یک Node Google Drive متصل کنید.

* با استفاده از OAuth2 با حساب Google Drive خود احراز هویت کنید.

* درایو (Drive) را روی "My Drive" و پوشه (Folder) را روی ریشه (/) تنظیم کنید.

6. Microsoft Teams:

* Node Google Drive را به یک Node Microsoft Teams متصل کنید.

* با استفاده از OAuth2 با حساب Microsoft Teams خود احراز هویت کنید.

* منبع (Resource) را روی chatMessage تنظیم کنید.

* به طور حیاتی، Chat ID را با شناسه صحیح برای چت یا کانال هدف خود پیکربندی کنید.

* فیلد Message را با متن هشدار دلخواه خود پیکربندی کنید (مثلاً "هشدار تجهیزات: از آستانه‌های دما و ولتاژ عبور شد. داده‌ها بایگانی شدند.").

نکات عمومی و منابع

• اعتبارنامه‌ها (Credentials): اطمینان حاصل کنید که اعتبارنامه‌های OAuth2 Google Drive و Microsoft Teams شما دارای دامنه‌ها و مجوزهای لازم برای آپلود فایل و ارسال پیام به ترتیب هستند. برای راه‌اندازی دقیق اعتبارنامه‌ها به کاتالوگ Axeto مراجعه کنید.
• نقطه پایانی API (API Endpoint): URL API نمایشی ارائه شده برای نمایش است. آن را با نقطه پایانی API نظارت بر تجهیزات واقعی خود جایگزین کنید.
• پیکربندی Microsoft Teams: فیلدهای Message و Chat ID در Node Microsoft Teams برای ارسال مؤثر هشدارها نیاز به پیکربندی خاصی دارند.
• مورد استفاده (Use Case): این Workflow به عنوان یک الگو برای نظارت بر داده‌های تلمتری IoT یا تجهیزات، ادغام آن با ذخیره‌سازی ابری و فعال کردن هشدارهای بی‌درنگ در پلتفرم‌های همکاری عمل می‌کند.

برای اطلاعات بیشتر در مورد Workflows n8n و Node های موجود، از کاتالوگ Axeto دیدن کنید: https://axeto.ai/n8n