واجهة برمجة تطبيقات Aspose.Cells Cloud – دمج نطاق خلايا

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

نظرة عامة – يؤدي دمج النطاق إلى دمج الخلايا المحددة في خلية واحدة، مع الاحتفاظ بقيمة الخلية العلوية اليسرى وتُهمل القيم المتبقية. استخدم هذه العملية عندما تحتاج إلى إنشاء رأس يمتد عبر أعمدة أو صفوف متعددة، أو عندما ترغب في تبسيط تخطيط ورقة العمل.

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

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/merge

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	نص	المسار	اسم ملف المصنف.
sheetName	نص	المسار	اسم ورقة العمل.
range	كائن	الجسم	كائن النطاق الذي يحدد الخلايا المراد دمجها.
folder	نص	الاستعلام	المجلد الذي يُخزَّن فيه المصنف.
storageName	نص	الاستعلام	اسم وحدة التخزين.

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

يجب أن يحتوي كائن النطاق على الحقول التالية (جميع الحقول الأخرى اختيارية):

الخاصية	النوع	الإلزام	الوصف
FirstRow	عدد صحيح	نعم	مؤشر الصف الأول في النطاق (مبني على الصفر).
FirstColumn	عدد صحيح	نعم	مؤشر العمود الأول في النطاق (مبني على الصفر).
RowCount	عدد صحيح	نعم	عدد الصفوف المُضمنة في النطاق.
ColumnCount	عدد صحيح	نعم	عدد الأعمدة المُضمنة في النطاق.
Name	نص	لا	اسم اختياري للنطاق.
RefersTo	نص	لا	صيغة يشير إليها النطاق.
Worksheet	نص	لا	اسم ورقة العمل (إذا اختلف عن معلمة المسار).
RowHeight	رقم	لا	ارتفاع الصفوف في النطاق (بالبكسل).
ColumnWidth	رقم	لا	عرض الأعمدة في النطاق (بالبكسل).

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمة إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

Response

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

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

حالة HTTP	الوصف	JSON مثال
200 OK	تم دمج النطاق بنجاح.	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	معلمات النطاق غير صالحة (مثل: مؤشرات خارج النطاق).	`{ "Code": 400, "Message": "Invalid range." }`
401 Unauthorized	رمز JWT مفقود أو غير صالح.	`{ "Code": 401, "Message": "Authentication failed." }`
404 Not Found	المصنف أو ورقة العمل غير موجودين.	`{ "Code": 404, "Message": "Resource not found." }`
500 Internal Server Error	خطأ في الخادم الداخلي غير متوقع.	`{ "Code": 500, "Message": "Internal server error." }`

عائلة حزم تطوير البرامج السحابية

استخدام حزمة تطوير البرامج (SDK) هو أفضل طريقة لتسريع عملية التطوير. وتتولى حزم التطوير تفاصيل المستوى المنخفض تلقائيًا، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرامج الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام حزم تطوير البرامج المختلفة: