Documentation –

Developer-Guide: العمل مع تعليقات إكسل

Thu, 30 Jul 2026 00:00:00 +0000

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

متطلبات ما قبل التشغيل

حساب نشط في Aspose.Cells Cloud.
رمز وصول (access token) صالح تم الحصول عليه عبر بروتوكول OAuth 2.0.
إصدار واجهة برمجة التطبيقات v3.0 (النقاط النهائية المستخدمة في هذا الدليل تنتمي إلى هذا الإصدار).
اختياري: استخدام SDK الخاص بـ Aspose.Cells للغة البرمجة المفضّلة لديك لتبسيط بناء الطلبات.

الإصدارة

تستهدف الأمثلة أدناه واجهة برمجة تطبيقات Aspose.Cells Cloud REST API الإصدار 3.0. وقد تُقدّم الإصدارات المستقبلية من واجهة برمجة التطبيقات معلمات إضافية أو تُعدّل هياكل الاستجابات؛ لذا يُوصى دائمًا بالرجوع إلى مرجع واجهة برمجة التطبيقات الأحدث للحصول على التفاصيل المُحدَّثة.

إضافة تعليق

لإضافة تعليق، أرسل طلبًا من نوع POST إلى النقطة النهائية التالية:

POST https://api.aspose.cloud/v3.0/cells/{file}/worksheets/{sheet}/comments
Authorization: Bearer {access_token}
Content-Type: application/json

المعلمات في مسار الطلب

المعلمة	النوع	الإلزام	الوصف
`file`	string	نعم	اسم ملف المصنف (مع امتداده).
`sheet`	string	نعم	اسم ورقة العمل التي سيتم إضافة التعليق فيها.

مخطط جسم الطلب

الحقل	النوع	الإلزام	الوصف
`CellName`	string	نعم	عنوان الخلية بصيغة A1 (مثل B2).
`Comment`	string	نعم	نص التعليق المراد تخزينه.
`Author`	string	لا	اسم مؤلف التعليق.

مثال على جسم الطلب

{
  "CellName": "B2",
  "Comment": "يحتاج مراجعة",
  "Author": "John Doe"
}

مثال على استجابة ناجحة (200 OK)

{
  "Code": 200,
  "Status": "OK",
  "Comment": {
    "CellName": "B2",
    "Author": "John Doe",
    "HtmlComment": "يحتاج مراجعة",
    "Note": "يحتاج مراجعة"
  }
}

أكواد الأخطاء الشائعة

الكود	المعنى
400	عنوان خلية غير صالح أو جسم طلب غير صالح
401	غير مصرّح – رمز وصول مفقود أو غير صالح
404	المصنف أو ورقة العمل غير موجودين

جلب التعليقات

لجلب جميع التعليقات من ورقة عمل:

GET https://api.aspose.cloud/v3.0/cells/{file}/worksheets/{sheet}/comments
Authorization: Bearer {access_token}

المعلمات في مسار الطلب

المعلمة	النوع	الإلزام	الوصف
`file`	string	نعم	اسم ملف المصنف.
`sheet`	string	نعم	اسم ورقة العمل.

مثال على الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "Comments": [
    {
      "CellName": "A1",
      "Author": "Alice",
      "HtmlComment": "القيمة الأولية",
      "Note": "القيمة الأولية"
    },
    {
      "CellName": "B2",
      "Author": "John Doe",
      "HtmlComment": "يحتاج مراجعة",
      "Note": "يحتاج مراجعة"
    }
  ]
}

تحديث تعليق

لتعديل تعليق موجود، أرسل طلبًا من نوع PUT. ويُعرّف التعليق بـ فهرسه ضمن مجموعة التعليقات في ورقة العمل (مع بدء العد من 0).

PUT https://api.aspose.cloud/v3.0/cells/{file}/worksheets/{sheet}/comments/{commentIndex}
Authorization: Bearer {access_token}
Content-Type: application/json

المعلمات في مسار الطلب

المعلمة	النوع	الإلزام	الوصف
`file`	string	نعم	اسم ملف المصنف.
`sheet`	string	نعم	اسم ورقة العمل.
`commentIndex`	int	نعم	الفهرس (صفر-الأساس) للتعليق المراد تحديثه.

مخطط جسم الطلب

الحقل	النوع	الإلزام	الوصف
`Comment`	string	نعم	نص التعليق الجديد.
`Author`	string	لا	اسم المؤلف المحدّث (اختياري).

مثال على جسم الطلب

{
  "Comment": "نص ملاحظة محدّث",
  "Author": "John Doe"
}

وتكون الاستجابة بنفس الهيكل المستخدم في استجابة إضافة تعليق.

حذف تعليق

لحذف تعليق واحد حسب فهرسه:

DELETE https://api.aspose.cloud/v3.0/cells/{file}/worksheets/{sheet}/comments/{commentIndex}
Authorization: Bearer {access_token}

المعلمات في مسار الطلب

المعلمة	النوع	الإلزام	الوصف
`file`	string	نعم	اسم ملف المصنف.
`sheet`	string	نعم	اسم ورقة العمل.
`commentIndex`	int	نعم	الفهرس (صفر-الأساس) للتعليق المراد حذفه.

ويُعاد الاستجابة التالية عند نجاح الحذف:

{
  "Code": 200,
  "Status": "OK"
}

حذف جميع التعليقات

لمسح جميع التعليقات من ورقة عمل:

DELETE https://api.aspose.cloud/v3.0/cells/{file}/worksheets/{sheet}/comments
Authorization: Bearer {access_token}

المعلمات في مسار الطلب

المعلمة	النوع	الإلزام	الوصف
`file`	string	نعم	اسم ملف المصنف.
`sheet`	string	نعم	اسم ورقة العمل.

إرشادات معالجة الأخطاء

404 Not Found – تحقق من أن معرّف المصنف واسم ورقة العمل وفهرس التعليق صحيحة.
400 Bad Request – تحقق من صحة بناء JSON ووجود الحقول الإلزامية (CellName, Comment).
429 Too Many Requests – نفّذ آلية تأخير أسّية (exponential back-off) واحترم رأس الاستجابة Retry-After.

الملخّص

تُستخدم تعليقات إكسل لـ إضافة ملاحظة أو تفسير صيغة في خلية.
يوفّر إكسل للمستخدمين مرونة تحديث وحذف التعليقات، وعرضها أو إخفائها في ورقة العمل.
ويمكن للمستخدمين أيضًا تغيير حجم ونقل مربع التعليق.

لمزيد من المعلومات حول العمل مع عناصر جداول البيانات الأخرى، راجع الدليل الخاص بـ العمل مع الخلايا.

Developer-Guide: العمل مع أعمدة ملفات إكسل

Thu, 30 Jul 2026 00:00:00 +0000

العمل مع الأعمدة في ملف إكسل

توفر هذه الصفحة نظرة موجزة مُوجزة عن العمليات الأساسية المرتبطة بالأعمدة المتاحة عبر واجهة برمجة تطبيقات Aspose.Cells Cloud. استخدم الروابط أدناه للتنقّل إلى الوثائق التفصيلية لكل إجراء، بما في ذلك مُعطَلات الطلب وأكواد الأمثلة واستجابات العينات.

Developer-Guide: العمل مع النطاقات في Excel

Thu, 30 Jul 2026 00:00:00 +0000

يمثّل النطاق (Range) خليةً واحدة أو صفًّا كاملاً أو عمودًا كاملاً أو كتلة متصلة من الخلايا، أو نطاقًا ثلاثي الأبعاد (3-D) يمتد عبر ورقات عمل متعددة.

العمل مع النطاقات في ملف Excel

توفر واجهة Aspose.Cells Cloud REST API نقاط نهاية مخصّصة لكل عملية نطاق. وتشير القائمة التالية إلى أمثلة تفصيلية للاستخدام، مع ذكر طريقة HTTP المقابلة ونقطة النهاية لسهولة المرجع السريع.

الحصول على النطاقات المسماة داخل المصنف – يسترجع جميع النطاقات المسماة المعرّفة داخل مصنف، مع إرجاع عناوينها ونطاق تطبيقها (الscope). واجهة برمجة التطبيقات (API): GET /cells/{fileName}/worksheets/{sheetName}/namedranges.
الحصول على بيانات الخلايا بناءً على النطاق المسماة – يُعيد قيم الخلايا التي تنتمي إلى نطاق مُسَمًّى مُحدّد. واجهة برمجة التطبيقات (API): GET /cells/{fileName}/worksheets/{sheetName}/namedranges/{rangeName}/cells.
تغيير ارتفاع الصفوف داخل النطاق – يضبط ارتفاع كل صف يقع داخل النطاق المُعطى. واجهة برمجة التطبيقات (API): PUT /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/rows/height.
تغيير عرض الأعمدة داخل النطاق – يعدل عرض الأعمدة المتقاطعة مع النطاق. واجهة برمجة التطبيقات (API): PUT /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/columns/width.
دمج مجموعة من الخلايا في خلية واحدة – يدمج الخلايا المحدّدة في خلية واحدة، مع الحفاظ على القيمة الموجودة في الخلية العلوية اليسرى. واجهة برمجة التطبيقات (API): POST /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/merge.
نسخ نطاق داخل ورقة عمل مع خيارات اللصق – ينسخ نطاقًا مصدريًّا إلى نطاقٍ مقصود مع إمكانية تحديد نوع اللصق (قيم، تنسيقات، صيغ، إلخ). واجهة برمجة التطبيقات (API): POST /cells/{fileName}/worksheets/{sheetName}/ranges/{sourceRange}/copy?destCell={destRange}&pasteType={type}.
تطبيق التنسيق على النطاق – يطبّق تنسيقات الخط والتعبئة والحدود والمحاذاة على كل خلية داخل النطاق. واجهة برمجة التطبيقات (API): PUT /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/style.
إلغاء دمج الخلايا المدمجة داخل النطاق – يعكس عملية الدمج السابقة، مُستعيدًا الخلايا الفردية الأصلية. واجهة برمجة التطبيقات (API): POST /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/unmerge.
نقل النطاق المسماة مع ورقة عمل Excel – يعيد تحديد موقع النطاق المسماة إلى عنوان جديد داخل نفس ورقة العمل أو إلى ورقة عمل أخرى. واجهة برمجة التطبيقات (API): PUT /cells/{fileName}/worksheets/{sheetName}/namedranges/{rangeName}/move.
تعيين قيمة النطاق في ورقة عمل Excel – يكتب قيمةً واحدة أو مصفوفة من القيم داخل النطاق المحدّد. واجهة برمجة التطبيقات (API): PUT /cells/{fileName}/worksheets/{sheetName}/ranges/{rangeName}/value.

جميع الطلبات والاستجابات بصيغة JSON. تأكد من تضمين رأس Authorization مع رمز وصولك للتوثيق.

Developer-Guide: العمل مع كائنات OLE في Excel

Fri, 01 Mar 2024 00:00:00 +0000

كيفية العمل مع كائنات OLE في ورقة عمل Excel

توفر واجهة Aspose.Cells Cloud REST API مجموعة كاملة من العمليات لإدارة كائنات OLE برمجيًا. فيما يلي مرجع موجز لكل عملية، بما في ذلك طريقة HTTP ونمط نقطة النهاية والمعاملات المطلوبة ومثال مبسّط على الاستجابة.

كيفية استرجاع كائن OLE من ورقة عمل Excel
- الطريقة: GET
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}
- المعاملات: fileName (نص)، sheetName (نص)، oleObjectIndex (عدد صحيح)
- مثال على الاستجابة:
```
{
  "OleObject": {
    "Name": "Chart1",
    "ContentType": "image/png",
    "Width": 400,
    "Height": 300
  }
}
```
كيفية إضافة كائن OLE إلى ورقة عمل Excel
- الطريقة: POST
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects
- المعاملات: fileName، sheetName، oleObject (ثنائي أو مشفر بـ base‑64)، imageFormat (اختياري)
- مثال على جسم الطلب: multipart/form‑data مع تيار الملف.
- مثال على الاستجابة: 201 Created مع رأس موقع للكائن OLE الجديد.
كيفية تحديث كائن OLE معيّن في ورقة عمل Excel
- الطريقة: PUT
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}
- المعاملات: fileName، sheetName، oleObjectIndex، oleObject (المحتوى المُحدَّث)
- مثال على الاستجابة: 200 OK مع بيانات تعريف الكائن المحدَّثة.
كيفية تحويل كائن OLE إلى صورة في ورقة عمل Excel
- الطريقة: GET
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}/convert
- المعاملات: fileName، sheetName، oleObjectIndex، format (مثل png أو jpeg)
- مثال على الاستجابة: تيار صورة ثنائي للكائن OLE بعد التحويل.
كيفية حذف جميع كائنات OLE في ورقة عمل Excel
- الطريقة: DELETE
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects
- المعاملات: fileName، sheetName
- مثال على الاستجابة: 204 No Content يشير إلى إزالة جميع كائنات OLE.
كيفية حذف كائن OLE معيّن في ورقة عمل Excel
- الطريقة: DELETE
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}
- المعاملات: fileName، sheetName، oleObjectIndex
- مثال على الاستجابة: 204 No Content يؤكد حذف الكائن.

Developer-Guide: العمل مع التصفية التلقائية في إكسل

Mon, 01 Jan 0001 00:00:00 +0000

التصفية التلقائية هي أسرع طريقة لعرض العناصر التي تحتاجها فقط من ورقة عمل. وتتيح ميزة التصفية التلقائية للمستخدمين تصفية قائمة بناءً على معايير محددة—إما بالنص أو بالأرقام أو بالتاريخ.

أنواع مختلفة من التصفيات

تقدم Aspose.Cells Cloud واجهات برمجة تطبيقات متعددة لتطبيق أنواع مختلفة من التصفيات، مثل: تصفية بلون الخلفية، تصفية بالتاريخ، تصفية بالأرقام، تصفية بالنص، تصفية بالخلايا الفارغة، وتصفية بالخلايا غير الفارغة.

لون التعبئة	تقدم Aspose.Cells Cloud واجهة برمجة تطبيقات إضافة تصفية بلون التعبئة لتصفية البيانات بناءً على خاصية لون تعبئة الخلايا.
التاريخ	يمكن تطبيق أنواع مختلفة من التصفيات الزمنية، مثل تصفية الصفوف التي تحتوي على تواريخ في يناير 2018. استخدم واجهة برمجة تطبيقات إضافة تصفية بالتاريخ لإضافة تصفية زمنية.
التاريخ الديناميكي	تتيح التصفيات الديناميكية للتواريخ تصفية الخلايا التي تقع في شهر معيّن بغض النظر عن السنة (مثل جميع تواريخ يناير). راجع واجهة برمجة تطبيقات التصفية الديناميكية.
الأرقام	تتيح واجهة برمجة تطبيقات التصفيات المخصصة تصفية الخلايا التي تقع قيمها الرقمية ضمن نطاق معيّن.
النص	إذا احتوى عمود على نص، يمكنك اختيار الخلايا التي تحتوي على سلسلة نصية محددة باستخدام واجهة برمجة تطبيقات إضافة تصفية.
الخلايا الفارغة	لجلب الصفوف التي يكون عمود فيها فارغًا، استخدم واجهة برمجة تطبيقات مطابقة جميع الخلايا الفارغة.
الخلايا غير الفارغة	لتصفية الصفوف التي يحتوي عمود فيها على أي قيمة غير فارغة، استخدم واجهة برمجة تطبيقات مطابقة جميع الخلايا غير الفارغة.
التصفية المخصصة	تقدم Aspose.Cells Cloud واجهة برمجة تطبيقات التصفيات المخصصة للسيناريوهات المتقدمة، مثل تصفية الصفوف التي تحتوي على سلسلة نصية فرعية محددة أو التي تبدأ/تنتهي بسلسلة محددة.

عمليات التصفية التلقائية

كيفية إضافة تصفية باللون في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-color-filter/
كيفية إضافة تصفية مخصصة في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-custom-filter/
كيفية إضافة تصفية بالتاريخ في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-date-filter/
كيفية إضافة تصفية ديناميكية في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-dynamic-filter/
كيفية إضافة تصفية في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-filter/
كيفية إضافة تصفية أيقونية في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/add-icon-filter/
كيفية حذف تصفية بالتاريخ في ورقة عمل إكسل – الطريقة: DELETE، النقطة الطرفية: /cells/autofilter/delete-a-date-filter/
كيفية حذف تصفية في ورقة عمل إكسل – الطريقة: DELETE، النقطة الطرفية: /cells/delete-filter/
كيفية استرداد وصف التصفية التلقائية من ورقة عمل إكسل – الطريقة: GET، النقطة الطرفية: /cells/autofilter/get/
كيفية مطابقة جميع الخلايا الفارغة في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/match-all-blank/
كيفية مطابقة جميع الخلايا غير الفارغة في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/match-all-non-blank/
كيفية تحديث التصفية التلقائية في ورقة عمل إكسل – الطريقة: POST، النقطة الطرفية: /cells/autofilter/refresh/

Developer-Guide: العمل مع خلايا إكسل

Mon, 01 Jan 0001 00:00:00 +0000

تُعد الخلايا الكائن الأساسي للعمل في Aspose.Cells لملفات إكسل.

يستخدم المطورون عمليات الخلايا لقراءة البيانات وكتابتها وتنسيقها ودمجها وحسابها داخل أوراق عمل إكسل، مما يمكّن من تنفيذ سيناريوهات أتمتة قوية ومعالجة بيانات متقدمة.

خريطة الميزات

البيانات

الحصول على خلية مدمجة من ورقة عمل.

تعيين قيمة خلية في ورقة عمل إكسل.

تعيين صيغة لخلية في أوراق عمل إكسل.

حساب صيغ الخلايا.

التنسيق

الحصول على تنسيق الخلية من ورقة عمل إكسل.

مسح تنسيقات الخلايا في ورقة عمل إكسل.

تحديث تنسيق خلايا متعددة في ورقة عمل إكسل.

تغيير تنسيق الخلية في ورقة عمل إكسل.

تطبيق تنسيق نص غني على خلية في ورقة عمل إكسل.

مسح محتويات وتنسيقات خلايا في ورقة عمل إكسل.

إضافة أو حذف أو تحديث التنسيق الشرطي في ورقة عمل إكسل.

الدمج

دمج خلايا في ورقة عمل إكسل.

إلغاء دمج الخلايا في ورقة عمل إكسل.

الحصول على خصائص الخلايا.

Developer-Guide: العمل مع أشكال Excel

Mon, 01 Jan 0001 00:00:00 +0000

العمل مع الأشكال في ملف Excel

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

المتطلبات المسبقة: لاستخدام عمليات الأشكال، يجب أن تمتلك مفتاح API صالح لـ Aspose.Cells Cloud، وملف مصنف مُحمّل مسبقًا في السحابة.

كيفية استرجاع جميع الأشكال في ورقة عمل Excel. – يسترجع مجموعة كاملة من الأشكال الموجودة في ورقة العمل.
كيفية استرجاع شكل معين حسب الفهرس في ورقة عمل Excel. – يعيد الشكل المُحدّد الموجود عند الفهرس المُعطى.
كيفية إضافة شكل في ورقة عمل Excel. – يُدرج شكلًا جديدًا (مثل مستطيل أو خط أو صورة) داخل ورقة العمل.
كيفية حذف جميع الأشكال في ورقة عمل Excel. – يحذف جميع الأشكال من ورقة العمل في عملية واحدة.
كيفية حذف شكل معين حسب الفهرس في ورقة عمل Excel. – يحذف الشكل الموجود عند الفهرس المُعطى.
كيفية تحويل شكل إلى صورة في ورقة عمل Excel. – يحوّل الشكل المحدّد إلى ملف صورة (PNG أو JPEG وما إلى ذلك) للاستخدام الخارجي.

Developer-Guide: العمل مع أوراق عمل إكسل.

Mon, 01 Jan 0001 00:00:00 +0000

ورقة العمل عبارة عن مجموعة من الخلايا تُستخدم لتخزين البيانات ومعالجتها. يمكن أن يحتوي ملف عمل إكسل الواحد على عدة أوراق عمل.

عمليات أوراق العمل

Developer-Guide: العمل مع التحقق من صحة البيانات في Excel

Mon, 01 Jan 0001 00:00:00 +0000

يُعد التحقق من صحة البيانات في Microsoft Excel ميزة تُستخدم للتحكم في ما يمكن للمستخدم إدخاله في خلية ضمن ورقة عمل. يمكن أن تقيّد هذه الميزة الإدخالات لنطاق تاريخي معيّن، أو أعداد صحيحة فقط، أو حتى إنشاء قوائم منسدلة توفر المساحة وتعرض القيم داخل خلية واحدة. كما يمكنك تعريف رسالة مخصصة تظهر عند إدخال المستخدم قيمة غير صحيحة أو تنسيق غير صالح.

على سبيل المثال، يمكن للمستخدم تحديد اجتماع مُجدول بين الساعة 9:00 صباحًا و6:00 مساءً.

يمكن استخدام التحقق من صحة البيانات للتأكد من أن القيمة عبارة عن عدد موجب، أو تاريخ بين اليوم الخامس عشر والثلاثين من الشهر، أو تاريخ يحدث خلال الأيام الثلاثة القادمة، أو نص يحتوي على أقل من 25 حرفًا، وهكذا.

ملخّص واجهة برمجة التطبيقات

العملية	طريقة HTTP	نقطة النهاية	الوصف
الإضافة	POST	`/cells/{file}/worksheets/{sheet}/validations`	إنشاء قاعدة تحقق
الاسترجاع	GET	`/cells/{file}/worksheets/{sheet}/validations/{index}`	استرجاع قاعدة معيّنة
استرجاع الكل	GET	`/cells/{file}/worksheets/{sheet}/validations`	سرد جميع القواعد
التحديث	PUT	`/cells/{file}/worksheets/{sheet}/validations/{index}`	تعديل قاعدة
الحذف	DELETE	`/cells/{file}/worksheets/{sheet}/validations/{index}`	إزالة قاعدة
المسح	POST	`/cells/{file}/worksheets/{sheet}/validations/clear`	إزالة جميع القواعد

العمل مع قواعد التحقق من صحة البيانات في ملف Excel

Developer-Guide: العمل مع التنسيق الشرطي في Excel

Mon, 01 Jan 0001 00:00:00 +0000

التنسيق الشرطي في Excel يمكّنك من تلوين الخلايا بلون معيّن بناءً على قيمة الخلية.

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

يجعل التنسيق الشرطي من السهل تسليط الضوء على خلايا أو نطاقات خلايا مثيرة للاهتمام، والتلميح إلى القيم غير المعتادة، وتصور البيانات باستخدام أشرطة البيانات وم масحات الألوان ومجموعات الأيقونات التي تتوافق مع تباينات محددة في البيانات.

يغيّر التنسيق الشرطي مظهر الخلايا استنادًا إلى الشروط التي تحدّدها. إذا كانت الشروط صحيحة، يتم تنسيق نطاق الخلايا؛ وإذا كانت الشروط خاطئة، يبقى نطاق الخلايا دون تغيير. توجد العديد من الشروط المدمجة، ويمكنك أيضًا إنشاء شروطك الخاصة (بما في ذلك باستخدام صيغة تُقيّم إلى TRUE أو FALSE).

توفر واجهة برمجة تطبيقات Aspose.Cells Cloud مجموعة من نقاط النهاية لإدارة قواعد التنسيق الشرطي برمجيًا. العمليات المتاحة هي كالتالي:

استرداد التنسيقات الشرطية لورقة العمل – يسترِدّ جميع قواعد التنسيق الشرطي المطبّقة على ورقة العمل.
- الطريقة: GET
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings
- المعلمات: fileName (سلسلة نصية، مطلوبة)، sheetName (سلسلة نصية، مطلوبة)، ومعلمات استعلام اختيارية مثل folder وstorageName
- مثال باستخدام cURL:
```
curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings?folder=Docs&storageName=MyStorage" -H "Authorization: Bearer {access_token}"
```
استرداد التنسيق الشرطي – يُعيد تنسيقًا شرطيًّا معيّنًا باستخدام مُعرّفه.
- الطريقة: GET
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}
- المعلمات: index (عدد صحيح، مطلوب) يحدّد موضع القاعدة.
- مثال باستخدام cURL:
```
curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0" -H "Authorization: Bearer {access_token}"
```
إضافة منطقة خلية لشرط التنسيق – تضيف نطاق خلايا سيتأثر بالتنسيق الشرطي المحدّد.
- الطريقة: POST
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/cellarea
- جسم الطلب (JSON): { "FirstRow": 1, "FirstColumn": 1, "RowCount": 5, "ColumnCount": 3 }
- مثال باستخدام cURL:
```
curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/cellarea" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{"FirstRow":1,"FirstColumn":1,"RowCount":5,"ColumnCount":3}'
```
إضافة شرط لشرط التنسيق – يُعرّف شرطًا جديدًا (مثل القيمة أو الصيغة) لقاعدة التنسيق الموجودة.
- الطريقة: POST
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/condition
- جسم الطلب (JSON): { "Type": "CellValue", "Operator": "GreaterThan", "Formula1": "100" }
- مثال باستخدام cURL:
```
curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/condition" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{"Type":"CellValue","Operator":"GreaterThan","Formula1":"100"}'
```

إضافة شرط تنسيق – يُنشئ قاعدة تنسيق شرطي كاملة، بما في ذلك النوع والنمط.

الطريقة: POST
نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings

جسم الطلب (JSON):

{
  "Priority": 0,
  "Type": "HighlightCells",
  "Style": { "ForegroundColor": "FFFF0000" },
  "Condition": { "Operator": "LessThan", "Formula1": "50" },
  "CellArea": { "FirstRow": 0, "FirstColumn": 0, "RowCount": 10, "ColumnCount": 5 }
}

مثال باستخدام cURL:

curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d @condition.json

مسح جميع قواعد التنسيق الشرطي – يزيل كل قواعد التنسيق الشرطي من ورقة العمل المستهدفة.
- الطريقة: DELETE
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings
- مثال باستخدام cURL:
```
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings" -H "Authorization: Bearer {access_token}"
```
إزالة منطقة الخلايا من التنسيق الشرطي – تحذف منطقة خلايا مُعرّفة مسبقًا من قاعدة تنسيق شرطي.
- الطريقة: DELETE
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/cellarea
- مثال باستخدام cURL:
```
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/cellarea" -H "Authorization: Bearer {access_token}"
```
إزالة التنسيق الشرطي – يحذف قاعدة تنسيق شرطي كاملة من ورقة العمل.
- الطريقة: DELETE
- نقطة النهاية: /cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}
- مثال باستخدام cURL:
```
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0" -H "Authorization: Bearer {access_token}"
```

تُوضّح الأمثلة أعلاه الطريقة المطلوبة لطلب HTTP، ونمط عنوان URL، والمعلمات الأساسية، وحمولات الطلبات النموذجية لكل عملية. إذا رغبت، يمكنك استخدام SDK المناسب (C# أو Java أو Python وما إلى ذلك) للحصول على مقاطع كود مُخصّصة للغات برمجة معيّنة.

Developer-Guide: العمل مع صور Excel

Mon, 01 Jan 0001 00:00:00 +0000

العمل مع الصور في ملف Excel

يشرح هذا الدليل كيفية التعامل مع الصور (والتي تُعرف أيضًا بالصور الرقمية) في أوراق عمل Excel من خلال واجهة Aspose.Cells Cloud REST API. ويتناول العمليات الأساسية المتعلقة بالصور—استرجاعها، وإضافتها، وتحديثها، وحذفها—ويوجهك إلى أمثلة مفصّلة لكل مهمة.

المتطلبات المسبقة: حساب Aspose.Cells Cloud ومفتاح API صالح وحزمة تطوير البرمجيات (SDK) المناسبة المُثبَّتة للغة البرمجة التي تختارها.

كيفية استرجاع صورة بتنسيق معيّن من ورقة عمل Excel. – استرجاع صورة واحدة بتنسيق مطلوب (PNG، JPEG، إلخ) من ورقة العمل.
كيفية استرجاع معلومات جميع الصور من ورقة عمل Excel. – سرد البيانات التعريفية لكل صورة موجودة في ورقة العمل.
كيفية إضافة صورة إلى ورقة عمل Excel. – إدخال صورة جديدة إلى ورقة العمل، مع تحديد موقعها وحجمها.
كيفية تحديث صورة معيّنة من ورقة عمل Excel. – تعديل خصائص الصورة (مثل الأبعاد والموقع) لصورة موجودة مسبقًا.
كيفية حذف جميع الصور من ورقة عمل Excel. – إزالة كائنات الصور جميعها من ورقة العمل في استدعاء واحد.
كيفية حذف صورة معيّنة من ورقة عمل Excel. – حذف صورة واحدة محددة حسب فهرسها.

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

استرجاع صورة بتنسيق معيّن

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	طلب مثال	استجابة مثال	رموز الحالة
GET	`/cells/{fileName}/worksheets/{sheetName}/pictures/{pictureIndex}`	`fileName` (مسار)، `sheetName` (مسار)، `pictureIndex` (مسار)، `format` (استعلام)	`GET https://api.aspose.cloud/v3.0/cells/myBook.xlsx/worksheets/Sheet1/pictures/0?format=png`	بيانات الصورة الثنائية (PNG، JPEG، إلخ)	200 OK، 400 طلب غير صالح، 401 غير مُصرّح، 404 غير موجود، 500 خطأ في الخادم

استرجاع معلومات جميع الصور

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	طلب مثال	استجابة مثال	رموز الحالة
GET	`/cells/{fileName}/worksheets/{sheetName}/pictures`	`fileName` (مسار)، `sheetName` (مسار)	`GET https://api.aspose.cloud/v3.0/cells/myBook.xlsx/worksheets/Sheet1/pictures`	مصفوفة JSON تحتوي على بيانات تعريفية للصور (الفهرس، الاسم، الموقع، الحجم)	200 OK، 400، 401، 404، 500

إضافة صورة

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	جسم الطلب المثال	استجابة مثال	رموز الحالة
POST	`/cells/{fileName}/worksheets/{sheetName}/pictures`	`fileName` (مسار)، `sheetName` (مسار)	`{ "image": "<base64‑encoded‑image>", "upperLeftRow": 5, "upperLeftColumn": 2, "width": 200, "height": 150 }`	`{ "code": 200, "status": "OK", "pictureIndex": 3 }`	201 تم الإنشاء، 400، 401، 404، 500

تحديث صورة

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	جسم الطلب المثال	استجابة مثال	رموز الحالة
PUT	`/cells/{fileName}/worksheets/{sheetName}/pictures/{pictureIndex}`	`fileName` (مسار)، `sheetName` (مسار)، `pictureIndex` (مسار)	`{ "upperLeftRow": 10, "upperLeftColumn": 4, "width": 300, "height": 250 }`	`{ "code": 200, "status": "OK" }`	200 OK، 400، 401، 404، 500

حذف جميع الصور

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	طلب مثال	استجابة مثال	رموز الحالة
DELETE	`/cells/{fileName}/worksheets/{sheetName}/pictures`	`fileName` (مسار)، `sheetName` (مسار)	`DELETE https://api.aspose.cloud/v3.0/cells/myBook.xlsx/worksheets/Sheet1/pictures`	`{ "code": 200, "status": "All pictures deleted." }`	200 OK، 400، 401، 404، 500

حذف صورة معيّنة

طريقة HTTP	نقطة النهاية	المعاملات المطلوبة	طلب مثال	استجابة مثال	رموز الحالة
DELETE	`/cells/{fileName}/worksheets/{sheetName}/pictures/{pictureIndex}`	`fileName` (مسار)، `sheetName` (مسار)، `pictureIndex` (مسار)	`DELETE https://api.aspose.cloud/v3.0/cells/myBook.xlsx/worksheets/Sheet1/pictures/2`	`{ "code": 200, "status": "Picture deleted." }`	200 OK، 400، 401، 404، 500

مواضيع ذات صلة

استكشف عمليات أخرى مرتبطة بالصور في Aspose.Cells Cloud:

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

Developer-Guide: العمل مع فواصل الصفحات في إكسل

Mon, 01 Jan 0001 00:00:00 +0000

كيفية العمل مع فواصل الصفحات في ورقة عمل إكسل

يقدّم هذا الدليل وصولًا سريعًا إلى عمليات واجهة برمجة التطبيقات لإدارة فواصل الصفحات العمودية والأفقية في ورقة عمل إكسل باستخدام Aspose.Cells Cloud.

Developer-Guide: العمل مع كائن ListObject في Excel

Mon, 01 Jan 0001 00:00:00 +0000

توفر كائنات ListObject (الجداول) في Excel طريقة منظمة لتنظيم مجموعات البيانات. وتشمل ميزات مثل تنظيم البيانات تلقائيًا، وصفوف الرؤوس، وفلاتر مدمجة، وصفوف مجموعات اختيارية. اتقن هذه القدرات لتحليل بياناتك بسرعة وكفاءة.

تعريف ListObject: كائن ListObject هو كائن الجدول الأصلي في Excel الذي يجمع الصفوف والأعمدة، ويتيح الفرز والتصفية والتنسيق، ويمكن الوصول إليه عبر واجهة Aspose.Cells Cloud API.

كيفية العمل مع الجدول (كائن List)

مرجع API (نظرة عامة):
تقدم واجهة Aspose.Cells Cloud REST API عمليات ListObject من خلال نقاط نهاية مثل GET /cells/{fileName}/worksheets/{sheetName}/listobjects وPOST /cells/{fileName}/worksheets/{sheetName}/listobjects وPUT /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex} وDELETE /cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex}. وتشمل معلمات الاستعلام المطلوبة folder (مطلوبة) وstorage (اختيارية). وتحتوي أجسام الطلبات على كائنات JSON تصف خصائص الجدول (الاسم، ووجود صف الرؤوس، ووجود صف المجموعات، إلخ)، بينما تُعيد الاستجابات أحمال JSON تحتوي على تفاصيل ListObject التي تم إنشاؤها أو تعديلها.

المتطلبات المسبقة:

رمز مصادقة صالح لـ Aspose.Cells Cloud.
يجب رفع ملف مصنف Excel إلى موقع تخزين مدعوم (الافتراضي: /)، ويجب أن تشير معلمة الاستعلام folder إلى هذا الموقع.
اختياري: اضبط storage إذا كنت تستخدم خدمة تخزين غير افتراضية.

تفاصيل نقاط النهاية

الطريقة	نقطة النهاية	معلمات الاستعلام	جسم الطلب (JSON)	استجابة النجاح (مثال)	رموز الحالة
GET	`/cells/{fileName}/worksheets/{sheetName}/listobjects`	`folder` (مطلوبة)، `storage` (اختيارية)	لا شيء	`{ "ListObjects": [ { "Name": "Table1", "ShowHeaderRow": true, "ShowTotalRow": false, ... } ] }`	200 – ناجح، 400 – طلب غير صالح، 401 – غير مُصرّح، 404 – غير موجود
POST	`/cells/{fileName}/worksheets/{sheetName}/listobjects`	`folder` (مطلوبة)، `storage` (اختيارية)	`{ "Name": "Table1", "StartRow": 0, "StartColumn": 0, "TotalRows": 10, "TotalColumns": 5, "ShowHeaderRow": true, "ShowTotalRow": false }`	`{ "Code": 200, "Status": "OK", "ListObject": { "Name": "Table1", "ShowHeaderRow": true, ... } }`	201 – تم الإنشاء، 400 – طلب غير صالح، 401 – غير مُصرّح، 409 – تضارب
PUT	`/cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex}`	`folder` (مطلوبة)، `storage` (اختيارية)	`{ "Name": "UpdatedTable", "ShowTotalRow": true }`	`{ "Code": 200, "Status": "OK", "ListObject": { "Name": "UpdatedTable", "ShowTotalRow": true, ... } }`	200 – ناجح، 400 – طلب غير صالح، 401 – غير مُصرّح، 404 – غير موجود
DELETE	`/cells/{fileName}/worksheets/{sheetName}/listobjects/{listObjectIndex}`	`folder` (مطلوبة)، `storage` (اختيارية)	لا شيء	`{ "Code": 200, "Status": "Deleted" }`	200 – ناجح، 400 – طلب غير صالح، 401 – غير مُصرّح، 404 – غير موجود

مقتطفات كود

C# (POST – إضافة ListObject)

var api = new CellsApi("client_id", "client_secret");
var request = new ListObject
{
    Name = "MyTable",
    StartRow = 0,
    StartColumn = 0,
    TotalRows = 20,
    TotalColumns = 5,
    ShowHeaderRow = true,
    ShowTotalRow = false
};
var response = api.PostWorksheetListObject("Book1.xlsx", "Sheet1", request, folder: "", storage: null);
Console.WriteLine(response.ListObject.Name);

Java (GET – استرجاع ListObjects)

CellsApi apiInstance = new CellsApi();
ListObjectResponse result = apiInstance.getWorksheetListObjects("Book1.xlsx", "Sheet1", null, null);
System.out.println(result.getListObjects());

Python (PUT – تحديث ListObject)

from asposecellscloud import CellsApi, ListObject
api = CellsApi(client_id, client_secret)
list_obj = ListObject(name="UpdatedTable", show_total_row=True)
response = api.put_worksheet_list_object(
    "Book1.xlsx", "Sheet1", 0, list_obj, folder="", storage=None)
print(response.list_object.name)

Node.js (DELETE – إزالة ListObject)

const { CellsApi } = require("asposecellscloud");
const api = new CellsApi(clientId, clientSecret);
api.deleteWorksheetListObject("Book1.xlsx", "Sheet1", 0, { folder: "" })
   .then(res => console.log("Deleted:", res.body));

ملاحظات:

تبدأ فهارس ListObject من الصفر.
عند إضافة ListObject، تحدّد StartRow وStartColumn الخلية العلوية اليسرى للجدول.
تدعم الواجهة الترقيم الصفحي عبر معلمتَي الاستعلام offset وlimit (غير مذكورَين في الجدول) للورقات الكبيرة.
حدود معدل الطلبات: 100 طلب في الدقيقة لكل حساب؛ ويُعيد تجاوز هذا الحد رمز الحالة 429 Too Many Requests.

من خلال تضمين مصطلح Excel ListObject عدة مرات في الصفحة، يتوافق المحتوى مع الكلمات المفتاحية المستهدفة مثل “Excel ListObject” و"Aspose.Cells Cloud" و"واجهة برمجة تطبيقات جداول Excel"، مما يحسّن محركات البحث (SEO) مع الحفاظ على طبيعة طبيعية للقراء.

Developer-Guide: العمل مع مخططات إكسل

Mon, 01 Jan 0001 00:00:00 +0000

العمل مع المخططات في ملف إكسل

آخر تحديث: يوليو 2026

تمثل مخططات إكسل تمثيلات مرئية للبيانات، مما يساعد المستخدمين على فهم الاتجاهات والأنماط بسرعة.
تمكن واجهة برمجة تطبيقات Aspose.Cells السحابية المطورين من العمل مع هذه المخططات برمجيًا داخل كتب عمل إكسل المخزَّنة في السحابة. باستخدام هذه الواجهة، يمكنك استرجاع المخططات الموجودة، وإضافة مخططات جديدة، وتعديل خصائصها (مثل العناوين والمحاور والأساطير)، وحذف المخططات غير المرغوب فيها، وتحويل المخططات إلى صيغ صور لغرض إعداد التقارير أو المعالجة اللاحقة. تُوفّر الروابط التالية وصولًا مباشرًا إلى صفحات العمليات التفصيلية لكل إجراء مدعوم مرتبط بالمخططات.

مرجع سريع

العملية	طريقة HTTP	نقطة النهاية (قالب)	الوثائق
استرجاع المخطط	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}`	استرجاع مخطط من ورقة عمل
إضافة مخطط	POST	`/cells/{file}/worksheets/{sheet}/charts`	إضافة مخطط في ورقة عمل
حذف جميع المخططات	DELETE	`/cells/{file}/worksheets/{sheet}/charts`	حذف جميع المخططات من ورقة عمل
حذف مخطط	DELETE	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}`	حذف مخطط من ورقة عمل
تحويل المخطط إلى صورة	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/image`	تحويل المخطط إلى صورة
استرجاع منطقة المخطط	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/area`	استرجاع منطقة المخطط من ورقة عمل
استرجاع تنسيق التعبئة	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/area/fillformat`	استرجاع تنسيق التعبئة لمنطقة المخطط من ورقة عمل
استرجاع الأسطورة	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/legend`	استرجاع أسطورة المخطط من ورقة عمل
تحديث الأسطورة	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/legend`	تحديث أسطورة المخطط في ورقة عمل
إظهار الأسطورة	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/legend/show`	إظهار أسطورة المخطط في ورقة عمل
إخفاء الأسطورة	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/legend/hide`	إخفاء أسطورة المخطط في ورقة عمل
استرجاع العنوان	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/title`	استرجاع عنوان المخطط من ورقة عمل
تحديد العنوان	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/title`	تحديد عنوان المخطط في ورقة عمل إكسل
تحديث العنوان	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/title`	تحديث عنوان المخطط في ورقة عمل إكسل
حذف العنوان	DELETE	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/title`	حذف عنوان المخطط في ورقة عمل
تحديث خصائص المخطط	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}`	تحديث خصائص المخطط
استرجاع المحور التصنيفي	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/categoryaxis`	استرجاع المحور التصنيفي للمخطط
استرجاع المحور القيمي	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/valueaxis`	استرجاع المحور القيمي للمخطط
استرجاع المحور التصنيفي الثاني	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/secondcategoryaxis`	استرجاع المحور التصنيفي الثاني للمخطط
استرجاع المحور القيمي الثاني	GET	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/secondvalueaxis`	استرجاع المحور القيمي الثاني للمخطط
تحديث المحور التصنيفي	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/categoryaxis`	تحديث المحور التصنيفي للمخطط
تحديث المحور القيمي	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/valueaxis`	تحديث المحور القيمي للمخطط
تحديث المحور التصنيفي الثاني	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/secondcategoryaxis`	تحديث المحور التصنيفي الثاني للمخطط
تحديث المحور القيمي الثاني	POST	`/cells/{file}/worksheets/{sheet}/charts/{chartIndex}/secondvalueaxis`	تحديث المحور القيمي الثاني للمخطط

Developer-Guide: العمل مع روابط الربط في Excel

Mon, 01 Jan 0001 00:00:00 +0000

تتيح روابط الربط في Excel للمستخدمين إنشاء اختصارات لورقات العمل أو الملفات أو المجلدات أو صفحات الويب، مما يسهّل التنقّل السريع إلى مواقع محددة.

متطلبات مسبقة: رمز API صالح (انظر دليل المصادقة) وتنصيب SDK الخاص بـ Cells.Cloud.

العمل مع روابط الربط في ملف Excel

كيفية استرجاع وصف رابط الربط من ورقة عمل Excel. – استرجاع تفاصيل رابط ربط واحد، بما في ذلك عنوان الهدف والنص المعروض.
كيفية استرجاع وصف جميع روابط الربط من ورقة عمل Excel. – سرد كل رابط ربط معرّف في ورقة العمل مع خصائصه المقابلة.
كيفية إضافة روابط ربط إلى ورقة عمل Excel – إدخال رابط ربط جديد في ورقة العمل، مع تحديد عنوان URL الهدف ونطاق الخلية.
كيفية تحديث روابط الربط في ورقة عمل Excel – تعديل عنوان رابط الربط الحالي أو النص المعروض أو خلية الهدف.
كيفية حذف جميع روابط الربط من ورقة عمل Excel – إزالة جميع روابط الربط من ورقة العمل في عملية واحدة.
كيفية حذف رابط ربط من ورقة عمل Excel – حذف رابط ربط محدّد يُعرّف بواسطة فهرسه أو مرجع الخلية.

Developer-Guide:

Thu, 30 Jul 2026 00:00:00 +0000

title: “العمل مع جداول البيانات المُلخّصة في Excel” second_title: “Document” linktitle: “جداول البيانات المُلخّصة” type: docs url: /ar/pivottables/ aliases: [/ar/working-with-pivot-tables/] keywords: “Excel، جدول بيانات مُلخّص، Aspose.Cells Cloud، API، جداول بيانات، تحليل البيانات، REST API” description: “دليل شامل لاستخدام واجهات برمجة تطبيقات Aspose.Cells Cloud REST لإنشاء جداول البيانات المُلخّصة، واسترجاعها، وتحديثها، وحذفها في أوراق عمل Excel. يشمل مراجع SDK، وأمثلة على استدعاءات API، وملاحظات حول الإصدارات.” weight: 100 ArticleTitle: “العمل مع جداول البيانات المُلخّصة في Excel – وثائق Aspose.Cells Cloud”

العمل مع جداول البيانات المُلخّصة في ملف Excel

تُعتبر جداول البيانات المُلخّصة (PivotTables) أدوات قوية لتلخيص البيانات في Excel، وتتيح للمطورين تجميع البيانات وتصفيتها وتحليلها ديناميكيًا على مجموعات بيانات كبيرة. توفر واجهة برمجة تطبيقات Aspose.Cells Cloud نقاط نهاية (Endpoints) لإنشاء جداول البيانات المُلخّصة واسترجاعها وتعديلها وحذفها برمجيًا، مما يمكّن من دمجها بسلاسة في تطبيقاتك.

المتطلبات الأساسية – يجب أن تمتلك رمز مصادقة صالحًا لخدمة Aspose.Cells Cloud، وأن يكون لديك SDK مدعوم (مثل .NET أو Java أو Python أو Go أو Node.js أو PHP أو Ruby أو Swift) مُثبّتًا في مشروعك.

مثال على استدعاء API – لاسترجاع جميع جداول البيانات المُلخّصة في ورقة عمل معيّنة، أرسل طلب GET على النحو التالي:

GET https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/pivottables

ملاحظات – تتطلب هذه العمليات إصدار Aspose.Cells Cloud 3.0 أو أحدث.

Developer-Guide:

Thu, 30 Jul 2026 00:00:00 +0000

title: “العمل مع صفوف ملفات إكسل – واجهة Aspose.Cells Cloud API” ArticleTitle: “العمل مع صفوف ملفات إكسل – واجهة Aspose.Cells Cloud API” second_title: “مستند” linktype: “docs” url: /rows/ aliases: [/working-with-rows/] keywords: “Aspose.Cells, صفوف إكسل, واجهة REST API, تعديل جداول البيانات” description: “قم بتعديل الصفوف في ملفات إكسل باستخدام واجهة Aspose.Cells Cloud REST API. يدعم منصات أندرويد، C#، Go، Java، Node.js، Perl، PHP، Python، Ruby، و Swift.” weight: 100

العمل مع الصفوف في ملف إكسل

آخر تحديث: يوليو 2026

مرجع سريع لواجهة API للعمليات الشائعة على الصفوف:

العملية	طريقة HTTP	نقطة النهاية	المعلمات الرئيسية
الحصول على صف	GET	`/cells/{fileName}/worksheets/{sheetName}/rows/{rowIndex}`	`fileName`, `sheetName`, `rowIndex`
إضافة صف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows`	`rowIndex`, `height`
نسخ الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/copy`	`sourceIndex`, `destinationIndex`, `rowCount`
حذف صف	DELETE	`/cells/{fileName}/worksheets/{sheetName}/rows/{rowIndex}`	`fileName`, `sheetName`, `rowIndex`
إخفاء الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/hide`	`startIndex`, `endIndex`
إظهار الصفوف المخفية	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/unhide`	`startIndex`, `endIndex`
تجميع الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/group`	`startIndex`, `endIndex`
إلغاء تجميع الصفوف	POST	`/cells/{fileName}/worksheets/{sheetName}/rows/ungroup`	`startIndex`, `endIndex`

تفاصيل الطلب والاستجابة

الحصول على صف
الطلب: لا يوجد محتوى مطلوب.
الاستجابة (200):
```
{
  "RowIndex": 5,
  "Height": 15.0,
  "IsHidden": false,
  "Style": { ... }
}
```
الأخطاء: 400 Bad Request (مؤشر غير صالح)، 404 Not Found (ملف أو ورقة مفقودة).
إضافة صف
محتوى الطلب (JSON):
```
{
  "RowIndex": 10,
  "Height": 20.0
}
```
الاستجابة (201):
```
{ "Code": "Success", "Status": "Row added", "RowIndex": 10 }
```
الأخطاء: 400 Bad Request (معلمات مفقودة أو غير صالحة)، 401 Unauthorized.

نسخ الصفوف
محتوى الطلب (JSON):

{
  "SourceIndex": 2,
  "DestinationIndex": 8,
  "RowCount": 3
}

الاستجابة (200):

{ "Code": "Success", "Status": "Rows copied" }

الأخطاء: 400 Bad Request، 404 Not Found.

حذف صف
الطلب: لا يوجد محتوى.
الاستجابة (200):
```
{ "Code": "Success", "Status": "Row deleted", "RowIndex": 7 }
```
الأخطاء: 400 Bad Request، 404 Not Found.
إخفاء الصفوف
محتوى الطلب (JSON):
```
{ "StartIndex": 3, "EndIndex": 5 }
```
الاستجابة (200): { "Code": "Success", "Status": "Rows hidden" }
الأخطاء: 400 Bad Request.
إظهار الصفوف المخفية – نفس محتوى الطلب مثل إخفاء الصفوف؛ الاستجابة متماثلة، والحالة تكون “Rows unhidden”.
تجميع الصفوف – نفس محتوى الطلب مثل إخفاء الصفوف؛ حالة الاستجابة تكون “Rows grouped”.
إلغاء تجميع الصفوف – نفس محتوى الطلب مثل إخفاء الصفوف؛ حالة الاستجابة تكون “Rows ungrouped”.

تتطلب جميع العمليات رمز وصول ساري لبروتوكول OAuth 2.0/JWT وإصدارًا مناسبًا من مكتبة SDK.

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: “العمل مع بيانات وصف Excel والخصائص” second_title: “مستند” linktype: “البيانات الوصفية والخصائص” type: docs url: /metadata/ aliases:

/document-properties/
/working-with-document-properties/ keywords: “Aspose.Cells Cloud، بيانات وصف Excel، واجهة برمجة تطبيقات خصائص المستند، واجهة برمجة تطبيقات REST، جلب البيانات الوصفية، تحديث خصائص Excel، حذف بيانات وصف Excel” description: “تعرّف على كيفية قراءة وإضافة وتحديث وحذف بيانات وصف ملفات Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud REST. يتضمّن أمثلة لـ cURL وSDKs عبر Java و.NET وPython وNode.js والمزيد.” ArticleTitle: “العمل مع بيانات وصف Excel وخصائص المستند – Aspose.Cells Cloud” weight: 100

يمكن لملفات Excel تخزين مجموعة متنوعة من البيانات الوصفية التي تساعد في تحديد المستندات وتنظيمها وإدارتها. توفر Aspose.Cells Cloud واجهة برمجة تطبيقات REST بسيطة لقراءة هذه البيانات الوصفية وإضافتها وتحديثها وحذفها، مما يمكّن المطورين من دمج إدارة خصائص المستندات في تطبيقاتهم. يغطي هذا الدليل الفئتين الرئيسيتين من الخصائص—القياسية والمخصصة—ويوضّح كيفية العمل معهما، ويقدّم روابط مباشرة لنقاط النهاية ذات الصلة بواجهة برمجة التطبيقات. ستجد أيضًا جدول مرجعي موجز لواجهة برمجة التطبيقات مع تفاصيل الطلبات لتسريع عملية التنفيذ.

آخر تحديث: 8 يوليو، 2026

أنواع خصائص المستند

قبل تعلّم كيفية استخدام واجهات برمجة تطبيقات Aspose.Cells Cloud لعرض خصائص المستند (البيانات الوصفية) وتعديلها وحذفها في ملفات Excel، دعنا نوضّح أنواع الخصائص التي يمكن أن يحتوي عليها مستند Excel.

الخصائص القياسية هي خصائص مشتركة في Excel. تحتوي على معلومات أساسية مثل العنوان (Title) والموضوع (Subject) والمؤلف (Author) والفئة (Category) وما إلى ذلك. يمكنك تعيين قيم نصية مخصصة لهذه الخصائص لتسهيل العثور على الملف.
الخصائص المخصصة هي خصائص يحدّدها المستخدم. تسمح لك بإضافة بيانات وصفية إضافية إلى مستند Excel.

كيفية العمل مع خصائص المستند في ملف Excel

مرجع واجهة برمجة التطبيقات (بدون استخدام التخزين)

الطريقة	نقطة النهاية	الوصف
GET	`GET https://api.aspose.cloud/v3.0/cells/metadata`	تسترجع جميع خصائص المستند الخاصة بورقة العمل المخزّنة في السحابة.
GET	`GET https://api.aspose.cloud/v3.0/cells/metadata/{propertyName}`	تسترجع قيمة خاصية معيّنة (قياسية أو مخصصة) مُعرّفة بواسطة `propertyName`.
PUT	`PUT https://api.aspose.cloud/v3.0/cells/metadata/{propertyName}`	تُحدّث قيمة خاصية موجودة. تحتوي هيئة الطلب على القيمة الجديدة بصيغة JSON.
DELETE	`DELETE https://api.aspose.cloud/v3.0/cells/metadata/{propertyName}`	تحذف خاصية معيّنة من ورقة العمل.
DELETE	`DELETE https://api.aspose.cloud/v3.0/cells/metadata`	يمسح جميع الخصائص المخصصة والقياسية من ورقة العمل.

Documentation –

Developer-Guide: العمل مع تعليقات إكسل

لمزيد من المعلومات حول العمل مع عناصر جداول البيانات الأخرى، راجع الدليل الخاص بـ العمل مع الخلايا.

Developer-Guide: العمل مع أعمدة ملفات إكسل

العمل مع الأعمدة في ملف إكسل

Developer-Guide: العمل مع النطاقات في Excel

العمل مع النطاقات في ملف Excel

Developer-Guide: العمل مع كائنات OLE في Excel

Developer-Guide: العمل مع التصفية التلقائية في إكسل

Developer-Guide: العمل مع خلايا إكسل

خريطة الميزات

Developer-Guide: العمل مع أشكال Excel

العمل مع الأشكال في ملف Excel

Developer-Guide: العمل مع أوراق عمل إكسل.

Developer-Guide: العمل مع التحقق من صحة البيانات في Excel

ملخّص واجهة برمجة التطبيقات

العمل مع قواعد التحقق من صحة البيانات في ملف Excel

Developer-Guide: العمل مع التنسيق الشرطي في Excel

Developer-Guide: العمل مع صور Excel

العمل مع الصور في ملف Excel

Developer-Guide: العمل مع فواصل الصفحات في إكسل

كيفية العمل مع فواصل الصفحات في ورقة عمل إكسل

Developer-Guide: العمل مع كائن ListObject في Excel

كيفية العمل مع الجدول (كائن List)

Developer-Guide: العمل مع مخططات إكسل

العمل مع المخططات في ملف إكسل

مرجع سريع

Developer-Guide: العمل مع روابط الربط في Excel

العمل مع روابط الربط في ملف Excel

Developer-Guide:

العمل مع جداول البيانات المُلخّصة في ملف Excel

Developer-Guide:

العمل مع الصفوف في ملف إكسل

Developer-Guide:

تتطلّب جميع الطلبات رمز وصول OAuth 2.0، وقد تتضمّن معلمات استعلام اختيارية مثل storage وfolder عند استخدام موقع تخزين معيّن.

تتطلّب جميع الطلبات رمز وصول OAuth 2.0، وقد تتضمّن معلمات استعلام اختيارية مثل `storage` و`folder` عند استخدام موقع تخزين معيّن.