ONLYOFFICE Docs 9.3 للمطورين: واجهة PDF API وطرق جديدة في Office JavaScript API والمزيد

يوفر ONLYOFFICE Docs 9.3 مجموعة من التحديثات للمطورين. يوسع هذا الإصدار قدرات واجهة برمجة التطبيقات (API) الخاصة بنا بشكل كبير، مما يوفر المزيد من التحكم والمرونة لتكامل المحررات وتوسيعها. دعونا نتعمق في التحسينات الرئيسية.

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

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

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

تحققوا من عينة الكود لإنشاء ملف PDF جديد:

// create a PDF file with ONLYOFFICE Document Builder
builder.CreateFile("pdf")

// create a new 'oDocument' variable and get the created PDF document
const oDocument = Api.GetDocument()

// create a new paragraph for the PDF content
const oParagraph = Api.CreateParagraph()

// set the paragraph justification to center the text
oParagraph.SetJc("center")

// add a text containing a single 'Center' word to the paragraph
oParagraph.AddText("Center")

// push the paragraph to the document
oDocument.Push(oParagraph)

// save the resulting PDF document as a file in the .pdf format with the 'example.pdf' name and close it
builder.SaveFile("pdf", "example.pdf")
builder.CloseFile()

تحديثات رئيسية لواجهة برمجة تطبيقات Office JavaScript

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

تحسينات النماذج

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

قدرات الرسم والتعليق الموسعة

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

• التعليقات التوضيحية (علامة الإقحام، الدائرة، التمييز، الحبر، إلخ)
• الأشكال الهندسية والمسارات
• التعبئة (التدرجات، الألوان) والخطوط

تحققوا من عينة الكود لطريقة ApiStroke/GetFill (واجهة برمجة تطبيقات محرر جداول البيانات):

// Creates a shape with a colored border and retrieves its fill properties..
let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 200, 100));
let stroke = Api.CreateStroke(2 * 36000, Api.CreateSolidFill(Api.CreateRGBColor(0, 0, 255)));
let shape = worksheet.AddShape("rect", 60 * 36000, 40 * 36000, fill, stroke, 3, 0, 2, 2);
let strokeObj = shape.GetLine();
if (strokeObj) {
    let strokeFill = strokeObj.GetFill();
    if (strokeFill) {
        worksheet.GetRange("A1").SetValue("Stroke fill type: " + strokeFill.GetType());
    }
}

طرق متقدمة للمخططات والجداول

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

إضافات بارزة أخرى لواجهة برمجة تطبيقات JavaScript

• التصفية والتحقق من الصحة: تم تقديم طرق جديدة لـ Autofilter و Filter و Validation لإدارة البيانات بشكل أفضل في جداول البيانات.
• الحواشي السفلية والتعليقات الختامية: إضافة الحواشي السفلية والتعليقات الختامية وإدارتها برمجياً في مستنداتكم.
• الروابط التشعبية والانتقالات: الحصول على مزيد من التحكم في الروابط التشعبية وانتقالات شرائح العرض التقديمي.

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

تحسينات واجهة برمجة التطبيقات للإضافات والماكرو

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

على سبيل المثال، تتحقق طريقة IsFormSigned مما إذا كان النموذج المحدد قد تم توقيعه رقمياً:

window.Asc.plugin.executeMethod ("IsFormSigned", [], function(isSigned) {    
console.log ("Form is signed: " + isSigned);
});

تتيح واجهة برمجة تطبيقات الماكرو المقدمة حديثاً في PDF محرر ملفات إضافة الصفحات والنماذج والتعليقات التوضيحية والأشكال التلقائية والجداول والصور والمخططات وحذفها وتحريرها. على سبيل المثال، إليكم طريقة SetMacros داخل window.Asc.plugin.executeMethod لواجهة برمجة تطبيقات PDF:

window.Asc.plugin.executeMethod ("SetMacros", [JSON.stringify (Content)], function () {    
window.Asc.plugin.executeCommand ("close", "");
});

تحققوا من سجل التغييرات الكامل لواجهة برمجة تطبيقات الإضافات والماكرو