تست و دیباگ (Test & Debugging)
🧪 عیب‌یابی و رفع مشکلات
اگر هنگام استفاده از هارمونی کلاب با خطا یا عملکرد غیرمنتظره‌ای مواجه شدید، این بخش به شما کمک می‌کند مشکل را بررسی کنید و برای رفع آن، اطلاعات لازم را در اختیار داشته باشید.
پیش از هر اقدامی، پیام خطا را به‌دقت بررسی کنید و مشخص کنید مشکل در کدام بخش سامانه رخ داده است. در بسیاری از موارد، بررسی تنظیمات و اطلاعات ورودی می‌تواند به شناسایی علت مشکل کمک کند.
🔌 مشکلات اتصال
اگر اتصال به سامانه یا یکی از سرویس‌های خارجی با مشکل مواجه شده است، موارد زیر را بررسی کنید:
- اتصال اینترنت: از برقرار بودن اتصال اینترنت و در دسترس بودن سرویس موردنظر مطمئن شوید.
- فایروال و پراکسی: در صورت استفاده از فایروال یا پراکسی، تنظیمات مربوط به دسترسی شبکه را بررسی کنید.
- اطلاعات اتصال: در صورت بروز مشکل در اتصال به ابزارهای خارجی، اطلاعات اتصال و تنظیمات سرویس مربوطه را بررسی کنید.
- پیام‌رسان‌ها و سرویس‌های پیامکی: از صحیح بودن تنظیمات اتصال و اطلاعات احراز هویت سرویس اطمینان حاصل کنید.
🔐 مشکلات ورود به سامانه
اگر نمی‌توانید وارد حساب کاربری خود شوید، موارد زیر را بررسی کنید:
- از صحت اطلاعات ورود اطمینان حاصل کنید.
- مطمئن شوید حساب کاربری شما فعال است.
- اگر پس از ورود به سامانه به بخش خاصی دسترسی ندارید، نقش و سطح دسترسی اختصاص‌یافته به حساب کاربری خود را بررسی کنید.
اگر مشکل همچنان ادامه داشت، پیام خطای نمایش‌داده‌شده را برای پیگیری ثبت کنید.
🔗 خطاهای اتصال و API
در صورت بروز مشکل در ارتباط سامانه با وب‌سایت یا سایر سرویس‌های خارجی، موارد زیر را بررسی کنید:
- اطلاعات اتصال و تنظیمات سرویس خارجی صحیح باشند.
- آدرس درخواست و اطلاعات ارسال‌شده با تنظیمات موردانتظار سرویس مطابقت داشته باشند.
- در صورت دریافت پاسخ خطا از API، متن پاسخ و کد وضعیت آن را بررسی کنید.
- اگر مشکل مربوط به وب‌سایت وردپرسی یا پیام‌رسان‌ها است، تنظیمات اتصال مربوط به همان سرویس را بررسی کنید.
برای بررسی دقیق‌تر، آدرس درخواست، زمان وقوع خطا و متن پاسخ دریافتی را ثبت کنید. اطلاعات محرمانه مانند توکن‌ها و کلیدهای دسترسی را در گزارش خطا قرار ندهید.
📥 مشکلات ورود اطلاعات
اگر هنگام بارگذاری اطلاعات مشتریان یا محصولات با خطا مواجه شدید، موارد زیر را بررسی کنید:
- فایل ورودی در قالب پشتیبانی‌شده، مانند Excel یا CSV، باشد.
- نوع داده انتخاب‌شده با اطلاعات موجود در فایل مطابقت داشته باشد.
- ستون‌های فایل به فیلدهای صحیح سامانه نگاشت شده باشند.
- اطلاعات ضروری و شناسه‌های موردنیاز برای شناسایی رکوردها به‌درستی وارد شده باشند.
- وضعیت بارگذاری و جزئیات رکوردهای ردشده را در تاریخچه بارگذاری بررسی کنید.
در صورت رد شدن برخی رکوردها، دلیل ثبت‌شده برای هر رکورد را بررسی و اطلاعات آن را اصلاح کنید.
⚠️ خطاهای عمومی سامانه
اگر هنگام استفاده از یکی از بخش‌های هارمونی کلاب با خطا مواجه شدید یا نتیجه‌ای متفاوت از انتظار مشاهده کردید:
- پیام خطا یا رفتار غیرمنتظره را ثبت کنید.
- بررسی کنید مشکل در چه شرایطی رخ می‌دهد و آیا امکان تکرار آن وجود دارد.
- اطلاعات واردشده و تنظیمات مرتبط با همان بخش را بررسی کنید.
- در صورت ادامه مشکل، اطلاعات لازم را برای پیگیری در اختیار تیم پشتیبانی قرار دهید.
🆘 ارتباط با پشتیبانی
اگر با انجام بررسی‌های بالا مشکل برطرف نشد، موضوع را برای بررسی بیشتر به تیم پشتیبانی هارمونی گزارش دهید.
برای اینکه مشکل سریع‌تر بررسی شود، بهتر است گزارش شما شامل اطلاعات زیر باشد:
- بخش مربوطه: مشخص کنید مشکل در کدام قسمت سامانه رخ داده است.
- شرح مشکل: توضیح دهید چه کاری انجام می‌دادید و چه نتیجه‌ای انتظار داشتید.
- پیام خطا: متن کامل خطا یا تصویر صفحه را، در صورت امکان، ارسال کنید.
- زمان وقوع: تاریخ و زمان تقریبی بروز مشکل را اعلام کنید.
- مراحل تکرار مشکل: مراحل لازم برای مشاهده دوباره خطا را بنویسید.
نکته امنیتی: رمز عبور، توکن، کلید API و سایر اطلاعات محرمانه را در تصاویر، گزارش‌ها یا پیام‌های پشتیبانی ارسال نکنید.