ضبط صيغة الخلية في أوراق عمل Excel

تقوم هذه الواجهة البرمجية (REST API) بضبط صيغة الخلية في ملف Excel.

الواجهة البرمجية REST

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

الأمان والمصادقة

تتطلب واجهات Aspose.Cells Cloud APIs مصادقة تعتمد على رمز JWT وهي آمنة.

معلمات الطلب

اسم المعلمة	النوع	الموقع	الإلزام	الوصف
name	string	path	نعم	اسم ملف Excel.
sheetName	string	path	نعم	اسم ورقة العمل.
cellName	string	path	نعم	عنوان الخلية المستهدفة (مثل A1).
value	string	query	لا	القيمة المراد تعيينها للخلية.
type	string	query	لا	نوع البيانات للقيمة (مثل string).
formula	string	query	لا	الصيغة المراد تطبيقها على الخلية (مثل sum(A1,A2)).
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 باستخدام SDKs

مواصفات PostWorksheetCellSetValue API

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتمكّنك من إجراء تفاعلات REST مباشرة من متصفح الويب.

استخدم أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells عبر الويب.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet1/cells/A1?value=1234&type=string&formula=sum(A2:A15)" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access‑token>"

Response

{
  "Code": 200,
  "Status": "OK",
  "Cell":{
    "Name":"A1",
    "Row": 0,
    "Column":0,
    "Value": "",
    "Type":"String",
    "Formula" : "=Sum(A2:A15)",
    ...
  }
}

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

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

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام SDKs مختلفة:

// مثال بلغة C# – ضبط صيغة خلية
// استبدل <access-token> و <file-name> وما إلى ذلك بقيمك الخاصة.
var api = new CellsApi("<client-id>", "<client-secret>", "https://api.aspose.cloud");
var response = api.PostWorksheetCellSetValue(
    name: "myWorkbook.xlsx",
    sheetName: "Sheet1",
    cellName: "A3",
    value: "1234",
    type: "string",
    formula: "SUM(A1,A2)",
    folder: null,
    storageName: null);
Console.WriteLine(response.Status);

Java

// مثال بلغة Java – ضبط صيغة خلية
CellsApi api = new CellsApi("<client-id>", "<client-secret>", "https://api.aspose.cloud");
PostWorksheetCellSetValueRequest request = new PostWorksheetCellSetValueRequest()
        .name("myWorkbook.xlsx")
        .sheetName("Sheet1")
        .cellName("A3")
        .value("1234")
        .type("string")
        .formula("SUM(A1,A2)");
CellsResponse response = api.postWorksheetCellSetValue(request);
System.out.println(response.getStatus());

PHP

<?php
// مثال بلغة PHP – ضبط صيغة خلية
require_once('vendor/autoload.php');

$config = new Aspose\Cells\Configuration();
$config->setAppKey('<client-id>');
$config->setAppSid('<client-secret>');
$config->setHost('https://api.aspose.cloud');

$apiInstance = new Aspose\Cells\Api\CellsApi($config);
$result = $apiInstance->postWorksheetCellSetValue(
    "myWorkbook.xlsx",
    "Sheet1",
    "A3",
    "1234",
    "string",
    "SUM(A1,A2)"
);
echo $result->getStatus();
?>

Ruby

# مثال بلغة Ruby – ضبط صيغة خلية
require 'aspose_cells_cloud'

config = AsposeCellsCloud::Configuration.new
config.api_key['client_id'] = '<client-id>'
config.api_key['client_secret'] = '<client-secret>'
config.host = 'https://api.aspose.cloud'

api = AsposeCellsCloud::CellsApi.new
result = api.post_worksheet_cell_set_value(
  name: 'myWorkbook.xlsx',
  sheet_name: 'Sheet1',
  cell_name: 'A3',
  value: '1234',
  type: 'string',
  formula: 'SUM(A1,A2)'
)
puts result.status

Python

# مثال بلغة Python – ضبط صيغة خلية
import asposecellscloud

client = asposecellscloud.CellsApiClient(
    client_id='<client-id>',
    client_secret='<client-secret>',
    base_url='https://api.aspose.cloud'
)

api = asposecellscloud.CellsApi(client)
response = api.post_worksheet_cell_set_value(
    name='myWorkbook.xlsx',
    sheet_name='Sheet1',
    cell_name='A3',
    value='1234',
    type='string',
    formula='SUM(A1,A2)'
)
print(response.status)

Node.js

// مثال بلغة Node.js – ضبط صيغة خلية
const { CellsApi, ApiClient } = require('asposecellscloud');
const client = new ApiClient();
client.config = {
    clientId: '<client-id>',
    clientSecret: '<client-secret>',
    baseUrl: 'https://api.aspose.cloud'
};

const cellsApi = new CellsApi(client);
cellsApi.postWorksheetCellSetValue({
    name: 'myWorkbook.xlsx',
    sheetName: 'Sheet1',
    cellName: 'A3',
    value: '1234',
    type: 'string',
    formula: 'SUM(A1,A2)'
}).then(res => console.log(res.status));

Android

// مثال لأندرويد (Java) – ضبط صيغة خلية
// مشابه للمثال القياسي بلغة Java؛ تأكد من استخدام SDK المتوافق مع منصة Android.

Swift

مثال بلغة Swift غير متوفر حالياً. جاري تطوير SDK الخاص بلغة Swift.

Perl

# مثال بلغة Perl – ضبط صيغة خلية
use AsposeCellsCloud::CellsApi;
my $api_instance = AsposeCellsCloud::CellsApi->new(
    client_id => '<client-id>',
    client_secret => '<client-secret>',
    base_url => 'https://api.aspose.cloud'
);
my $result = $api_instance->post_worksheet_cell_set_value(
    name => 'myWorkbook.xlsx',
    sheet_name => 'Sheet1',
    cell_name => 'A3',
    value => '1234',
    type => 'string',
    formula => 'SUM(A1,A2)'
);
print $result->{Status};

// مثال بلغة Go – ضبط صيغة خلية
package main

import (
    "fmt"
    "github.com/asposecellscloud/asposecellscloud-go/v3"
)

func main() {
    config := asposecellscloud.NewConfiguration()
    config.ClientId = "<client-id>"
    config.ClientSecret = "<client-secret>"
    config.BasePath = "https://api.aspose.cloud"

    api := asposecellscloud.NewAPIClient(config).CellsApi
    resp, _, err := api.PostWorksheetCellSetValue(
        "myWorkbook.xlsx",
        "Sheet1",
        "A3",
        map[string]string{
            "value":   "1234",
            "type":    "string",
            "formula": "SUM(A1,A2)",
        },
        nil,
        nil,
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(resp.Status)
}

تعيين قيمة الخلية – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 3.0) حساب صيغة الخلية – واجهة برمجة تطبيقات Aspose.Cells Cloud