Documentation –

Developer-Guide: ConvertRangeToPdf

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

خدمة تحويل النطاق إلى PDF في Aspose.Cells Cloud Web Services

يُحوّل نطاقًا من جدول بيانات على محرك محلي إلى ملف PDF.

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

PUT https://api.aspose.cloud/v4.0/cells/convert/range/pdf

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

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

معاملات الطلب

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات.
range	نص	استعلام	منطقة الخلايا. مثال: A1:C10
outPath	نص	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه كتاب العمل. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم وحدة التخزين الخاصة بالملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصصة.
AutoRowsFit	منطقي (Boolean)	استعلام	(اختياري) ضبط ارتفاع جميع الصفوف في أوراق العمل تلقائيًا.
AutoColumnsFit	منطقي (Boolean)	استعلام	(اختياري) ضبط عرض جميع الأعمدة في أوراق العمل تلقائيًا.
region	نص	استعلام	إعدادات منطقة/لغة جدول البيانات (مثل `en-US` أو `fr-FR`). تؤثر على تنسيق الأرقام، وتفسير التواريخ، والسلوك الخاص باللغة المحلية.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

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

اسم المعامل	النوع	الوصف
Spreadsheet	ملف	رفع ملف جدول البيانات.

الاستجابة

{
  "file": "<محتوى PDF ثنائي>"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	ناجح	تم التحويل بنجاح؛ يُعيد تدفق ملف PDF المُولّد.
400	طلب غير صالح	عنوان URL غير صحيح.
401	غير مُعتمد	فشلت المصادقة، أو لم تُقدَّم أي بيانات اعتماد.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	واجه جدول البيانات مشكلة أثناء استرجاع بيانات التحويل.

كيفية استخدام ConvertRangeToPdf مع مكتبات تطوير البرمجيات (SDKs)

مواصفات ConvertRangeToPdf

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}

{< tab tabNum=“1” >}

# استخدام HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/range/pdf?worksheet=Sheet1&range=A1:C10" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/pdf" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "file": "<محتوى PDF ثنائي>"
}

{< /tab >}

{< /tabs >}

استخدام مكتبات تطوير Aspose.Cells Cloud (SDKs)

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose Cells Cloud باستخدام مكتبات تطوير مختلفة:

// كود مثال للمكتبة في C#
var apiInstance = new ConversionApi();
var file = File.OpenRead("sample.xlsx");
var result = apiInstance.ConvertRangeToPdf(file, "Sheet1", "A1:C10", outPath: null, outStorageName: null, fontsLocation: null, autoRowsFit: null, autoColumnsFit: null, region: null, password: null);
File.WriteAllBytes("output.pdf", result);

// كود مثال للمكتبة في Java
ConversionApi api = new ConversionApi();
File file = new File("sample.xlsx");
byte[] result = api.convertRangeToPdf(file, "Sheet1", "A1:C10", null, null, null, null, null, null, null);
Files.write(Paths.get("output.pdf"), result);

# كود مثال للمكتبة في Python
api_instance = conversion_api.ConversionApi()
with open("sample.xlsx", "rb") as f:
    result = api_instance.convert_range_to_pdf(f, worksheet="Sheet1", range="A1:C10")
    with open("output.pdf", "wb") as out_file:
        out_file.write(result)

// كود مثال للمكتبة في JavaScript/Node.js
const fs = require('fs');
const { ConversionApi } = require('asposecellscloud');
const apiInstance = new ConversionApi();

let file = fs.createReadStream('sample.xlsx');
apiInstance.convertRangeToPdf(file, { worksheet: 'Sheet1', range: 'A1:C10' })
    .then((result) => {
        fs.writeFileSync('output.pdf', result);
    })
    .catch((error) => console.error(error));

`[TBD]`

Developer-Guide: تحويل الجدول إلى CSV

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

تحويل الجدول إلى CSV باستخدام خدمات الويب الخاصة بـ Aspose.Cells Cloud

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

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/csv

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

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

معاملات الطلب

اسم المعامل	النوع	المسار/سلسلة الاستعلام/جسم الطلب HTTP	الوصف
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات.
tableName	نص	استعلام	اسم الجدول.
outPath	نص	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه الملف المُحتوى. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مساحة التخزين للملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصصة.
AutoRowsFit	منطقي	استعلام	(اختياري) ضبط ارتفاع جميع الصفوف في أوراق العمل تلقائيًا.
AutoColumnsFit	منطقي	استعلام	(اختياري) ضبط عرض جميع الأعمدة في أوراق العمل تلقائيًا.
region	نص	استعلام	إعدادات منطقة/لغة جدول البيانات (مثل `en-US`، `fr-FR`)، وتؤثر في تنسيق الأرقام، وتحليل التواريخ، والسلوك المُعتمد على الإعدادات المحلية.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

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

اسم المعامل	النوع	الوصف
بلا	بلا	لا يُطلَب جسم طلب؛ يُرسل الملف كبيانات multipart/form-data.

الاستجابة

{
  "file": "تدفق ثنائي لملف CSV المُولَّد"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	ناجح	تم تحويل الجدول بنجاح وعودة ملف CSV.
400	طلب غير صالح	معاملات طلب غير صحيحة أو عنوان URL غير منسق بشكل جيد.
401	غير مُصادَق عليه	فشلت المصادقة أو لم تُقدَّم أي بيانات اعتماد.
404	غير موجود	الملف المصدر غير قابل للوصول أو غير موجود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	واجه جدول البيانات مشكلة أثناء عملية التحويل.

كيفية استخدام خدمة تحويل الجدول إلى CSV باستخدام حزم تطوير البرمجيات (SDKs)

مواصفات تحويل الجدول إلى CSV

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}

{< tab tabNum=“1” >}

# استخدام HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/table/csv?worksheet={worksheet}&tableName={tableName}&outPath={outPath}&outStorageName={outStorageName}&fontsLocation={fontsLocation}&AutoRowsFit={AutoRowsFit}&AutoColumnsFit={AutoColumnsFit}&region={region}&password={password}" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/octet-stream" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "file": "تدفق ثنائي لملف CSV المُولَّد"
}

{< /tab >}

{< /tabs >}

استخدام حزم تطوير البرمجيات الخاصة بـ Aspose Cells Cloud

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

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

Developer-Guide: تحويل النطاق إلى CSV

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

تحويل النطاق إلى CSV باستخدام خدمات Aspose.Cells Cloud الويبية

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

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

PUT https://api.aspose.cloud/v4.0/cells/convert/range/csv

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

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

بارامترات الطلب

اسم البارامتر	النوع	المسار/سلسلة الاستعلام/جسم الـ HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات. إلزامي.
range	نص	استعلام	منطقة الخلايا. مثال: `A1:C10`. إلزامي.
outPath	نص	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه جدول العمل. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مساحة التخزين للملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصّصة.
AutoRowsFit	منطقي	استعلام	(اختياري) ضبط تلقائي لحجم جميع الصفوف في أوراق العمل.
AutoColumnsFit	منطقي	استعلام	(اختياري) ضبط تلقائي لحجم جميع الأعمدة في أوراق العمل.
region	نص	استعلام	إعدادات إقليم/لغة جدول البيانات (مثل `en-US`، `fr-FR`). تؤثّر على تنسيق الأرقام، وتفسير التواريخ، والسلوك المرتبط بالإقليم.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

بارامترات جسم الطلب

اسم البارامتر	النوع	الوصف
None	N/A	لا توجد بارامترات في جسم الطلب.

الاستجابة

{
  "ResponseFile": "تدفق ملف ثنائي (محتوى CSV)"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	ناجح	تم تحويل النطاق بنجاح وتمت إعادة ملف CSV في جسم الاستجابة.
400	طلب غير صالح	عنوان URL غير صحيح أو نقص بارامترات إلزامية.
401	غير مصادق عليه	فشلت المصادقة أو لم تُوفَّر بيانات اعتماد.
413	حجم الحمولة كبير جداً	تجاوز حجم جسم الطلب الحد المسموح به.
500	خطأ داخلي في الخادوم	واجه جدول البيانات مشكلة أثناء جلب بيانات التحويل.

كيفية استخدام تحويل النطاق إلى CSV باستخدام مكتبات التطوير (SDKs)

مواصفات تحويل النطاق إلى CSV

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

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

الطلب

# استخدام HTTPS لتوصيل آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/range/csv?worksheet=Sheet1&range=A1:C10&outPath=outputFolder&outStorageName=MyStorage&fontsLocation=/custom/fonts&AutoRowsFit=true&AutoColumnsFit=true&region=en-US&password=MyPassword" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/octet-stream" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'Spreadsheet=@sample.xlsx'

الاستجابة

{
  "ResponseFile": "Base64EncodedCsvContent"
}

استخدام مكتبات Aspose Cells Cloud SDKs

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

تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose Cells Cloud باستخدام مكتبات مختلفة: `[TBD]`

Developer-Guide: ConvertWorksheetToPdf

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

دالة ConvertWorksheetToPdf في خدمات الويب Aspose.Cells Cloud

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

تشمل الميزات الرئيسية التحويل المُبنَى على السحابة، وتقليل العبء على موارد السحابة، وتبسيط سير العمل.

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

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/pdf

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

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

معاملات الطلب

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص (String)	استعلام	اسم ورقة العمل في جدول البيانات.
outPath	نص (String)	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه ملف المصنف. القيمة الافتراضية هي null.
outStorageName	نص (String)	استعلام	اسم مساحة التخزين للملف الناتج.
fontsLocation	نص (String)	استعلام	استخدام خطوط مخصصة.
AutoRowsFit	منطقي (Boolean)	استعلام	(اختياري) ضبط ارتفاع جميع الصفوف في أوراق العمل تلقائيًا.
AutoColumnsFit	منطقي (Boolean)	استعلام	(اختياري) ضبط عرض جميع الأعمدة في أوراق العمل تلقائيًا.
region	نص (String)	استعلام	إعدادات إقليم/لغة جدول البيانات (مثل `en-US`، `fr-FR`). تؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك الخاص بالمنطقة الجغرافية.
password	نص (String)	استعلام	كلمة المرور لفتح ملف جدول البيانات.

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

اسم المعامل	النوع	الوصف
[TBD]

الاستجابة

{
  "file": "<تدفق ثنائي لملف PDF المُولَّد>"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	نجاح (OK)	تم تحويل ورقة العمل إلى PDF بنجاح وإرجاعها كتدفق ملف.
400	طلب غير صالح (Bad Request)	معاملات طلب غير صحيحة أو عنوان URL غير مُنسَّق.
401	غير مُصادَق (Unauthorized)	فشلت المصادقة أو لم تُوفَّر أي بيانات اعتماد.
404	غير موجود (Not Found)	الملف المصدر غير قابل للوصول.
413	حمل مُرسل كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	واجه جدول البيانات اختلالًا أثناء عملية التحويل.

كيفية استخدام ConvertWorksheetToPdf مع مكتبات SDK

مواصفات ConvertWorksheetToPdf

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}

{< tab tabNum=“1” >}

# استخدم بروتوكول HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/worksheet/pdf?worksheet=Sheet1&outPath=output%2Ffolder&outStorageName=MyStorage&fontsLocation=%2Fcustom%2Ffonts&AutoRowsFit=true&AutoColumnsFit=true&region=en-US&password=SecretPwd" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/octet-stream" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "file": "<تدفق ثنائي لملف PDF المُولَّد>"
}

{< /tab >}

{< /tabs >}

استخدام مكتبات Aspose.Cells Cloud SDK

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

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells Cloud باستخدام مكتبات SDK المختلفة: `[TBD]`

Developer-Guide: Aspose.Cells Cloud – تحويل الجدول إلى HTML

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

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

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/html

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

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

معاملات الطلب

الاسم	الموقع	النوع	مطلوب	الوصف
Spreadsheet	Form‑Data	`File`	نعم	ملف Excel الذي يحتوي على الجدول المراد تحويله.
worksheet	Query	`String`	نعم	اسم ورقة العمل التي يحتوي عليها الجدول.
tableName	Query	`String`	نعم	الاسم الدقيق للجدول المراد تحويله.
outPath	Query	`String`	لا	مسار المجلد في مساحة تخزين Aspose Cloud التي سيتم حفظ ملف HTML فيها (اختياري).
outStorageName	Query	`String`	لا	اسم مساحة التخزين الخاصة بالملف الناتج (اختياري).
fontsLocation	Query	`String`	لا	مسار مجلد يحتوي على خطوط مخصصة مطلوبة للتحويل.
region	Query	`String`	لا	معرّف المنطقة (مثل `en-US`، `fr-FR`). يؤثّر على تنسيق الأرقام/التاريخ.
password	Query	`String`	لا	كلمة المرور لفتح ملف Excel المحمي.
AutoRowsFit	Query	`Boolean`	لا	ضبط ارتفاع جميع الصفوف تلقائيًا في ورقة العمل (`true`/`false`).
AutoColumnsFit	Query	`Boolean`	لا	ضبط عرض جميع الأعمدة تلقائيًا في ورقة العمل (`true`/`false`).

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (نجاح)	تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب خاطئ)	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حِمْل كبير جدًا)	حجم الملف المرفَع يتجاوز الحد المسموح.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقّع في الخادم.

متى تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى HTML؟

محتوى ويب ديناميكي – أدمج جداول الأسعار أو الجداول الزمنية أو قوائم المنتجات مباشرةً في صفحات الويب أو أنظمة إدارة المحتوى (CMS).
قوالب البريد الإلكتروني – أنشئ مقاطع HTML لملخّصات الطلبات أو التقارير التي تُعرَض بشكل متسق عبر برامج البريد الإلكتروني المختلفة.
لوحات التحكم وأدوات التقارير – عرض بيانات جداول البيانات الحية دون تحميل ملف Excel بالكامل أو استخدام مكوّنات جداول بيانات ثقيلة.
معاينة المستندات – قدم معاينات سريعة وتحتفظ بالتنسيق لمُقتطفات محددة من جداول البيانات.

كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى HTML باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى HTML

توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى HTML واجهة برمجة تطبيقات برمجية متاحة علنًا، مما يتيح التفاعل مع REST مباشرةً من متصفح الويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/html?worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.html

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

استخدام مكتبات Aspose.Cells Cloud SDK

يُعد استخدام مكتبة SDK أسرع طريقة للتطوير، حيث تُجرّدك من تفاصيل المستوى المنخفض، مما يتيح لك تحويل بيانات جدول جدول البيانات إلى ملف CSV باستخدام كود محدود. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات Aspose.Cells Cloud SDK.

توضّح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

Developer-Guide: Aspose.Cells Cloud – تحويل نطاق Excel إلى HTML

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

تحويل نطاق محدد من ملف Excel محلي إلى ملف HTML مباشرةً عبر Aspose.Cells Cloud. تتم عملية التحويل بالكامل على خوادم السحابة، لذا لا تحتاج أبدًا إلى تحميل الملف الكامل أو تثبيت Excel محليًا.

واجهة برمجة تطبيقات تحويل النطاق إلى HTML

PUT https://api.aspose.cloud/v4.0/cells/convert/range/html

يحتوي جسم الطلب على multipart/form-data يحتوي ملف جدول البيانات. وتُزوَّد جميع الخيارات الأخرى كمعلّمات استعلام.

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

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

معلمات الطلب

الاسم	النوع	الموقع	الإجباري	الوصف
Spreadsheet	ملف	FormData	نعم	ملف Excel المراد تحويله.
worksheet	نص	استعلام	نعم	اسم ورقة العمل التي تحتوي على النطاق.
range	نص	استعلام	نعم	منطقة الخلايا المراد تحويلها، مثل `A1:C10`.
outPath	نص	استعلام	لا	مسار المجلد الذي يجب حفظ ملف HTML الناتج فيه (افتراضيًا `null`).
outStorageName	نص	استعلام	لا	اسم خدمة التخزين المستخدمة لحفظ ملف الإخراج.
fontsLocation	نص	استعلام	لا	مسار مجلد الخطوط المخصصة.
AutoRowsFit	منطقي	استعلام	لا	ضبط ارتفاع جميع الصفوف تلقائيًا في ورقة العمل.
AutoColumnsFit	منطقي	استعلام	لا	ضبط عرض جميع الأعمدة تلقائيًا في ورقة العمل.
region	نص	استعلام	لا	معرّف التوطين (مثل `en-US`, `fr-FR`). يؤثر على تنسيق الأرقام والتاريخ.
password	نص	استعلام	لا	كلمة المرور لفتح ملف Excel المحمي.
fontsLocation	نص	استعلام	لا	موقع الخطوط المخصصة.
region	نص	استعلام	لا	إعداد منطقة/لغة جدول البيانات.
password	نص	استعلام	لا	كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

ترجع واجهة برمجة التطبيقات ملف HTML المحول كـ دفق ثنائي (application/octet-stream).

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

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

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423

<table>
  <tr><th>Product</th><th>Price</th></tr>
  <tr><td>Widget A</td><td>$10</td></tr>
  <tr><td>Widget B</td><td>$15</td></tr>
</table>

احفظ محتوى جسم الاستجابة في ملف (مثل report.html) لعرض الجدول المُرسَل في المتصفح.

أكواد حالة HTTP

الكود	المعنى	الوصف
200	OK (نجاح)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب غير صالح)	معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حجم البيانات كبير جدًا)	ملف التحميل يتجاوز الحد الأقصى للحجم.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

كيف تستخدم واجهة برمجة تطبيقات تحويل النطاق إلى HTML باستخدام مكتبات SDK؟

مواصفات OpenAPI

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

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/html?worksheet=Sheet1&range=A1:C10&AutoRowsFit=true&AutoColumnsFit=true" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@Report.xlsx" \
     -F "outPath=output/report.html"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423

<table>
  <tr><th>Product</th><th>Price</th></tr>
  <tr><td>Widget A</td><td>$10</td></tr>
  <tr><td>Widget B</td><td>$15</td></tr>
</table>

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة. إذا تم حظر تحميل الأمثلة من Gist، يمكنك تنزيلها مباشرةً من المستودع.

Developer-Guide: تحويل المخطط إلى PDF

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

خدمة تحويل المخطط إلى PDF من Aspose.Cells Cloud

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

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

PUT https://api.aspose.cloud/v4.0/cells/convert/chart/pdf

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

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

مَعلمات الطلب

اسم المعلمة	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات.
chartIndex	عدد صحيح	استعلام	مؤشر المخطط داخل ورقة العمل.
outPath	نص	استعلام	(اختياري) مسار المجلد حيث يُخزَّن ملف العمل. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم وحدة التخزين الخاصة بالملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصصة.
region	نص	استعلام	إعدادات المنطقة/اللغة لجدول البيانات (مثل `en-US`، `fr-FR`). وتؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك المرتبط بالإعدادات المحلية.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

معلمة جسم الطلب

اسم المعلمة	النوع	الوصف
Spreadsheet	ملف	رفع ملف جدول البيانات.

الاستجابة

{
  "ResponseFile": "تدفق ملف PDF ثنائي"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	نجاح	تم تحويل المخطط بنجاح إلى PDF؛ تم إرجاع ملف PDF ثنائي.
400	طلب غير صالح	معلمات الطلب غير صحيحة أو رابط URL معطَّل.
401	غير مُصادَق	فشلت المصادقة أو لم تُوفَّر أي بيانات اعتماد.
404	غير موجود	لا يمكن الوصول إلى ملف المصدر.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	حدث خطأ أثناء معالجة التحويل.

كيفية استخدام خدمة تحويل المخطط إلى PDF باستخدام حزم تطوير البرمجيات (SDKs)

مواصفات تحويل المخطط إلى PDF

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >} {< tab tabNum=“1” >}

# استخدام HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/chart/pdf?worksheet={worksheet}&chartIndex={chartIndex}&outPath={outPath}&outStorageName={outStorageName}&fontsLocation={fontsLocation}&region={region}&password={password}" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/pdf" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >} {< tab tabNum=“2” >}

{
  "ResponseFile": "تدفق ملف PDF ثنائي"
}

{< /tab >} {< /tabs >}

استخدام حزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud

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

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud - تحويل بيانات جدول Excel المحلية إلى ملف صورة - أداة مجانية عبر الإنترنت

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

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

تنسيقات الصور المدعومة:

واجهة برمجة تطبيقات تحويل الجدول إلى صورة

قبل استخدام هذه النقطة النهائية، تأكد من توفر المتطلبات الأساسية التالية:

رمز وصول JWT صالح تم الحصول عليه من خلال مصادقة Aspose.Cells Cloud.
حساب تخزين قابل للوصول إذا كنت تنوي استخدام معاملات outPath أو outStorageName.
يجب أن يكون ملف المصنف المصدر (ملف Excel المحلي) قابلًا للقراءة، وإذا كان مشفرًا، يجب توفير كلمة المرور الصحيحة.

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/image

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

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

معاملات الطلب:

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم الـ HTTP	الوصف
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل الخاصة بجدول البيانات أو Excel.
tableName	نص	استعلام	اسم الجدول المراد تحويله.
format	نص	استعلام	تنسيق ملف الصورة المرغوب (مثل: png, svg).
outPath	نص	استعلام	(اختياري) مسار المجلد حيث سيتم حفظ الصورة المحولة. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	تحديد اسم تخزين ملف الإخراج.
fontsLocation	نص	استعلام	استخدام خطوط مخصصة عند الحاجة.
region	نص	استعلام	إعداد منطقة/لغة جدول البيانات (مثل: `en-US`, `fr-FR`). يؤثر على تنسيق الأرقام، وتفسير التواريخ، والسلوك الخاص باللغة المحلية.
password	نص	استعلام	كلمة المرور المطلوبة للوصول إلى ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	نجاح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401	غير مصرح به	رمز JWT غير صالح أو مفقود.
413	حجم الحمل كبير جدًا	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب عليك استخدام واجهة برمجة تطبيقات تحويل الجدول إلى صورة؟

لقطات ثابتة للتقارير: حوّل جداول مالية أو نتائج الحسابات أو أي بيانات منسقة إلى صور لتضمينها في تقارير PDF أو شرائح PowerPoint أو المستندات المطبوعة حيث لا يُطلب تعديلها.
تصور البيانات في العروض التقديمية: حوّل جداول جداول البيانات المعقدة – بما في ذلك التنسيق الشرطي أو التصورات البسيطة – إلى صور يمكن تضمينها في العروض التقديمية (PPTX، Google Slides).
المستندات ومواد التدريب: خذ لقطات لדוגمات جداول البيانات أو القوالب أو نماذج إدخال البيانات كصور لأدلة المستخدم أو البرامج التعليمية أو مقالات قاعدة المعرفة.
معاينات مصغرة: أنشئ معاينات صغيرة لصور أقسام جدول البيانات الرئيسية لمستعرضات الملفات أو مكتبات المستندات أو نتائج البحث.

لماذا يجب عليك استخدام واجهة برمجة تطبيقات تحويل الجدول إلى صورة؟

سهلة للمطورين: توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يمكّن من تطوير سريع، وتُرفق معها وثائق شاملة. بالمقارنة مع بناء حلول عرض مخصصة، فإن هذا يقلل بشكل كبير من جهد التطوير.
موفرة من حيث التكلفة: يمكنك تحويل بيانات الجدول دون الحاجة أولاً لرفع المصنف بالكامل، مما يوفر مساحة تخزين ويقلل التكاليف.
الحفاظ على دقة البكسل: إعادة إنتاج مظهر Excel بدقة – بما في ذلك تنسيق الخلايا، والصيغ (كقيم معروضة)، والحدود، والألوان، والتنسيق الشرطي – في صورة الإخراج.
توافق عالمي: تنسيقات الصور (PNG وJPEG وTIFF وBMP وSVG وما إلى ذلك) قابلة للعرض على أي جهاز أو منصة دون برامج متخصصة، مما يضمن أقصى قدر من إمكانية الوصول.

كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى صورة باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى صورة

توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى صورة واجهة برمجة تطبيقات برمجية متاحة علنًا لإجراء تفاعلات REST مباشرة من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/image?format=png&worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.png

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

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

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

توضح الأمثلة التالية كيفية استدعاء خدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة:

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud – تحويل مخطط Excel إلى PDF

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

تصدير المخططات من ملف Excel محلي إلى تنسيق PDF باستخدام واجهة برمجة التطبيقات السحابية.

تحويل المخطط إلى PDF – واجهة برمجة التطبيقات عبر الويب

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

PUT https://api.aspose.cloud/v4.0/cells/convert/chart/pdf

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

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

معلمات الطلب:

