كيفية ترجمة جدول بيانات بالكامل باستخدام واجهة ترجمة الذكاء الاصطناعي Aspose.Cells Cloud
تقوم نقطة النهاية TranslateSpreadsheet، التي تُشكّل جزءًا من واجهة ترجمة جدول البيانات، بقراءة كل عنصر نصّي في ملف العمل، وإرسال المحتوى إلى خدمة ترجمة مدعومة بالذكاء الاصطناعي، ثم إرجاع ملف جدول بيانات جديد يحتوي على جميع البيانات النصية مُصاغة بلغة الهدف المحددة. وتحافظ العملية على التخطيط الأصلي وأنماط الخلايا والمعادلات وهيكل الأوراق المتعددة كما هي، مما يجعلها مثالية لجعل التقارير واللوحات التحليلية والمستندات القائمة على البيانات جاهزةً للعرض عالميًا. وتشمل تنسيقات الملفات المدعومة: XLS وXLSX وXLSM وCSV وODS. ويتم إرجاع أخطاء في حال كانت رموز اللغات غير صالحة أو فشلت عملية المصادقة أو حدثت انقطاعات في خدمة الترجمة.
واجهة ترجمة جدول البيانات
واجهة الويب (Web API)
PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet
معلمات الطلب:
| اسم المعلمة | النوع | الموقع | إلزامي/اختياري | الوصف |
|---|---|---|---|---|
| Spreadsheet | ملف | مطلوب | FormData | ملف Excel المراد ترجمته. الامتدادات المقبولة: .xls و.xlsx و.xlsm و.csv و.ods. الحد الأقصى لحجم الملف: 50 ميجابايت. مثال: budget.xlsx. |
| targetLanguage | سلسلة نصية | مطلوب | Query | رمز اللغة وفق معيار ISO 639-1 للغة المطلوبة في الناتج (مثل “es” للإسبانية و"fr" للفرنسية و"de" للألمانية). يجب أن تكون اللغة مدعومة من خدمة الذكاء الاصطناعي الأساسية. |
| region | سلسلة نصية | اختياري | Query | معرّف منطقة جدول البيانات، الذي يؤثر في تنسيقات محددة حسب الإقليم مثل التواريخ والأرقام والعملات. القيم الشائعة: “US” و"EU" و"CN". وإذا لم يُحدّد، سيُستخدم الإعداد الأصلي للمنطقة في ملف العمل. |
| password | سلسلة نصية | اختياري | Query | كلمة المرور لفتح ملف العمل المحمي. اتركه فارغًا إذا لم يكن الملف محميًا بكلمة مرور. |
الاستجابة
استجابة ناجحة (200 OK)
الرؤوس (Headers):
Content-Type: application/octet-stream // أو text/csv عند طلب إخراج بصيغة CSV
Content-Disposition: attachment; filename=“translated.xlsx”
Content-Length: <الحجم بالبايت>
الجسم (Body):
<دفق ثنائي يحتوي ملف جدول البيانات المُترجَم>
استجابات الأخطاء تتبع نموذج أخطاء Aspose.Cells Cloud القياسي (application/json) مع الحقول code وmessage وdetails (اختياريًا).
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK | تم تطبيق الترجمة بنجاح؛ وتحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request | معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | Internal Server Error | خطأ في الخادم غير متوقع. |
أين يجب استخدام واجهة ترجمة جدول البيانات؟
- التقارير المالية الدولية – تحويل تقارير Excel الفصلية إلى لغات متعددة للمكاتب الإقليمية مع الحفاظ على المعادلات وتنسيق الرسوم البيانية.
- اللوحات التحليلية التسويقية متعددة اللغات – إنشاء نسخ مُترجَمة تلقائيًا للوحات أداء المبيعات للفِرَق العاملة عالميًا.
- توزيع المحتوى التعليمي – ترجمة كُتُب الدرجات وأوراق الواجبات وجداول المناهج الدراسية للطلاب في دول مختلفة دون الحاجة إلى نسخ ولصق يدوي.
- الامتثال للوائح التنظيمية – إنتاج جداول بيانات مخصّصة للامتثال حسب اللغة، مع الاحتفاظ بقواعد التحقق وقوائم التحقق من البيانات.
لماذا يجب استخدام واجهة ترجمة جدول البيانات؟
- دقة مدعومة بالذكاء الاصطناعي – يستخدم نماذج ترجمة عصبية حديثة لتحويل لغوي سياقي عالي الجودة.
- عدم وجود تشويه في التنسيق – يحافظ على معادلات الخلايا والتنسيق الشرطي والرسوم البيانية وترتيب الأوراق كما هي في الملف الأصلي.
- معالجة متعددة الأوراق في استدعاء واحد – تترجم كل أوراق العمل في طلب واحد، ما يلغي الحاجة إلى حلقات تكرار لكل ورقة.
- تكامل سلس مع السحابة – يعمل مع مصادقة Aspose.Cells Cloud، مما يمكّن من تنفيذ سير عمل تلقائي في أنظمة CI/CD أو الوظائف بدون خادم (serverless) أو الأنظمة الخلفية المؤسسية.
كيفية استخدام واجهة ترجمة جدول البيانات باستخدام SDKs
مواصفات واجهة ترجمة جدول البيانات
توفر مواصفات واجهة ترجمة جدول البيانات واجهة برمجة تفاعلية مفتوحة للوصول مباشرةً عبر المتصفح.
واجهة Excel API SDK
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، إذ تُجرّدك من تفاصيل المستوى المنخفض، وتتيح لك دمج جدول بيانات في آخر عبر كود موجز.
يرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات Aspose.Cells عبر مكتبات SDK مختلفة: