كيفية تحويل ورقة عمل جدول بيانات محلي إلى ملف PDF: دليل خطوة بخطوة
تصدير ورقة عمل من ملف 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.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، إذ تُجرّدك من التفاصيل منخفضة المستوى، مما يسمح لك بتحويل بيانات جداول البيانات إلى ملف PDF باستخدام كود محدود. يُرجى زيارة مستودع GitHub للاطلاع على القائمة الكاملة لمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضح الأمثلة التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: