Logging، Performance و Troubleshooting

61. Provider Parameter Logging

کلید زیر در appSettings فایل web.config وضعیت ثبت Log اجرای Provider را کنترل می‌کند:

<add
    key="isProviderParamLogActive"
    value="true"
/>

وقتی مقدار true باشد، اجرای Providerها و پارامترهای مربوط به هر اجرا به‌صورت کامل در جدول:

ProviderLog

ثبت می‌شوند.

این قابلیت برای Audit و Debug مفید است، اما از منظر امنیت باید جدی گرفته شود. اگر Parameter شامل Token، Password، کد ملی، داده شخصی یا اطلاعات قراردادی باشد، همان داده می‌تواند وارد Log شود.

در این سند Schema ستون‌های ProviderLog یا Retention Policy فرض نشده‌اند، چون برای توضیح قابلیت اصلی لازم نیستند و ممکن است به Deployment وابسته باشند.

62. از SELECT * در Production پرهیز کنید

به‌جای:

SELECT *
FROM LargeTable;

فقط Fieldهای لازم:

SELECT
    Id,
    Title,
    StatusId
FROM LargeTable;

مزایا:

• Network کمتر؛
• Serialization کمتر؛
• Schema تمیزتر؛
• احتمال افشای داده حساس کمتر.

63. Paging برای Dataset بزرگ

اگر Provider برای Grid، Report یا Search است و رکورد زیاد دارد، Paging فعال شود.

نشانه‌های نیاز:

• Table بزرگ؛
• Load زمان‌بر؛
• Grid با تعداد رکورد زیاد؛
• REST Service کند؛
• مصرف زیاد Browser Memory.

64. Provider در onLoad

Call سنگین در onLoad UX فرم را خراب می‌کند.

در صورت امکان:

• فقط داده ضروری دریافت شود؛
• Paging استفاده شود؛
• Call تکراری حذف شود؛
• Query و Indexهای Database بهینه باشند.

65. Parameter تعریف شده اما مقدار نمی‌گیرد

بررسی کنید:

1. name دقیقاً برابر Parameter باشد.
2. اشتباه تایپی یا اختلاف نام وجود نداشته باشد.
3. Parameter در Query واقعاً استفاده شده باشد.
4. Constant Value در REST رفتار مورد نظر را تغییر نداده باشد.
5. Parameter مخصوص Paging را دوباره در لیست عادی ارسال نکرده باشید.

66. JSON.parse خطا می‌دهد

ممکن است Provider:

• File برگرداند؛
• خروجی Structured نداشته باشد؛
• providerResult خالی باشد؛
• text/plain باشد.

برای Structured Result:

const rows =
    JSON.parse(
        result.Content.providerResult || '[]'
    );

ولی ابتدا نوع خروجی Provider را بررسی کنید.

67. File ارسال نمی‌شود

بررسی کنید:

• مقدار واقعاً File باشد؛
• Blob خام نباشد؛
• REST Content Type برابر multipart/form-data باشد؛
• Parameter Type برابر File باشد؛
• Position برابر form-data باشد.

Blob → File:

const file =
    new File(
        [blob],
        'my-file.bin'
    );

68. File Output به شکل مورد انتظار Download نمی‌شود

Helper فعلی File را وقتی تشخیص می‌دهد که Response Header شامل:

Content-Disposition: attachment

باشد.

Endpoint و Network Response را بررسی کنید.

69. ROWCOUNT یا TRANCOUNT به‌عنوان Parameter ظاهر شده

اگر Advanced Editor از:

@@ROWCOUNT
@@TRANCOUNT

استفاده می‌کند، Parser UI ممکن است آن‌ها را Parameter تشخیص دهد.

لیست Parameters را قبل از Save بازبینی کنید.

70. Paging نتیجه اشتباه می‌دهد

کنترل کنید:

• Page Number / Index مبنا؛
• Page Size؛
• Key Column؛
• GlobalFilter Mapping؛
• Filter Parameter Mapping؛
• SortColumn / SortValue Pair؛
• نام Parameterها؛
• ORDER BY معتبر؛
• منطق Page Count/Total در Provider مقصد.