تحديثات ONLYOFFICE API: ما الجديد في ديسمبر 2025

تجلب نهاية العام موجة هائلة من التحديثات لـ ONLYOFFICE API. وصل الإصدار 9.2 من ONLYOFFICE Docs، ومعه يأتي توسع كبير في Office JavaScript API الخاص بنا، وقدرات جديدة للإضافات ووحدات الماكرو، وتحسينات أساسية في الوثائق.

بالنسبة للمطورين الذين يبنون اعتماداً على ONLYOFFICE، توفر هذه التحديثات تحكماً أكثر دقة في عناصر المستند، ومعالجة محسّنة للنماذج، وأدوات تكامل أفضل. سواء كنتم تقومون بأتمتة إنشاء المستندات، أو بناء إضافات معقدة، أو دمج DocSpace، فإن هذا الإصدار يحتوي على شيء لكم. دعونا نتعمق في التفاصيل الفنية.

Office JavaScript API: تحكم موسع

تلقى Office JavaScript API عدداً كبيراً من الطرق الجديدة عبر المجموعة.

معالجة محسّنة للنماذج

أصبح العمل مع النماذج برمجياً أكثر قوة الآن. لقد قدمنا طرقاً جديدة للتعامل مع عناصر النموذج بدقة.

طرق CheckBoxForm. يمكنكم الآن إدارة التسميات ديناميكياً لخانات الاختيار في كل من Form API و Text Document API:

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

إدارة دورة الحياة والمعرفات. لقد قمنا بتوحيد كيفية تفاعلكم مع كائنات النموذج. تمت إضافة طرق Delete و GetInternalId جديدة لكل نوع من أنواع النماذج تقريباً في كل من Form API و Text Document API. يشمل ذلك:

• ApiCheckBoxForm
• ApiComboBoxForm
• ApiComplexForm
• ApiDateForm
• ApiFormBase
• ApiPictureForm
• ApiTextForm

يسمح هذا التحكم الدقيق ببرمجة أنظف عند إدارة النماذج الديناميكية، مما يتيح لكم إزالة العناصر أو الإشارة إليها بواسطة المعرفات الداخلية برمجياً.

طرق الفقرة لواجهات برمجة تطبيقات العروض التقديمية وجداول البيانات

واحدة من أكبر الإضافات في هذا التحديث هي توسيع طرق ApiParagraph لتشمل Presentation API و Spreadsheet API. سابقاً، كانت المعالجة العميقة للفقرات هي مجال Text Document API بشكل أساسي. الآن، يمكنكم تطبيق تنسيق النص المنسق والتغييرات الهيكلية مباشرة داخل الشرائح وأوراق العمل.

• الهيكل: InsertParagraph, Push, Last, GetLastRunWithText.
• التنسيق: SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• النمط: SetColor, SetFontSize, SetFontFamily, SetSpacing.
• الخصائص: GetFontNames, SetTextPr.
• البيانات: ToJSON, GetInternalId.

يوحد هذا تجربة المطور عبر المحررات، مما يجعل التعليمات البرمجية الخاصة بكم قابلة لإعادة الاستخدام بشكل أكبر سواء كنتم تقومون بإنشاء تقرير في مستند أو تنسيق مربع نص في مجموعة شرائح.

مساعدو تحويل الوحدات

غالباً ما تتطلب معالجة القياسات في Office Open XML التحويل بين الوحدات المترية الإنجليزية (EMUs) والوحدات القياسية. لقد أضفنا طرقاً مساعدة إلى Presentation API و Spreadsheet API و Text Document API لتبسيط ذلك:

• Api/EmusToMillimeters
• Api/MillimetersToEmus

التنقل والوصول إلى المحتوى

بالنسبة لـ Text Document API، قمنا بتحسين حركة المؤشر وإدراج المحتوى، وهو أمر بالغ الأهمية لوحدات الماكرو التي تقوم بأتمتة الكتابة أو التحرير:

• ApiDocument/MoveCursorDown, MoveCursorLeft, MoveCursorRight, MoveCursorUp
• ApiDocument/EnterText
• ApiDocument/InsertParagraphBreak

بالإضافة إلى ذلك، أصبح الوصول إلى المحتوى داخل العروض التقديمية وجداول البيانات أسهل مع طرق ApiDocumentContent الجديدة مثل GetAllParagraphs و GetCurrentParagraph و GetText.

تحققوا من القائمة الكاملة للطرق الجديدة

إضافات لـ Docs: تجربة تطوير أفضل

إن بناء الإضافات يتعلق بأكثر من مجرد التعليمات البرمجية؛ إنه يتعلق بتجربة المطور وواجهة المستخدم النهائية.

دروس تصحيح الأخطاء

لقد أضفنا قسماً فرعياً جديداً لتصحيح الأخطاء إلى دروسنا التعليمية لكل من محررات الويب و محررات الحاسوب. ستساعدكم هذه الأدلة في استكشاف أخطاء إضافاتكم وإصلاحها بشكل أسرع وأكثر فعالية.

اتساق واجهة المستخدم

• الأيقونات: قمنا بتحديث صفحة الأيقونات الخاصة بالإضافة بأفضل الممارسات. تعد إضافة الأيقونات خطوة صغيرة تعمل على تحسين قابلية الاستخدام بشكل كبير وتجعل واجهتكم بديهية.
• السمات: تشرح صفحة “كيفية تخصيص السمات” الجديدة كيف يمكن للإضافة الخاصة بكم اكتشاف سمة المحرر الحالية والتفاعل وفقاً لذلك. يضمن هذا أن تبدو إضافتكم أصلية، سواء كان المستخدم في الوضع الداكن أو الوضع الفاتح.

استكشاف أخطاء التوطين وإصلاحها

أضفنا قسماً لـ استكشاف الأخطاء وإصلاحها في صفحة التوطين لمساعدتكم في حل المشكلات الشائعة عند ترجمة إضافاتكم لجمهور عالمي.

تحديثات DocSpace SDK

للمطورين الذين يقومون بدمج منصة التعاون القائمة على الغرف DocSpace، تم تحديث JavaScript SDK. تمت إعادة هيكلة بنية الوثائق ويتم إنشاؤها الآن تلقائياً باستخدام ملفات مباشرة من DocSpace، مما يضمن أن المرجع الذي تقرؤونه متزامن دائماً مع الكود الفعلي.

تحسينات موقع وثائق API

نحن نعمل باستمرار على تحسين موقع وثائق API لجعله أسرع وأسهل في الاستخدام.

• المحرك: قمنا بتحديث Docusaurus إلى الإصدار 3.9.2.
• وضع سمة النظام: يدعم موقع الوثائق الآن اكتشاف سمة النظام، مع احترام تفضيلات نظام التشغيل الخاص بكم للوضع الداكن أو الفاتح.
• سهولة الاستخدام والتوطين: لقد قمنا بإعادة تصميم صفحة بدء الوثائق وتحسين الوثائق الصينية، بما في ذلك قسم Desktop Editors المترجم بالكامل.

انضموا إلى ندوات مجانية عبر الإنترنت للمطورين

استعدوا للتعمق في أدوات المطورين لدينا! نحن نطلق ندوات عبر الإنترنت لنوضح لكم كيفية تعظيم إمكانات ONLYOFFICE. انضموا إلينا في أوائل عام 2026 لحضور جلسات حول أدوات التكامل وخادم DocSpace MCP. احجزوا مكانكم الآن!

سجلوا الآن