ملخص API للمطورين: ONLYOFFICE Docs 9.1 و DocSpace 3.5

مرحبًا بكم في آخر ملخص لواجهة برمجة التطبيقات (API) لنظام ONLYOFFICE البيئي. مع إصدار ONLYOFFICE Docs 9.1 و DocSpace 3.5، نقدم مجموعة من الميزات والتحسينات الجديدة القوية المصممة لمنح المطورين مزيدًا من التحكم والمرونة والكفاءة.

سيرشدكم هذا المنشور خلال التحديثات الرئيسية، بدءًا من دعم التنسيقات الجديدة وخيارات التخصيص في Docs إلى التحسينات الكبيرة في عدة تطوير البرمجيات (SDK) لـ DocSpace. دعونا نستكشف ما تخبئه هذه الإصدارات الجديدة لمشاريع التطوير الخاصة بكم.

التحديثات في ONLYOFFICE Docs 9.1

يقدم الإصدار 9.1 من ONLYOFFICE Docs مجموعة متنوعة من تحسينات واجهة برمجة التطبيقات (API).

دعم وتحويل التنسيقات الجديدة

لتوسيع توافق المستندات، أضفنا دعمًا لتنسيقات جديدة ووسعنا إمكانيات التحويل:

• فتح ملفات HML؛
• تحويل عروض PPTX التقديمية إلى تنسيق TXT.

التخصيص

نحن نمنحكم مزيدًا من التحكم في شكل وأسلوب المحررات. أصبحت المعلمة editorConfig.customization.uitheme ، التي تحدد سمة المحرر، متاحة الآن لمحررات الهاتف المحمول. يتيح لكم هذا إنشاء تجربة مرئية متسقة عبر جميع المنصات.

لقد قمنا أيضًا بتحديث متطلبات الحجم لـ editorConfig.customization.logo.image. يمكنكم الآن استخدام صورة بأبعاد 300×20 بكسل لعرض شعاركم المخصص في رأس المحرر.

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

تكامل WOPI

بالنسبة لأولئك الذين يستخدمون واجهة منصة تطبيقات الويب المفتوحة (WOPI), فقد قدمنا خاصية UserCanOnlyComment إلى عملية CheckFileInfo. تتيح لكم هذه الخاصية المنطقية (boolean) تحديد ما إذا كان يجب أن يمتلك المستخدم صلاحيات التعليق فقط، مما يقيدهم من إجراء تعديلات أخرى.

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

طريقة جديدة للاضافات

لقد قمنا بتوسيع واجهة برمجة التطبيقات لجداول البيانات والعروض التقديمية باستخدام طريقة RemoveOleObject (للأوراق / للشرائح). يتيح لكم هذا إزالة كائن OLE برمجيًا من مصنف أو عرض تقديمي باستخدام معرفه الداخلي، مما يوفر تحكمًا أكبر في المحتوى المضمن.

expression.RemoveOleObject(internalId);

Office API

يقدم الإصدار 9.1 عددًا كبيرًا من الطرق الجديدة إلى Office JavaScript API. تفتح هذه الإضافات إمكانيات جديدة قوية لمعالجة المستندات برمجيًا، خاصة داخل جداول البيانات. تشمل مجالات التوسع الرئيسية ما يلي:

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

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

تحديث عدة تطوير البرمجيات (SDKs) وأمثلة التكامل

لدعم هذه التحديثات، أصدرنا عدة تطوير برمجيات (SDK) محدثة لـ Java متوافقة مع Docs 9.1. تتضمن دعمًا لتحويل العروض التقديمية الجديدة إلى TXT ومعالجة تنسيق HTML.

لقد قمنا أيضًا بتحديث أمثلة الاختبار الخاصة بنا لتوصيل المحررات، بما في ذلك أمثلة Node.js التي توضح دعم التنسيقات لـ Docs v9.1. تحققوا منها على GitHub

التحديثات في ONLYOFFICE DocSpace 3.5

يقدم DocSpace 3.5 مجموعة متنوعة من التحسينات المصممة لتمكين المطورين، وتتميز بعدة تطوير برمجيات (SDKs) محسّنة و Backend API محدثة.

DocSpace Plugins SDK 2.0.0

تقدم عدة تطوير البرمجيات (SDK) الجديدة للاضافات العديد من التغييرات الرئيسية التي تهدف إلى تحسين الأمان ووظائف مربعات الحوار المشروطة (modal).

• أمان ملفات مُحسَّن: لقد نقلنا إعدادات أمان الملفات إلى تعداد (enum) منفصل باسم FilesSecurity لتنظيم ووضوح أفضل. تتضمن واجهة IFileItem الآن خاصيتي fileSecurity و security.
• مربعات حوار مشروطة مُحسَّنة: يمكنكم الآن إنشاء مربعات حوار مشروطة (modal) مع مزيد من التحكم في مظهرها باستخدام خاصيتي withoutBodyPadding و withoutHeaderMargin. أضفنا أيضًا إجراء updateCreateDialogModal للتحديثات الديناميكية.
• مربعات حوار إنشاء أذكى: تم تحسين واجهة ICreateDialog بخصائص جديدة مثل isAutoFocusOnError، و errorText، و onError، و onChange، و isCloseAfterCreate، و isCreateDisabled، مما يمنحكم تحكمًا أدق في تفاعلات المستخدم والتحقق من صحة النماذج.

You are also welcome to check the updated system plugins based on SDK 2.0.0 in action within DocSpace:

• draw.io
• Markdown
• PDF Converter
• Speech-to-Text

تحديثات DocSpace v3.5 API SDKs

للتوافق مع إصدار DocSpace 3.5، قمنا بتحديث حزم SDK لواجهة برمجة التطبيقات (API SDKs) الخاصة بنا عبر لغات متعددة. توفر حزم SDK هذه طريقة ملائمة للتفاعل مع DocSpace API، وإدارة الملفات، والمستخدمين، والغرف برمجيًا.

تتوفر حزم SDK المحدثة لـ:

• TypeScript: @onlyoffice/docspace-api-sdk على npm
• C#: DocSpace.API.SDK على NuGet
• Python: docspace-api-sdk على PyPI

ابدأوا البناء اليوم

توفر آخر التحديثات لـ ONLYOFFICE Docs و DocSpace مجموعة أدوات أغنى وأقوى للمطورين. بدءًا من التحكم العميق في واجهة برمجة التطبيقات والتخصيص في المحررات إلى عدة تطوير برمجيات (SDK) أكثر قوة لاضافات DocSpace، تم تصميم هذه التحسينات لمساعدتكم على بناء حلول أكثر تكاملاً وغنى بالميزات.

نشجعكم على استكشاف الوثائق المحدثة، وتنزيل أحدث حزم SDK، والبدء في تنفيذ هذه الإمكانيات الجديدة في مشاريعكم. نتطلع لرؤية ما ستبدعونه!

احصلوا على أحدث إصدار من ONLYOFFICE Docs للمطورين:

تنزيل