تتناول هذه المقالة عملية إضافة إشارة مرجعية في Word باستخدام واجهة برمجة تطبيقات Python REST. سنستخدم Aspose.Words for Python Cloud SDK لإضافة إشارة مرجعية إلى مستند Word باستخدام واجهة برمجة تطبيقات Python منخفضة الكود**. ستُعيّن معلمات مختلفة للإشارة المرجعية، وستستدعي استدعاءات واجهة برمجة التطبيقات لإضافة هذه الإشارة المرجعية إلى ملف Word على القرص المحلي.
متطلب أساسي
- {{الرابط التشعبي 1}}
- قم بتنزيل مجموعة أدوات تطوير البرامج السحابية Aspose.Words للغة Python لإضافة إشارة مرجعية في ملف Word
- إعداد مشروع حل Python باستخدام مجموعة أدوات التطوير البرمجية المذكورة أعلاه
خطوات إنشاء إشارة مرجعية في Word باستخدام Python REST API
- تعيين معرف العميل والسر الخاص بالعميل لواجهة برمجة التطبيقات لإضافة إشارة مرجعية
- إنشاء كائن من فئة WordsApi باستخدام بيانات اعتماد العميل الخاصة بك
- قراءة ملف Word المصدر في مجرى الذاكرة لإنشاء إشارة مرجعية
- قم بتحديد نطاق البداية والنهاية للإشارة المرجعية باستخدام فئة PositionInsideNode
- إنشاء كائن InsertBookmarkOnlineRequest عن طريق توفير المعلمات المطلوبة
- استدعاء طريقة InsertBookmarkOnline إلى إدراج إشارة مرجعية وفقًا لـ InsertBookmarkOnlineRequest
- احفظ ملف Word الناتج باستخدام الإشارة المرجعية الجديدة
توضح الخطوات المذكورة أعلاه كيفية إنشاء إشارة مرجعية في Word باستخدام واجهة برمجة تطبيقات Python منخفضة الكود. ابدأ العملية بإنشاء كائن WordsApi، ثم قراءة ملف Word المصدر وتحديد معلمات الإشارة المرجعية. أخيرًا، أضف هذه الإشارة المرجعية إلى ملف Word الخاص بك عن طريق استدعاء بعض استدعاءات واجهة برمجة التطبيقات، ثم حفظ ملف Word الناتج على القرص المحلي.
كود إدراج إشارة مرجعية في Word باستخدام Python REST API
يوضح هذا الكود النموذجي كيفية إضافة إشارة مرجعية في Word باستخدام واجهة برمجة تطبيقات Python REST. تُستخدم فئة PositionInsideNode لتعيين نطاقي بداية ونهاية الإشارة المرجعية في ملف Word الوجهة. يُعاد التدفق الناتج كعنصر قاموس بالمفتاح المحدد، ويمكن استرجاعه باستخدام دالة TryGetValue كما هو موضح في الكود النموذجي.
In this topic, we have learned how to make a bookmark in Word with Python REST API. If you are looking to convert a Word file to an HTML file, refer to the article on Convert DOCX to HTML with Python REST API.