اسم المعلمة	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات.
worksheet	نص (String)	استعلام	اسم ورقة العمل التي تحتوي على المخطط.
chartIndex	عدد صحيح	استعلام	فهرس المخطط المراد تحويله.
outPath	نص (String)	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه الملف المحول. القيمة الافتراضية هي null.
outStorageName	نص (String)	استعلام	اسم مخزن الملفات الناتجة.
fontsLocation	نص (String)	استعلام	استخدام خطوط مخصصة عند الضرورة.
region	نص (String)	استعلام	إعداد منطقة جدول البيانات.
password	نص (String)	استعلام	كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معلمات ناقصة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401	غير مخوّل (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم البيانات كبير جدًا (Payload Too Large)	يتجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة التطبيقات لتحويل المخطط إلى PDF؟

1. التقارير التجارية والأتمتة

الأقسام المالية: مخططات التقارير المالية الشهرية → أرشفة بصيغة PDF
فرق المبيعات: مخططات اتجاهات الأداء → تقارير PDF مقدمة للعملاء
تحليلات التسويق: مخططات أداء الحملات → عروض تنفيذية موجزة بصيغة PDF
إدارة العمليات: مخططات مراقبة الإنتاج → وثائق التزامن (Compliance) بصيغة PDF

2. تطوير البرمجيات والتكامل

تطبيقات SaaS: بيانات المخططات المُنشأة من قبل المستخدمين → تقارير قابلة للتحميل بصيغة PDF
الأنظمة المؤسسية: مخططات أنظمة ERP/CRM → وثائق تدقيق بصيغة PDF
تطبيقات الجوال: مخططات التحليلات داخل التطبيق → ملفات PDF قابلة للمشاركة
تطبيقات الويب: مخططات لوحة المعلومات → وظيفة تصدير إلى PDF

3. سير عمل معالجة المستندات

المعالجة بالدُّفعات (Batch Processing): تحويل مخططات من ملفات Excel متعددة إلى PDF في وقت واحد
المهام المجدولة: إنشاء تلقائي للتقارير اليومية/الأسبوعية من مخططات
الإخراج القائم على القوالب: تنسيقات مخططات قياسية → مستندات PDF
تجميع المستندات: دمج المخططات مع محتويات أخرى في تنسيق PDF

4. تطبيقات مخصصة حسب القطاع

المؤسسات البحثية: مخططات بيانات التجارب → أشكال مخططات لأوراق البحث المنشورة بصيغة PDF
قطاع التعليم: مخططات المواد التعليمية → مواد دراسية بصيغة PDF
شركات الاستشارات: مخططات التحليل → مستندات تسليم للعملاء بصيغة PDF
التصنيع: مخططات ضمان الجودة → تقارير فحص بصيغة PDF
قطاع الرعاية الصحية: مخططات بيانات المرضى → سجلات طبية بصيغة PDF
القطاع الحكومي: مخططات إحصائية → منشورات رسمية بصيغة PDF

5. إدارة المحتوى وتوزيعه

إدارة الأصول الرقمية: أرشفة المخططات بصيغة PDF معيارية
قواعد المعرفة: وثائق تقنية تحتوي على مخططات PDF مُدمجة
منصات العملاء: تسليم آمن لتقارير PDF للمُ stakeholder
الامتثال التنظيمي: إنشاء وثائق PDF جاهزة للتدقيق

لماذا يجب استخدام واجهة برمجة التطبيقات لتحويل المخطط إلى PDF؟

يمكنك تحويل المخططات بدون تحميل ملف المصنف مسبقًا، مما يوفر مساحة التخزين ويقلل التكاليف.
يمكن إكمال التطوير بسرعة من خلال SDKs الموجودة لـ Aspose.Cells Cloud.
تكامل بسيط: واجهة برمجة تطبيقات REST مع توثيق واضح.
بنية قابلة للتطوير (Scalable Architecture): معالجة أحجام عمل تتراوح من عمليات صغيرة إلى عمليات مؤسسية كبيرة.

كيفية استخدام واجهة برمجة التطبيقات لتحويل المخطط إلى PDF مع SDKs؟

مواصفات واجهة برمجة التطبيقات لتحويل المخطط إلى PDF

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

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

استخدام SDK هو أسرع طريقة للتطوير، حيث يُجرّدك من التفاصيل منخفضة المستوى، مما يسمح لك بتحويل المخطط إلى ملف PDF باستخدام كود معدود.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells Cloud باستخدام SDKs المختلفة:

Developer-Guide: واجهة Aspose.Cells Cloud Web API - تحويل مخطط Excel إلى صورة - أداة مجانية عبر الإنترنت

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

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

قم بتحويل مخطط من ملف جدول بيانات محلي أو ملف Excel إلى ملف صورة. تنسيقات الصور المدعومة: PNG، SVG، TIFF، JPEG، BMP

واجهة API لتحويل المخطط إلى صورة

واجهة API عبر الويب

PUT https://api.aspose.cloud/v4.0/cells/convert/chart/image

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/chart/image?format=png&chartIndex=0" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@MyWorkbook.xlsx" \
     -o chart.png

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

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

معلمات الطلب:

اسم المعلمة	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف	الإلزام
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات الذي يحتوي على المخطط.	نعم
worksheet	سلسلة نصية	استعلام	تحديد اسم ورقة العمل إن وُجد.	لا
chartIndex	عدد صحيح	استعلام	فهرس المخطط المراد تحويله.	نعم
format	سلسلة نصية	استعلام	(إلزامي) نوع الصورة المطلوب (مثل: svg، png، jpg).	نعم
outPath	سلسلة نصية	استعلام	(اختياري) مسار المجلد الذي سيتم تخزين ملف الإخراج فيه؛ الافتراضي هو null.	لا
outStorageName	سلسلة نصية	استعلام	اسم وحدة التخزين الخاصة بملف الإخراج.	لا
fontsLocation	سلسلة نصية	استعلام	تحديد الخطوط المخصصة عند الحاجة.	لا
region	سلسلة نصية	استعلام	ضبط منطقة جدول البيانات.	لا
password	سلسلة نصية	استعلام	كلمة المرور لفتح ملف جدول البيانات.	لا

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صحيحة (مثل: نوع ملف غير مدعوم).
401	غير مصادق عليه	رمز JWT غير صالح أو مفقود.
413	حملة البيانات كبيرة جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة API لتحويل المخطط إلى صورة؟

توليد التقارير واللوحات التفاعلية (Dashboards): تحويل المخططات تلقائيًا من بيانات Excel إلى صور (PNG وJPEG وما إلى ذلك) لتضمينها في تقارير PDF أو لوحات تفاعلية على الويب أو عروض PowerPoint.
تطبيقات الويب/البريد الإلكتروني: عرض صور المخططات مباشرةً في صفحات الويب أو رسائل البريد الإلكتروني دون الحاجة إلى تنزيل أو فتح ملفات Excel. مفيد في أدوات التقارير الديناميكية أو النشرات الإخبارية أو الإشعارات الآلية.
سير عمل معالجة المستندات: دمجها في خطوط أنابيب آلية (مثل: الفوترة أو التحليلات) حيث تكون الحاجة إلى إدراج مخططات من Excel في تنسيقات أخرى (Word أو PDF أو HTML) ضرورية.
تطبيقات الجوال/سطح المكتب: عرض مخططات Excel في التطبيقات التي لا تتطلب عرض جدول البيانات بالكامل أو يكون ذلك غير عملي.
الأرشفة والتصور: حفظ المخططات كصور منفصلة لتخزينها على المدى الطويل أو كصور مصغرة أو معاينات سريعة دون اعتماد على Excel.

لماذا يجب استخدام واجهة API لتحويل المخطط إلى صورة؟

الحفاظ على الدقة البصرية: تحافظ على تنسيق المخطط بالضبط (الألوان والتصنيفات والم масحات) كما تظهر في Excel، مما يضمن إخراجًا بجودة احترافية.
مستقلة عن المنصة: لا حاجة لتثبيت Excel. تعمل عبر أنظمة التشغيل (Windows وLinux وmacOS) عبر واجهة API REST، مما يجعلها مناسبة للتطبيقات السحابية أو الخوادم.
الأتمتة والقابلية للتوسع: تحويل جماعي لمخططات أو ملفات متعددة برمجيًا، مما يوفر الوقت مقارنةً بالتصدير اليدوي. معالجة كميات كبيرة بكفاءة في السحابة.
تنسيقات إخراج مرنة: تدعم تنسيقات الصور الشائعة (PNG وJPG وBMP وSVG وما إلى ذلك)، مما يسمح بالتكامل مع أنظمة ووسائط متنوعة.
آمنة وموثوقة: معالجة الملفات في بيئة سحابية تابعة لـ Aspose دون تعريض البيانات الحساسة لاستخدام أدوات من جانب العميل. توفر متانة عالية وأداءً ثابتًا.
سهلة للمطورين: توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسهّل التطوير بسرعة، وتُرفق بتوثيق شامل. مقارنةً ببناء حلول تصور مخصصة للمخططات، فإن هذا يقلل بشكل كبير من جهد التطوير.
موفرة من حيث التكلفة: يمكنك تحويل المخططات دون رفع كتاب العمل أولاً، مما يوفر مساحة التخزين ويقلل التكاليف.

كيفية استخدام واجهة API لتحويل المخطط إلى صورة مع مكتبات SDK؟

مواصفات واجهة API لتحويل المخطط إلى صورة

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

استخدام مكتبات SDK لـ Aspose.Cells Cloud

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

توضح أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة:

Developer-Guide: تحويل نطاق إكسل إلى PDF باستخدام واجهة Aspose.Cells Cloud API

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

تصدير نطاق من البيانات من ملف إكسل محلي إلى ملف PDF باستخدام واجهة Cloud API.

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

واجهة تحويل النطاق إلى PDF

PUT https://api.aspose.cloud/v4.0/cells/convert/range/pdf

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

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

معاملات الطلب:

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف الجدول.
worksheet	نص	استعلام	اسم ورقة العمل داخل الجدول.
range	نص	استعلام	منطقة الخلايا المراد تحويلها، مثل A1:C10.
outPath	نص	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه الملف. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مخزن ملف الإخراج.
fontsLocation	نص	استعلام	موقع تخزين الخطوط المخصصة للاستخدام الشخصي.
region	نص	استعلام	إعداد منطقة الجدول.
password	نص	استعلام	كلمة المرور لفتح ملف الجدول.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

الاستجابة النموذجية هي دفق ثنائي PDF يُعاد كتنزيل ملف.

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب عليك استخدام واجهة تحويل النطاق إلى PDF؟

البيانات المالية: تحويل ميزانيات العمليات، والقوائم المالية (نطاقات محددة) إلى PDF لتوثيق جاهز للمراجعة.
تقارير المبيعات: تحويل لوحات معلومات المبيعات أو حسابات العمولات إلى ملفات PDF قابلة للتوزيع.
مقاييس العمليات: تصدير جداول المؤشرات الرئيسية للأداء ومقاييس الأداء كتقارير PDF رسمية.
البيانات التعاقدية: تصدير جداول الأسعار واتفاقيات مستوى الخدمة من الجداول إلى مرفقات PDF.
سجلات التدقيق: الحفاظ على نطاقات البيانات المالية كأدلة PDF غير قابلة للتعديل.
ملخصات المحافظ: تصدير نطاقات أداء الاستثمارات كبيانات PDF جاهزة للعميل.
تقارير ضبط الجودة: تصدير نطاقات بيانات التفتيش إلى PDF للسجلات الامتثالية.
ملخصات المخزون: تحويل جداول مستويات المخزون إلى PDF لمراجعة الإدارة.

لماذا يجب عليك استخدام واجهة تحويل النطاق إلى PDF؟

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

كيفية استخدام واجهة تحويل النطاق إلى PDF باستخدام SDK؟

مواصفات واجهة تحويل النطاق إلى PDF

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة Cloud API باستخدام cURL.

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/pdf?worksheet=Sheet1&range=A1:C10" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@/path/to/file.xlsx"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="result.pdf"
Content-Length: 8423

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

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

توضح أمثلة الكود التالية كيفية إجراء استدعاءات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة:

Developer-Guide: واجهة Aspose.Cells Cloud Web API – تحويل ورقة العمل إلى HTML

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

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

واجهة تحويل ورقة العمل إلى HTML

واجهة الويب

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/html

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

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

معاملات الطلب

اسم المعامل	النوع	الموقع	إجباري/اختياري	الوصف
Spreadsheet	ملف	مطلوب	FormData	ملف Excel ثنائي لمعالجته. يجب أن يكون ملفًا صالحًا بامتدادات مثل .xlsx أو .xls أو .xlsb وما إلى ذلك. مثال: `myWorkbook.xlsx`. ويُقرأ ملف Excel مباشرة من جسم الطلب، ولا حاجة لرفعه مسبقًا إلى التخزين السحابي.
worksheet	نص	مطلوب	استعلام	اسم ورقة العمل المراد تحويلها (حساس لحالة الأحرف). يجب أن تكون موجودة في المصنف المزوّد. مثال: `Sheet1`.
outPath	نص	اختياري	استعلام	مسار المجلد الهدف (في التخزين السحابي) الذي سيتم حفظ ملف HTML الناتج فيه. وإذا تُرك فارغًا، يُعاد الملف مباشرةً في الاستجابة. مثال: `/output/html/`.
outStorageName	نص	اختياري	استعلام	اسم خدمة التخزين السحابي المراد استخدامها لمسار الإخراج (`outPath`). يتطلّب فقط عند توجيه `outPath` إلى تخزين غير افتراضي.
fontsLocation	نص	اختياري	استعلام	المسار المطلق لمجلد يحتوي على خطوط TrueType/OpenType مخصّصة تُستخدم أثناء التحويل، مما يضمن عرض الأحرف غير القياسية بشكل صحيح.
region	نص	اختياري	استعلام	معرّف محلي يؤثّر على تنسيق الأرقام/التواريخ (مثل `en-US` أو `fr-FR`)، ويُستخدم الافتراضي المُعرّف داخليًا في المصنف في حال إهماله.
password	نص	اختياري	استعلام	كلمة المرور المطلوبة لفتح مصنف محمي. يُترك فارغًا للملفات غير المحمية.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالات HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مصادق عليه	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقّع في الخادم.

أين يجب استخدام واجهة تحويل ورقة العمل إلى HTML؟

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

لماذا يجب استخدام واجهة تحويل ورقة العمل إلى HTML؟

سير عمل بدون رفع – تحويل الملفات المحلية مباشرةً في السحابة، ما يلغي الحاجة لنقل المصنفات الكبيرة إلى التخزين مسبقًا.
عرض عالي الأداء – يستفيد التحويل من محرك Aspose المُحسّن على الخوادم، ما يضمن إخراج HTML سريعًا ودقيقًا.
تحكم كامل في الإخراج – تسمح المعاملات الاختيارية (الخطوط المخصّصة، المنطقة، كلمة المرور) بتخصيص HTML بما يتوافق مع متطلبات التوطين والهوية البصرية.
تكامل سلس – طلب PUT بسيط مع multipart/form‑data يناسب بيئات سير العمل التلقائي (CI/CD)، أو الميكروسيرفيس (microservices)، أو وظائف serverless.

كيفية استخدام واجهة تحويل ورقة العمل إلى HTML باستخدام SDKs

مواصفات واجهة تحويل ورقة العمل إلى HTML

مواصفات واجهة تحويل ورقة العمل إلى HTML توفر واجهة برمجة تطبيقات مفتوحة للوصول مباشرةً من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. ويُعرض المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/worksheet/html?worksheet=Sheet1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.html

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

Developer-Guide: تصدير مخطط Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud

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

قم بتحويل مخطط موجود في ملف عمل مخزن في مساحة التخزين الخاصة بـ Aspose Cloud إلى تنسيق ملف مختلف (PDF أو PNG أو SVG أو غيرها) دون تنزيل الملف المصدر.

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

GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/charts/{chartIndex}

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

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

📦 معاملات الطلب

الاسم	النوع	الموقع	إجباري	الوصف
name	نص	المسار	نعم	اسم ملف العمل.
worksheet	نص	المسار	نعم	اسم ورقة العمل التي يحتويها المخطط.
chartIndex	عدد صحيح	المسار	نعم	الفهرس بصفر كبداية للمخطط المراد تصديره.
format	نص	الاستعلام	نعم	تنسيق الإخراج المرغوب (مثل: `png`، `pdf`، `svg`).
folder	نص	الاستعلام	لا	مسار المجلد الذي يخزن فيه ملف العمل (الافتراضي: الجذر).
storageName	نص	الاستعلام	لا	اسم التخزين المخصص؛ تجاهل هذا الخيار لاستخدام التخزين الافتراضي.
outPath	نص	الاستعلام	لا	مسار المجلد الذي سيتم حفظ الملف المحول فيه.
outStorageName	نص	الاستعلام	لا	اسم التخزين لملف الإخراج.
fontsLocation	نص	الاستعلام	لا	مسار مجلد يحتوي على الخطوط المخصصة.
region	نص	الاستعلام	لا	إعدادات الإقليم (مثل: `en-US`، `fr-FR`).
password	نص	الاستعلام	لا	كلمة المرور لفتح ملف عمل محمي.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream",
      "Name": "file"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	نجاح	تمت عملية التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصادق عليه	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جداً	حجم الملف المرفوع يتجاوز الحد المسموح به.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

كيف تستخدم واجهة برمجة تطبيقات Export Chart as Format باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات Export Chart as Format

توفر مواصفات واجهة برمجة تطبيقات Export Chart as Format واجهة برمجة تطبيقات متاحة للعامة وتتيح التفاعل عبر REST مباشرةً من متصفح ويب.

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

Request

curl -X GET "https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/charts/{chartIndex}?format={format}" \
  -H "Authorization: Bearer {access_token}"

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

Developer-Guide: تحويل ورقة العمل – وثائق واجهة برمجة تطبيقات Aspose.Cells Cloud

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

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

تنسيقات الصور المدعومة

واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة

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

PUT http://api.aspose.cloud/v4.0/cells/convert/worksheet/image

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

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

معلمات الطلب

اسم المعلمة	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	سلسلة نصية	استعلام	اسم ورقة العمل المراد تحويلها.
format	سلسلة نصية	استعلام	تنسيق الصورة المطلوب (`svg`، `png`، `tiff`، `jpeg`، `bmp`، إلخ).
outPath	سلسلة نصية	استعلام	(اختياري) مسار المجلد الذي سيتم حفظ صورة الإخراج فيه؛ القيمة الافتراضية هي `null`.
outStorageName	سلسلة نصية	استعلام	اسم موقع التخزين لملف الإخراج.
fontsLocation	سلسلة نصية	استعلام	مسار مجلد خطوط مخصصة، إن احتجت لاستخدام خطوط غير متوفرة على الخادم.
region	سلسلة نصية	استعلام	إعداد منطقة جدول البيانات (مثل `en-US`).
password	سلسلة نصية	استعلام	كلمة المرور المطلوبة لفتح ملف جدول البيانات المحمي.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معلمات ناقصة أو غير صحيحة (مثل نوع الملف غير المدعوم).
401	غير مصرح (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة؟

لقطات ثابتة للتقارير – تحويل الجداول المالية أو الحسابات أو غيرها من البيانات إلى صور لاستخدامها في تقارير PDF أو شرائح PowerPoint أو المستندات المطبوعة حيث لا يُطلب تعديلها.
تمثيل بصري للبيانات في العروض التقديمية – تحويل جداول البيانات المعقدة (بما في ذلك التنسيق الشرطي أو المخططات البسيطة) إلى صور يمكن تضمينها في العروض التقديمية (PPTX، Google Slides).
المستندات ومواد التدريب – التقاط أمثلة جداول البيانات أو القوالب أو نماذج إدخال البيانات كصور لاستخدامها في الكتيبات أو الدلائل أو المقالات في قواعد المعرفة.
معاينات مصغرة – إنشاء معاينات صور صغيرة لأقسام جداول البيانات الأساسية لمستعرضات الملفات أو مكتبات المستندات أو نتائج البحث.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة؟

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

كيفية استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة مع مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة

تعرّف مواصفات واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتسمح بالتفاعل مع REST مباشرةً من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/worksheet/image?format=png&worksheet=Sheet1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.png

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

استخدام مكتبات SDK لـ Aspose.Cells Cloud

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة:

Developer-Guide: تحويل ورقة عمل إلى CSV – وثائق واجهة برمجة تطبيقات Aspose.Cells Cloud

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

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

واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV

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

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/csv

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

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

-H "Authorization: Bearer {access_token}"

مُعاملات الطلب

اسم المُعامل	النوع	الموقع	إلزامي/اختياري	الوصف
Spreadsheet	ملف	FormData	إلزامي	ملف ثنائي لجدول البيانات المصدر (مثل `.xlsx`، `.xls`). مثال: `myWorkbook.xlsx`.
worksheet	سلسلة نصية	Query	إلزامي	اسم ورقة العمل المراد تحويلها (حالة حساسة). إذا تُرك فارغًا، تُستخدم الورقة الأولى. مثال: `Sheet1`.
outPath	سلسلة نصية	Query	اختياري	مسار المجلد المستهدف في التخزين السحابي حيث يُحفظ ملف CSV الناتج. إذا تُرك فارغًا، يُعاد ملف CSV مباشرة في تدفق الاستجابة.
outStorageName	سلسلة نصية	Query	اختياري	اسم خدمة التخزين (مثل Azure، AWS S3) حيث يجب وضع ملف الإخراج. مطلوب فقط عند استخدام `outPath`.
fontsLocation	سلسلة نصية	Query	اختياري	مسار مجلد الخطوط المخصصة على الخادم، مما يتيح لمحرك التحويل استخدام خطوط غير قياسية.
region	سلسلة نصية	Query	اختياري	معرّف محلي يؤثّر في تنسيق الأرقام/التاريخ في ملف CSV (مثل `en-US`، `fr-FR`).
password	سلسلة نصية	Query	اختياري	كلمة المرور لفتح جدول بيانات محمي. يجب أن تتطابق مع كلمة مرور التشفير للملف المصدر.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	مُعطَلات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق عليه	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

متى تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV؟

استخراج البيانات لخطوط أنابيب تحليل الأعمال (BI) – استخراج ورقة عمل محددة من تقرير Excel وإرسال ملف CSV الناتج مباشرة إلى Power BI أو Tableau دون الحاجة إلى معالجة الملفات الوسيطة.
معالجة الفواتير بشكل آلي – تحويل ورقة العمل التي تحتوي على صفوف الفواتير إلى CSV لاستيرادها سريعًا في أنظمة المحاسبة.
دمج مع أنظمة قديمة – تصدير بيانات ورقة العمل إلى CSV للاستهلاك من قبل تطبيقات أقدم لا تقبل سوى ملفات النصوص المفصولة بفاصل.
توليد التقارير لحظيًا – إنشاء لقطات CSV لبيانات جدول البيانات الحية في خدمة ويب، وإعادة الملف فورًا إلى متصفح العميل.

لماذا تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV؟

لا يتطلب تخزينًا سحابيًا دائمًا – يُمرّر الملف مباشرةً إلى محرك التحويل ويُحذف بعد التحويل، مما يوفّر النطاق الترددي وتكاليف التخزين.
تنفيذ عالي الأداء في السحابة – يعمل التحويل على خوادم Aspose المُحسَّنة، وغالبًا ما يكتمل خلال ثانيتين فقط للملفات التي تصل إلى 100 ميغابايت.
تحكم دقيق – اختيار ورقة عمل واحدة، وتطبيق خطوط مخصصة، وتنسيق إقليمي، وحماية بكلمة مرور في طلب واحد.
إخراج متسق عبر منصات مختلفة – يضمن إخراج CSV متطابق عبر SDKs مختلفة مثل .NET وJava وPython وغيرها باستخدام نفس endpoint_واجهة REST.

كيف تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV باستخدام حزم تطوير البرمجيات (SDKs)؟

مواصفات واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV

مواصفات واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV توفر واجهة برمجة برمجية متاحة علنًا لتنفيذ تفاعلات REST مباشرة من متصفح الويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/image?format=png&worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.png

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

استخدام حزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud

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

تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK مختلفة:

Developer-Guide: تحويل ورقة عمل إلى جدول HTML

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

تحويل ورقة العمل إلى جدول HTML ضمن خدمات ويب Aspose.Cells Cloud

تقوم هذه العملية بقراءة ملف جدول محاسبي من نظام الملفات المحلي، وتحويل ورقة العمل المحددة فيه إلى جدول HTML، ثم إعادة النتيجة المحولة ك поток ملف (file stream). ويتم إجراء التحويل بالكامل على خادم السحابة، لذا لا يتطلب تحميلًا مبدئيًّا إلى مساحة التخزين السحابية. كما يدعم إعدادات التوطين (Locale) الاختيارية وملفات العمل المحمية بكلمة مرور.

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

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/html-table

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

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

معاملات الطلب

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف الجدول المحاسبي.
worksheet	نص	استعلام	اسم ورقة العمل داخل الجدول المحاسبي. (مطلوبة)
region	نص	استعلام	إعدادات المنطقة/اللغة للجدول المحاسبي (مثل `en-US`، `fr-FR`). تؤثر على تنسيق الأرقام، وتفسير التواريخ، وسلوك الإعدادات المحلية.
password	نص	استعلام	كلمة المرور المطلوبة لفتح ملف الجدول المحاسبي.

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

اسم المعامل	النوع	الوصف
لا يوجد	لا يوجد	لا يُطلب وجود جسم JSON؛ يُرسل الملف على شكل multipart/form-data.

الاستجابة

{
  "File": " поток ثنائي للجدول HTML الناتج"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	نجاح	تم تحويل ورقة العمل إلى جدول HTML بنجاح، وتم إعادته ك поток ملف.
400	طلب غير صالح	عنوان URL غير صالح أو معاملات مطلوبة مفقودة.
401	غير مُصادَق عليه	فشلت المصادقة أو لم تُقدَّم أي بيانات اعتماد.
404	غير موجود	الملف المصدر غير قابل للوصول.
500	خطأ داخلي في الخادم	واجه الجدول المحاسبي حالة شاذة أثناء جلب بيانات التحويل.
413	حجم الحمولة كبير جدًّا	تجاوز حجم الملف المرفوع الحد المسموح به.

كيفية استخدام خدمة تحويل ورقة العمل إلى جدول HTML باستخدام مكتبات SDK

مواصفات تحويل ورقة العمل إلى جدول HTML

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}

{< tab tabNum=“1” >}

# استخدام بروتوكول HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/worksheet/html-table?worksheet={worksheet}&region={region}&password={password}" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/octet-stream" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "File": " поток ثنائي للجدول HTML الناتج"
}

{< /tab >}

{< /tabs >}

استخدام مكتبات Aspose.Cells Cloud SDK

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells Cloud باستخدام مكتبات SDK مختلفة: `[TBD]`

Developer-Guide: تصدير الجدول – واجهة برمجة تطبيقات Aspose.Cells Cloud | تحويل Excel إلى PDF و PNG و CSV

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

تصدير جدول جدول بيانات (Excel) المخزن في السحابة إلى ملف بتنسيق آخر.

واجهة برمجة تطبيقات تصدير الجدول إلى تنسيق

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

GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/tables/{tableName}

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

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

-H "Authorization: Bearer {access_token}"

معلمات الطلب:

اسم المعلمة	النوع	المسار / سلسلة الاستعلام / جسم الطلب	الوصف
name	String	Path	مطلوبة. اسم ملف المصنف المراد استرجاعه.
worksheet	String	Path	اسم ورقة العمل.
tableName	String	Path	اسم الجدول.
format	String	Query	مطلوبة. التنسيق المطلوب للإخراج (مثل “png”، “pdf”، “svg”).
folder	String	Query	اختياري. مسار المجلد الذي يُخزَّن فيه المصنف. القيمة الافتراضية هي `null`.
storageName	String	Query	اختياري. اسم وحدة التخزين عند استخدام خدمة تخزين سحابية مخصصة. يُستخدم التخزين الافتراضي في حال حذفها.
outPath	String	Query	اختياري. مسار المجلد لتخزين الملفات الخارجة. القيمة الافتراضية هي `null`.
outStorageName	String	Query	اختياري. اسم وحدة تخزين الملف الخارجي.
fontsLocation	String	Query	اختياري. موقع الخطوط المخصصة.
region	String	Query	اختياري. إعداد منطقة/لغة جدول البيانات (مثل `en-US`، `fr-FR`). يؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك الخاص باللغة والموقع.
password	String	Query	اختياري. كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

كُودات حالة HTTP

الكود	المعنى	الوصف
200	ناجح (OK)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معلمات ناقصة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصرح (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم حمل الطلب كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

متى يجب استخدام واجهة برمجة تطبيقات تصدير الجدول إلى تنسيق آخر؟

ترحيل الأنظمة القديمة: تحويل آلاف ملفات XLS القديمة إلى تنسيق XLSX لدعم الأنظمة الحديثة.
توحيد تنسيقات الأرشفة: جعل تنسيقات جداول البيانات المتنوعة (XLS و XLSM و ODS و CSV) متجانسة إلى تنسيق واحد للأرشفة.
التوافق مع حزم المكتب: تحويل ملفات Excel إلى تنسيقات متوافقة مع LibreOffice و Google Sheets أو Apple Numbers.
توحيد مصادر البيانات: تحويل تنسيقات جداول البيانات المختلفة إلى CSV أو JSON لاستيرادها إلى قواعد البيانات.
النشر على الويب: تحويل نماذج البيانات المالية إلى HTML لعرضها على الويب.

لماذا يجب استخدام واجهة برمجة تطبيقات تصدير الجدول إلى تنسيق آخر؟

سهلة للمطورين: تُقدِّم Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يُسهّل التطوير السريع ويوفر وثائق شاملة. ومقارنةً ببناء حلول مخصصة لعرض الرسوم البيانية، تقلل هذه الطريقة بشكل كبير من جهد التطوير.
تقليل تكاليف العمالة: تُقلل الحاجة إلى تخصيص وظائف لدمج المستندات.
الدفع حسب الاستخدام: لا توجد استثمارات مبدئية؛ تدفع فقط مقابل_calls_ التي تُستخدم فعليًا.
لا توجد تكاليف صيانة: لا حاجة لصيانة الخوادم أو تحديث البرمجيات أو التعامل مع مشكلات التوافق.
تُعيد الواجهة بيانات الجدول الخام فقط دون أي تنسيق للمصنف الأصلي.

كيفية استخدام واجهة برمجة تطبيقات تصدير جدول جدول البيانات إلى تنسيق باستخدام SDK؟

مواصفات واجهة برمجة تطبيقات تصدير الجدول إلى تنسيق

تُعرِّف مواصفات واجهة برمجة تطبيقات تصدير الجدول إلى تنسيق واجهة برمجة متاحة عمومًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

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

Request

curl -X GET "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/tables/Table1?format=pdf" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/octet-stream"

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

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

Developer-Guide: تصدير نطاق Excel إلى PDF أو PNG أو CSV – واجهة برمجة تطبيقات Aspose.Cells Cloud

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

تصدير نطاق جدول بيانات (أو Excel) الموجود في السحابة إلى ملف بتنسيق معيّن. يمكن حفظ ملف التنسيق في السحابة أو تصديره إلى التخزين المحلي.

واجهة برمجة تطبيقات تصدير النطاق كتنسيق

واجهة برمجة التطبيقات عبر الويب (Web API)

GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{range}

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

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

مُعاملات الطلب (Request Parameters)

اسم المُعامل	النوع	الموقع	الوصف
name	سلسلة نصية (String)	المسار (Path)	(إجباري) اسم ملف المصنف (workbook) المطلوب استرجاعه.
worksheet	سلسلة نصية (String)	المسار (Path)	اسم ورقة العمل في جدول البيانات.
range	سلسلة نصية (String)	المسار (Path)	النطاق المراد تحويله (مثال: `A1:C12`).
format	سلسلة نصية (String)	استعلام (Query)	(إجباري) تنسيق الإخراج المطلوب (مثال: `pdf`، `png`، `svg`).
folder	سلسلة نصية (String)	استعلام (Query)	(اختياري) مسار المجلد الذي يحتوي على المصنف.
storageName	سلسلة نصية (String)	استعلام (Query)	(اختياري) اسم التخزين في حال استخدام تخزين سحابي مخصص.
outPath	سلسلة نصية (String)	استعلام (Query)	(اختياري) مسار ملف الإخراج في التخزين السحابي.
outStorageName	سلسلة نصية (String)	استعلام (Query)	(اختياري) اسم التخزين المُستخدم لملف الإخراج.
fontsLocation	سلسلة نصية (String)	استعلام (Query)	(اختياري) موقع خطوط مخصصة.
region	سلسلة نصية (String)	استعلام (Query)	(اختياري) إعداد المنطقة/اللغة لجدول البيانات (مثال: `en-US`، `fr-FR`). يؤثّر على تنسيق الأرقام، وتحليل التواريخ، والسلوك المرتبط بالمنطقة.
password	سلسلة نصية (String)	استعلام (Query)	(اختياري) كلمة المرور المطلوبة لفتح ملف جدول البيانات.

الاستجابة (Response)

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب خاطئ)	مُعاملات مفقودة أو غير صالحة (مثال: نوع ملف غير مدعوم).
401	Unauthorized (غير مُصادَق)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حمولة كبيرة جدًا)	تجاوز حجم الملف المرفوع الحد المسموح به.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تصدير النطاق إلى تنسيق آخر؟

سيناريوهات تصدير البيانات والنقل (Data Export & Migration)

دمج مع قواعد البيانات (Database Integration) – تصدير نطاقات Excel محددة مباشرةً إلى أنظمة قواعد البيانات.
دمج مع التطبيقات (Application Integration) – إمداد تطبيقات SaaS ببيانات جدول البيانات المحددة.
الترحيل بين الأنظمة (System Migration) – نقل نطاقات بيانات محددة بين الأنظمة القديمة والحديثة.
المشاركة عبر منصات مختلفة (Cross‑Platform Sharing) – مشاركة مجموعات فرعية من البيانات المحددة عبر منصات متنوعة.

التقارير والتحليلات (Reporting & Analytics)

التقارير المُوجّهة (Targeted Reporting) – تصدير أقسام تقارير محددة إلى تنسيقات أخرى لتحليل مركّز.
تغذية بيانات لوحة التحكم (Dashboard Data Feeds) – تزويد أدوات لوحات تحكم BI بنطاقات بيانات محددة.
مقاييس الأداء (Performance Metrics) – استخراج نطاقات KPI لأنظمة مراقبة الأداء.
التقارير المالية (Financial Reporting) – تصدير أقسام البيانات المالية لغرض التدقيق الخارجي.

التطوير والاختبار (Development & Testing)

إدارة بيانات الاختبار (Test Data Management) – تصدير نطاقات بيانات محددة لأغراض الاختبار.
بيئات التطوير (Development Environments) – مشاركة نطاقات بيانات مثال مع فرق التطوير.
اختبار واجهة برمجة التطبيقات (API Testing) – إنشاء بيانات اختبار بصيغة CSV من أقسام محددة من جدول البيانات.
تطوير النماذج الأولية (Prototype Development) – توفير مجموعات بيانات مركّزة لنماذج التطبيقات الأولية.

العمليات التجارية (Business Operations)

مشاركة بيانات انتقائية (Selective Data Sharing) – مشاركة نطاقات بيانات محددة مع شركاء خارجيين.
نسخ احتياطي جزئي للبيانات (Partial Data Backup) – النسخ الاحتياطي ل نطاقات بيانات حرجة بصيغة محددة.
نقل البيانات بين الإدارات (Departmental Data Transfer) – مشاركة نطاقات بيانات محددة بين الإدارات المختلفة.
التقارير الامتثالية (Compliance Reporting) – تصدير نطاقات بيانات تنظيمية لأغراض تقديم تقارير الامتثال.

سير العمل الآلي (Automation Workflows)

تصدير النطاقات المجدولة (Scheduled Range Exports) – تصدير نطاقات محددة تلقائيًا وفق جدول زمني.
الاستخراج المُحفَّز بالحدث (Trigger‑Based Extraction) – تصدير النطاقات استنادًا إلى أحداث أو مُحفّزات تجارية.
دمج تصدير النطاقات في سير العمل (Workflow Integration) – دمج عمليات تصدير النطاقات في سير العمل للعمليات التجارية.
المعالجة الدُفعية للنطاقات (Batch Range Processing) – معالجة نطاقات محددة متعددة في عمليات دفعية.

لماذا يجب استخدام واجهة برمجة تطبيقات تصدير النطاق إلى تنسيق آخر؟

سهلة الاستخدام للمطورين (Developer‑Friendly) – توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يتيح تطويرًا سريعًا مع توفر وثائق شاملة. ومقارنةً ببناء حلول مخصصة لعرض الرسوم البيانية، فإنها تقلّل بشكل كبير من جهد التطوير المطلوب.
خفض تكاليف العمالة (Reduced Labor Costs) – الحاجة الأقل إلى الموظفين المخصصين لدمج الوثائق.
دفع مقابل الاستخدام فقط (Pay‑per‑Use) – لا استثمار مبدئي؛ تدفع فقط مقابل طلبات واجهة برمجة التطبيقات التي تستخدمها فعلًا.
لا صيانة للخوادم (No Server Maintenance) – لا خوادم مطلوب صيانتها، ولا تحديثات برمجيات، ولا مشاكل توافق.
الحفاظ على تنسيقات Excel المعقدة (Preserves Complex Excel Formatting) – تحافظ ملفات الإخراج على التنسيق الأصلي لجدول البيانات.

كيفية استخدام واجهة برمجة تطبيقات تصدير نطاق جدول البيانات كتنسيق باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تصدير النطاق كتنسيق

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

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

Request

curl -X GET "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/ranges/A1:C12?format=pdf" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/octet-stream"

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 مشفرة)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة:

Developer-Guide: تصدير ورقة عمل – واجهة Aspose.Cells Cloud API الإصدار 4 (PDF وPNG وSVG وCSV)

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

تصدير ورقة عمل من جدول بيانات/Excel مخزّن في السحابة إلى ملف بتنسيق آخر باستخدام واجهة Aspose.Cells Cloud Web API.

واجهة تصدير ورقة العمل كتنسيق

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

GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}

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

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

-H "Authorization: Bearer {access_token}"

معلمات الطلب

اسم المعلمة	النوع	المسار / سلسلة الاستعلام / جسم الطلب HTTP	الوصف
name	String	Path	(مطلوبة) اسم ملف المصنف المراد استرجاعه.
worksheet	String	Path	(مطلوبة) ورقة العمل المحددة المراد تحويلها.
format	String	Query	(مطلوبة) التنسيق المطلوب للملف الناتج (مثل `png` أو `pdf` أو `svg`).
folder	String	Query	(اختياري) مسار المجلد الذي يخزّن فيه المصنف. القيمة الافتراضية هي `null`.
storageName	String	Query	(اختياري) اسم مساحة التخزين السحابية المخصصة. استخدام مساحة التخزين الافتراضية عند حذفها.
outPath	String	Query	(اختياري) مسار مجلد الإخراج. القيمة الافتراضية هي `null`.
outStorageName	String	Query	(اختياري) اسم مساحة تخزين الملف الناتج.
fontsLocation	String	Query	(اختياري) تحديد الخطوط المخصصة عند الحاجة.
region	String	Query	(اختياري) إعداد منطقة/لغة جدول البيانات (مثل `en-US` أو `fr-FR`). يؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك المتعلق باللغة المحلية.
password	String	Query	(اختياري) كلمة المرور للوصول إلى ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

كودات حالة HTTP

الكود	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصدق	رمز JWT غير صحيح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة تصدير ورقة العمل إلى تنسيق آخر؟

ترحيل الأنظمة القديمة – تحويل آلاف ملفات XLS القديمة إلى تنسيق XLSX لأنظمة حديثة.
توحيد التنسيقات للأرشفة – جعل تنسيقات جداول البيانات المختلفة (XLS وXLSM وODS وCSV) موحدة لغرض الأرشفة.
التوافق مع حزم المكتب – تحويل ملفات Excel إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
توحيد مصادر البيانات – تحويل تنسيقات جداول البيانات المختلفة إلى CSV أو JSON لاستيرادها في قواعد البيانات.
النشر على الويب – تحويل النماذج المالية إلى HTML لعرضها على الويب.

لماذا تستخدم واجهة تصدير ورقة العمل إلى تنسيق آخر؟

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

كيفية استخدام واجهة تصدير ورقة جدول البيانات كتنسيق باستخدام واجهات برمجة التطبيقات (SDKs)؟

مواصفات واجهة تصدير ورقة العمل كتنسيق

توفر مواصفات واجهة تصدير ورقة العمل كتنسيق واجهة برمجة مفتوحة للوصول إلى التفاعلات REST مباشرةً من متصفح ويب.

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

Request

curl -X GET "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/worksheets/Sheet1?format=pdf" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/octet-stream"

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

استخدام واجهات برمجة تطبيقات Aspose.Cells Cloud (SDKs)

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

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

Developer-Guide: حفظ جدول البيانات بصيغة أخرى – واجهة برمجة تطبيقات Aspose.Cells Cloud (الإصدار 4.0)

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

احفظ جدول بيانات سحابي أو ملف Excel بصيغة مختلفة في مساحة التخزين السحابية.

واجهة برمجة تطبيقات حفظ جدول البيانات بصيغة أخرى

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

PUT https://api.aspose.cloud/v4.0/cells/{name}/saveas

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	سلسلة	المسار	مطلوبة. اسم ملف المصنف المراد تحويله.
format	سلسلة	الاستعلام	مطلوبة. الصيغة المطلوبة للإخراج (مثل `Xlsx`، `PDF`، `CSV`).
saveOptionsData	فئة	الجسم	بيانات خيارات الحفظ اختيارية. إذا تُركت فارغة، تُفترض القيمة الافتراضية `null`.
folder	سلسلة	الاستعلام	مسار المجلد اختياري حيث يتم تخزين المصنف المصدر. إذا تُرك فارغًا، تُفترض القيمة الافتراضية `null`.
storageName	سلسلة	الاستعلام	اسم مساحة تخزين مخصصة اختيارية. إذا تُرك فارغًا، تُستخدم مساحة التخزين الافتراضية.
outPath	سلسلة	الاستعلام	مسار الإخراج اختياري للملف المحول. إذا تُرك فارغًا، تُفترض القيمة الافتراضية `null`.
outStorageName	سلسلة	الاستعلام	اسم مساحة التخزين اختياري للملف الناتج.
fontsLocation	سلسلة	الاستعلام	موقع خطوط مخصص اختياري.
region	سلسلة	الاستعلام	إعداد المنطقة لجدول البيانات اختياري.
password	سلسلة	الاستعلام	كلمة مرور اختيارية لفتح ملف جدول البيانات.

الصيغ المدعومة للإخراج

الصيغة	الامتداد
Xlsx	.xlsx
Pdf	.pdf
Csv	.csv
Html	.html
Ods	.ods
Xls	.xls
Txt	.txt
Mhtml	.mhtml
Tiff	.tiff
Pptx	.pptx
… (المزيد)	راجع مواصفات واجهة برمجة التطبيقات للحصول على القائمة الكاملة (أكثر من 20 صيغة)

الاستجابة

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

مثال على استجابة خطأ (400 طلب غير صالح)

{
  "Code": 400,
  "Message": "معلمات الطلب غير صالحة."
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح به	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	ملف التحميل يتجاوز الحد الأقصى للحجم.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب عليك استخدام واجهة برمجة التطبيقات لحفظ جدول البيانات بصيغة أخرى؟

نظام إدارة الوثائق المؤسسي

حفظ تقارير مالية تلقائيًا كأرشيفات PDF.
النسخ الاحتياطي المنتظم لبيانات المبيعات بصيغة CSV.
حفظ خطط المشاريع كملفات للقراءة فقط لمنع التعديلات العرضية.

عمليات دمج البيانات وعمليات ETL

تصدير بيانات نظام إدارة علاقات العملاء وحفظها كقالب Excel قياسي.
تحويل بيانات نظام تخطيط موارد المؤسسة إلى CSV لاستيرادها في أنظمة أخرى.
حفظ البيانات الخام بصيغة JSON لنقلها عبر واجهة برمجة تطبيقات.

سيناريوهات التطوير والأتمتة

المعالجة الخلفية لتطبيقات الويب.
أنظمة إنشاء التقارير الآلية.
منصات التعاون السحابية.
دمج عمليات الموافقة.
النسخ الاحتياطي والترحيل للبيانات.

لماذا يجب عليك استخدام واجهة برمجة التطبيقات لحفظ جدول البيانات بصيغة أخرى؟

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

كيف تستخدم واجهة برمجة التطبيقات لحفظ جدول البيانات بصيغة أخرى باستخدام SDKs؟

مواصفات واجهة برمجة تطبيقات حفظ جدول البيانات بصيغة أخرى

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

مثال مع جسم الطلب وcURL

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/saveas?format=pdf&outPath=output.pdf" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{"SaveOptions":{"SaveFormat":"pdf"}}'

Response

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

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

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

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

Developer-Guide: واجهة Aspose.Cells Cloud Web API – تحويل ورقة العمل إلى JSON

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

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

واجهة API لتحويل ورقة العمل إلى JSON

واجهة API على الويب

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/json

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

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

معلمات الطلب:

اسم المعلمة	النوع	الموقع	إلزامي/اختياري	الوصف
Spreadsheet	ملف	FormData	إلزامي	ملف مصنف Excel المراد معالجته. يجب أن يكون بصيغة مدعومة (مثل xls، xlsx، csv، إلخ). يُرسَل كـ multipart/form-data. مثال: `Spreadsheet=@C:\Docs\Sample.xlsx`.
worksheet	نص	Query	إلزامي	الاسم الدقيق لورقة العمل المراد تحويلها (مع مراعاة حالة الأحرف). إذا حُذفت أو لم يُعثر عليها، تُعيد الواجهة خطأً. مثال: `worksheet=Sheet1`.
outPath	نص	Query	اختياري	المجلد الوجهة على مساحة التخزين السحابية المُعدة لحفظ ملف JSON الناتج. إن لم يُحدَّد، يُعاد محتوى JSON مباشرةً في تدفق الاستجابة. مثال: `outPath=/converted/`.
outStorageName	نص	Query	اختياري	اسم مساحة التخزين المستهدفة (مثل “MyStorage”) التي تحتوي على `outPath`. ويُستخدم مساحة التخزين الافتراضية عند حذف هذه المعلمة.
fontsLocation	نص	Query	اختياري	مجلد على الخادم يحتوي على خطوط مخصصة مطلوبة لعرض النصوص في ورقة العمل بدقة. مثال: `fontsLocation=/fonts/custom/`.
region	نص	Query	اختياري	معرّف ثقافة/منطقة يؤثّر على تنسيق الأرقام والتاريخ والعملات في ملف JSON الناتج (مثل `en-US`، `fr-FR`).
password	نص	Query	اختياري	كلمة المرور لفتح مصنف مشفر. إن لم يكن المصنف محميًا بكلمة مرور، يمكن حذف هذه المعلمة.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

أكواد حالة HTTP

الكود	المعنى	الوصف
200	نجاح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح به	رمز JWT غير صحيح أو مفقود.
413	حجم البيانات كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين نستخدم واجهة API لتحويل ورقة العمل إلى JSON؟

الوحة القيادية على الويب (Web dashboards) – تصدير بيانات ورقة العمل إلى JSON لاستخدامها مع مكتبات الرسم البياني من جانب العميل (مثل Chart.js، D3.js).
الهجرة البياناتية – نقل بيانات Excel القديمة إلى قواعد بيانات NoSQL أو خدمات REST التي تستهلك بيانات JSON.
تطبيقات الجوال أو غير المتصلة بالإنترنت – تحويل محتوى ورقة العمل إلى JSON على الخادم، ثم مزامنة البيانات الخفيفة مع أجهزة الجوال.
خطوط أنابيب التقرير – تغذية بيانات ورقة العمل مباشرةً إلى محركات التحليلات التي تقبل إدخال JSON دون الحاجة لخطوات وسيطة بملفات CSV.

لماذا يجب استخدام واجهة API لتحويل ورقة العمل إلى JSON؟

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

كيفية استخدام واجهة API لتحويل ورقة العمل إلى JSON باستخدام SDKs

مواصفات واجهة API لتحويل ورقة العمل إلى JSON

توفّر مواصفات واجهة API لتحويل ورقة العمل إلى JSON واجهة برمجة تطبيقات عامة قابلة للوصول تنفيذ تفاعلات REST مباشرة من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/worksheet/json?worksheet=Sheet1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.json

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

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

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

Developer-Guide: واجهة Aspose.Cells Cloud Web API – تحويل ورقة عمل Excel محلية إلى ملف PDF – أداة مجانية عبر الإنترنت

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

تصدير ورقة عمل من ملف Excel محلي إلى ملف PDF باستخدام واجهة Cloud API.

واجهة تحويل ورقة العمل إلى PDF

واجهة Web API

PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/pdf

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

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

مُعلمات الطلب:

اسم المُعلمة	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات.
worksheet	سلسلة نصية	استعلام	اسم ورقة العمل داخل جدول البيانات.
outPath	سلسلة نصية	استعلام	(اختياري) مسار المجلد لتخزين ملف جدول العمل؛ القيمة الافتراضية هي null.
outStorageName	سلسلة نصية	استعلام	اسم تخزين ملف الإخراج.
fontsLocation	سلسلة نصية	استعلام	استخدام خطوط مخصصة لإنشاء ملف PDF.
region	سلسلة نصية	استعلام	تحديد إعداد منطقة جدول البيانات.
password	سلسلة نصية	استعلام	كلمة المرور المطلوبة لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream",
      "Name": "file"
    }
  }
]

رموز حالة HTTP

الكود	المعنى	الوصف
200	نجاح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مخوَّل	رمز JWT غير صالح أو مفقود.
413	حجم البيانات كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	حدث خطأ غير متوقع في الخادم.

أين يجب عليك استخدام واجهة تحويل ورقة العمل إلى PDF؟

البيانات المالية: تحويل ميزانيات التشغيل، قوائم الدخل (جداول محددة) إلى PDF لتوثيق جاهز للمراجعة.
تقارير المبيعات: تحويل لوحات عرض المبيعات أو حسابات العمولات إلى ملفات PDF قابلة للتوزيع.
مقاييس العمليات: تصدير جداول المؤشرات الرئيسية للأداء (KPI) ومقاييس الأداء كتقرير PDF رسمي.
البيانات التعاقدية: تصدير جداول الأسعار واتفاقيات مستوى الخدمة من جداول البيانات إلى ملفات PDF مُرفقة.
سجلات التدقيق: الاحتفاظ بورقات العمل المالية كأدلة PDF غير قابلة للتعديل.
ملخصات المحافظ الاستثمارية: تصدير جداول أداء الاستثمارات كبيانات PDF جاهزة للعميل.
تقارير ضبط الجودة: تصدير ورقات عمل الفحص إلى PDF لسجلات الامتثال.
ملخصات المخزون: تحويل ورقات عمل المخزون إلى PDF لمراجعة الإدارة.

لماذا يجب عليك استخدام واجهة تحويل ورقة العمل إلى PDF؟

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

كيفية استخدام واجهة تحويل ورقة العمل إلى PDF باستخدام مكتبات SDK؟

مواصفات واجهة تحويل ورقة العمل إلى PDF

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

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

الطلب

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/worksheet/json?worksheet=Sheet1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.json

الاستجابة

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

توضح الأمثلة التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

Developer-Guide: واجهة Aspose.Cells Cloud الويبية - تحويل بيانات النطاق المحلي لملف Excel إلى ملف JSON - أداة مجانية عبر الإنترنت

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

صدِّر بيانات النطاق من ملف Excel محلي إلى ملف JSON باستخدام واجهة Cloud API.

واجهة تحويل النطاق إلى JSON

PUT https://api.aspose.cloud/v4.0/cells/convert/range/json

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

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

معلمات الطلب:

اسم المعلمة	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل داخل جدول البيانات.
range	نص	استعلام	منطقة الخلايا المراد تحويلها، مثل A1:C10.
outPath	نص	استعلام	(اختياري) مسار المجلد حيث يُخزَّن ملف العمل؛ القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مخزن ملفات الإخراج.
fontsLocation	نص	استعلام	موقع تخزين الخطوط المخصّصة للاستخدام الشخصي.
region	نص	استعلام	إعداد منطقة جدول البيانات.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة تحويل النطاق إلى JSON؟

لوحات التحكم في الوقت الفعلي: حوّل بيانات Excel الحية إلى JSON لاستخدامها مع مكتبات الرسم البياني مثل Chart.js أو D3.js.
جداول البيانات كخدمة (Spreadsheet-as-a-Service): قدّم نطاقات Excel كنقاط نهاية JSON لخدمات أخرى.
حمولات Webhook: حوّل بيانات جداول البيانات إلى JSON لإرسال إشعارات Webhook.
نماذج أولية سريعة للبيانات: حوّل بيانات Excel النظيفة بسرعة إلى JSON لتحليلها باستخدام Python أو R.
سير عمل التعلّم الآلي: أجرِ معالجة أولية لبيانات التدريب من جداول البيانات المُدارة من قِبل الأعمال.
عمليات التجارة الإلكترونية: زامن كتالوجات المنتجات أو أوراق أسعارها مع المواقع الإلكترونية عبر JSON.
أتمتة التقارير: أنشئ تدفقات بيانات JSON من نماذج مالية لأغراض إنشاء تقارير تلقائية.
تكوين التطبيقات: أدر علامات الميزات والإعدادات أو معلمات اختبارات A/B في Excel → JSON.
الدعم متعدد اللغات: حوّل جداول البيانات الخاصة بالتعريب إلى JSON لاستخدامها مع مكتبات i18n.
القوائم/التنقل الديناميكي: اخزن هياكل التنقل في الموقع الإلكتروني في Excel ونفّذها كـ JSON.

لعرض خيارات التحويل الأخرى، راجع دليل تحويل النطاق إلى CSV.

لماذا يجب استخدام واجهة تحويل النطاق إلى JSON؟

دعم SDK: توفر Aspose.Cells Cloud مكتبات بلغات برمجة متعددة، مما يقلل من الحاجة إلى كتابة كود مخصص.
خفض تكاليف التخزين: يمكن تحويل النطاق دون رفع ملف العمل بالكامل أولاً، مما يوفر مساحة تخزين.
التوافق مع تطبيقات الويب والجوّال: JSON هو تنسيق البيانات الأصلي لإطارات عمل JavaScript الحديثة مثل React وVue وAngular.
دعم واسع للغات البرمجة: يمكن لمعظم لغات البرمجة وقواعد البيانات قراءة JSON.
الحفاظ على هيكلية البيانات
- الكشف الذكي عن الهيكل: تحويل تلقائي لبيانات الجداول إلى مصفوفات أو كائنات JSON صحيحة.
- ربط الرؤوس: استخدام الصف الأول كمفاتيح JSON لبناء كائنات واضحة.
- الحفاظ على أنواع البيانات: الاحتفاظ بأنواع البيانات (أرقام، تواريخ، قيم منطقية) بدلاً من نصوص بسيطة.

كيف تستخدم واجهة تحويل النطاق إلى JSON باستخدام SDKs؟

معيار واجهة تحويل النطاق إلى JSON

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء المكالمات إلى Cloud API باستخدام cURL.

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/json?worksheet=Sheet1&range=A1:C10" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/your/file.xlsx"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="result.json"
Content-Length: 8423

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

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

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

Developer-Guide: واجهة Aspose.Cells Cloud الويبية – تحويل جدول البيانات إلى PDF

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

ينهي_endpoint_ **ConvertSpreadsheetToPdf** قراءة ملف جدول البيانات المرفوع من محرك أقراص محلي، ومعالجته على خادم Aspose.Cells Cloud، ثم إرجاع مستند PDF الناتج كدفق ثنائي. يلغي هذا التحويل السحابي الحاجة إلى رفع ملف المصدر إلى التخزين، ويقلل من استهلاك الموارد، ويُبسّط سير العمل من خلال تسليم ملف PDF مباشرةً إلى العميل. تعتمد التنسيقات المدعومة على المكتبات الأساسية؛ وتتحقق الواجهة من وجود الملف وأذوناته وسلامة التحويل، وتُطلق أكواد HTTP مناسبة للأخطاء الناتجة عن المدخلات غير الصالحة أو فشل المعالجة.

واجهة API لتحويل جدول البيانات إلى PDF

واجهة الويب

PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/pdf

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

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

معاملات الطلب:

اسم المعامل	النوع	الموقع	إلزامي/اختياري	الوصف
جدول البيانات	ملف	FormData	إلزامي	ملف جدول البيانات المصدر (XLS أو XLSX أو CSV، إلخ) المراد تحويله. يجب أن يكون ملفًا صالحًا وقابلًا للقراءة؛ وأقصى حجم مسموح به هو 100 ميغا بايت. مثال: `myWorkbook.xlsx`.
outPath	نص	استعلام	اختياري	مسار مجلد الوجهة الذي سيتم حفظ ملف PDF المحول فيه على الخادم (إن أردت الحفظ). وفي حال إهماله، يُعاد الملف مباشرةً في الاستجابة. مثال: `/output/reports/`.
outStorageName	نص	استعلام	اختياري	اسم خدمة التخزين المستهدفة (مثل `MyCloudStorage`). مطلوب فقط عند استخدام `outPath` وعدم كون التخزين الافتراضي هو الوجهة.
fontsLocation	نص	استعلام	اختياري	مسار مجلد خطوط مخصصة على الخادم لضمان عرض النصوص بشكل صحيح في ملف PDF. مثال: `/fonts/custom/`.
region	نص	استعلام	اختياري	إعدادات إقليم/لغة جدول البيانات (مثل `en-US` أو `fr-FR`). تؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك المتعلق بالإعدادات المحلية.
password	نص	استعلام	اختياري	كلمة المرور المطلوبة لفتح جدول البيانات المحمي. تُتجاهل في حال لم يكن الملف مشفرًا.

الاستجابة

استجابة ناجحة (200 OK)
نوع المحتوى: application/pdf
تصرّف المحتوى: attachment; filename=“converted.pdf”
طول المحتوى: <الحجم بالبايت>

الجسم: دفق ثنائي لملف PDF المُولّد

أكواد حالة HTTP

الكود	المعنى	الوصف
200	OK (نجاح)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادق عليه	رمز JWT غير صالح أو مفقود.
413	حملة كبيرة جدًا	حجم ملف المرفقات يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين ينبغي استخدام واجهة API لتحويل جدول البيانات إلى PDF؟

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

لماذا ينبغي استخدام واجهة API لتحويل جدول البيانات إلى PDF؟

سير عمل لا يتطلب رفع الملف أولاً – لا حاجة لرفع ملف المصدر إلى التخزين السحابي؛ يتم التحويل مباشرةً من الدفق المرفوع، مما يوفر النطاق الترددي وتكاليف التخزين.
عرض عالي الجودة والدقة – تحافظ Aspose.Cells على الصيغ المعقدة والرسوم البيانية والتنسيق عند التحويل إلى PDF، بحيث يطابق إخراج Excel على سطح المكتب.
تنفيذ قابل للتوسّع على السحابة – تستفيد من البنية التحتية السحابية لـ Aspose لتقديم تحويل سريع وموثوق بغض النظر عن عتاد العميل.
واجهة REST بسيطة – طلب PUT واحد مع معاملات اختيارية في سلسلة الاستعلام؛ وتُعيد دفق PDF جاهزًا للتنزيل، مما يجعل التكامل سهلًا في أي لغة برمجة.

كيفية استخدام واجهة API لتحويل جدول البيانات إلى PDF باستخدام حزم تطوير البرمجيات (SDKs)

مواصفات واجهة API لتحويل جدول البيانات إلى PDF

توفّر مواصفات واجهة API لتحويل جدول البيانات إلى PDF واجهة برمجة تطبيقات قابلة للوصول للعامة لتنفيذ تفاعلات REST مباشرةً من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/pdf" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.pdf

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

استخدام حزم تطوير البرمجيات (SDKs) لـ Aspose.Cells Cloud

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud - تحويل بيانات جدول إكسل محلي إلى ملف PDF - أداة مجانية عبر الإنترنت

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

تصدير بيانات الجدول من ملف إكسل محلي إلى ملف PDF باستخدام واجهة برمجة تطبيقات السحابة.

واجهة برمجة تطبيقات تحويل الجدول إلى PDF

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/pdf

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

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

معامِلات الطلب:

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم HTTP	الوصف
Spreadsheet	ملف	FormData	تحميل ملف جدول البيانات المراد تحويله.
worksheet	سلسلة نصية	استعلام	اسم ورقة العمل الخاصة بجدول البيانات.
tableName	سلسلة نصية	استعلام	اسم الجدول المراد تحويله.
outPath	سلسلة نصية	استعلام	(اختياري) مسار المجلد الذي سيتم حفظ ملف PDF المحول فيه. القيمة الافتراضية هي null.
outStorageName	سلسلة نصية	استعلام	تحديد اسم مخزن الملفات الناتجة.
fontsLocation	سلسلة نصية	استعلام	استخدام خطوط مخصصة لملف PDF.
region	سلسلة نصية	استعلام	تحديد إعداد المنطقة لجدول البيانات.
password	سلسلة نصية	استعلام	كلمة المرور للوصول إلى ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

عناوين استجابة نموذجية

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="ConvertedTable.pdf"
Content-Length: 124578

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تمت تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح به	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى PDF؟

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

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى PDF؟

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

كيفية استخدام واجهة برمجة تطبيقات تحويل الجدول إلى PDF باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى PDF

توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى PDF واجهة برمجة تطبيقات برمجية متاحة عمومًا لتنفيذ تفاعلات REST مباشرة من متصفح ويب. يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة تطبيقات السحابة باستخدام cURL.

الطلب

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/pdf?worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.pdf

الاستجابة

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

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

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud الويبية - تحويل جدول البيانات إلى تنسيق آخر - أداة مجانية عبر الإنترنت

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

قم بتحويل ملف جدول بيانات/Excel محلي إلى تنسيق آخر باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud الويبية.

واجهة برمجة تطبيقات تحويل جدول البيانات

PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet

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

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

معلمات الطلب:

اسم المعلمة	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات المراد تحويله.
format	نص	استعلام	(إلزامي) التنسيق الناتج المطلوب (مثل: “XLSX”، “PDF”، “CSV”).
outPath	نص	استعلام	(اختياري) مسار المجلد الذي سيتم حفظ المصنف المحول فيه. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	تحديد اسم تخزين للملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصصة لجدول البيانات.
region	نص	استعلام	تحديد إعداد منطقة جدول البيانات.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات إذا كان مشفرًا.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

حالة النجاح

200 OK – تمّ التحويل بنجاح، وتحتوي حِمْل الاستجابة على تيار الملف المحول.
يُظهر الرأس Content-Type نوع MIME لتنسيق الإخراج المطلوب (مثل: application/pdf لتنسيق PDF).

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (تمّ بنجاح)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب غير صالح)	معلمات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حمولة كبيرة جدًا)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

التنسيقات المدعومة

تنسيق الإخراج	الوصف
XLS	مصنف Excel 95/5.0 - 2003.
XLSX	تنسيق ملف Excel SpreadsheetML المفتوح.
XLSB	مصنف Excel الثنائي.
XLSM	مصنف Excel المُمكّن للماكرو.
XLT	قالب Excel من 97 إلى 2003.
XLTX	قالب Excel.
XLTM	قالب Excel المُمكّن للماكرو.
XLAM	ملف إضافة Excel المُمكّن للماكرو، ويُستخدم لإضافة وظائف جديدة إلى Excel.
CSV	ملف CSV (قيم مفصولة بفواصل).
TSV	ملف TSV (قيم مفصولة بمسافات.tab).
TXT	ملف نصي عادي مفصول.
HTML	تنسيق HTML.
MHTML	ملف MHTML.
ODS	ملف جدول بيانات OpenDocument (ODS).
SpreadsheetML	ملف Excel 2003 XML.
Numbers	الملف تم إنشاؤه باستخدام تطبيق Apple “Numbers”، وهو جزء من حزمة iWork لأنظمة macOS وiOS.
JSON	تدوين كائن جافا سكريبت (JavaScript Object Notation).
DIF	تنسيق تبادل البيانات (Data Interchange Format).
DBF	ملف الامتداد .dbf هو ملف قاعدة بيانات يُستخدم من قبل نظام إدارة قواعد بيانات dBASE.
PDF	تنسيق مستند Adobe Portable (Adobe Portable Document Format).
XPS	تنسيق مواصفات ورقة XML (XML Paper Specification).
SVG	تنسيق الرسومات المتجهة القابلة للتوسع (Scalable Vector Graphics).
TIFF	تنسيق ملف الصور المُوسّم (Tagged Image File Format).
PNG	تنسيق الرسومات الشبكية المحمولة (Portable Network Graphics).
BMP	تنسيق صورة نقطية (Bitmap).
EMF	تنسيق Metafile المُحسّن (Enhanced Metafile).
JPEG	JPEG هو نوع من صور الملفات المحفوظة باستخدام ضغط فاقد للبيانات.
GIF	تنسيق تبادل الرسومات (Graphics Interchange Format).
MARKDOWN	يمثل مستند Markdown.
SXC	تنسيق قائم على XML يُستخدم في OpenOffice وStarOffice.
FODS	هذا تنسيق Open Document محفوظ بصيغة XML مسطحة.
DOCX	تنسيق معروف لمستندات Microsoft Word، يجمع بين ملفات XML والثنائية.
PPTX	يعتمد تنسيق PPTX على تنسيق ملف العرض التقديمي المفتوح لـ PowerPoint من Microsoft.
SqlScript	لغة الاستعلام المهيكلة (Structured Query Language).
XHtml	XHTML هو تنسيق ملف نصي يعتمد على علامات XML، ويستخدم إعادة صياغة لـ HTML 4.0.
Epub	الملفات ذات الامتداد .epub هي تنسيق للكتب الإلكترونية يوفّر معيارًا للنشر الرقمي للمؤلفين والمستخدمين.
Xml	XML تعني لغة الترميز القابلة للتوسع (Extensible Markup Language)، وهي مشابهة لـ HTML لكنها تستخدم العلامات لتعريف الكائنات.
Ots	ملف قالب جدول بيانات Open Document (OTS).
AZW3	AZW هو تنسيق ملف كتب إلكترونية طوّرته أمازون لأجهزة Kindle. AZW3، ويُعرف أيضًا باسم Kindle Format 8 (KF8).

أين يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات؟

ترحيل الأنظمة القديمة: تحويل آلاف ملفات XLS القديمة إلى XLSX للاستخدام في الأنظمة الحديثة.
توحيد تنسيقات الأرشفة: جعل تنسيقات جداول البيانات المختلفة (XLS، XLSM، ODS، CSV) موحّدة في تنسيق واحد للأرشفة.
التوافق مع حزم المكاتب: تحويل ملفات Excel إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
توحيد مصادر البيانات: تحويل جداول بيانات متنوعة إلى CSV أو JSON لاستهلاكها في قواعد البيانات.
النشر على الويب: تحويل النماذج المالية إلى HTML لعرضها على الويب.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات؟

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

كيف تستخدم واجهة برمجة تطبيقات تحويل جدول البيانات باستخدام SDKs؟

تُظهر الأمثلة التالية كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات باستخدام مكتبات SDK مختلفة.

مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات

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

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert?format=pdf \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@/path/to/file.xlsx"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="file.pdf"
Content-Length: 8423

استخدام مكتبات Aspose.Cells Cloud SDK

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud الويبية - تصدير ورقة عمل إكسل عن بُعد إلى تنسيقات أخرى - أداة مجانية عبر الإنترنت

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

تصدير جدول بيانات سحابي (إكسل) إلى تنسيق ملف آخر.

واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق

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

GET https://api.aspose.cloud/v4.0/cells/{name}?format={format}&folder={folder}&storageName={storageName}&outPath={outPath}&outStorageName={outStorageName}&fontsLocation={fontsLocation}&region={region}&password={password}

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

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

معاملات الطلب:

اسم المعامل	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
name	String	المسار	(إلزامي) اسم ملف كتاب العمل الذي سيتم استرجاعه.
format	String	استعلام	(إلزامي) التنسيق المطلوب للملف الناتج (مثل: “Xlsx”، “PDF”، “CSV”).
folder	String	استعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه كتاب العمل. القيمة الافتراضية هي null.
storageName	String	استعلام	(اختياري) اسم التخزين عند استخدام تخزين سحابي مخصّص. استخدم التخزين الافتراضي إن حُذف.
outPath	String	استعلام	(اختياري) مسار المجلد الذي سيتم حفظ كتاب العمل فيه. القيمة الافتراضية هي null.
outStorageName	String	استعلام	(اختياري) اسم تخزين الملف الناتج.
fontsLocation	String	استعلام	(اختياري) موقع الخطوط المخصّصة.
region	String	استعلام	(اختياري) إعدادات إقليم/لغة جدول البيانات (مثل: `en-US`، `fr-FR`). يؤثر على تنسيق الأرقام، وتحليل التواريخ، والسلوك الخاص باللغة المحلية.
password	String	استعلام	(اختياري) كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

