جولة API: آخر مستجدات ONLYOFFICE DocSpace و Docs
توفر تحديثات أغسطس 2025 لواجهات برمجة التطبيقات الخاصة بـ ONLYOFFICE DocSpace و Docs موجة جديدة من إمكانيات التكامل وأدوات التطوير. سواء كنتم تبنون مهام سير عمل المستندات، أو تنشئون إضافات مخصصة، أو تربطون ONLYOFFICE بمجموعة التقنيات الحالية لديكم، فإن هذه التحديثات تقدم حلولًا عملية توفر الوقت وتبسط عملية التطوير.
DocSpace: عينات تكامل لواجهة برمجة تطبيقات REST الخلفية
يتضمن آخر تحديث لواجهة برمجة تطبيقات DocSpace أمثلة تكامل شاملة توضح حالات استخدام واقعية. هذه ليست مجرد مقتطفات برمجية – إنها حلول كاملة يمكنكم تكييفها لمشاريعكم.
تكاملات Trello
مزامنة المستخدمين ثنائية الاتجاه. مزامنة المستخدمين تلقائيًا بين DocSpace ولوحات Trello. هذا يلغي الحاجة إلى الإعداد اليدوي ويضمن اتساق الفريق عبر المنصات. إضافة مستخدمي DocSpace إلى Trello / إضافة مستخدمي Trello إلى DocSpace
ترحيل الأصول. استيراد مرفقات بطاقات Trello مباشرة إلى غرف DocSpace. يعمل هذا السيناريو على تبسيط عمليات تسليم المشاريع ومركزية التوثيق.
محاكاة هيكل المشروع. إنشاء غرف DocSpace مباشرة من لوحات Trello بعناوين متطابقة. مثالي للحفاظ على تنظيم موحد للمشاريع. تفحصوا عينة الكود:
import requests
# ONLYOFFICE DocSpace configuration
ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"
ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"
# Trello configuration
TRELLO_API_KEY = "your_trello_api_key"
TRELLO_TOKEN = "your_trello_token"
TRELLO_BOARD_ID = "your_board_id"
ONLYOFFICE_HEADERS = {
"Authorization": f"Bearer {ONLYOFFICE_API_KEY}",
"Content-Type": "application/json",
"Accept": "application/json"
}
# Step 1: Get Trello board name
def get_trello_board_name(board_id):
url = f"https://api.trello.com/1/boards/{board_id}"
params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}
response = requests.get(url, params=params)
if response.status_code == 200:
return response.json()["name"]
else:
print(f"Trello board fetch error: {response.status_code}")
return None
# Step 2: Create a DocSpace room with board name
def create_docspace_room(room_title):
url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"
payload = {
"title": room_title,
"roomType": 2, # Collaboration room
"private": True
}
response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)
if response.status_code == 200:
print(f"Room created: {room_title}")
return response.json()
else:
print(f"DocSpace room creation error: {response.status_code}, {response.text}")
return None
# Run integration
if __name__ == "__main__":
board_name = get_trello_board_name(TRELLO_BOARD_ID)
if board_name:
create_docspace_room(board_name)تكاملات التخزين السحابي
الاتصال بـ Dropbox. تدعم تكاملات Dropbox الجديدة مهام سير العمل للاستيراد والتصدير. تصدير الملفات من DocSpace باستخدام عناوين URL الموقعة مسبقًا للأرشفة أو النسخ الاحتياطي. استيراد الملفات مباشرة إلى غرف محددة لإدارة مركزية للمستندات.
أتمتة مشاركة المجلدات. مشاركة مجلدات Dropbox تلقائيًا مع مستخدمي DocSpace أو أعضاء المجموعات، مما ينشئ جسور تعاون سلسة بين المنصات.
مهام سير العمل مع Notion و Asana
تكامل مستخدمي Notion. مزامنة مستخدمي مساحة عمل Notion مع DocSpace، مما يضمن وصولًا متسقًا عبر نظامكم البيئي للتوثيق.
أتمتة مشاريع Asana. إنشاء هياكل غرف DocSpace بناءً على مشاريع Asana، مع إنشاء مجلدات تلقائيًا لكل مهمة. هذا يخلق توافقًا مثاليًا بين إدارة المشاريع والتعاون على المستندات.
الدعوات المستندة إلى المهام. دعوة المكلفين بمهام Asana تلقائيًا إلى غرف DocSpace ذات الصلة، مما يلغي الحاجة إلى الإدارة اليدوية للوصول.
DocSpace: حزمة تطوير البرمجيات (SDK) المحسنة للإضافات
تلقت حزمة تطوير البرمجيات (SDK) للإضافات تحديثات هامة مع عينات متقدمة وأساسية لتسريع تطوير الإضافات.
عينات الإضافات المتقدمة
- إضافة تصفية امتداد الملفات. تضيف إمكانيات تصفية سياقية بواجهة نمطية نظيفة. يمكن للمستخدمين تصفية محتويات الغرفة حسب نوع الملف، مما يحسن التنقل في البيئات المليئة بالمستندات.
- إضافة الحوار النمطي. توضح تكامل شريط الأدوات المخصص مع استدعاءات واجهة برمجة التطبيقات الخلفية. إنشاء مستندات جديدة مباشرة من الواجهة باستخدام معلمات يحددها المستخدم.
- واجهة مستخدم لإضافة الإعدادات. توفر للمسؤولين واجهات إعداد مخصصة، مما يتيح التحكم الدقيق في سلوك الإضافة.
عينات المكونات الأساسية
تغطي العينات الأساسية الجديدة مكونات واجهة المستخدم الأساسية:
- إضافة API – توضح التعامل الصحيح مع اتصال واجهة برمجة تطبيقات المنصة.
- مكون الصندوق (Box) – أمثلة على إعدادات التخطيط والتباعد.
- مكون الزر (Button) – تنفيذ العناصر التفاعلية.
- مكون القائمة المنسدلة (ComboBox) – واجهات تحديد منسدلة.
- شسمكون النص (Text) – خيارات الطباعة والتنسيق.
- شمكون زر التبديل (ToggleButton) – عناصر تحكم الحالة الثنائية.
توفر هذه العينات اللبنات الأساسية لتطوير إضافات أكثر تعقيدًا، مع أنماط تنفيذ واضحة يمكنكم اتباعها.
الجديد في واجهة برمجة تطبيقات Docs: التخصيص
تمنحكم المعلمة الجديدة suggestFeature تحكمًا دقيقًا في عنصر واجهة المحرر المضاف حديثًا.
const config = {
editorConfig: {
customization: {
...
suggestFeature: true,تتحكم هذه المعلمة في رؤية زر قائمة “اقتراح ميزة” في علامة تبويب “ملف”. عينوها على false للنشرات الداخلية حيث لا تكون اقتراحات الميزات ذات صلة، أو أبقوها على true للحفاظ على تفاعل المستخدمين مع تطوير المنتج.
Docs: أمثلة جديدة لواجهة برمجة تطبيقات Office
لدعم حالات الاستخدام المتنوعة، قدمنا عينات جديدة لإنشاء المستندات مع تطبيقات عملية.
- الأرقام التسلسلية. تحسين التنقل في الجداول والإشارة إلى الصفوف عن طريق إضافة ترقيم تسلسلي إلى العمود الأول.
- إنشاء جداول منسقة. تنسيق الجداول تلقائيًا أثناء إنشائها عن طريق إضافة حدود، وتنسيق الرؤوس، ومحاذاة النص داخل الخلايا. مثالي للتقارير، أو صادرات قواعد البيانات، أو القوالب التي تتطلب تخطيطًا مصقولًا وسهل القراءة.
- جدول بيانات مع مرشحات. إنشاء جدول بيانات يتميز بمرشحات تفاعلية في الرؤوس، مما يمكن المستخدمين من فرز البيانات وتصفيتها بسهولة للتنقل والتحليل السلس.
- تذييل مع التاريخ واسم الشركة. إضافة تذييل تلقائيًا إلى مستندكم يضم التاريخ الحالي على جانب واسم شركتكم على الجانب الآخر. مثالي للتنسيق القياسي للمذكرات والتقارير والرسائل والقوالب
- جدول بعرض تلقائي. إنشاء مستند يحتوي على جدول يقوم بضبط عرض الأعمدة ديناميكيًا ليتناسب مع المحتوى بشكل مثالي
- قائمة مهام نقطية. إنشاء مستند يتميز بقائمة نقطية واضحة ومنظمة، مثالية لتحديد المهام أو الخطوات أو المتطلبات
ONLYOFFICE ١. أنشئ حسابك المجاني من
،٢. قم بعرض و تحرير أو التعاون على المستندات، الجداول ، العروض التقديمية
