ONLYOFFICE 10.0 للمطورين: ما الجديد

ONLYOFFICE 10.0 يقدّم مجموعة متينة من التحديثات للمطورين الذين يبنون حلولهم فوق المحررات. ستحصلون على نقاط نهاية جديدة تبسّط التعامل مع الملفات، وتحرير ملفات PDF في Document Builder، وواجهة برمجة تطبيقات حديثة للإضافات مع طرق غير متزامنة. كما يضيف الإصدار عناصر تحكم جديدة لميزات الذكاء الاصطناعي وإعدادات افتراضية أكثر أمانًا في الخادم.

فيما يلي جولة سريعة في أهم التغييرات التي تخص عمليات التكامل لديكم، إضافة إلى بعض التغييرات في السلوك التي ينبغي مراجعتها قبل الترقية.

أدوات الذكاء الاصطناعي، وخيارات تخصيص الذكاء الاصطناعي، وإدارة الذكاء الاصطناعي من جانب الخادم

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

في الإصدارات التجارية من ONLYOFFICE Docs 10.0، يمكن للمسؤولين إعداد مزوّدي الذكاء الاصطناعي مرة واحدة في لوحة الإدارة. وبعد الإعداد، يحصل مستخدمو المحررات على أدوات ذكاء اصطناعي جاهزة للاستخدام دون الحاجة إلى إدخال مفاتيح API الخاصة بهم. يمكن للمسؤولين تعيين نماذج مختلفة لمهام محددة، وربط خوادم MCP للوصول إلى الأدوات الخارجية، والتحكم في إتاحة البحث على الويب. وبمجرد حفظ إعداد من جانب الخادم، يقتصر المستخدمون على المزوّدين والنماذج المعتمدة – ولا يمكنهم بعد ذلك إضافة مفاتيحهم الخاصة أو تغيير النموذج المستخدم. اعرفوا المزيد

أنتم من يقرر ظهور أدوات الذكاء الاصطناعي في منتجكم. يوفر الإصدار 10.0 مستويين من التحكم:

• لكل نسخة محرر: استخدموا editorConfig.customization.ai مع المعامل disabled لإخفاء ميزات الذكاء الاصطناعي في إعداد محرر محدد.
• على مستوى الخادم: استخدموا إعداد الخادم aiSettings.enable لإيقاف ميزات الذكاء الاصطناعي واستبعاد أدوات الذكاء الاصطناعي من /plugins.json.

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

التطبيقات المعيارية

يقدّم ONLYOFFICE Docs 10.0 التطبيقات المعيارية – وهي طريقة جديدة لتوسيع المحررات دون تغيير نواتها. تتصل تطبيقات مثل وكلاء الذكاء الاصطناعي والنماذج والغرف والملفات بـ ONLYOFFICE Docs وتضيف وظائف جديدة فوقه.

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

تحسينات الأمان والبنية

ينقل الإصدار 10.0 عدة حمايات إلى وضع “مفعّلة افتراضيًا”، لتبدأ عمليات التكامل الجديدة من أساس أكثر أمانًا.

• JWT مفعّل افتراضيًا. أصبح JWT مفعّلًا الآن في default.json.
• معالجة أكثر صرامة للرموز. إذا كان السر فارغًا أو غير معيّن، بما في ذلك أسرار المستأجرين، فإن ONLYOFFICE Docs يرفض الرمز الآن بدلًا من التحقق منه أو توقيعه.
• رموز محددة النطاق لواجهات الخدمات. لم تعد /converter و/docbuilder و/command تقبل رمزًا من إعداد المحرر. الحقل الجديد operation في الرمز اختياري لهذه الطلبات، وإلزامي لكل من /converter/from-file و/docbuilder/from-file.
• التحقق من سلامة الملفات التي يتم تنزيلها. عندما يرسل تكاملكم ترويسات السلامة، يتحقق الخادم من الملفات التي يتم تنزيلها مقابلها. تشمل الترويسات المدعومة Content-Digest وRepr-Digest وx-amz-checksum-* وWOPI SHA256. يتحكم في ذلك الإعداد services.CoAuthoring.requestDefaults.checksumVerification، وقيمته true افتراضيًا.
• مضيفو WOPI الصريحون. يجب الآن السماح بمضيفي WOPI عبر قاعدة مرشح IP. لم تعد قاعدة الحرف البدل allow: * كافية، لذا حدّدوا كل مضيف بشكل صريح.
• ضوابط الوصول إلى واجهات API. استخدموا services.CoAuthoring.server.convertServiceEnable وservices.CoAuthoring.server.docbuilderEnable لإيقاف واجهات التحويل وDocument Builder العامة. قيمة كل منهما true افتراضيًا.
• إعدادات تشغيل أكثر إحكامًا. لا يمكن الآن تغيير سوى مستوى التسجيل في log4js عبر runtime.json.

نظرة فاحصة على أحدث إصلاحات الأمان

تحرير ملفات PDF في Document Builder

يمكن الآن لـ Document Builder تحرير ملفات PDF، مما يفتح الباب أمام العديد من سيناريوهات الأتمتة الجديدة:

• OpenFile يتعامل مع ملفات PDF بذكاء. تُفتح نماذج PDF التي أُنشئت في ONLYOFFICE في محرر المستندات. أما ملفات PDF الأخرى فتُفتح في محرر ملفات PDF مع وصول كامل إلى PDF API.
• ملفات PDF المحمية بكلمة مرور. يتيح لكم المعامل الجديد m_sPassword في OpenFile فتح الملفات المحمية.
• إنشاء نماذج PDF. استدعوا CreateFile مع النوع pdf لإنشاء نماذج PDF.

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

ألكسندر تروفيموف، رئيس فريق تطوير المحررات في ONLYOFFICE:

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

تحديثات النشر والإدارة

أصبح تشغيل ONLYOFFICE Docs في بيئة الإنتاج أسهل أيضًا:

• لوحة الإدارة تبدأ مع الخادم. في الإصدارات التجارية، تعمل لوحة الإدارة الآن تلقائيًا بشكل افتراضي. كما تتضمن كتلًا لعرض سر JWT وأزرارًا لفتح المثال التجريبي وتشغيله أو إيقافه.
• إنشاء المسؤول عبر سطر الأوامر. تنشئون الآن أول مسؤول عبر واجهة سطر الأوامر documentserver-admin على المضيف، باستخدام create-admin وreset-admin-password. وهذا يحل محل صفحة الويب القديمة التي كانت تعتمد على سجلات التهيئة.
• استرداد تلقائي للتغييرات غير المحفوظة. إذا تم إيقاف تشغيل الخادم، تُسترد التغييرات غير المحفوظة تلقائيًا إلى “الملفات المنسية”. وقد أُزيل البرنامج النصي المنفصل changes2forgotten.
• منفذ افتراضي جديد. تستخدم عمليات تثبيت DEB وRPM الآن المنفذ 8083 افتراضيًا. حدّثوا قواعد الوكيل وجدار الحماية لديكم عند الحاجة.
• مراقبة أفضل. يتضمن المقياس الجديد coauth.connections وسمي mode (edit وliveview وview) وreplica.
• خيار تحديث Desktop Editors. على نظام Windows، يتيح خيار سطر الأوامر --prefer-alternate-url لـ Desktop Editors تنزيل التحديثات من مصدر بديل.
• صفحة ترحيب محدّثة. أصبح لصفحة الترحيب في الخادم تصميم جديد.

دعم صيغ ملفات جديدة

يضيف الإصدار 10.0 تحديثين في الصيغ يساعدانكم على التعامل مع مستندات أكثر بجهد مخصص أقل:

• عرض OFD وتحويله. يمكنكم فتح ملفات ofd وتحويلها. وكما هو الحال مع xps، تُفتح في وضع العرض فقط.
• التحويل إلى XLS. يمكنكم تحويل أي صيغة جداول بيانات إلى صيغة xls الكلاسيكية. وهذا مفيد عندما لا يزال مستخدموكم أو شركاؤكم يعتمدون على أنظمة قديمة.

نقاط نهاية متعددة الأجزاء لرفع الملفات مباشرة

حتى الآن، كانت خدمتا التحويل وDocument Builder تنزّلان الملفات المصدر من عنوان URL. وهذا يعني أنه كان عليكم استضافة الملف في مكان يمكن للخادم الوصول إليه. يضيف الإصدار 10.0 نقطتي نهاية جديدتين تلغيان هذه الخطوة:

• POST /converter/from-file
• POST /docbuilder/from-file

كلتاهما تقبل البيانات بصيغة multipart/form-data. يمكنكم إرسال ملف أو برنامج نصي مباشرة في الطلب، فلا حاجة إلى إتاحته عبر عنوان URL مؤقت.

وهذا خيار أنظف للعديد من مسارات العمل. فعلى سبيل المثال، يمكن لخدمة خلفية تحويل الملفات المرفوعة من المستخدمين أثناء التشغيل، أو تنفيذ برنامج نصي لـ Document Builder دون تجهيز الملفات مسبقًا.

مثال على الطلب: تحويل TXT إلى DOCX

curl -f -X POST "https://documentserver/converter/from-file" \
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Example Document Title.txt"}' \
  -F 'file=@example.txt' \
  -o "Example Document Title.docx"

تحديث واجهة برمجة تطبيقات الإضافات

شهدت واجهة برمجة تطبيقات الإضافات والماكرو أكبر تحديث لها منذ فترة.

كائن Editor عام جديد

تُستدعى الطرق الآن كدوال عادية تُرجع Promise. فبدلًا من تمرير كل استدعاء عبر window.Asc.plugin.executeMethod، يمكنكم كتابة شيفرة غير متزامنة نظيفة:

const text = await Editor.GetSelectedText();

والنتيجة شيفرة أقصر وأسهل قراءة تتناسب بشكل طبيعي مع مشاريع JavaScript الحديثة.

طرق وأحداث جديدة

يضيف الإصدار 10.0 أيضًا أدوات جديدة لبناء إضافات أكثر ثراءً:

• الطرق: Editor.RunMacro وGetRestrictions وSetButtonDisabled وGetOFormRole
• الأحداث: onFloatActionButtonClick وonSelectionEnd وonSelectionCancel

على سبيل المثال، تتيح أحداث التحديد لإضافتكم التفاعل لحظة انتهاء المستخدم من التحديد أو إلغائه.

اطلعوا على القائمة الكاملة للتغييرات في واجهة برمجة تطبيقات الإضافات

ابدأوا البناء مع ONLYOFFICE 10.0

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

• راجعوا التغييرات في السلوك. تحققوا من استخدام الرموز، وقواعد مرشح IP الخاصة بـ WOPI، والمنفذ الافتراضي الجديد.
• حدّثوا إضافاتكم. انتقلوا إلى كائن Editor العام واستبدلوا أي طرق أُعيدت تسميتها أو أُزيلت.
• جرّبوا نقاط النهاية الجديدة. اختبروا /converter/from-file و/docbuilder/from-file في مسارات التحويل لديكم.
• قرروا بشأن الذكاء الاصطناعي. اضبطوا editorConfig.customization.ai أو aiSettings.enable بما يناسب احتياجات منتجكم.

تنزيل إصدارات المطورين

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

اطلعوا على سجل التغييرات الكامل لمعرفة كل التفاصيل، وشاركونا ملاحظاتكم على منتدى مجتمع ONLYOFFICE. نتطلع إلى رؤية ما ستبنونه!