10 مورد از رایج ترین مشکلات توسعه دهنده های شیرپوینت که با آن مواجه میشوند

۱. مشکل نمایش وب‌پارت‌ها (Web Part Not Loading / Cannot Display Web Part)

معرفی مشکل:

کاربران شیرپوینت گاهی با این مشکل مواجه می‌شوند که وب‌پارت‌ها در صفحات بارگذاری نمی‌شوند یا خطایی مثل:

“Web Part Page Cannot be Displayed”
نمایش داده می‌شود. حتی ممکن است وب‌پارت ظاهر شود اما محتوای آن خالی باشد.

این مشکل در نسخه‌های On-Prem 2013/2016/2019 و Online رخ می‌دهد و یکی از شایع‌ترین مشکلات است.


دلایل رایج:
  1. کش مرورگر: مرورگر نسخه قدیمی فایل‌های JS و CSS را نگه داشته است.

  2. مشکلات دسترسی: کاربر سطح دسترسی لازم برای لیست/کتابخانه وب‌پارت ندارد.

  3. خطا در فایل‌های JS/CSS سفارشی: اگر Web Part با اسکریپت یا CSS سفارشی کار می‌کند و خطا دارد، وب‌پارت بارگذاری نمی‌شود.

  4. ویژگی Minimal Download Strategy (MDS): در بعضی صفحات مدرن باعث مشکل لود وب‌پارت می‌شود.

  5. نسخه مرورگر ناسازگار: بعضی Web Partها در IE یا Edge قدیمی درست کار نمی‌کنند.


راه‌حل‌های مرحله‌ای:
مرحله ۱: پاک کردن کش مرورگر
  • مرورگر را ببندید.

  • کش مرورگر را پاک کنید (Ctrl + Shift + Delete).

  • دوباره صفحه را باز کنید و بررسی کنید.

مرحله ۲: بررسی مجوزهای کاربر
  • مطمئن شوید کاربر حداقل سطح دسترسی Read روی لیست/کتابخانه دارد.

  • در صورت نیاز دسترسی را افزایش دهید.

  • برای بررسی، از Site Permissions استفاده کنید.

مرحله ۳: غیرفعال کردن MDS (در نسخه‌های On-Prem)
  • به Site Settings → Manage Site Features بروید.

  • ویژگی Minimal Download Strategy را غیرفعال کنید و صفحه را دوباره بارگذاری کنید.

مرحله ۴: بررسی اسکریپت و CSS سفارشی
  • اگر وب‌پارت از JS یا CSS سفارشی استفاده می‌کند، کدها را یک به یک بررسی کنید.

  • از Developer Tools (F12) برای شناسایی خطاهای JS استفاده کنید.

  • خطاها را اصلاح کنید و دوباره تست کنید.

مرحله ۵: مرورگر و نسخه شیرپوینت
  • اگر از مرورگر قدیمی استفاده می‌کنید، به آخرین نسخه Chrome، Edge یا Firefox بروید.

  • برخی وب‌پارت‌ها فقط با مرورگرهای مدرن درست کار می‌کنند.


نکات حرفه‌ای:
  • همیشه قبل از افزودن اسکریپت، در یک محیط تست امتحان کنید.

  • استفاده از Script Editor Web Part در Modern Page محدودیت دارد، بهتر است Embed Web Part یا SPFx استفاده کنید.

  • برای وب‌پارت‌های سفارشی، مطمئن شوید که ClientSideComponentId و مسیر فایل‌ها درست تنظیم شده باشد.

  • بررسی لاگ‌های ULS (Unified Logging Service) در شیرپوینت On-Prem کمک می‌کند تا خطاهای پشت پرده وب‌پارت را پیدا کنید.

۲. خطاهای دسترسی (Access Denied / You don’t have permission)

معرفی مشکل:

یکی از رایج‌ترین مشکلات در شیرپوینت این است که کاربران هنگام باز کردن یک سایت، لیست یا وب‌پارت با پیغام:

“Access Denied”
یا
“You don’t have permission to view this page”
مواجه می‌شوند.

این خطا هم در On-Prem (2013/2016/2019) و هم در SharePoint Online رخ می‌دهد و برای کاربران تازه‌کار گیج‌کننده است.


دلایل رایج:
  1. سطح دسترسی ناکافی: کاربر به گروه درست یا لیست دسترسی ندارد.

  2. عدم ارث‌بری مجوزها (Broken Inheritance): وقتی لیست یا کتابخانه مجوز خود را از سایت والد دریافت نمی‌کند.

  3. کاربر خارج از گروه‌ها: کاربر عضو گروه اشتباهی است یا گروه حذف شده.

  4. محدودیت‌های امنیتی: بعضی Web Partها یا فایل‌ها دسترسی محدود دارند.

  5. خطای Cache یا Session: گاهی تغییر دسترسی اعمال نشده است و مرورگر هنوز session قدیمی دارد.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی مجوزهای کاربر
  • به Site Settings → Site Permissions بروید.

  • سطح دسترسی کاربر را بررسی کنید و حداقل Read برای لیست/کتابخانه اعمال کنید.

  • برای رفع خطا، می‌توانید کاربر را به گروه‌های با دسترسی مناسب اضافه کنید.

مرحله ۲: بررسی ارث‌بری مجوزها
  • اگر لیست یا کتابخانه ارث‌بری مجوزها را قطع کرده است:

    • به لیست → Settings → Permissions for this list بروید.

    • روی Inherit Permissions کلیک کنید تا مجوزها از سایت والد اعمال شود.

مرحله ۳: بررسی گروه‌ها و کاربران
  • مطمئن شوید گروه‌ها حذف نشده‌اند و کاربران عضو گروه درست هستند.

  • کاربران خارجی (External Users) را بررسی کنید (در Online).

مرحله ۴: پاک کردن Cache مرورگر
  • گاهی session قدیمی باعث نمایش Access Denied می‌شود.

  • مرورگر را ببندید و کش را پاک کنید.

مرحله ۵: بررسی ویژگی‌ها و Web Partها
  • اگر خطا فقط در یک Web Part خاص است، ممکن است دسترسی فایل‌ها یا script محدود باشد.

  • بررسی کنید که همه فایل‌ها و JS/CSS مربوط به Web Part قابل دسترسی باشند.


نکات حرفه‌ای:
  • برای محیط On-Prem: بررسی ULS Logs کمک می‌کند بفهمید خطا از کجا آمده است.

  • همیشه دسترسی‌ها را مستندسازی و مدیریت گروهی کنید تا از خطای انسانی جلوگیری شود.

  • در محیط Online، استفاده از SharePoint Admin Center → Permission Reports برای شناسایی کاربران بدون دسترسی مفید است.

۳. مشکل آپلود فایل‌های بزرگ در شیرپوینت (Large File Upload Issues)

معرفی مشکل:

کاربران هنگام آپلود فایل‌های بزرگ (مثلاً بالای 50 مگابایت یا 250 مگابایت بسته به تنظیمات) با مشکلاتی مواجه می‌شوند، مانند:

  • فایل آپلود نمی‌شود

  • مرورگر خطای Timeout می‌دهد

  • صفحه هنگام آپلود متوقف یا Refresh می‌شود

این مشکل در SharePoint On-Prem 2013/2016/2019 و حتی Online ممکن است رخ دهد و یکی از مشکلات شایع کاربران است.


دلایل رایج:
  1. محدودیت حجم آپلود (Maximum Upload Size):

    • در شیرپوینت On-Prem، مقدار پیش‌فرض معمولاً 50 یا 250 مگابایت است.

  2. Timeout در IIS یا مرورگر:

    • زمان آپلود طولانی باعث قطع ارتباط می‌شود.

  3. محدودیت مرورگر:

    • بعضی مرورگرها به طور پیش‌فرض فایل‌های خیلی بزرگ را پشتیبانی نمی‌کنند.

  4. شبکه یا پروکسی:

    • سرعت پایین اینترنت یا پروکسی‌های سازمانی باعث Timeout می‌شوند.

  5. OneDrive Sync / Explorer View:

    • آپلود مستقیم از مرورگر ممکن است مشکل داشته باشد، اما با Sync Client بهتر عمل می‌کند.


راه‌حل‌های مرحله‌ای:

مرحله ۱: افزایش Maximum Upload Size در On-Prem
  1. به Central Administration → Web Applications → Manage Web Applications بروید.

  2. وب اپلیکیشن مورد نظر را انتخاب کنید و روی General Settings → General Settings کلیک کنید.

  3. مقدار Maximum Upload Size را افزایش دهید (مثلاً تا 2 گیگابایت اگر نیاز دارید).

مرحله ۲: افزایش Timeout در IIS
  • در سرور شیرپوینت، IIS Manager → Application Pool → Advanced Settings

  • مقدار Connection Timeout یا Request Timeout را افزایش دهید تا فایل‌های بزرگ بتوانند آپلود شوند.

مرحله ۳: استفاده از مرورگر مناسب
  • آخرین نسخه Chrome، Edge یا Firefox را استفاده کنید.

  • برخی مرورگرهای قدیمی یا IE قدیمی برای فایل‌های بزرگ مشکل دارند.

مرحله ۴: استفاده از OneDrive Sync یا Explorer View

  • برای فایل‌های خیلی بزرگ، از OneDrive for Business Sync Client استفاده کنید.

  • یا کتابخانه را در Open with Explorer / View in File Explorer باز کنید و فایل‌ها را انتقال دهید.

مرحله ۵: بررسی خطاها و لاگ‌ها

  • اگر مشکل ادامه داشت، ULS Logs یا Event Viewer را بررسی کنید تا خطای دقیق پیدا شود.

  • خطای Common: “File size exceeds the maximum upload size” یا “Request timed out”.


نکات حرفه‌ای:

  • در SharePoint Online محدودیت حجم آپلود 250 مگابایت پیش‌فرض است، ولی با OneDrive Sync تا 100 گیگابایت هم امکان آپلود وجود دارد.

  • همیشه قبل از افزایش حجم، مطمئن شوید سرور منابع کافی دارد و با افزایش حجم آپلود مشکلی برای Performance پیش نیاید.

  • برای فایل‌های خیلی بزرگ، پیشنهاد می‌شود از Chunked Upload در REST API یا PnPjs استفاده کنید تا فایل به تکه‌های کوچک تقسیم شود.

۴. مشکلات جستجو و Content Search در شیرپوینت (Search Issues / Content Search Not Working)

معرفی مشکل:

یکی از چالش‌های رایج کاربران شیرپوینت، عدم نمایش نتایج جستجو یا نمایش ناقص محتوا است.
مثال‌ها:

  • آیتم‌های جدید لیست در نتایج Search ظاهر نمی‌شوند.

  • Web Partهای Content Search یا Highlighted Content چیزی نشان نمی‌دهند.

  • نتایج قدیمی یا غیرمرتبط نمایش داده می‌شوند.

این مشکل هم در SharePoint On-Prem (2013/2016/2019) و هم در SharePoint Online رخ می‌دهد.


دلایل رایج:

  1. Crawl یا Index شدن ناقص محتوا:

    • آیتم‌ها هنوز توسط Search Crawl ایندکس نشده‌اند.

  2. پیکربندی Search Schema نادرست:

    • فیلدها یا Columnها به درستی mapped نشده‌اند.

  3. محدودیت Permissions:

    • کاربر سطح دسترسی کافی به آیتم‌ها ندارد، بنابراین Search آن‌ها را نشان نمی‌دهد.

  4. خطای Web Part یا Content Search Query:

    • Query اشتباه، Filter یا Result Source نامناسب باعث نمایش صفر نتیجه می‌شود.

  5. مدت زمان Index:

    • در On-Prem Crawlها زمان‌بندی دارند و محتوا بلافاصله ایندکس نمی‌شود.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی Crawl و Index

  • در On-Prem:

    • به Central Administration → Search Service Application → Crawl Log بروید.

    • بررسی کنید که آیتم‌ها Crawl شده‌اند و خطای خاصی ندارند.

  • در Online:

    • صبر کنید تا Content جدید توسط Microsoft Search ایندکس شود (گاهی 15 دقیقه تا چند ساعت).

مرحله ۲: بررسی Search Schema و Managed Properties

  • مطمئن شوید Columnها به Managed Property مرتبط شده‌اند.

  • اگر Column جدید اضافه کرده‌اید، باید آن را به Search Schema Map کنید.

مرحله ۳: بررسی Permissions

  • کاربر باید دسترسی Read یا بالاتر به آیتم‌ها داشته باشد.

  • بدون دسترسی، آیتم‌ها در نتایج Search نشان داده نمی‌شوند.

مرحله ۴: بررسی Query Web Part

  • در Web Partهای Content Search یا Highlighted Content:

    • Query تنظیم شده را بررسی کنید.

    • مطمئن شوید Filterها صحیح هستند و Result Source درست انتخاب شده است.

  • در صورت نیاز Query را ساده کنید و تست کنید.

مرحله ۵: Force Crawl (On-Prem)

  • برای تست سریع، Crawl را دستی اجرا کنید:

    • Full Crawl یا Incremental Crawl از Central Admin اجرا شود.

  • بعد از Crawl، نتایج را مجدد بررسی کنید.


نکات حرفه‌ای:

  • همیشه مطمئن شوید Search Service Account دسترسی کافی به همه Content دارد.

  • در Online، از Search & Intelligence Center برای مانیتور Crawl و Query استفاده کنید.

  • برای بهبود سرعت، از Result Sourceهای اختصاصی و Query Rules استفاده کنید.

  • اضافه کردن Illustration یا GIF برای مراحل بررسی Crawl و Query Web Part باعث جذابیت مقاله و بهبود SEO می‌شود.

۵. مشکلات لیست‌ها و کتابخانه‌ها در شیرپوینت (Lists & Libraries Issues)

معرفی مشکل:

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

  • افزودن یا ویرایش آیتم‌ها غیرممکن است

  • پیام خطای “List does not exist” نمایش داده می‌شود

  • ستون‌ها یا Lookup Fieldها به درستی کار نمی‌کنند

  • صفحات لیست یا کتابخانه خیلی کند بارگذاری می‌شوند

این مشکلات در On-Prem 2013/2016/2019 و SharePoint Online رخ می‌دهند و یکی از رایج‌ترین مشکلات کاربران است.


دلایل رایج:

  1. خطا در URL یا حذف لیست:

    • ممکن است لیست به اشتباه حذف شده باشد یا URL تغییر کرده باشد.

  2. Broken Permissions / دسترسی ناکافی:

    • کاربر سطح دسترسی کافی برای مشاهده یا ویرایش ندارد.

  3. Large List / Threshold Limit:

    • تعداد آیتم‌ها بیش از 5000 شده و List View Threshold اعمال شده است.

  4. ستون‌های Lookup یا Choice مشکل‌دار:

    • ستون Lookup به لیست دیگری اشاره دارد که حذف یا تغییر کرده است.

  5. کش مرورگر یا Session قدیمی:

    • باعث نمایش خطای دسترسی یا Load ناقص لیست می‌شود.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی URL و موجودیت لیست

  • اطمینان حاصل کنید لیست یا کتابخانه هنوز موجود است:

    • به Site Contents بروید و لیست را پیدا کنید.

  • اگر URL تغییر کرده، لینک‌ها و Web Partها را به‌روزرسانی کنید.

مرحله ۲: بررسی مجوزهای کاربر

  • به List Settings → Permissions for this list بروید.

  • دسترسی کاربر یا گروه‌ها را بررسی و در صورت نیاز اصلاح کنید.

مرحله ۳: بررسی Large List و Threshold Limit

  • برای لیست‌های بالای 5000 آیتم:

    • از Indexed Columns و Filtered Views استفاده کنید تا محدودیت List View Threshold رعایت شود.

    • امکان استفاده از Folders برای تقسیم داده‌ها وجود دارد.

مرحله ۴: بررسی ستون‌های Lookup یا Choice

  • ستون‌های Lookup باید به لیست‌های معتبر اشاره کنند.

  • اگر لیست مقصد حذف یا تغییر کرده، ستون را اصلاح یا دوباره بسازید.

مرحله ۵: پاک کردن کش مرورگر

  • گاهی Load ناقص یا خطاهای نمایش ناشی از کش مرورگر یا session قدیمی است.

  • مرورگر را ببندید و کش را پاک کنید، سپس دوباره صفحه را باز کنید.

مرحله ۶: بررسی لاگ‌ها (برای On-Prem)

  • بررسی ULS Logs و Event Viewer می‌تواند خطاهای Backend را مشخص کند.

  • به خصوص برای خطاهای “List does not exist” یا Load Fail.


نکات حرفه‌ای:

  • برای لیست‌های بزرگ، viewهای سفارشی با Indexed Columns بسازید تا Performance بهبود یابد.

  • استفاده از Content Typeها باعث مدیریت بهتر داده‌ها در لیست‌ها می‌شود.

  • همیشه نسخه پشتیبان (Backup) از لیست‌های مهم داشته باشید تا در صورت حذف یا تغییر ناخواسته بازیابی شود.

  • تصاویر مرحله‌ای شامل List Settings → Permissions و View Settings باعث جذابیت مقاله و ارتقاء SEO می‌شوند.

۶. مشکلات فرم‌ها و Power Apps در شیرپوینت (Forms & Power Apps Issues)

معرفی مشکل:

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

  • فرم‌ها بارگذاری نمی‌شوند یا سفید هستند

  • فرم سفارشی Power Apps داده‌ها را Submit نمی‌کند

  • Validation یا خطای ورودی در فرم‌ها نمایش داده می‌شود

  • Web Part فرم یا Embedded Form کار نمی‌کند

این مشکلات هم در SharePoint On-Prem (با InfoPath یا Power Apps در نسخه‌های جدید) و هم در SharePoint Online رخ می‌دهند.


دلایل رایج:

  1. دسترسی ناکافی به لیست یا کتابخانه:

    • کاربر سطح دسترسی لازم برای ایجاد/ویرایش آیتم‌ها ندارد.

  2. خطای Connection در Power Apps:

    • اتصال به لیست شیرپوینت یا Data Source قطع یا نادرست است.

  3. خطاهای Validation یا Rules فرم:

    • فرمول‌های Power Apps ممکن است اشتباه یا ناسازگار باشند.

  4. بارگذاری ناقص Script یا Web Part:

    • در صفحات مدرن Script Editor یا Embed Web Part ممکن است محدودیت داشته باشند.

  5. مشکل مرورگر یا کش:

    • گاهی فرم‌ها به دلیل مرورگر قدیمی یا Cache کار نمی‌کنند.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی دسترسی‌ها

  • اطمینان حاصل کنید کاربر حداقل سطح Contribute روی لیست یا کتابخانه دارد.

  • بررسی Permissions در List Settings → Permissions for this list.

مرحله ۲: بررسی اتصال (Connection) در Power Apps

  • وارد Power Apps Studio شوید.

  • Data Source مربوطه (لیست شیرپوینت) را بررسی و Refresh کنید.

  • مطمئن شوید که Account شما و کاربران دسترسی لازم دارند.

مرحله ۳: بررسی Validation و Rules

  • فرمول‌ها، Default Valueها و Validation Rules را چک کنید.

  • از Test Form استفاده کنید و خطاهای Submit را بررسی کنید.

مرحله ۴: بررسی Script/Web Part

  • اگر فرم Embedded یا در Script Editor است، اطمینان حاصل کنید فایل‌ها به درستی لود شده‌اند.

  • در Modern Pages از Embed Web Part یا SPFx استفاده کنید.

مرحله ۵: پاک کردن کش مرورگر

  • Cache و Session مرورگر را پاک کنید و دوباره فرم را باز کنید.

  • تست فرم در مرورگر دیگر نیز مفید است.

مرحله ۶: بررسی خطاهای مرورگر و Console

  • کلید F12 و بخش Console برای شناسایی خطاهای JS یا Connection مفید است.

  • Errorهای Power Apps معمولاً کد خطا و توضیح کوتاه دارند که کمک به حل مشکل می‌کند.


نکات حرفه‌ای:

  • فرم‌های Power Apps همیشه در محیط Test قبل از انتشار تست شوند.

  • استفاده از Patch و SubmitForm به جای Manual Update بهتر و امن‌تر است.

  • برای فرم‌های حساس، همزمان از SharePoint Permissions و Data Loss Prevention (DLP) استفاده کنید.

  • اضافه کردن تصاویر مرحله‌ای از Power Apps Studio → Data Source → Validation باعث جذابیت مقاله و ارتقاء SEO می‌شود.

۷. مشکلات اتوماسیون با Power Automate (Flow Issues in SharePoint)

معرفی مشکل:

کاربران هنگام ساخت یا اجرای Flow در Power Automate ممکن است با مشکلات زیر مواجه شوند:

  • Flow اجرا نمی‌شود یا Failed می‌شود

  • Trigger اجرا نمی‌شود (مثلاً وقتی آیتم ایجاد یا ویرایش می‌شود)

  • خطای Connection یا Permission نمایش داده می‌شود

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

این مشکلات در SharePoint On-Prem (با Gateway) و SharePoint Online شایع هستند.


دلایل رایج:

  1. اتصال (Connection) نادرست یا منقضی شده:

    • Account مورد استفاده در Flow دسترسی لازم ندارد یا Connection Expired شده است.

  2. دسترسی ناکافی به لیست/کتابخانه:

    • کاربر یا Service Account که Flow اجرا می‌کند، سطح دسترسی کافی ندارد.

  3. Trigger اشتباه یا شرط نادرست:

    • Flow بر اساس Trigger اشتباه تنظیم شده یا Condition اشتباه دارد.

  4. محدودیت‌ها و Timeout:

    • Flowهای بزرگ یا طولانی ممکن است Fail شوند.

  5. مشکلات Gateway (برای On-Prem):

    • اگر شیرپوینت On-Prem است، Data Gateway به درستی نصب یا کانفیگ نشده باشد.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی اتصال (Connection)

  • در Power Automate، به Data → Connections بروید.

  • Connection مربوط به SharePoint را بررسی کنید و در صورت نیاز Refresh یا Reconnect کنید.

  • مطمئن شوید Account اتصال، دسترسی Contribute یا بالاتر دارد.

مرحله ۲: بررسی دسترسی‌ها

  • کاربر یا Service Account باید به لیست/کتابخانه دسترسی داشته باشد.

  • Permissions را در List Settings → Permissions بررسی و اصلاح کنید.

مرحله ۳: بررسی Trigger

  • مطمئن شوید Trigger انتخابی مناسب است:

    • When an item is created برای اضافه کردن آیتم

    • When an item is created or modified برای آپدیت

  • Conditions یا Filters داخل Trigger را بررسی کنید تا داده‌ها درست فیلتر شوند.

مرحله ۴: بررسی خطاهای اجرا

  • در Power Automate به My Flows → Run History بروید.

  • Flowهای Failed را باز کنید و Error Details را بررسی کنید.

  • اکثر خطاها شامل کد و توضیح کوتاه هستند که به رفع مشکل کمک می‌کند.

مرحله ۵: بررسی محدودیت‌ها

  • برای Flowهای پیچیده یا با تعداد زیاد آیتم، از Scope یا Parallel Branch استفاده کنید.

  • Flow طولانی ممکن است Timeout شود؛ در صورت نیاز آن را به بخش‌های کوچکتر تقسیم کنید.

مرحله ۶: بررسی Gateway (برای On-Prem)

  • مطمئن شوید Data Gateway نصب و فعال است.

  • Connection به سایت On-Prem تست شود و Gateway در وضعیت Online باشد.


نکات حرفه‌ای:

  • همیشه قبل از انتشار Flow، در محیط Test اجرا کنید.

  • از Run History و Peek Code برای تحلیل دقیق مشکلات استفاده کنید.

  • در On-Prem، Gateway باید آخرین نسخه باشد و سرویس‌های مربوطه فعال باشند.

۸. مشکلات Performance و سرعت سایت در شیرپوینت (Site Performance Issues)

معرفی مشکل:

یکی از چالش‌های رایج کاربران، کندی صفحات شیرپوینت یا طولانی بودن زمان بارگذاری است.
مثال‌ها:

  • صفحات مدتی طول می‌کشند تا باز شوند

  • Web Partها دیر لود می‌شوند

  • کاربرانی که لیست‌های بزرگ دارند، هنگام باز کردن Viewها با تاخیر مواجه می‌شوند

این مشکل هم در SharePoint On-Prem 2013/2016/2019 و هم در SharePoint Online دیده می‌شود.


دلایل رایج:

  1. لیست‌های بزرگ (Large Lists) و List View Threshold

    • بیش از 5000 آیتم در یک لیست باعث کاهش سرعت می‌شود.

  2. Web Partهای سنگین یا Script زیاد

    • استفاده از JS یا Web Partهای پیچیده باعث طولانی شدن Load Time می‌شود.

  3. تصاویر بزرگ یا Media بدون بهینه‌سازی

    • تصاویر با حجم بالا باعث کند شدن صفحه می‌شوند.

  4. شبکه یا مرورگر کند

    • سرعت اینترنت یا مرورگر قدیمی می‌تواند Performance را کاهش دهد.

  5. Caching و Query ناکافی

    • عدم استفاده از Cache مناسب یا Query بهینه باعث Load کند می‌شود.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بهینه‌سازی لیست‌ها

  • برای لیست‌های بزرگ:

    • استفاده از Indexed Columns و Filtered Views

    • استفاده از Folders برای تقسیم داده‌ها

  • جلوگیری از نمایش تمام آیتم‌ها در یک View

مرحله ۲: بهینه‌سازی Web Part و Script

  • Web Partهای سنگین را بازبینی کنید و JS غیرضروری را حذف کنید.

  • استفاده از SPFx یا Embed Web Part مدرن به جای Script Editor در صفحات مدرن پیشنهاد می‌شود.

مرحله ۳: بهینه‌سازی تصاویر و Media

  • تصاویر را قبل از آپلود فشرده کنید.

  • از فرمت‌های WebP یا JPEG با حجم پایین استفاده کنید.

  • برای ویدئوها، از Stream یا لینک خارجی به جای آپلود مستقیم در سایت استفاده کنید.

مرحله ۴: بهبود Cache و Query

  • استفاده از Output Cache در On-Prem

  • بررسی و بهینه‌سازی Query در Content Search Web Part یا Highlighted Content

  • کاهش درخواست‌های غیرضروری به سرور

مرحله ۵: بررسی شبکه و مرورگر

  • مرورگرهای مدرن (Chrome, Edge, Firefox) را استفاده کنید.

  • بررسی سرعت اینترنت و Latency شبکه


نکات حرفه‌ای:

  • برای صفحات با Web Partهای متعدد، Load Order و Async Loading را رعایت کنید.

  • استفاده از CDN برای JS و CSS باعث کاهش Load Time می‌شود.

  • مانیتورینگ Performance با ULS Logs (On-Prem) و Page Diagnostics Tool (Online) به شناسایی گلوگاه‌ها کمک می‌کند.

  • اضافه کردن تصویر مراحل بهینه‌سازی و نمودار Performance باعث جذابیت مقاله و SEO بهتر می‌شود.

۹. مشکلات Mobile & Responsive در شیرپوینت (Mobile & Responsive Issues)

معرفی مشکل:

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

  • صفحات سایت در موبایل به درستی نمایش داده نمی‌شوند

  • Web Partها یا فرم‌ها بهم ریخته هستند

  • فونت‌ها، تصاویر یا جدول‌ها درست ریسپانسیو نیستند

  • Navigation یا منوها در موبایل قابل استفاده نیستند

این مشکل هم در On-Prem و هم در Online رایج است.


دلایل رایج:

  1. صفحات Classic یا قدیمی

    • صفحات Classic به صورت پیش‌فرض ریسپانسیو نیستند.

  2. Web Partها و Scriptهای غیرمدرن

    • بعضی Web Partها و JS سفارشی در Mobile به درستی کار نمی‌کنند.

  3. تصاویر و جدول‌های بزرگ

    • اندازه ثابت تصاویر و ستون‌های جدول باعث بهم ریختگی در موبایل می‌شود.

  4. CSS سفارشی یا Theme ناسازگار

    • قوانین CSS قدیمی می‌توانند Layout موبایل را خراب کنند.

  5. Navigation و Mega Menu قدیمی

    • منوها برای صفحه کوچک بهینه نشده‌اند و استفاده از موبایل را سخت می‌کنند.


راه‌حل‌های مرحله‌ای:

مرحله ۱: استفاده از صفحات Modern

  • در SharePoint Online یا On-Prem 2019، از Modern Pages استفاده کنید.

  • صفحات Modern به صورت پیش‌فرض ریسپانسیو هستند و Mobile Friendly هستند.

مرحله ۲: بازبینی Web Partها و Scriptها

  • Web Partهای قدیمی یا Script Editor را با Embed Web Part یا SPFx Web Part مدرن جایگزین کنید.

  • از Web Partهایی استفاده کنید که Mobile Friendly هستند، مانند Highlighted Content یا List Web Part مدرن.

مرحله ۳: بهینه‌سازی تصاویر و جداول

  • تصاویر را با CSS به صورت max-width: 100% تنظیم کنید.

  • جداول را با overflow-x: auto یا Breakpoint مناسب Mobile نمایش دهید.

مرحله ۴: بررسی CSS سفارشی

  • مطمئن شوید قوانین CSS باعث Overlap یا Break Layout نمی‌شوند.

  • از Media Query برای صفحات موبایل استفاده کنید.

  • تست تغییرات CSS در موبایل و Desktop حتما انجام شود.

مرحله ۵: Navigation و Menu

  • از Mega Menu مدرن استفاده کنید که در موبایل Collapse می‌شود.

  • بررسی کنید که لینک‌ها در حالت موبایل قابل لمس و استفاده باشند.


