پنج کد خطای رایج Office API و معنی آن‌ها
به گزارش اپ خونه، وقتی می‌گوییم «رایج»، منظورمان کدهای خطایی است که ممکن است هنگام کار با مدل “Common API” با آن‌ها مواجه شوید. این کدها کدهای خطای مختص یک اپلیکیشن خاص نیستند، مانند کدهای خطایی که هنگام کار با Word JavaScript API ممکن است ببینید. در اینجا به چند نمونه‌ای که باید به آن‌ها توجه کنید، اشاره می‌کنیم:
کد ۱ – Error.code 1000
این خطا به شما می‌گوید که یک نوع تبدیل نامعتبر (coercion type) در جایی از کد شما وجود دارد. مثال واضح این موضوع در Excel است. اکسل از انواع تبدیل HTML یا OOXML پشتیبانی نمی‌کند، بنابراین اگر بخواهید آن را مجبور به این تبدیل کنید، این کد خطا را مشاهده خواهید کرد.
اگر نمی‌دانید، تبدیل نوع (type coercion) فرآیندی است که اپلیکیشن‌ها برای تبدیل یک نوع داده به نوع دیگر دنبال می‌کنند. اگر در این تبدیل تضادی وجود داشته باشد، احتمالاً این کد خطا را خواهید دید.
کد ۲ – Error.code 2009
این خطا به راحتی قابل شناسایی است چون با عناصر داده (data objects) سروکار دارد. هرچه این عناصر بزرگ‌تر شوند، احتمال اینکه یکی از آن‌ها از محدودیت‌های داده‌ای که در اپلیکیشن آفیس خود تعریف کرده‌اید فراتر رود، بیشتر می‌شود. اگر این کد را مشاهده کردید، راه‌حل این است که داده‌ای که باعث مشکل شده را کوچک‌تر کنید.
کد ۳ – Error.code 4000
هر برنامه‌نویسی می‌تواند به شما بگوید که نام‌گذاری صحیح عناصر کلید اجرای درست برنامه است. اگر این کار را انجام ندهید، احتمالاً با Error.code 4000 مواجه خواهید شد. این کد زمانی ظاهر می‌شود که نامی را مشخص کنید که در هیچ‌جای کد API شما وجود ندارد.
کد ۴ – Error.code 5002
این پیامی است که با این کد خطا دریافت می‌کنید. این خطا به شما می‌گوید که شما به‌عنوان توسعه‌دهنده راه‌حل (solution developer) در حال تلاش برای انجام عملیاتی هستید که سند مربوطه اجازه‌های لازم را برای آن نمی‌دهد. این خطا را بیشتر زمانی می‌بینید که از اسنادی استفاده می‌کنید که ویرایش در آن‌ها محدود شده است.
کد ۵ – Error.code 9021
خطاهای ارتباطی رخ می‌دهند. وقتی این خطاها پیش بیایند، قادر نخواهید بود آیتم خود را در سرور ذخیره کنید. کد Error.code 9021 به شما می‌گوید که یک خطای ارتباطی در جایی از تنظیمات شما وجود دارد که باید آن را برطرف کنید. به‌عنوان مثال، مشکلات “Online Mode” هنگام استفاده از Outlook Desktop می‌تواند این خطا را ایجاد کند.
راه‌حل‌های سریع برای کدهای خطای رایج Office API
ما تنها به چند نمونه از رایج‌ترین کدهای خطای Office API که ممکن است در طول دوران توسعه خود با آن‌ها روبرو شوید، اشاره کردیم. هر کدام راه‌حل‌های خاص خود را دارند که شامل پیدا کردن محل اشتباه در کد شما و انجام اقدامات لازم برای رفع آن است. اما دو راه‌حل سریع وجود دارد که می‌توانید برای همه این کدها امتحان کنید:
راه‌حل ۱: تنظیمات فایروال خود را بررسی کنید
فایروال شما ممکن است مانع اجرای اپلیکیشنی شود که سعی در راه‌اندازی آن دارید. خاموش کردن فایروال یا بررسی تنظیمات آن به طوری که برنامه شما مسدود نشود، ممکن است مشکل را حل کند.
مرحله ۱: عبارت “Windows Security” را در نوار جستجوی پایین صفحه تایپ کرده و روی آیکونی با همین نام کلیک کنید.
مرحله ۲: از گزینه‌های سمت چپ، “Firewall & Network Protection” را انتخاب کنید و دامنه‌های مختلف خود را برای مشاهده تنظیمات فایروال بررسی کنید. خاموش کردن دامنه یا شبکه‌های خصوصی شما ممکن است API شما را به کار بیندازد.
مرحله ۳: به جای خاموش کردن فایروال، می‌توانید روی گزینه “Allow an app through firewall” کلیک کنید و به برنامه خود اجازه دهید از فایروال ویندوز عبور کند.
راه‌حل ۲: حالت سازگاری Microsoft Edge را خاموش کنید
اگر خطاهای مربوط به وب با ویژگی‌هایی که تعریف کرده‌اید مواجه شدید، ممکن است حالت سازگاری Microsoft Edge مشکل‌ساز باشد. برای خاموش کردن آن مراحل زیر را دنبال کنید:
مرحله ۱: روی آیکون سه نقطه (“…”) در گوشه بالا-راست Edge کلیک کرده و “Settings” را انتخاب کنید.
مرحله ۲: از نوار ناوبری به تب “Default Browser” بروید.
مرحله ۳: از منوی کشویی کنار گزینه
“Allow sites to be reloaded in Internet Explorer mode IE mode”، گزینه “Don’t Allow” را انتخاب کنید.
