تعيين قيمة الخلية – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0)
تقوم هذه الواجهة البرمجية لواجهة برمجة التطبيقات (REST API) بتعيين قيمة الخلية في ملف إكسل.
واجهة برمجة التطبيقات (REST API)
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/{cellName}
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| الاسم | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | مسار (path) | اسم مستند إكسل (مع امتداد الملف). |
| sheetName | نص (string) | مسار (path) | اسم ورقة العمل (مع مراعاة حالة الأحرف). |
| cellName | نص (string) | مسار (path) | عنوان الخلية المستهدفة بنظام A1 (مثل A1). |
| value | نص (string) | استعلام (query) | القيمة المراد تعيينها في الخلية. |
| type | نص (string) | استعلام (query) | نوع البيانات للقيمة (int، string، float، إلخ). |
| formula | نص (string) | استعلام (query) | الصيغة المراد تطبيقها على الخلية (اختيارية). |
| folder | نص (string) | استعلام (query) | المجلد الذي يحتوي على المستند (اختياري). |
| storageName | نص (string) | استعلام (query) | اسم وحدة التخزين التي يوجد فيها الملف (اختياري). |
الاستجابة
ترجع كائن CellResponse.
- نظرة عامة على حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
Name |
نص (string) | عنوان الخلية (مثل F341). |
Row |
عدد صحيح (integer) | فهرس الصف (بدءًا من الصفر). |
Column |
عدد صحيح (integer) | فهرس العمود (بدءًا من الصفر). |
Value |
نص (string) | القيمة المعروضة في الخلية. |
Type |
نص (string) | نوع بيانات الخلية (مثل IsString). |
Formula |
نص (string) | نص الصيغة إذا كانت الخلية تحتوي على صيغة. |
IsFormula |
منطقي (bool) | يشير إلى ما إذا كانت الخلية تحتوي على صيغة. |
IsMerged |
منطقي (bool) | يشير إلى ما إذا كانت الخلية جزءًا من نطاق مدمج. |
IsArrayHeader |
منطقي (bool) | يشير إلى ما إذا كانت الخلية رأس مصفوفة. |
IsInArray |
منطقي (bool) | يشير إلى ما إذا كانت الخلية تابعة لمصفوفة. |
IsErrorValue |
منطقي (bool) | يشير إلى ما إذا كانت الخلية تحتوي على قيمة خطأ. |
IsInTable |
منطقي (bool) | يشير إلى ما إذا كانت الخلية داخل جدول. |
IsStyleSet |
منطقي (bool) | يشير إلى ما إذا تم تطبيق نمط على الخلية. |
HtmlString |
نص (string) | تمثيل القيمة بالخلية بصيغة مشفرة بـ HTML. |
Style/link |
كائن (object) | رابط تشعبي لموارد النمط. |
{
"Status":"OK",
"Code":200,
"Cell":{
"Name":"A1",
"Row": 0,
"Column":0,
"Value": "",
"Type":"String",
"Formula" : "=Sum(A2:A15)",
...
}
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostWorksheetCellSetValue API مع مكتبات SDK
مواصفات واجهة PostWorksheetCellSetValue API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، ما يمكّن المطورين من استدعاء نقاط نهاية REST مباشرةً من المتصفح أو أي عميل HTTP.
يمكنك استخدام أداة cURL سطر الأوامر لاستدعاء خدمات Aspose.Cells. يوضح المثال التالي كيفية تعيين قيمة خلية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK يُسرّع عملية التطوير من خلال التعامل مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مشروعك. راجع مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الرموز التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK المختلفة: