نعم. يستطيع LibreOffice Calc تشغيل كود بايثون كوحدة ماكرو داخل عملية LibreOffice، كما يمكن لماكرو LibreOffice Basic استدعاء دالة بايثون عبر إطار عمل البرمجة النصية الخاص بـ LibreOffice. إذا كان هدفك قراءة أو تعديل خلايا في جدول البيانات المفتوح، فإن ماكرو بايثون داخل العملية هو عادةً أبسط نقطة بداية. استخدم استدعاء Basic-to-Python عندما يحتاج ماكرو Basic موجود إلى إسناد مهمة معينة إلى دالة بايثون قابلة لإعادة الاستخدام.
تختلف هذه الأساليب عن تشغيل سكربت بايثون عادي باستخدام أمر سطر الأوامر. لا تتلقى عملية بايثون خارجية عادية كائن المستند الخاص ببرنامج Calc تلقائيًا. للوصول إلى المصنف، شغّل ماكرو بايثون من خلال LibreOffice أو اربط عملية خارجية بنسخة LibreOffice عمدًا عبر UNO.
يدعم LibreOffice لغات برمجة نصية متعددة من خلال إطار عمله. في ماكرو بايثون، يوفر LibreOffice كائن سياق UNO يسمح للبرنامج النصي بالوصول إلى المستند الحالي وأوراقه. ماكرو بايثون هو دالة ضمن .pyوحدة نمطية؛ g_exportedScriptsوتحدد مجموعة الوحدة النمطية الدوال التي يجب أن يعرضها LibreOffice كوحدات ماكرو قابلة للتنفيذ.
يمكن تشغيل ماكرو بايثون بشكل مستقل من قائمة الماكرو في برنامج Calc، دون الحاجة إلى استدعائه من لغة Basic. إذا كان لديك ماكرو Basic وترغب في أن يستدعي بايثون، Session.ExecutePythonScriptفيمكنك استخدام موفر البرامج النصية في LibreOffice أو خدمة ScriptForge الأحدث لربط اللغتين.
على سبيل المثال، يمكن كتابة أداة تنظيف جداول البيانات الصغيرة بالكامل باستخدام ماكرو بايثون. إذا كان زر Basic موجودًا بالفعل يقوم بتشغيل تقرير، فاحتفظ بماكرو الزر واجعله يستدعي دالة بايثون لحساب إجمالي التقرير.
يخزن LibreOffice نصوص بايثون الشخصية في ملف تعريف المستخدم، والنصوص العامة للتطبيق في مجلد التثبيت، ونصوص المستندات مع المستند نفسه. في الاختبار الأولي، يُعد النص الشخصي مناسبًا لأنه متاح من أي مستند LibreOffice مفتوح لنفس المستخدم. مع ذلك، لا يُنقل هذا النص مع ملف ODS، لذا لن يتلقاه شخص آخر تلقائيًا مع جدول البيانات.
ابحث عن مجلد نصوص بايثون الشخصية لنظامك في تعليمات LibreOffice ضمن "تنظيم نصوص بايثون وموقعها". تشمل المواقع الشائعة %APPDATA%\LibreOffice\4\user\Scripts\pythonعلى نظامي التشغيل Windows و ~/.config/libreoffice/4/user/Scripts/pythonLinux. قد يختلف الملف الشخصي الفعلي؛ استخدم الموقع الموثق لتثبيتك بدلاً من إنشاء دليل ملف شخصي ثانٍ بشكل عشوائي.
أنشئ ملفًا باسم calc_tools.pyفي مجلد البرامج النصية الشخصية بلغة بايثون، ثم أضف هذا المثال البسيط:
def double_a1(args=None):
doc = XSCRIPTCONTEXT.getDocument()
sheet = doc.getCurrentController().getActiveSheet()
source = sheet.getCellRangeByName("A1")
target = sheet.getCellRangeByName("B1")
target.setValue(source.getValue() * 2)
g_exportedScripts = (double_a1,)يقرأ هذا الأمر القيمة العددية في الخلية A1 من الورقة النشطة ويكتب ضعف تلك القيمة في الخلية B1. XSCRIPTCONTEXTيتم تمرير هذا الأمر إلى ماكرو بايثون في LibreOffice أثناء التشغيل؛ فهو ليس متغيرًا عامًا عاديًا في بايثون عند تشغيل الملف نفسه خارج LibreOffice. يتم إدراج الدالة العامة في g_exportedScriptsملف `.org/libreoffice ...
احفظ الملف، ثم افتحه أو ارجع إلى برنامج Calc واختر أدوات > وحدات الماكرو > تشغيل وحدات الماكرو . قد يكون اسم القائمة بصيغة المفرد، وذلك حسب إصدار LibreOffice أو ترجمة النظام الأساسي. حدد وحدات الماكرو الخاصة بي > calc_tools > double_a1 وشغّلها. أدخل رقمًا في الخلية A1 أولًا، ثم تأكد من أن الخلية B1 تحتوي على القيمة المضاعفة. إذا لم يظهر البرنامج، فتأكد من أن امتداد الملف هو .py .py، وأن الملف موجود في مجلد Python الخاص بالملف الشخصي الصحيح، وأن دعم برمجة Python مثبت. قد يساعد إعادة تشغيل LibreOffice بعد إضافة برنامج جديد في تحديث قائمة البرامج النصية.
لإجراء استدعاء من لغة Basic إلى لغة Python، ضع وحدة Python في مجلد البرامج النصية الشخصية، ثم استدعِ دالتها عبر Sessionخدمة ScriptForge. يجمع هذا المثال قيمتين في Python ويكتب النتيجة في الخلية B1 في ورقة Calc الحالية.
في calc_tools.py، قم بتعريف الدالة:
def add_values(first, second):
return float(first) + float(second)
g_exportedScripts = (add_values,)ثم أنشئ ماكرو أساسي في برنامج Calc واستخدمه:
Sub RunPythonHelper()
Dim session As Object
Dim result As Variant
Dim sheet As Object
session = CreateScriptService("Session")
result = session.ExecutePythonScript( _
session.SCRIPTISPERSONAL, _
"calc_tools.py$add_values", _
12, 30)
sheet = ThisComponent.CurrentController.getActiveSheet()
sheet.getCellRangeByName("B1").setValue(result)
End Subقم بتشغيل البرنامج RunPythonHelperمن مُحدِّد الماكرو الأساسي. إذا نجح الاستدعاء، يجب أن تعرض الخلية B1 الرقم 42. يتبع مرجع البرنامج النصي الشكل التالي module.py$function_name: ; بالنسبة لوحدة نمطية في مجلد فرعي أو موقع تخزين آخر، استخدم الصيغة وثابت الموقع الموثقين لإصدار ScriptForge هذا. حافظ على الوسائط وقيم الإرجاع من أنواع البيانات التي يمكن لكلا اللغتين تمثيلها بشكل صحيح، مثل الأرقام والسلاسل النصية والتسلسلات البسيطة.
CreateScriptServiceتتوفر أدوات مساعدة جلسات ScriptForge الموثقة في إصدارات LibreOffice الحديثة، ولكن قد تختلف أسماء القوائم والمكونات المضمنة في الإصدارات القديمة أو تلك المُجمّعة. في حال عدم توفر هذه الخدمة، استخدم طريقة مُزوّد البرامج النصية UNO الموثقة في LibreOffice، والتي تحصل على مُعرّف البرنامج النصي XScriptمن عنوان URI الخاص بالبرنامج النصي وتستدعيه. تجنّب نسخ جزء من التعليمات البرمجية لموقع ماكرو مختلف دون تغيير إعدادات موقعه.
| تخزين | الأنسب | التنازل عن ميزة ممن أجل الحصول على أخرى |
|---|---|---|
| وحدات الماكرو الخاصة بي / ملف تعريف المستخدم | أدواتك الخاصة القابلة لإعادة الاستخدام في جميع المستندات | لا يتم تضمينها تلقائيًا عند إرسال جدول البيانات |
| وحدات الماكرو للتطبيقات | البرامج النصية المُدارة لعدة مستخدمين على تثبيت واحد | يتطلب عادةً صلاحيات المسؤول لتثبيته أو صيانته |
| وحدات ماكرو للمستندات | رمز مخصص للربط بمستند واحد | قد يحتاج المستلمون إلى السماح باستخدام وحدات الماكرو؛ اختبر قابلية النقل وسلوك الأمان على إصدار LibreOffice المستهدف |
لضمان سير عمل الفريق، حدد كيفية حصول المستلمين على الكود وكيفية ثقتهم به قبل إنشاء مصنف عمل حول ماكرو شخصي. إذا كان لا بد من إرفاق منطق بايثون مع جدول البيانات، فاختبر تخزين الماكرو في المستند ومطالبات الأمان على نفس إصدارات LibreOffice التي يستخدمها المستلمون. بالنسبة للنشر المُدار، يمكن للمسؤول تجميع البرامج النصية للمستخدمين أو توزيع إضافة ضمن ضوابط البرامج المعتادة في المؤسسة.
Scripts/python.g_exportedScriptsالدالة التي تنوي تشغيلها من مُحدِّد الماكرو. تأكد من أن صيغة المجموعة تتضمن الفاصلة الأخيرة لمجموعة من عنصر واحد.XSCRIPTCONTEXT هذا ينطبق على الماكرو الذي يتم تشغيله بواسطة LibreOffice، وليس عند تشغيل الملف نفسه باستخدام أمر النظام python. استخدم مُشغِّل الماكرو أو أنشئ اتصال UNO موثقًا.XSCRIPTCONTEXTغير مُمرَّرة إلى الوحدات النمطية المستوردة. مرِّر كائن المستند أو ورقة العمل المطلوب إلى الدوال المساعدة بدلاً من توقع أن تقرأ الوحدات النمطية المستوردة هذا المتغير العام.اختبر باستخدام نسخة من جدول البيانات ومدخلات معروفة. تأكد من ظهور ماكرو بايثون في المُشغِّل، وشغِّله مرة واحدة، وقارن خلية الإخراج بنتيجة محسوبة يدويًا. بالنسبة لاستدعاء Basic إلى بايثون، اختبر مدخلًا بسيطًا واحدًا وتأكد من كتابة القيمة المُعادة في الورقة المقصودة. تجنب البدء ببرامج نصية تحذف أوراقًا، أو تستبدل نطاقات كبيرة، أو تُنفِّذ أوامر نظام التشغيل.
عند نجاح الاختبار، حدد كيفية تثبيت البرنامج النصي على أجهزة الكمبيوتر الأخرى، ووثّق أي مكتبات بايثون مطلوبة أو افتراضات حول إصدار LibreOffice. بيئة بايثون المدمجة في LibreOffice هي المستخدمة لوحدات الماكرو داخل العملية؛ وقد لا تكون الحزم المثبتة لمفسر بايثون منفصل متاحة لها. إذا كنت بحاجة إلى حزم من مفسر آخر، فاستخدم طريقة العملية الخارجية/UNO وقم بتهيئة هذا الاتصال بعناية.
قم بتوصيل محرري سطح المكتب ONLYOFFICE بخادم ownCloud الخاص بك، وقم بتسجيل الدخول، وافتح ملفات السحابة، وقم بإدارة الاتصال، وقم باستكشاف أخطاء الإعداد الشائعة وإصلاحها.
قم باستكشاف أخطاء استخدام وحدة المعالجة المركزية العالية في Collabora Online وإصلاحها من خلال تحديد عمليات مجموعة الأدوات المشغولة، والتحقق من المقاييس والسجلات، وضبط التزامن والتنظيف، والتحقق من الإصلاحات بأمان.
تعرف على كيفية تخصيص العلامة التجارية لـ ONLYOFFICE Docs بشعار رأس الصفحة وألوان الواجهة، بما في ذلك حدود الترخيص، وإعداد JSON الخاص بالسمات، ومسارات Docker، والاختبار.
قم بإصلاح النصوص التي يصعب قراءتها في LibreOffice Calc عن طريق التحقق من سمة التطبيق، وخط الخلية وألوان التعبئة، والأنماط، والتنسيق الشرطي - ثم تحقق من مخرجات الطباعة.
قم بإزالة تحذير قفل المستخدم غير المعروف من LibreOffice بأمان. تحقق من الجلسات النشطة، واحمِ نسخة، وأزل القفل القديم الذي تم التحقق منه فقط، واختبر المستند.
أصلح النصوص العربية أو العبرية التي تتدفق أو تتماشى أو تختلط مع الإنجليزية بشكل غير صحيح في برنامج LibreOffice Writer. فعّل تخطيط النص المعقد، وحدد اتجاه الفقرة، وتحقق من النتيجة.
تعلم VLOOKUP و XLOOKUP في LibreOffice Calc، بما في ذلك التطابقات التامة، والبحث الأيسر، ونتائج عدم العثور، والبحث العكسي، وبدائل INDEX/MATCH، والأخطاء الشائعة.
قم باستكشاف أخطاء التحقق من صحة إثبات WOPI في Collabora Online وإصلاحها عن طريق التحقق من مفاتيح الاكتشاف، وتدوير المفاتيح، وعناوين URL للوكيل، والطوابع الزمنية، وقوائم السماح للمضيف.
قم بتمكين ميزة تتبع التغييرات للجميع في مستند ONLYOFFICE، واحتفظ بها نشطة بعد إعادة فتحه، وافهم حدود الإعداد الافتراضي العام.
قارن بين إعدادات Collabora Online الخاصة بكل عرض، وعدم التركيز، وخمول المستند، والحفظ التلقائي، ومهلات الوكيل، ثم اختر الإعدادات المناسبة لعملية النشر الخاصة بك وتحقق منها.