تحتوي الاستجابة على كائن واحد يمثّل تيار الملف المحول.

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401	غير مُصادَق (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا (Payload Too Large)	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق آخر؟

ترحيل الأنظمة القديمة: تحويل آلاف ملفات XLS القديمة إلى تنسيق XLSX لتناسب الأنظمة الحديثة.
توحيد التنسيقات للأرشفة: جعل تنسيقات جداول البيانات المتنوعة (XLS، XLSM، ODS، CSV) موحدة إلى تنسيق واحد للأرشفة.
التوافق مع حزم المكاتب: تحويل ملفات إكسل إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
توحيد مصادر البيانات: تحويل تنسيقات جداول البيانات المتنوعة إلى CSV أو JSON لاستيعابها في قواعد البيانات.
النشر على الويب: تحويل النماذج المالية إلى تنسيق HTML لعرضها على الويب.

لماذا يجب استخدام واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق آخر؟

ملائمة للمطورين: تقدّم Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسهّل التطوير بسرعة، ويأتي مع وثائق شاملة. وبالمقارنة مع بناء حلول مخصّصة لعرض الرسوم البيانية، تقلّل هذه الخدمة بشكل كبير من جهد التطوير.
خفض تكاليف العمالة: تقلّل الحاجة إلى تخصيص وظائف لأغراض دمج الوثائق.
الدفع حسب الاستخدام: لا توجد استثمارات مبدئية؛ تدفع مقابل استدعاءات API الفعلية فقط.
لا يتطلب صيانة خوادم من جانبك: لا حاجة لصيانة الخوادم أو تحديث البرامج أو التعامل مع مشاكل التوافق.
دعم شامل للتنسيقات: يدعم التحويل بين أكثر من 20 تنسيق لجداول البيانات.
الحفاظ على دقة البيانات والتنسيق الأصلي: تحفظ التخطيط والمعادلات والأنماط الأصلية أثناء التحويل.

كيف تستخدم واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق مع مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق

مواصفات واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق توفر واجهة برمجة مفتوحة للوصول واجهات REST بسلاسة.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells الويبية. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة Cloud API باستخدام cURL.

الطلب

curl -X GET "https://api.aspose.cloud/v4.0/cells/MyWorkbook.xlsx/worksheets?format=pdf" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/octet-stream"

الاستجابة

{
  "type": "FileContentResult",
  "fileContents": "byte[] (مشفرة بـ Base64)",
  "contentType": "نوع MIME",
  "fileDownloadName": "اسم ملف اختياري"
}

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

استخدام مكتبة SDK هو أسرع طريقة للتطوير، لأنها تُجرّدك من التفاصيل منخفضة المستوى، ما يسمح لك بتصدير جدول بيانات إلى ملف بصيغة معينة عبر كود موجز.
قبل إجراء استدعاء لواجهة برمجة التطبيقات، احصل على رمز وصول OAuth 2.0 وأدرجْه في رأس Authorization: Bearer <token>.

يرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة لمكتبات SDK الخاصة بـ Aspose.Cells Cloud.

توضّح أمثلة الكود التالية كيفية التفاعل مع خدمات الويب الخاصة بـ Aspose.Cells عبر مكتبات SDK مختلفة:

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud عبر الويب - تحويل بيانات جدول في جدول بيانات إلى ملف CSV - أداة مجانية عبر الإنترنت

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

تصدير بيانات الجدول من ملف Excel محلي إلى ملف CSV باستخدام واجهة برمجة التطبيقات السحابية.

واجهة برمجة تطبيقات تحويل الجدول إلى CSV

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

PUT http://api.aspose.cloud/v4.0/cells/convert/table/csv

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

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

-H "Authorization: Bearer {access_token}"

مُعاملات الطلب:

اسم المُعامل	النوع	المسار / سلسلة الاستعلام / جسم الطلب HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	سلسلة نصية	سلسلة الاستعلام	اسم ورقة العمل داخل جدول البيانات.
tableName	سلسلة نصية	سلسلة الاستعلام	اسم الجدول المراد تحويله.
outPath	سلسلة نصية	سلسلة الاستعلام	(اختياري) مسار المجلد الذي يُخزَّن فيه المصنف؛ القيمة الافتراضية هي null.
outStorageName	سلسلة نصية	سلسلة الاستعلام	اسم وحدة التخزين التي سيتم حفظ ملف الإخراج فيها.
fontsLocation	سلسلة نصية	سلسلة الاستعلام	مسار استخدام الخطوط المخصصة.
region	سلسلة نصية	سلسلة الاستعلام	إعداد منطقة/لغة جدول البيانات (مثل `en-US`، `fr-FR`). يؤثر على تنسيق الأرقام، وتحليل التواريخ، والسلوك الخاص باللغة والمنطقة.
password	سلسلة نصية	سلسلة الاستعلام	كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	مُعاملات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق عليه	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	ملف التحميل يتجاوز الحد الأقصى للحجم.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

أين يجب عليك استخدام واجهة برمجة تطبيقات تحويل الجدول إلى CSV؟

الترحيل إلى قواعد البيانات: تحويل جداول Excel إلى CSV لاستيرادها دفعة واحدة إلى قواعد بيانات SQL (MySQL، PostgreSQL، SQL Server).
تحميل مخازن البيانات: تحويل جداول التقارير المستندة إلى Excel إلى CSV لتحميلها في Snowflake أو Redshift أو BigQuery.
حمولة دفعات واجهات برمجة التطبيقات: تحويل بيانات جدول Excel إلى CSV لرفعها دفعة واحدة إلى خدمات REST.
الاتصال بين الخدمات: استخدام CSV كصيغة خفيفة لتبادل البيانات بين الخدمات الدقيقة.
تحضير البيانات لتعلم الآلة: تحويل جداول الميزات من Excel إلى CSV لاستخدامها مع مكتبات تعلم الآلة بلغتي Python أو R.
التحليل الإحصائي: تحويل جداول بيانات البحث إلى CSV لاستيرادها في SPSS أو SAS أو Stata.
ترحيل المحتوى: نقل المحتوى المنظم من Excel إلى أنظمة إدارة المحتوى (CMS) عبر CSV.

لماذا يجب عليك استخدام واجهة برمجة تطبيقات تحويل الجدول إلى CSV؟

سهلة للمطورين: توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسرّع التطوير، وت伴随ها وثائق شاملة. ومقارنةً ببناء حلول مخصصة، فإنها تقلّل بشكل كبير من جهد التطوير.
فعالة من حيث التكلفة: يمكنك تحويل بيانات الجدول دون الحاجة أولاً لتحميل المصنف، ما يوفر مساحة تخزين ويقلل التكاليف.
استخراج البيانات النقي فقط دون التنسيق.
CSV مدعوم من قبل تقريبًا جميع الأنظمة:
- قواعد البيانات (كل أنظمة قواعد البيانات العلائقية الرئيسية)
- لغات البرمجة (مُحللات أصلية مدمجة في كل لغة)
- أدوات ذكاء الأعمال (Tableau، Power BI، Looker)
- برامج جداول البيانات (Excel، Google Sheets، LibreOffice)
- أدوات سطر الأوامر (awk، sed، grep)

كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى CSV باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى CSV

توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى CSV واجهة برمجة تطبيقات متاحة للعامة، ما يسمح بإجراء تفاعلات REST مباشرة من متصفح ويب. يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/csv?worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.csv

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

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

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

توضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud عبر الويب – تحويل بيانات جدول إكسل محلي إلى ملف JSON

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

قم بتحويل جدول جدول البيانات/إكسل المحلي إلى ملف JSON باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud عبر الويب.

واجهة برمجة تطبيقات تحويل الجدول إلى JSON

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/json

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

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

مُعطَلات الطلب

اسم المُعطَل	النوع	الموقع	الوصف
جدول البيانات	ملف	FormData	ملف إكسل المراد تحميله.
worksheet	سلسلة نصية	استعلام	اسم ورقة العمل التي تحتوي على الجدول.
tableName	سلسلة نصية	استعلام	اسم الجدول المراد تحويله.
outPath	سلسلة نصية	استعلام	(اختياري) مسار المجلد الذي سيتم فيه تخزين ملف JSON الناتج؛ القيمة الافتراضية هي null.
outStorageName	سلسلة نصية	استعلام	(اختياري) اسم وحدة التخزين التي سيتم وضع ملف الإخراج فيها.
fontsLocation	سلسلة نصية	استعلام	(اختياري) مسار الخطوط المخصصة المستخدمة أثناء التحويل.
region	سلسلة نصية	استعلام	(اختياري) الإعدادات الإقليمية لكتاب العمل.
password	سلسلة نصية	استعلام	(اختياري) كلمة المرور لفتح كتاب عمل محمي.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	نجاح (OK)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	مُعطَلات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مصادق عليه (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حملة الطلب كبيرة جدًا (Payload Too Large)	تجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى JSON؟

لوحات التحكم في الوقت الفعلي – حوّل بيانات إكسل الحية إلى JSON لاستخدامها في مكتبات الرسم البياني مثل Chart.js أو D3.js.
جدول البيانات كخدمة (Spreadsheet-as-a-Service) – عرّض جداول إكسل كنقاط نهاية JSON لخدمات ميكرو-خدمات أخرى.
أحمال Webhook – حوّل بيانات جدول البيانات إلى JSON لإشعارات Webhook.
نماذج البيانات السريعة (Rapid Data Prototyping) – حوّل بيانات إكسل المنظمة بسرعة إلى JSON لتحليلها باستخدام Python أو R.
أنابيب التعلم الآلي (Machine-Learning Pipelines) – قم بمعالجة مسبق لبيانات التدريب المخزّنة في جداول بيانات الأعمال.
عمليات التجارة الإلكترونية (E-commerce Operations) – زامن قوائم المنتجات أو أوراق الأسعار مع المواقع عبر JSON.
أتمتة التقارير (Reporting Automation) –ولّد تغذّيات JSON من نماذج مالية لتقارير آلية.
تكوين التطبيقات (App Configuration) – أدر أعلام الميزات والإعدادات أو معلمات اختبارات A/B في إكسل → JSON.
الدعم متعدد اللغات (Multi-language Support) – حوّل جداول البيانات الخاصة بالترجمة إلى JSON لمكتبات التدويل (i18n).
قوائم/تنقل ديناميكي (Dynamic Menus/Navigation) – خزّن هياكل التنقل في الموقع في إكسل ونفّذها كملفات JSON.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى JSON؟

سهلة المطورين (Developer-Friendly) – توفر Aspose.Cells Cloud SDKs للعديد من اللغات، مما يقلل من جهود التطوير ويقدم توثيقًا شاملاً.
فعالة من حيث التكلفة (Cost-Effective) – حوّل بيانات الجدول دون الحاجة أولاً لتحميل كتاب العمل، مما يوفر مساحة تخزين ويقلل التكاليف.
متوافقة مع الويب والجوّال الحديثة (Modern Web & Mobile Compatibility) – JSON هي لغة البيانات الأصلية للويب؛ تتيح لك واجهة البرمجة هذه تغذية بيانات جدول البيانات الحية مباشرةً في React أو Vue أو Angular أو تطبيقات الجوال أو تطبيقات الصفحة الواحدة دون تحليل معقد.
دعم واسع للغات (Broad Language Support) – يعمل JSON مع تقريب جميع لغات البرمجة وقواعد البيانات وخدمات الويب.
الحفاظ على هيكلية البيانات (Structured Data Preservation)
- كشف تلقائي للهيكل (Intelligent Structure Detection) – يحول بيانات الجدول تلقائيًا إلى مصفوفات/كائنات JSON صحيحة.
- ربط الرؤوس (Header Mapping) – يستخدم الصف الأول كمفاتيح JSON لهياكل الكائنات النظيفة.
- الحفاظ على أنواع البيانات (Data Type Retention) – يحافظ على الأرقام والتاريخ والقيم المنطقية (وليس فقط النصوص).

سجل الإصدارات: تم إدخال نقطة نهاية تحويل الجدول إلى JSON مع إصدار واجهة برمجة التطبيقات v4.0 (2024)، ويبقى هو الإصدار المستقر الحالي. نقاط نهاية الإصدارات الأقدم v3.x لم تعد مستخدمة (مُهمَلة).

كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى JSON مع SDKs؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى JSON

توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى JSON{:target="_blank" rel=“noopener noreferrer”} واجهة برمجة تطبيقات قابلة للوصول للعامة، مما يمكّن من إجراء تفاعلات REST مباشرة من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/json?worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.json

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/json?worksheet=Sheet1&tableName=MyTable" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/your/file.xlsx" \
     -F "outPath=output/folder" \
     -F "outStorageName=MyStorage"

Response

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

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

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

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

توضح أمثلة الكود التالية كيفية التفاعل مع خدمات ويب Aspose.Cells باستخدام مختلف SDKs:

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud عبر الويب – تحويل جداول البيانات إلى JSON

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

يحوّل الـ Endpoint ConvertSpreadsheetToJson جدول بيانات مخزّن على محرك أقراص محلي إلى ملف JSON بالكامل على خوادم خدمة Aspose.Cells Cloud. وبإرسال جدول البيانات كـ multipart/form-data، تُرجع الخدمة تدفق JSON جاهزًا للتنزيل أو المعالجة اللاحقة. ويُلغي هذا التحويل القائم على السحابة الحاجة إلى رفع الملف إلى التخزين مسبقًا، ويقلّل من تكاليف التخزين، ويبسّط سير العمل للتطبيقات التي تتطلب بيانات جداول البيانات بصيغة JSON لأغراض التحليل، أو التقارير، أو تبادل البيانات.

المتطلبات الأساسية: يجب أن تمتلك حسابًا في Aspose Cloud، ورمز وصول JWT صالحًا، وتم إعداد SDK أو مفتاح API لخدمة Aspose.Cells Cloud.

الخلفية: يُعد تحويل جداول البيانات إلى تنسيق JSON خطوة شائعة عند دمج بيانات Excel مع خدمات الويب، أو قواعد بيانات NoSQL، أو تطبيقات JavaScript من جانب العميل. وتوفّر واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON تحويلًا سريعًا من جانب الخادم دون الحاجة إلى تخزين الملف الأصلي.

واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON

PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/json

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

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

معاملات الطلب

اسم المعامل	النوع	الموقع	إلزامي/اختياري	الوصف
Spreadsheet	ملف (multipart/form-data)	FormData	إلزامي	ملف جدول البيانات المصدر (مثل: `.xls`، `.xlsx`، `.xlsm`). مثال: `curl -F "Spreadsheet=@myfile.xlsx"`
outPath	سلسلة نصية (String)	Query	اختياري	مسار المجلد الهدف في التخزين السحابي حيث سيتم حفظ ملف JSON المحول. إذا تُرك فارغًا، يُعاد JSON مباشرةً في تدفق الاستجابة. مثال: `outPath=/output/`.
outStorageName	سلسلة نصية (String)	Query	اختياري	اسم خدمة التخزين السحابي (مثل: Amazon S3، Azure Blob) حيث يجب كتابة ملف الإخراج. مطلوب فقط عند استخدام `outPath` مع تخزين غير افتراضي.
fontsLocation	سلسلة نصية (String)	Query	اختياري	مسار مجلد خطوط مخصص على الخادم. استخدم هذا الخيار عندما يشير جدول البيانات إلى خطوط غير متوفرة في المكتبة الافتراضية.
region	سلسلة نصية (String)	Query	اختياري	إعداد منطقة/لغة جدول البيانات (مثل: `en-US`، `fr-FR`). يؤثر على تنسيق الأرقام والتواريخ والعملات أثناء التحويل.
password	سلسلة نصية (String)	Query	اختياري	كلمة المرور لفتح جدول بيانات محمي بكلمة مرور. تجاهله للملفات غير المحمية.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالة HTTP

الرمز	المعنى	الوصف
200	نجاح (OK)	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معاملات مفقودة أو غير صحيحة (مثل: نوع ملف غير مدعوم).
401	غير مُصادَق (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا (Payload Too Large)	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON؟

خطوط أنابيب نقل البيانات (Data migration pipelines) – تحويل تقارير Excel القديمة إلى تنسيق JSON لاستهلاكها في قواعد بيانات NoSQL الحديثة أو بحيرات البيانات.
التطبيقات المحمولة أو الويب – تحويل جداول البيانات التي يُرفعها المستخدم بسرعة إلى تنسيق JSON لعرضها من جانب العميل دون تخزين الملف الأصلي في السحابة.
توليد التقارير تلقائيًا – إنشاء حمولات JSON لخدمات التحليل اللاحقة (مثل: Power BI، Tableau) مباشرةً من مدخلات جداول البيانات.
الوظائف بدون خادم (Serverless functions) – استخدام الواجهة داخل AWS Lambda أو Azure Functions لأداء عمليات تحويل فورية دون إدارة تخزين مؤقت.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON؟

التحويل القائم على السحابة يلغي الحاجة إلى رفع ملفات كبيرة إلى التخزين قبل المعالجة، مما يقلل من زمن الاستجابة وتكاليف التخزين.
سير عمل مكوّن من طلب واحد: رفع جدول البيانات واستلام JSON في نفس استدعاء HTTP، مما يبسّط منطق الدمج.
يدعم جداول البيانات المحمية بكلمة مرور والجداول المخصصة للمناطق، مما يضمن تمثيلًا دقيقًا للبيانات عبر المناطق المختلفة.
قابل للتحجيم على بنية Aspose الأساسية – يتعامل مع كتب عمل كبيرة ومعادلات معقدة دون التأثير على موارد خادمك.

كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON باستخدام SDKs

مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON

توفر مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى JSON واجهة برمجة تطبيقات قابلة للوصول بشكل عام لتنفيذ تفاعلات REST مباشرةً من متصفح الويب.

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/json?outPath=/output/result.json" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@myWorkbook.xlsx"

Response

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

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

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud – تحويل جدول البيانات إلى CSV

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

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

واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV

PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/csv

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

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

مُعاملات الطلب:

اسم المُعامل	النوع	الموقع	الإلزام	الوصف
Spreadsheet	ملف	FormData	إلزامي	ملف جدول البيانات المراد تحويله. يدعم التنسيقات الشائعة مثل .xls و.xlsx و.xlsm. يجب تقديمه كmultipart/form‑data. مثال: `myWorkbook.xlsx`.
outPath	سلسلة نصية	استعلام	اختياري	مسار مجلد الوجهة حيث سيتم حفظ ملف CSV المحول. إذا حُذِف، يُعاد ملف CSV مباشرةً في جسم الاستجابة. مثال: `/output/reports/`.
outStorageName	سلسلة نصية	استعلام	اختياري	اسم خدمة تخزين سحابي حيث سيتم حفظ ملف الإخراج. عند عدم تزويده، تُستخدم وحدة التخزين الافتراضية المُعدّة لحساب Aspose.Cells.
fontsLocation	سلسلة نصية	استعلام	اختياري	مسار مجلد يحتوي على خطوط مخصصة مطلوبة من قبل جدول البيانات. يُمكّن من العرض الصحيح للخلايا التي تستخدم خطوطًا غير قياسية.
region	سلسلة نصية	استعلام	اختياري	إعداد منطقة/لغة جدول البيانات (مثل `en-US` أو `fr-FR`). يؤثّر على تنسيق الأرقام وتحليل التواريخ والسلوك الخاص بالمنطقة المحلية.
password	سلسلة نصية	استعلام	اختياري	كلمة المرور المستخدمة لفتح جداول البيانات المحمية بكلمة مرور. إذا كان الملف مشفرًا وحُذِفت كلمة المرور أو كانت غير صحيحة، تُعاد رسالة خطأ 400/401.

الاستجابة

في حال النجاح، تُعيد واجهة برمجة التطبيقات HTTP 200 (أو 202 للمعالجة غير المتزامنة) مع الرأس Content-Type: application/octet-stream. ويحتوي جسم الاستجابة على ملف CSV المُولّد كدفق ثنائي.

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

رموز حالات HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	مُعاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حملة البيانات كبيرة جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV؟

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

لماذا استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV؟

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

كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV مع مكتبات SDK

مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV

توفر مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات إلى CSV واجهة برمجة برمجية يمكن الوصول إليها بشكل عام لتنفيذ تفاعلات REST مباشرةً من متصفح ويب.

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/json?outPath=/output/result.json" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@myWorkbook.xlsx"

Response

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

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

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

Developer-Guide: تحويل الجدول إلى PDF

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

خدمة تحويل الجدول إلى PDF في Aspose.Cells Cloud

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

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

PUT https://api.aspose.cloud/v4.0/cells/convert/table/pdf

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

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

معاملات الطلب

اسم المُعامل	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات.
tableName	نص	استعلام	اسم الجدول.
outPath	نص	استعلام	(اختياري) مسار المجلد حيث يُخزَّن ملف العمل. القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مساحة التخزين للملف الناتج.
fontsLocation	نص	استعلام	استخدام خطوط مخصّصة.
AutoRowsFit	منطقي	استعلام	(اختياري) ضبط ارتفاع الصفوف تلقائيًا في جميع أوراق العمل.
AutoColumnsFit	منطقي	استعلام	(اختياري) ضبط عرض الأعمدة تلقائيًا في جميع أوراق العمل.
region	نص	استعلام	إعداد المنطقة/اللغة لجدول البيانات (مثل `en-US` أو `fr-FR`)؛ ويؤثر على تنسيق الأرقام، وتفسير التواريخ، والسلوك المرتبط بالإعدادات المحلية.
password	نص	استعلام	كلمة المرور لفتح ملف جدول البيانات.

مُعامل جسم الطلب

اسم المُعامل	النوع	الوصف
لا شيء	لا شيء	لا يُطلَب جسم JSON؛ يُرسل الملف عبر multipart/form-data.

الاستجابة

{
  "file": "<محتوى PDF ثنائي>"
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	ناجح	تمت عملية تحويل الجدول إلى PDF بنجاح؛ ويحتوي جسم الاستجابة على تيار ملف PDF.
400	طلب غير صالح	مُعطَلات الطلب غير صحيحة أو عنوان URL مُشكَل بشكل خاطئ.
401	غير مُصرّح	فشلت المصادقة أو لم تُقدَّم بيانات اعتماد.
404	غير موجود	لم يكن الملف المصدر متاحًا أو لم يُعثر على ورقة العمل/الجدول.
413	حجم الحمولة كبير جدًا	تجاوز حجم ملف جدول البيانات المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	حدث خطأ أثناء تحويل جدول البيانات إلى PDF.

كيفية استخدام خدمة تحويل الجدول إلى PDF باستخدام مكتبات SDK

###仕様 تحويل الجدول إلى PDF

تُعرِّف 仕様 واجهة برمجة تطبيقات تحويل الجدول إلى PDF واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“الطلب” tabName2=“الاستجابة” >}

{< tab tabNum=“1” >}

# استخدام HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/convert/table/pdf?worksheet={worksheet}&tableName={tableName}&outPath={outPath}&outStorageName={outStorageName}&fontsLocation={fontsLocation}&AutoRowsFit={AutoRowsFit}&AutoColumnsFit={AutoColumnsFit}&region={region}&password={password}" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/pdf" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "file": "<محتوى PDF ثنائي>"
}

{< /tab >}

{< /tabs >}

استخدام مكتبات Aspose Cells Cloud SDK

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

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

// مثال على الكود باستخدام SDK لغة C#
var apiInstance = new ConversionApi();
var file = File.ReadAllBytes("sample.xlsx");
var response = apiInstance.ConvertTableToPdf(
    file,
    worksheet: "Sheet1",
    tableName: "Table1",
    outPath: null,
    outStorageName: null,
    fontsLocation: null,
    AutoRowsFit: null,
    AutoColumnsFit: null,
    region: null,
    password: null);
File.WriteAllBytes("output.pdf", response);

// مثال على الكود باستخدام SDK لغة Java
ConversionApi apiInstance = new ConversionApi();
byte[] file = Files.readAllBytes(Paths.get("sample.xlsx"));
byte[] result = apiInstance.convertTableToPdf(
    file,
    "Sheet1",
    "Table1",
    null,
    null,
    null,
    null,
    null,
    null,
    null);
Files.write(Paths.get("output.pdf"), result);

# مثال على الكود باستخدام SDK لغة Python
api_instance = conversion_api.ConversionApi()
with open("sample.xlsx", "rb") as f:
    file_bytes = f.read()
pdf_bytes = api_instance.convert_table_to_pdf(
    file=file_bytes,
    worksheet="Sheet1",
    table_name="Table1")
with open("output.pdf", "wb") as out_file:
    out_file.write(pdf_bytes)

`[TBD]`

Developer-Guide: تحويل النص في جدول بيانات عن بُعد

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

خدمة تحويل النص في جدول بيانات عن بُعد من Aspose.Cells Cloud

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

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

PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/range/{range}/content/convert/text

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

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

معاملات الطلب

اسم المعامل	النوع	المسار / سلسلة الاستعلام / جسم الطلب HTTP	الوصف
name	string	Path	(إجباري) اسم ملف المصنف المطلوب استرجاعه.
worksheet	string	Path	تحديد ورقة العمل في جدول البيانات.
range	string	Path	تحديد نطاق ورقة العمل في جدول البيانات.
convertTextType	string	Query	نوع التحويل المطلوب للنص. (إجباري)
sourceCharacters	string	Query	الأحرف المصدر. (اختياري)
targetCharacters	string	Query	الأحرف الهدف. (اختياري)
folder	string	Query	(اختياري) مسار المجلد الذي يحتوي على المصنف. القيمة الافتراضية هي null.
storageName	string	Query	(اختياري) اسم وحدة التخزين عند استخدام خدمة تخزين سحابية مخصصة. يُستخدم التخزين الافتراضي إذا لم يُحدَّد.
region	string	Query	إعدادات الإقليم/اللغة لجدول البيانات (مثل `en-US`, `fr-FR`). تؤثر على تنسيق الأرقام، وتحليل التواريخ، والسلوك المُتعلّق باللغة المحلية. (اختياري)
password	string	Query	كلمة المرور لفتح ملف جدول البيانات. (اختياري)

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

اسم المعامل	النوع	الوصف
-	-	-

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "Message": "اكتمل تحويل النص بنجاح.",
  "Data": {
    // يمكن إضافة تفاصيل نتيجة التحويل هنا، مثل عدد الخلايا المُحدَّثة.
  }
}

رموز حالة الاستجابة

الرمز	المعنى	الوصف
200	OK	اكتمل عملية تحويل النص بنجاح.
400	Bad Request	كان الطلب غير مكوّن بشكل صحيح أو ناقص المعاملات الإجبارية.
401	Unauthorized	فشلت المصادقة أو أن رمز JWT مفقود/غير صالح.
413	Payload Too Large	تجاوز حجم حمل الطلب الحد المسموح به.
500	Internal Server Error	حدث خطأ غير متوقع في الخادم.

كيفية استخدام خدمة تحويل النص في جدول بيانات عن بُعد باستخدام مكتبات SDK

مواصفات تحويل النص في جدول بيانات عن بُعد

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

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

{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}

{< tab tabNum=“1” >}

# استخدم HTTPS لاتصال آمن
curl -v "https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/range/{range}/content/convert/text?convertTextType={convertTextType}&sourceCharacters={sourceCharacters}&targetCharacters={targetCharacters}&folder={folder}&storageName={storageName}&region={region}&password={password}" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

{< /tab >}

{< tab tabNum=“2” >}

{
  "Code": 200,
  "Status": "OK",
  "Message": "اكتمل تحويل النص بنجاح.",
  "Data": {
    "UpdatedCellsCount": 124,
    "Details": "تم تحويل الأرقام، واستبدال الأحرف، وتوحيد فواصل الأسطر."
  }
}

{< /tab >}

{< /tabs >}

استخدام مكتبات Aspose Cells Cloud SDK

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

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose Cells Cloud باستخدام مكتبات SDK مختلفة: `[TBD]`

Developer-Guide: تحويل نطاق إكسل إلى صورة – واجهة برمجة تطبيقات Aspose.Cells Cloud

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

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

طريقة تحويل النطاق إلى صورة

PUT https://api.aspose.cloud/v4.0/cells/convert/range/image

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

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

مُعاملات الطلب

الاسم	الموقع	النوع	الإجبارية	الوصف
Spreadsheet	Form‑Data (`multipart/form-data`)	ملف	نعم	ملف إكسل الذي سيتم معالجته.
worksheet	Query	سلسلة نصية	نعم	اسم ورقة العمل التي تحتوي على النطاق (مثال: `Sheet1`).
range	Query	سلسلة نصية	نعم	منطقة الخلايا المراد تحويلها، مثال: `A1:C10`.
format	Query	سلسلة نصية	نعم	تنسيق الصورة الناتجة (`png`، `jpeg`، `svg`، `tiff`، `bmp`).
printHeadings	Query	منطقي	لا	`true` لتضمين عناوين الصفوف والأعمدة في الصورة.
outPath	Query	سلسلة نصية	لا	مسار المجلد لحفظ الملف المُولّد إذا أردت تخزينه في مساحة التخزين السحابية.
outStorageName	Query	سلسلة نصية	لا	اسم خدمة التخزين (مثال: `MyStorage`).
fontsLocation	Query	سلسلة نصية	لا	عنوان URL أو مسار خطوط مخصّصة تُستخدم أثناء التحويل.
region	Query	سلسلة نصية	لا	معرّف المنطقة (مثال: `en-US`، `fr-FR`)؛ يؤثّر على تنسيق الأرقام والتاريخ.
password	Query	سلسلة نصية	لا	كلمة المرور لملفات العمل المشفرة.
AutoRowsFit	Query	منطقي	لا	ضبط ارتفاع الصفوف تلقائيًا قبل العرض.
AutoColumnsFit	Query	منطقي	لا	ضبط عرض الأعمدة تلقائيًا قبل العرض.

الاستجابة

تُعيد واجهة برمجة التطبيقات ملف HTML مُحوّل كـ دفق ثنائي (application/octet-stream).

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

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

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.png"
Content-Length: 8423

احفظ محتوى جسم الاستجابة في ملف (مثل report.png) لعرض الصورة المُولّدة في المتصفح.

أكواد حالة HTTP

الكود	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

كيف تستخدم واجهة برمجة تطبيقات تحويل النطاق إلى صورة باستخدام مكتبات SDK؟

مواصفات OpenAPI

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

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/image?format=png&worksheet=Sheet1&range=A1:C10&AutoRowsFit=true&AutoColumnsFit=true" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@Report.xlsx" \
     -F "outPath=output/report.png"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.png"
Content-Length: 8423

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

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

توضح الأمثلة التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK المختلفة. إذا كان تحميل الأمثلة من Gist ممنوعًا، يمكنك تحميل الأمثلة مباشرةً من المستودع.

Developer-Guide: تحويل نطاق إكسل إلى CSV – واجهة برمجة تطبيقات Aspose.Cells Cloud

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

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

واجهة برمجة تحويل النطاق إلى CSV

المتطلبات الأساسية
للاستدعاء هذا الطرفية، يجب أن تمتلك معرف عميل وسر عميل صالحين لحساب Aspose Cloud، واحصل على رمز وصول JWT، وتأكد من أن ملف جدول البيانات الأصلي بصيغة XLSX أو XLS.

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

PUT https://api.aspose.cloud/v4.0/cells/convert/range/csv

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

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv?worksheet=Sheet1&range=A1:C10" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@sample.xlsx"

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

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

متغيّرات الطلب:

اسم المتغيّر	النوع	المسار/سلسلة الاستعلام/جسم HTTP	الوصف
Spreadsheet	ملف	FormData	رفع ملف جدول البيانات.
worksheet	نص	استعلام	اسم ورقة العمل في جدول البيانات.
range	نص	استعلام	تحديد منطقة الخلايا (مثال: A1:C10).
outPath	نص	استعلام	مسار المجلد الذي سيُخزّن فيه ملف العمل (اختياري). القيمة الافتراضية هي null.
outStorageName	نص	استعلام	اسم مساحة التخزين الخارجة.
fontsLocation	نص	استعلام	تحديد خطوط مخصّصة إن لزم الأمر.
region	نص	استعلام	يحدّد إعدادات منطقة جدول البيانات.
password	نص	استعلام	كلمة المرور المطلوبة لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

مثال لمحتوى CSV المُعاد (الصفوف الأولى فقط):

Name,Date,Amount
John Doe,2023-01-15,1250.00
Jane Smith,2023-01-16,980.50

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	مُعطَلات ناقصة أو غير صالحة (مثال: نوع ملف غير مدعوم).
401	غير مصرّح (Unauthorized)	رمز JWT غير صالح أو ناقص.
413	حمل البيانات كبير جدًا (Payload Too Large)	تجاوز حجم الملف المرفوع الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقّع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل النطاق إلى CSV؟

1. سيناريوهات تصدير البيانات والترحيل

دمج قواعد البيانات: تصدير نطاقات محددة من إكسل مباشرة إلى أنظمة قواعد البيانات.
دمج التطبيقات: تغذية بيانات جدول البيانات المختارة إلى تطبيقات SaaS.
ترحيل الأنظمة: نقل نطاقات بيانات محددة بين الأنظمة القديمة والحديثة.
المشاركة عبر منصات مختلفة: مشاركة مجموعات بيانات مركّزة عبر منصات متعددة.

2. التقارير والتحليلات

التقارير الهدفية: تصدير أقسام تقرير محددة إلى CSV لتحليلها بدقة.
تغذية بيانات لوحات التحكم: تزويد أدوات لوحات التحكم بالبيانات المحددة.
مقاييس الأداء: استخراج نطاقات مؤشرات الأداء (KPI) لأنظمة متابعة الأداء.
التقارير المالية: تصدير أقسام البيانات المالية لمراجعتها خارجيًا.

3. التطوير والاختبار

إدارة بيانات الاختبار: تصدير نطاقات بيانات محددة لأغراض الاختبار.
بيئات التطوير: مشاركة نطاقات بيانات تجريبية مع فِرق التطوير.
اختبار واجهات برمجة التطبيقات: إنشاء بيانات اختبار CSV من أقسام جدول البيانات المحددة.
تطوير النماذج الأولية: توفير مجموعات بيانات مركّزة لتطبيقات النماذج الأولية.

4. العمليات التجارية

مشاركة بيانات انتقائية: مشاركة نطاقات بيانات محددة مع شركاء خارجيين.
نسخ احتياطي جزئي للبيانات: نسخ نطاقات بيانات حرجة احتياطيًا بصيغة CSV.
نقل البيانات بين الأقسام: مشاركة نطاقات بيانات محددة بين الأقسام المختلفة.
التقارير الامتثالية: تصدير نطاقات بيانات تنظيمية لأغراض الامتثال.

5. سير عمل الأتمتة

تصديرات النطاقات المجدولة: تصدير نطاقات محددة تلقائيًا وفق جدول زمني.
الاستخراج المُحفَّز: تصدير نطاقات استنادًا إلى أحداث أو محفزات تجارية.
دمج سير العمل: دمج تصديرات النطاقات في سير العمل لعمليات الأعمال.
معالجة النطاقات بالجملة: معالجة نطاقات محددة متعددة في عمليات جملية.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل النطاق إلى CSV؟

يمكنك تحويل نطاق من جدول البيانات دون رفع ملف العمل أولاً، مما يوفّر مساحة التخزين ويقلّل التكاليف.
يمكن إكمال التطوير بسرعة باستخدام SDKs الموجودة لـ Aspose.Cells Cloud.
دمج بسيط: واجهة برمجة تطبيقات REST مع توثيق واضح.
بنية قابلة للتوسّع: تتعامل مع عمليات صغيرة ومتوسطة وضخمة على حد سواء.

كيف تستخدم واجهة برمجة تطبيقات تحويل النطاق إلى CSV مع SDKs؟

مواصفات OpenAPI

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

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

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

توضّح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة. في حال حظر تحميل الأمثلة من Gist، يمكنك تنزيلها مباشرة من المستودع.

Documentation –

Developer-Guide: ConvertRangeToPdf

خدمة تحويل النطاق إلى PDF في Aspose.Cells Cloud Web Services

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

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

معاملات الطلب

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

الاستجابة

كيفية استخدام ConvertRangeToPdf مع مكتبات تطوير البرمجيات (SDKs)

مواصفات ConvertRangeToPdf

استخدام مكتبات تطوير Aspose.Cells Cloud (SDKs)

[TBD]

Developer-Guide: تحويل الجدول إلى CSV

تحويل الجدول إلى CSV باستخدام خدمات الويب الخاصة بـ Aspose.Cells Cloud

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

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

معاملات الطلب

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

الاستجابة

كيفية استخدام خدمة تحويل الجدول إلى CSV باستخدام حزم تطوير البرمجيات (SDKs)

مواصفات تحويل الجدول إلى CSV

استخدام حزم تطوير البرمجيات الخاصة بـ Aspose Cells Cloud

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

Developer-Guide: تحويل النطاق إلى CSV

تحويل النطاق إلى CSV باستخدام خدمات Aspose.Cells Cloud الويبية

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

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

بارامترات الطلب

بارامترات جسم الطلب

الاستجابة

كيفية استخدام تحويل النطاق إلى CSV باستخدام مكتبات التطوير (SDKs)

مواصفات تحويل النطاق إلى CSV

استخدام مكتبات Aspose Cells Cloud SDKs

تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose Cells Cloud باستخدام مكتبات مختلفة: [TBD]

Developer-Guide: ConvertWorksheetToPdf

دالة ConvertWorksheetToPdf في خدمات الويب Aspose.Cells Cloud

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

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

معاملات الطلب

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

الاستجابة

كيفية استخدام ConvertWorksheetToPdf مع مكتبات SDK

مواصفات ConvertWorksheetToPdf

استخدام مكتبات Aspose.Cells Cloud SDK

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells Cloud باستخدام مكتبات SDK المختلفة: [TBD]

Developer-Guide: Aspose.Cells Cloud – تحويل الجدول إلى HTML

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

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

معاملات الطلب

الاستجابة

متى تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى HTML؟

كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى HTML باستخدام مكتبات SDK؟

مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى HTML

استخدام مكتبات Aspose.Cells Cloud SDK

Developer-Guide: Aspose.Cells Cloud – تحويل نطاق Excel إلى HTML

واجهة برمجة تطبيقات تحويل النطاق إلى HTML

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

معلمات الطلب

الاستجابة

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

كيف تستخدم واجهة برمجة تطبيقات تحويل النطاق إلى HTML باستخدام مكتبات SDK؟

مواصفات OpenAPI

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

Developer-Guide: تحويل المخطط إلى PDF

خدمة تحويل المخطط إلى PDF من Aspose.Cells Cloud

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

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

مَعلمات الطلب

معلمة جسم الطلب

الاستجابة

كيفية استخدام خدمة تحويل المخطط إلى PDF باستخدام حزم تطوير البرمجيات (SDKs)

مواصفات تحويل المخطط إلى PDF

استخدام حزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud

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

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells Cloud - تحويل بيانات جدول Excel المحلية إلى ملف صورة - أداة مجانية عبر الإنترنت

واجهة برمجة تطبيقات تحويل الجدول إلى صورة

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

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

معاملات الطلب:

الاستجابة

`[TBD]`

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

تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose Cells Cloud باستخدام مكتبات مختلفة: `[TBD]`

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells Cloud باستخدام مكتبات SDK المختلفة: `[TBD]`

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