نکات حرفه‌ای:

  • همیشه قبل از انتشار، Mobile Preview صفحات را در SharePoint بررسی کنید.

  • استفاده از SPFx Responsive Components باعث سازگاری کامل با موبایل می‌شود.

  • CSS سفارشی را به صورت Modular و با Media Query برای دستگاه‌های مختلف بنویسید.

۱۰. مشکلات بروز رسانی و Patch در شیرپوینت (Update & Patch Issues)

معرفی مشکل:

یکی از رایج‌ترین مشکلات در شیرپوینت، اختلالات و خطاهای بعد از نصب Patch یا Service Pack است.
مثال‌ها:

  • Featureهای فعال کار نمی‌کنند یا غیرفعال شده‌اند

  • وب‌پارت‌ها یا فرم‌ها به درستی نمایش داده نمی‌شوند

  • خطاهای ناشناخته در سایت یا Central Administration ظاهر می‌شوند

  • برخی Workflowها یا Flowها بعد از Patch Fail می‌شوند

این مشکل در On-Prem 2013/2016/2019 بیشتر رخ می‌دهد، زیرا Online توسط Microsoft مدیریت و خودکار Patch می‌شود.


دلایل رایج:

  1. Patch ناقص یا نصب اشتباه

    • ممکن است برخی فایل‌ها یا DLLها به درستی آپدیت نشده باشند.

  2. عدم هماهنگی با Custom Solutions

    • Web Partها، Scriptها یا فرم‌های سفارشی با نسخه جدید سازگار نیستند.

  3. Feature Activation مشکل‌دار

    • Featureهای فعال بعد از Patch نیاز به Reactivation دارند.

  4. Cache یا IIS قدیمی

    • Browser Cache یا Application Pool در IIS نیاز به ریست دارد.

  5. Dependencyهای خارجی

    • بعضی Patchها نیاز به آپدیت SQL Server یا .NET Framework دارند.


راه‌حل‌های مرحله‌ای:

مرحله ۱: بررسی Status Patch

  • در Central Administration → Upgrade and Migration → Check Product and Patch Installation Status بررسی کنید که Patch به درستی نصب شده باشد.

  • مطمئن شوید تمام سرورها در فارم هماهنگ هستند.

مرحله ۲: فعال/غیرفعال کردن Featureها

  • برخی Featureها بعد از Patch نیاز به Re-Activation دارند:

    • به Site Settings → Manage Site Features بروید و Featureهای مشکل‌دار را غیرفعال و دوباره فعال کنید.

مرحله ۳: بررسی Custom Solutions

  • هر Web Part یا Script سفارشی را بررسی کنید.

  • نسخه‌ها یا DLLهای مورد نیاز باید با Patch جدید سازگار باشند.

مرحله ۴: پاک کردن Cache و ریست IIS

  • Browser Cache را پاک کنید.

  • Application Pool مربوط به سایت را در IIS Recycle کنید.

مرحله ۵: بررسی Dependencyهای خارجی

  • اطمینان حاصل کنید SQL Server، .NET Framework یا دیگر پیش‌نیازها با نسخه Patch سازگار هستند.

  • اگر لازم بود، Patchهای مربوطه را روی پیش‌نیازها نصب کنید.

مرحله ۶: بررسی لاگ‌ها

  • ULS Logs و Event Viewer را بررسی کنید تا خطاهای دقیق پس از Patch شناسایی شود.

  • خطاهای رایج: “Feature not activated” یا “Web Part Load Failed”.


نکات حرفه‌ای:

  • همیشه قبل از نصب Patch، از محیط شیرپوینت Backup کامل تهیه کنید.

  • ابتدا Patch را روی Test Environment نصب و تست کنید.

  • بعد از Patch، تمامی صفحات اصلی، Web Partها و Workflowها را تست کنید.

  • مستندسازی مراحل نصب و مشکلات بعد از Patch باعث کاهش خطا در آینده می‌شود.

  • اضافه کردن تصاویر مراحل نصب Patch و بررسی Featureها باعث جذابیت مقاله و بهبود SEO می‌شود.

💡 SEO Tip:

  • کلیدواژه‌ها: “مشکل بعد از Patch شیرپوینت”، “Feature کار نمی‌کند بعد از Service Pack”، “رفع خطای Update شیرپوینت”.

اشتراک گذاری :

    نوشتن دیدگاه

    نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

      نوشتن دیدگاه

      نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *