ملخص واجهة برمجة التطبيقات (API): آخر التحديثات لـ ONLYOFFICE Docs

٢٢ يوليو ٢٠٢٥بواسطة Moncif MEFTAH

من خيارات التخصيص المحدثة إلى حزم تطوير البرمجيات (SDKs) وإنشاء وحدات الماكرو المدعومة بالذكاء الاصطناعي، تم تصميم هذه التحديثات لتعزيز الإنتاجية والإبداع لكل مطور ومتكامل. إليكم تحليل تفصيلي للميزات الجديدة.

API roundup: latest updates for ONLYOFFICE Docs

الجديد في تكامل Docs

لقد طرحنا تحديثات على حزم تطوير البرمجيات (SDKs) لدمج محررات ONLYOFFICE في تطبيقاتكم وخدماتكم الخاصة. تجلب أحدث إصدارات حزم Java و PHP SDK دعمًا محسنًا للصيغ، وخيارات تكوين جديدة، وإضافة نوع عارض جديد تمامًا — المخطط. دعونا نلقي نظرة فاحصة على الجديد.

Java SDK 1.6.0

متوفر على Maven Central، يوفر Java SDK المحدث حديثًا ما يلي:

نوع عارض جديد: مخطط. تدعم حزمة تطوير البرمجيات (SDK) الآن تهيئة عارض المخططات ONLYOFFICE Diagram viewer، الذي تم تقديمه في الإصدار 9.0.
حقول تكوين جديدة. متوافقة مع إصدار المحرر 9.0، مما يسمح بتحكم أكثر دقة في تهيئة المحرر.
قائمة محدثة من الصيغ المدعومة. تضمن التوافق مع أحدث أنواع ملفات المستندات وجداول البيانات والعروض التقديمية والنماذج والمخططات.
تحديثات التبعية. تم تحديث جميع المكونات التي بها ثغرات أمنية معروفة لتحسين الأمان والاستقرار.

PHP SDK 1.3.0

متوفر على Packagist، يدعم الإصدار الجديد من PHP SDK ما يلي:

نوع عارض جديد: مخطط. يمكن للمطورين الآن دمج عارض المخططات ONLYOFFICE Diagram viewer، وهو مثالي للمخططات الانسيابية والخرائط الذهنية وغيرها.
دعم عرض ملفات .odg و .md. يوسع توافق الملفات ليشمل الصيغ المفتوحة وملفات Markdown.
دعم تحرير ملفات .xlsb. يمكنكم الآن دمج إمكانيات التحرير لمصنفات Excel الثنائية.
قوالب ملفات فارغة جديدة. تمت إضافتها للغات التالية: الكاتالونية (ca-ES)، والتشيكية (cs-CZ)، والدنماركية (da-DK)، والمجرية (hu-HU)، والإندونيسية (id-ID)، والرومانية (ro-RO)، والألبانية (sq-AL)، والأردية (ur-PK).
الحد الأدنى لإصدار المحرر المتوافق: 8.0. يرجى التأكد من تحديث نسخة ONLYOFFICE Docs الخاصة بكم لضمان التوافق الكامل.

نوصي جميع المطورين الذين يدمجون محررات ONLYOFFICE بالتحديث إلى أحدث إصدارات حزم تطوير البرمجيات (SDKs) للاستفادة من الميزات الجديدة والحفاظ على التوافق مع ONLYOFFICE Docs 8.0 والإصدارات الأحدث.

الجديد في واجهة برمجة تطبيقات Docs

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

كيفية تعطيل تلميحات الميزات في المحررات للحفاظ على واجهة أنظف.
كيفية تغيير الخط وحجم النص لتخطيط محرر مخصص.
كيفية إخفاء أيقونات المستخدمين النشطين وأسماء المستخدمين في رأس المحرر لتعزيز الخصوصية.

أمثلة جديدة لواجهة برمجة تطبيقات Office. لدعم حالات الاستخدام المتنوعة، قدمنا عينات جديدة لإنشاء المستندات مع تطبيقات عملية.

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

الجديد في الإضافات ووحدات الماكرو

تخصيص محدث لوحدات الماكرو. مع إصدار 9.0.3، قمنا بتحسين سلوك المعلمة customization.macros. يؤدي تعيين macros إلى false الآن إلى تعطيل وظائف الماكرو بالكامل. وهذا يعني أنه لا يمكن للمستخدمين تشغيل أو إضافة أو تحرير وحدات الماكرو؛ ويتم إخفاء زر وحدات الماكرو من علامة التبويب “عرض”.

const config = {
  editorConfig: {
    customization: {
...
macros: false, 
...

إنشاء وحدات الماكرو المدعومة بالذكاء الاصطناعي. يؤدي دمج الذكاء الاصطناعي في تطوير وحدات الماكرو إلى تسريع عملية إنشاء وحدات الماكرو لـ ONLYOFFICE بشكل كبير.

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

API roundup: latest updates for ONLYOFFICE Docs and DocSpace

علاوة على ذلك، يمكنكم تحويل كود VBA تلقائيًا إلى وحدات ماكرو ONLYOFFICE المستندة إلى JavaScript.

فيما يلي ثلاثة أمثلة لوحدات الماكرو المحولة من VBA باستخدام الذكاء الاصطناعي:

إلغاء دمج كافة الخلايا. تبسيط تنسيق جداول البيانات عن طريق إزالة جميع عمليات دمج الخلايا في أمر واحد.
تحويل الصيغ إلى قيم. تحويل الحسابات الديناميكية بسرعة إلى بيانات ثابتة لتحقيق الاتساق.
تغيير قيمة الخلية. أتمتة التخصيص لخلايا معينة.

اطلعوا على مثال لماكرو لتغيير قيمة الخلية المحددة:

(function(){
    // Get the active sheet
    var activeSheet = Api.GetActiveSheet();
    
    // Select cell A1
    activeSheet.GetRange("A1").Select();
    
    // Set the value of the selected cell to "Hello World"
    activeSheet.GetRange("A1").SetValue("Hello World");
})();

API roundup: latest updates for ONLYOFFICE Docs and DocSpace

الحسابات غير المتزامنة. أضيفوا وظائف مخصصة غير متزامنة لإدارة أي طلب داخل جسم الوظيفة. اطلعوا على عينة لحساب مؤشر البنك الدولي.

API roundup: latest updates for ONLYOFFICE Docs and DocSpace

عينات ماكرو جديدة. وسعوا قدراتكم بأمثلة ماكرو جديدة تبسط سير عمل المستندات (بالإضافة إلى ذلك، استفيدوا من التعليمات المضافة حول كيفية تشغيل عينة ماكرو).

من خلال دمج وحدات الماكرو هذه، يمكنكم تقليل الأعباء اليدوية وتحسين الكفاءة التشغيلية:

اطلعوا على عينة الكود لتعيين عنصر نائب:

(function () {
    let key = "MyKey";
    let placeholderText = "Placeholder";
    let doc = Api.GetDocument();

    doc.GetAllForms()
        .filter(field => field.GetFormType() === "comboBoxForm" && field.GetFormKey() === key)
        .forEach(field => field.SetPlaceholderText(placeholderText));
})();