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

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

دعم موسع لتنسيقات الملفات

تدعم واجهة برمجة تطبيقات Docs الآن تنسيقات ملفات إضافية، مما يوفر توافقًا أوسع، لضمان تجربة سلسة للمستخدمين الذين يعملون بأنواع ملفات متنوعة. من بينها تنسيقات Apple iWork و Hancom Office:

• pages
• key
• numbers
• hwp
• hwpx

يمكن تحديد هذه التنسيقات باستخدام خاصية documentType، على سبيل المثال:

const config = {
  documentType: "pages",

خيارات تخصيص محسنة

أصبح لدى المطورين الآن تحكم أكبر في سلوك المحرر ومظهره. تشمل التحديثات الرئيسية ما يلي:

• إخفاء تلميحات الميزات

يسمح المعامل editorConfig.customization.features.featuresTips بتمكين أو تعطيل تلميحات الأدوات حول الميزات الجديدة أثناء تحميل المحرر لأول مرة عند التحديث. القيمة الافتراضية هي true.

• عرض أشرطة التمرير في محرر جداول البيانات

بدءًا من الإصدار 8.3، يمكن تحديد ما إذا كان شريط التمرير الأفقي/العمودي يُعرض أو يُخفى تلقائيًا عند تحميل محرر جداول البيانات. تحققوا من editorConfig.customization.showHorizontalScroll و editorConfig.customization.showVerticalScroll للتحكم في هذه المعاملات.

• خلفية عرض الشرائح في العروض التقديمية

استخدموا المعامل editorConfig.customization.slidePlayerBackground لتحديد لون خلفية عرض الشرائح بتنسيقات HEX أو RGB أو RGBA. على سبيل المثال، #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",

• ألوان عناوين المستندات

خصصوا أنماط العناوين في محرر المستندات باستخدام المعامل editorConfig.customization.wordHeadingsColor مما يسمح بتحديد الألوان بتنسيق HEX.

• زر المعلومات (Info) للجوال

بدّلوا عرض زر معلومات المستند (Document Info) لمحررات الجوال باستخدام editorConfig.customization.mobile.info. القيمة الافتراضية هي false.

• وضع المؤشر

اضبطوا وضع المؤشر (select أو hand) في عارض العروض التقديمية باستخدام المعامل9 editorConfig.customization.pointerMode القيمة الافتراضية هي select.

• شريط أدوات مدمج للعارض

يدعم المعامل editorConfig.customization.compactToolbar الآن وضع العارض، مما يسمح بالتبديل بين أشرطة الأدوات الكاملة والمدمجة. القيمة الافتراضية لوضع العرض هي true.

ميزات أمان محسنة

تقدم واجهة برمجة تطبيقات Docs معالجة للملفات المحمية بكلمة مرور مع الحدث المضاف events.onUserActionRequired. يتم استدعاء الدالة عندما يكون إجراء المستخدم مطلوبًا لفتح مستند في الحالات التالية:

• عندما يحتاج المستخدم إلى إدخال كلمة مرور لفتح المستند المحمي؛
• عندما يحتاج المستخدم إلى تحديد ترميز لملف TXT؛
• عندما يحتاج المستخدم إلى تحديد ترميز ومحدد لملف CSV.

إليكم مثال على كيفية عمل الحدث:

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

بالإضافة إلى ذلك، يمكنكم الآن استخدام الأمر drop لمنع تحرير المستند لمستخدمين معينين:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

سجل التغييرات الكامل لواجهة برمجة تطبيقات Docs متاح هنا.

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

حملوا الآن

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

تلقت Office API تحديثات مهمة لإدارة المستندات بشكل أفضل، وهي:

• الإشارات المرجعية (Bookmarks)
• عناصر التحكم في المحتوى (Content Controls)
• المقاطع (Sections)
• الفلاتر التلقائية (Autofilters)
• التحديد (Selection)
• والمزيد

تتيح هذه التحسينات تفاعلات وتجارب تحرير أغنى. للحصول على تفصيل دقيق للأوامر، راجعوا سجل تغييرات Office API.

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

توسع العديد من الطرق والخصائص الجديدة قدرات الإضافات:

• استرداد المحتوى

تسترد الطريقة GetSelectedContent المحتوى المحدد بتنسيق معين.

expression.GetSelectedContent(prop);

• rرسائل الخطأ

تُمكّن الطريقة ShowError الإضافات من عرض رسائل الخطأ أو التحذير.

expression.ShowError(error, level);

• خصائص محسنة لعناصر التحكم في المحتوى

تعزز الخصائص الجديدة Shd (تظليل الخلفية) و Border(الحدود) كائن ContentControlProperties لتخصيص مرئي أفضل.

• تنشيط اللوحة

يسمح لكم المعامل isActivated بتحديد ما إذا كانت لوحة الإضافة التي تم إنشاؤها موسعة (true) أو مطوية (false) عند التحميل.

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