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