اتوماسیون GeoTab: ایجاد خودکار منطقه برای سفارشات کار Sales…

اتوماسیون ایجاد منطقه GeoTab برای سفارش کار جدید Salesforce

این گردش کار، ایجاد مناطق geofence را در GeoTab به صورت خودکار انجام می‌دهد، هر زمان که یک رکورد سفارش کار (Job) جدید در Salesforce ایجاد شود، به شرطی که سفارش کار معیارهای خاصی را برآورده کند. این اطمینان حاصل می‌کند که مکان سفارش کار جدید به عنوان یک منطقه GeoTab ثبت شده و Salesforce را با شناسه منطقه مربوطه به‌روزرسانی می‌کند. علاوه بر این، ایمیل‌های اطلاع‌رسانی در مورد موفقیت یا شکست این عملیات ارسال می‌کند.

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

• ایجاد خودکار منطقه geofence در GeoTab برای سفارشات کار Salesforce.
• حفظ همگام‌سازی داده‌های geofence بین Salesforce و GeoTab.
• اطلاع‌رسانی به عملیات و ذینفعان در مورد موفقیت یا مشکلات داده‌های مکانی گمشده.
• در صورت نیاز، قابل انطباق با سایر اشیاء Salesforce.

ساختار گردش کار:

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

2. بازیابی جزئیات سفارش کار و استخراج فیلد: دریافت داده‌های کامل سفارش کار از Salesforce و استخراج فیلدهای ضروری.

3. اعتبارسنجی مکان و انشعاب شرطی: بررسی اینکه آیا داده‌های موقعیت جغرافیایی (عرض جغرافیایی/طول جغرافیایی) وجود دارد؛ بر اساس آن انشعاب دهید.

4. آماده‌سازی داده‌های منطقه GeoTab: قالب‌بندی و محاسبه نقاط برای چندضلعی منطقه GeoTab.

5. احراز هویت GeoTab و ایجاد منطقه: احراز هویت با API GeoTab، محاسبه تاریخ‌های فعال منطقه و ایجاد منطقه.

6. به‌روزرسانی Salesforce و اعلان‌ها: به‌روزرسانی رکورد Salesforce با جزئیات منطقه GeoTab و ارسال اعلان‌های ایمیل موفقیت یا خطا.

---

تجزیه و تحلیل دقیق گردش کار

۱. راه‌انداز Salesforce و پاسخ اولیه

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

• گره‌ها (Nodes):

* Salesforce Webhook (Webhook)

* Respond to Webhook (Respond to Webhook)

* Wait (Wait)

• جزئیات گره‌ها:

* Salesforce Webhook:

* نوع: Webhook (شنونده HTTP POST)

* عملکرد: گوش دادن به درخواست‌های POST در یک مسیر خاص که برای پیام‌های خروجی Salesforce پیکربندی شده است. انتظار بدنه SOAP XML حاوی شناسه سفارش کار را دارد.

* خروجی: JSON تجزیه شده از پیام SOAP.

* پیکربندی: نیاز به یک URL webhook منحصر به فرد دارد که در Salesforce پیکربندی شده است.

* Respond to Webhook:

* نوع: Respond to Webhook

* عملکرد: ارسال یک تأییدیه SOAP XML ثابت به Salesforce، تأیید دریافت موفقیت‌آمیز پیام.

* پیکربندی: هدر Content-Type را روی application/xml تنظیم می‌کند.

* Wait:

* نوع: Wait (گره تأخیر)

* عملکرد: اجرای گردش کار را به مدت ۳۰ ثانیه متوقف می‌کند. این تأخیر به داده‌های Salesforce اجازه می‌دهد تا قبل از تلاش برای دریافت جزئیات کامل سفارش کار، به طور کامل کامیت و منتشر شوند.

۲. بازیابی جزئیات سفارش کار و استخراج فیلد

این بلوک رکورد کامل سفارش کار را با استفاده از شناسه به‌دست‌آمده از webhook از Salesforce بازیابی کرده و سپس فیلدهای خاص مورد نیاز برای ایجاد geofence را استخراج می‌کند.

• گره‌ها (Nodes):

* Get Work Order details (Salesforce)

* Extract required fields (Set)

• جزئیات گره‌ها:

* Get Work Order details:

* نوع: گره Salesforce (عملیات get سفارشی)

* عملکرد: رکورد کامل سفارش کار را با استفاده از شناسه سفارش کار ارائه شده توسط webhook از Salesforce دریافت می‌کند.

* پیکربندی: نیاز به اعتبارنامه Salesforce OAuth2 دارد.

* Extract required fields:

* نوع: گره Set

* عملکرد: فیلدهای خاصی را از داده‌های سفارش کار بازیابی شده استخراج و اختصاص می‌دهد، از جمله Id, WorkOrderNumber, Job_Type__c, Job_Sub_Type__c, Address.latitude, Address.longitude, CreatedDate, و Last_Appointment_Date__c. این داده‌ها را برای گره‌های بعدی آماده می‌کند.

۳. اعتبارسنجی مکان و انشعاب شرطی

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

• گره‌ها (Nodes):

* If has location (If)

* Email notification - error (Microsoft Outlook)

• جزئیات گره‌ها:

* If has location:

* نوع: گره If (شرطی)

* عملکرد: ارزیابی می‌کند که آیا فیلد Address.latitude خالی نیست.

* شاخه‌ها:

* True: به فرآیند ایجاد منطقه GeoTab ادامه می‌دهد.

* False: گره Email notification - error را راه‌اندازی می‌کند.

* Email notification - error:

* نوع: گره Microsoft Outlook (ارسال ایمیل)

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

* پیکربندی: نیاز به اعتبارنامه Microsoft Outlook OAuth2 دارد.

۴. آماده‌سازی داده‌های منطقه GeoTab

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

• گره‌ها (Nodes):

* Prepare data for GeoTab (Set)

* Calculate points (Code)

• جزئیات گره‌ها:

* Prepare data for GeoTab:

* نوع: گره Set

* عملکرد: مقادیری را برای ایجاد منطقه GeoTab اختصاص می‌دهد، از جمله Name, Latitude, Longitude, Reference, Comment, ExternalReference, و ActiveTo با استفاده از داده‌های سفارش کار استخراج شده.

* Calculate points:

* نوع: گره Code (JavaScript)

* عملکرد: ۲۰ نقطه با فاصله مساوی روی یک دایره با شعاع ۲۰۰ متری در اطراف عرض جغرافیایی و طول جغرافیایی مرکزی سفارش کار را محاسبه می‌کند. این نقاط چندضلعی را برای منطقه GeoTab تعریف می‌کنند.

* خروجی: آرایه‌ای از نقاط عرض جغرافیایی/طول جغرافیایی که در فیلد result ذخیره شده‌اند.

۵. احراز هویت GeoTab و ایجاد منطقه

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

• گره‌ها (Nodes):

* GeoTab authentication (HTTP Request)

* Calculate zone's active dates (Code)

* Create zone in GeoTab (HTTP Request)

• جزئیات گره‌ها:

* GeoTab authentication:

* نوع: HTTP Request (POST)

* عملکرد: با استفاده از نام کاربری، رمز عبور و نام پایگاه داده ارائه شده با API GeoTab احراز هویت می‌کند.

* خروجی: sessionId و سایر توکن‌های احراز هویت مورد نیاز برای فراخوانی‌های API بعدی.

* پیکربندی: اعتبارنامه‌های جایگزین را با جزئیات حساب معتبر GeoTab جایگزین کنید.

* Calculate zone's active dates:

* نوع: گره Code (JavaScript)

* عملکرد: تاریخ activeFrom (نیمه‌شب UTC روز جاری) و تاریخ activeTo (۶۰ روز از activeFrom) را محاسبه می‌کند. این تاریخ‌ها را برای انطباق با API به رشته‌های ISO بدون میلی‌ثانیه قالب‌بندی می‌کند.

* Create zone in GeoTab:

* نوع: HTTP Request (POST)

* عملکرد: درخواستی با متد "Add" را به API GeoTab برای ایجاد یک موجودیت منطقه جدید ارسال می‌کند. این شامل نام منطقه، مرجع، نظر، نقاط چندضلعی (از Calculate points)، تنظیمات دید و تاریخ‌های فعال محاسبه شده است.

* پیکربندی: از sessionId از مرحله احراز هویت، پایگاه داده GeoTab و اعتبارنامه‌های نام کاربری استفاده می‌کند.

۶. به‌روزرسانی Salesforce و اعلان‌ها

در نهایت، این بلوک رکورد سفارش کار Salesforce را با شناسه منطقه GeoTab تازه ایجاد شده به‌روزرسانی کرده و یک ایمیل اطلاع‌رسانی موفقیت‌آمیز ارسال می‌کند.

• گره‌ها (Nodes):

* Update Salesforce with zone details (Salesforce)

* Email notification - success (Microsoft Outlook)

• جزئیات گره‌ها:

* Update Salesforce with zone details:

* نوع: گره Salesforce (عملیات update سفارشی)

* عملکرد: رکورد سفارش کار را در Salesforce با GeoTab_ID__c (شناسه منطقه تازه ایجاد شده) به‌روزرسانی کرده و GeoTab_Zone_Created__c را روی true تنظیم می‌کند.

* پیکربندی: نیاز به اعتبارنامه Salesforce OAuth2 دارد.

* Email notification - success:

* نوع: گره Microsoft Outlook (ارسال ایمیل)

* عملکرد: پس از ایجاد موفقیت‌آمیز منطقه، یک ایمیل تأییدیه دقیق به گیرندگان مشخص شده ارسال می‌کند. ایمیل شامل پیوندهایی به سفارش کار Salesforce و منطقه GeoTab برای دسترسی آسان است.

* پیکربندی: نیاز به اعتبارنامه Microsoft Outlook OAuth2 دارد.

---

گردش کارهای موجود

شما می‌توانید این گردش کار و موارد دیگر را در Pixori.me پیدا کنید:

• <strong>گردش کارهای n8n Pixori.me</strong>