https://docs.aspose.cloud/cells/ar/developer-guide/ai/ Recent content on Documentation Hugo -- gohugo.io ar https://docs.aspose.cloud/cells/ar/decompose-user-task/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.cloud/cells/ar/decompose-user-task/ <p>تقدم نقطة النهاية <strong>DecomposeUserTask</strong> واجهة REST لتحويل وصف مهمّة صيغته حُرّة إلى خطة إجرائية تفصيلية متسلسلة تلتزم بمعايير SMART. وتقوم هذه الخدمة تلقائيًا بتخصيص تقديرات زمنية مبنية على الساعات، وتنسيق المخرجات للاستيراد بما يتوافق مع Redmine، وإنشاء عُقد مُحطّات رئيسية للمشروع. وببساطة، عند تزويدها بقائمة المهمّة الخام وتقديرات زمنية اختيارية، تُعيد واجهة برمجة التطبيقات ملفًا جاهزًا للاستخدام (CSV أو XLSX أو غيرها) يمكن استيراده مباشرة في أدوات إدارة المشاريع، ما يُسهّل تحليل المهمّة ويقلّل الجهد اليدوي.</p> <h2 id="واجهة-برمجة-تطبيقات-تحليل-المهمة-المستخدم"><strong>واجهة برمجة تطبيقات تحليل المهمة المستخدم</strong></h2> <h3 id="واجهة-برمجة-التطبيقات-عبر-الويب">واجهة برمجة التطبيقات عبر الويب</h3> <div class="highlight"><pre class="chroma"><code class="language-http" data-lang="http"><span class="err">PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose </span></code></pre></div><h3 id="الأمان-والمصادقة"><strong>الأمان والمصادقة</strong></h3> <p>تتميز واجهات برمجة تطبيقات Aspose.Cells Cloud بالأمان وتتطلب <a href="https://docs.aspose.cloud/total/getting-started/rest-api-overview/authenticating-api-requests/" rel="noopener noreferrer">مصادقة مبنية على رمز JWT</a>.</p> <h3 id="معاملات-الطلب"><strong>مُعاملات الطلب:</strong></h3> <table> <thead> <tr> <th style="text-align:left">اسم المُعامل</th> <th style="text-align:left">النوع</th> <th style="text-align:left">الموقع</th> <th style="text-align:left">إجباري/اختياري</th> <th style="text-align:left">الوصف</th> </tr> </thead> <tbody> <tr> <td style="text-align:left">TaskDescription</td> <td style="text-align:left">نصّ</td> <td style="text-align:left">جسم الطلب</td> <td style="text-align:left">إجباري</td> <td style="text-align:left">وصف نصّي بسيط لهدف المستخدم العام. تقوم الخدمة بتحليل هذا الوصف وتوليد مهام فردية. مثال: «إطلاق حملة تسويقية للربع الثالث، بما في ذلك إنشاء المحتوى، وإرسال رسائل إلكترونية جماعية، وإعلانات وسائل التواصل الاجتماعي.»</td> </tr> </tbody> </table> <h3 id="الاستجابة"><strong>الاستجابة</strong></h3> <p>استجابة ناجحة (200 OK)<br> Content‑Type: <code>application/octet-stream</code> (تدفق ملف ثنائي)</p> <p>الرؤوس:</p> <ul> <li><code>Content-Disposition: attachment; filename=&quot;DecomposedTaskPlan.xlsx&quot;</code></li> <li><code>Content-Length: &lt;الحجم بالبايت&gt;</code></li> </ul> <p>يُستخدم نفس الهيكل لتنسيقات XLSX/ODS، مع توزيع الأعمدة في ورقة العمل الأولى.</p> <p><strong>رموز حالة HTTP</strong></p> <table> <thead> <tr> <th>الرمز</th> <th>المعنى</th> <th>الوصف</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>OK (نجاح)</td> <td>تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.</td> </tr> <tr> <td>400</td> <td>Bad Request (طلب غير صالح)</td> <td>مُعاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).</td> </tr> <tr> <td>401</td> <td>Unauthorized (غير مُصرّح له)</td> <td>رمز JWT غير صالح أو مفقود.</td> </tr> <tr> <td>413</td> <td>Payload Too Large (حمولة كبيرة جدًا)</td> <td>تجاوز حجم الملف المرفوع الحد المسموح.</td> </tr> <tr> <td>500</td> <td>Internal Server Error (خطأ داخلي في الخادم)</td> <td>خطأ غير متوقع في الخادم.</td> </tr> </tbody> </table> <p><strong>مثال على استجابة خطأ (400 Bad Request)</strong></p> <div class="highlight"><pre class="chroma"><code class="language-json" data-lang="json"><span class="p">{</span> <span class="nt">&#34;code&#34;</span><span class="p">:</span> <span class="s2">&#34;InvalidParameter&#34;</span><span class="p">,</span> <span class="nt">&#34;message&#34;</span><span class="p">:</span> <span class="s2">&#34;حقل &#39;TaskDescription&#39; إجباري ولا يمكن أن يكون فارغًا.&#34;</span> <span class="p">}</span> </code></pre></div><p><strong>مثال على جسم الطلب (JSON)</strong></p> <div class="highlight"><pre class="chroma"><code class="language-json" data-lang="json"><span class="p">{</span> <span class="nt">&#34;TaskDescription&#34;</span><span class="p">:</span> <span class="s2">&#34;تطوير واجهة برمجة تطبيقات ويب لميزة تقسيم المهام في النظام القائم.&#34;</span> <span class="p">}</span> </code></pre></div><p><strong>مثال على الاستجابة</strong><br> تُعيد واجهة برمجة التطبيقات تدفقًا ثنائيًا يحتوي على الملف المُولّد. ولعرض أول بضعة صفوف من استجابة CSV، يمكنك فك تشفير التدفق وعرض صف الرأس، مثالًا:</p> <pre><code>ID,Subject,Trucker,Estimated Duration,Description 1 جمع المتطلبات لواجهة برمجة تطبيقات تقسيم المهام محلل الأعمال 8 جمع المتطلبات الوظيفية وغير الوظيفية وقصص المستخدم ومعايير القبول لواجهة تقسيم المهام الجديدة. 2 مواصفات واجهة برمجة التطبيقات (OpenAPI) محلل الأعمال 6 تحديد عقد OpenAPI لـ POST /tasks/split، بما في ذلك مخطط الطلب وأشكال الاستجابة وأكواد الأخطاء ومتطلبات الأمان. 3 تصميم الخوارزمية وهيكل البيانات لعملية التقسيم مهندس الحلول 5 تصميم الخوارزمية الأساسية التي تقسم المهمة الأصلية إلى مهام فرعية، وتوسيع نموذج البيانات (جداول قاعدة البيانات/الكيانات) لتخزين التسلسل الهرمي والبيانات الوصفية. 4 مراجعة دمج المعمارية مهندس الحلول 4 تحليل الأثر على الخدمات الحالية وتدفقات الأحداث وعمليات ترحيل قاعدة البيانات؛ إعداد خطة الدمج. ... </code></pre><h2 id="أين-يجب-استخدام-واجهة-برمجة-تطبيقات-تحليل-المهمة-المستخدم">أين يجب استخدام واجهة برمجة تطبيقات تحليل المهمة المستخدم؟</h2> <ul> <li><strong>بدء المشروع</strong>: تحويل ملخّص المشروع عالي المستوى إلى قائمة مهام متوافقة مع Redmine تتضمن تقديرات زمنية، مما يمكّن من التخطيط الفوري للسباقات (Sprints).</li> <li><strong>أتمتة التسويق</strong>: تقسيم أهداف الحملة إلى خطوات قابلة للتنفيذ، وتصديرها كملف CSV واستيراده في أدوات إدارة المهام لتنسيق العمل عبر الفِرَق.</li> <li><strong>تخصيص الموارد</strong>: إنشاء تقديرات زمنية مبنية على الساعات لكل مهمة فرعية، ما يسمح للمديرين بتوزيع الأعباء بين أعضاء الفريق قبل بدء المشروع.</li> <li><strong>تتبع المُحطّات الرئيسية</strong>: إنشاء عُقد المُحطّات الرئيسية تلقائيًا، مع إمكانية مزامنتها مع أدوات مخططات جانت، لضمان وضوح المخرجات لكل مرحلة.</li> </ul> <h2 id="لماذا-يجب-استخدام-واجهة-برمجة-تطبيقات-تحليل-المهمة-المستخدم">لماذا يجب استخدام واجهة برمجة تطبيقات تحليل المهمة المستخدم؟</h2> <ul> <li><strong>مخرجات متوافقة مع معايير SMART</strong>: تضمن كل مهمة مُولّدة الامتثال لمتطلبات التحديد، والقياس، والقابلية للتحقيق، والصلة، والربط الزمني.</li> <li><strong>تقدير زمني مدمج مبني على الساعات</strong>: يلغي الحاجة إلى الحسابات اليدوية ويحسّن دقة التنبؤات.</li> <li><strong>تنسيقات ملفات جاهزة للاستيراد (CSV، XLSX، إلخ)</strong>: تسهّل التكامل مع Redmine وJira وAzure DevOps ومنصات إدارة المشاريع الأخرى.</li> <li><strong>أتمتة بطلب واحد</strong>: تمكّن من تحليل المهمة عبر طلب واحد فقط، ما يُسرّع بدء المشروع ويقلّل الجهد اليدوي.</li> </ul> <h2 id="كيفية-استخدام-واجهة-برمجة-تطبيقات-تحليل-المهمة-المستخدم-مع-sdks">كيفية استخدام واجهة برمجة تطبيقات تحليل المهمة المستخدم مع SDKs</h2> <h3 id="مواصفات-واجهة-برمجة-تطبيقات-تحليل-المهمة-المستخدم">مواصفات واجهة برمجة تطبيقات تحليل المهمة المستخدم</h3> <p>توفر <a href="https://reference.aspose.cloud/cells/?urls.primaryName=API+v4#/AI/DecomposeUserTask" target="_blank" rel="noopener noreferrer">مواصفات واجهة برمجة تطبيقات تحليل المهمة المستخدم</a> واجهة برمجة برمجية متاحة علنًا لتنفيذ التفاعلات REST مباشرة من متصفح الويب.</p> <h2 id="واجهة-برمجة-تطبيقات-excel-sdk">واجهة برمجة تطبيقات Excel SDK</h2> <h3 id="استخدام-asposecells-cloud-sdks">استخدام Aspose.Cells Cloud SDKs</h3> <p>استخدام SDK هو أسرع طريقة للتطوير، إذ يُجرّد التفاصيل من المستوى المنخفض ويتيح لك استدعاء نقطة النهاية DecomposeUserTask برمز موجز.<br> يرجى الاطّلاع على <a href="https://github.com/aspose-cells-cloud" target="_blank" rel="noopener noreferrer">مستودع GitHub</a> للاطّلاع على قائمة كاملة بـ Aspose.Cells Cloud SDKs.<br> تُظهر الأمثلة التالية كيفية التفاعل مع خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK مختلفة:</p> <nav> <div class="book-tabs nav nav-tabs" id="nav-tab" role="tablist"> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-1" checked="checked" /> <label for="tabs-1-1">C#</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/8a5b324fdf3e574dbd747c1a1e24b05d.js?file=Example_v4.0_DecomposeUserTask.cs"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-2" /> <label for="tabs-1-2">Java</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/c59aa5c02f735466a5e34751cee73f5f.js?file=Example_v4.0_DecomposeUserTask.java"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-3" /> <label for="tabs-1-3">PHP</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/84283c8ba766ed815f47e6dfb0891152.js?file=Example_v4.0_DecomposeUserTask.php"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-4" /> <label for="tabs-1-4">Ruby</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/36ed8b8727561b92692939513d365fca.js?file=Example_v4.0_DecomposeUserTask.rb"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-5" /> <label for="tabs-1-5">Node.js</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/e82de2e4189bc27ae92abf73c36b4df0.js?file=Example_v4.0_DecomposeUserTask.ts"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-6" /> <label for="tabs-1-6">Python</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/61e922de11e6e7144db88adcad6501c1.js?file=Example_v4.0_DecomposeUserTask.py"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-7" /> <label for="tabs-1-7">Perl</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/f82a3a00251e34ff8766116282c8c9ca.js?file=Example_v4.0_DecomposeUserTask.pl"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-8" /> <label for="tabs-1-8">Go</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/2b824d4e13644368d12682856aa49185.js?file=Example_v4.0_DecomposeUserTask.go"></script> </div></div> </nav> https://docs.aspose.cloud/cells/ar/translate-spreadsheet/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.cloud/cells/ar/translate-spreadsheet/ <p>تقوم نقطة النهاية <strong>TranslateSpreadsheet</strong>، التي تُشكّل جزءًا من <strong>واجهة ترجمة جدول البيانات</strong>، بقراءة كل عنصر نصّي في ملف العمل، وإرسال المحتوى إلى خدمة ترجمة مدعومة بالذكاء الاصطناعي، ثم إرجاع ملف جدول بيانات جديد يحتوي على جميع البيانات النصية مُصاغة بلغة <strong>الهدف</strong> المحددة. وتحافظ العملية على التخطيط الأصلي وأنماط الخلايا والمعادلات وهيكل الأوراق المتعددة كما هي، مما يجعلها مثالية لجعل التقارير واللوحات التحليلية والمستندات القائمة على البيانات جاهزةً للعرض عالميًا. وتشمل تنسيقات الملفات المدعومة: XLS وXLSX وXLSM وCSV وODS. ويتم إرجاع أخطاء في حال كانت رموز اللغات غير صالحة أو فشلت عملية المصادقة أو حدثت انقطاعات في خدمة الترجمة.</p> <h2 id="واجهة-ترجمة-جدول-البيانات"><strong>واجهة ترجمة جدول البيانات</strong></h2> <h3 id="واجهة-الويب-web-api">واجهة الويب (Web API)</h3> <div class="highlight"><pre class="chroma"><code class="language-http" data-lang="http"><span class="err">PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet </span></code></pre></div><h3 id="معلمات-الطلب"><strong>معلمات الطلب:</strong></h3> <table> <thead> <tr> <th style="text-align:left">اسم المعلمة</th> <th style="text-align:left">النوع</th> <th style="text-align:left">الموقع</th> <th style="text-align:left">إلزامي/اختياري</th> <th style="text-align:left">الوصف</th> </tr> </thead> <tbody> <tr> <td style="text-align:left">Spreadsheet</td> <td style="text-align:left">ملف</td> <td style="text-align:left">مطلوب</td> <td style="text-align:left">FormData</td> <td style="text-align:left">ملف Excel المراد ترجمته. الامتدادات المقبولة: .xls و.xlsx و.xlsm و.csv و.ods. الحد الأقصى لحجم الملف: 50 ميجابايت. مثال: <code>budget.xlsx</code>.</td> </tr> <tr> <td style="text-align:left">targetLanguage</td> <td style="text-align:left">سلسلة نصية</td> <td style="text-align:left">مطلوب</td> <td style="text-align:left">Query</td> <td style="text-align:left">رمز اللغة وفق معيار ISO 639-1 للغة المطلوبة في الناتج (مثل &ldquo;es&rdquo; للإسبانية و&quot;fr&quot; للفرنسية و&quot;de&quot; للألمانية). يجب أن تكون اللغة مدعومة من خدمة الذكاء الاصطناعي الأساسية.</td> </tr> <tr> <td style="text-align:left">region</td> <td style="text-align:left">سلسلة نصية</td> <td style="text-align:left">اختياري</td> <td style="text-align:left">Query</td> <td style="text-align:left">معرّف منطقة جدول البيانات، الذي يؤثر في تنسيقات محددة حسب الإقليم مثل التواريخ والأرقام والعملات. القيم الشائعة: &ldquo;US&rdquo; و&quot;EU&quot; و&quot;CN&quot;. وإذا لم يُحدّد، سيُستخدم الإعداد الأصلي للمنطقة في ملف العمل.</td> </tr> <tr> <td style="text-align:left">password</td> <td style="text-align:left">سلسلة نصية</td> <td style="text-align:left">اختياري</td> <td style="text-align:left">Query</td> <td style="text-align:left">كلمة المرور لفتح ملف العمل المحمي. اتركه فارغًا إذا لم يكن الملف محميًا بكلمة مرور.</td> </tr> </tbody> </table> <h3 id="الاستجابة"><strong>الاستجابة</strong></h3> <p>استجابة ناجحة (200 OK)<br> الرؤوس (Headers):<br> Content-Type: application/octet-stream // أو text/csv عند طلب إخراج بصيغة CSV<br> Content-Disposition: attachment; filename=&ldquo;translated.xlsx&rdquo;<br> Content-Length: &lt;الحجم بالبايت&gt;</p> <p>الجسم (Body):<br> &lt;دفق ثنائي يحتوي ملف جدول البيانات المُترجَم&gt;</p> <p>استجابات الأخطاء تتبع نموذج أخطاء Aspose.Cells Cloud القياسي (application/json) مع الحقول <code>code</code> و<code>message</code> و<code>details</code> (اختياريًا).</p> <p><strong>رموز حالة HTTP</strong></p> <table> <thead> <tr> <th>الرمز</th> <th>المعنى</th> <th>الوصف</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>OK</td> <td>تم تطبيق الترجمة بنجاح؛ وتحتوي الاستجابة على تفاصيل العملية.</td> </tr> <tr> <td>400</td> <td>Bad Request</td> <td>معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).</td> </tr> <tr> <td>401</td> <td>Unauthorized</td> <td>رمز JWT غير صالح أو مفقود.</td> </tr> <tr> <td>413</td> <td>Payload Too Large</td> <td>حجم الملف المرفوع يتجاوز الحد المسموح.</td> </tr> <tr> <td>500</td> <td>Internal Server Error</td> <td>خطأ في الخادم غير متوقع.</td> </tr> </tbody> </table> <h2 id="أين-يجب-استخدام-واجهة-ترجمة-جدول-البيانات">أين يجب استخدام واجهة ترجمة جدول البيانات؟</h2> <ul> <li><strong>التقارير المالية الدولية</strong> – تحويل تقارير Excel الفصلية إلى لغات متعددة للمكاتب الإقليمية مع الحفاظ على المعادلات وتنسيق الرسوم البيانية.</li> <li><strong>اللوحات التحليلية التسويقية متعددة اللغات</strong> – إنشاء نسخ مُترجَمة تلقائيًا للوحات أداء المبيعات للفِرَق العاملة عالميًا.</li> <li><strong>توزيع المحتوى التعليمي</strong> – ترجمة كُتُب الدرجات وأوراق الواجبات وجداول المناهج الدراسية للطلاب في دول مختلفة دون الحاجة إلى نسخ ولصق يدوي.</li> <li><strong>الامتثال للوائح التنظيمية</strong> – إنتاج جداول بيانات مخصّصة للامتثال حسب اللغة، مع الاحتفاظ بقواعد التحقق وقوائم التحقق من البيانات.</li> </ul> <h2 id="لماذا-يجب-استخدام-واجهة-ترجمة-جدول-البيانات">لماذا يجب استخدام واجهة ترجمة جدول البيانات؟</h2> <ul> <li><strong>دقة مدعومة بالذكاء الاصطناعي</strong> – يستخدم نماذج ترجمة عصبية حديثة لتحويل لغوي سياقي عالي الجودة.</li> <li><strong>عدم وجود تشويه في التنسيق</strong> – يحافظ على معادلات الخلايا والتنسيق الشرطي والرسوم البيانية وترتيب الأوراق كما هي في الملف الأصلي.</li> <li><strong>معالجة متعددة الأوراق في استدعاء واحد</strong> – تترجم كل أوراق العمل في طلب واحد، ما يلغي الحاجة إلى حلقات تكرار لكل ورقة.</li> <li><strong>تكامل سلس مع السحابة</strong> – يعمل مع مصادقة Aspose.Cells Cloud، مما يمكّن من تنفيذ سير عمل تلقائي في أنظمة CI/CD أو الوظائف بدون خادم (serverless) أو الأنظمة الخلفية المؤسسية.</li> </ul> <h2 id="كيفية-استخدام-واجهة-ترجمة-جدول-البيانات-باستخدام-sdks">كيفية استخدام واجهة ترجمة جدول البيانات باستخدام SDKs</h2> <h3 id="مواصفات-واجهة-ترجمة-جدول-البيانات">مواصفات واجهة ترجمة جدول البيانات</h3> <p>توفر <a href="https://reference.aspose.cloud/cells/?urls.primaryName=API+v4#/AI/TranslateSpreadsheet">مواصفات واجهة ترجمة جدول البيانات</a> واجهة برمجة تفاعلية مفتوحة للوصول مباشرةً عبر المتصفح.</p> <h2 id="واجهة-excel-api-sdk">واجهة Excel API SDK</h2> <h3 id="استخدام-sdks-الخاصة-بـ-asposecells-cloud">استخدام SDKs الخاصة بـ Aspose.Cells Cloud</h3> <p>استخدام SDK هو أسرع طريقة للتطوير، إذ تُجرّدك من تفاصيل المستوى المنخفض، وتتيح لك دمج جدول بيانات في آخر عبر كود موجز.<br> يرجى الاطّلاع على <a href="https://github.com/aspose-cells-cloud">مستودع GitHub</a> للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.<br> تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات Aspose.Cells عبر مكتبات SDK مختلفة:</p> <nav> <div class="book-tabs nav nav-tabs" id="nav-tab" role="tablist"> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-1" checked="checked" /> <label for="tabs-1-1">C#</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/8a5b324fdf3e574dbd747c1a1e24b05d.js?file=Example_v4.0_TranslateSpreadsheet.cs"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-2" /> <label for="tabs-1-2">Java</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/c59aa5c02f735466a5e34751cee73f5f.js?file=Example_v4.0_TranslateSpreadsheet.java"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-3" /> <label for="tabs-1-3">PHP</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/84283c8ba766ed815f47e6dfb0891152.js?file=Example_v4.0_TranslateSpreadsheet.php"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-4" /> <label for="tabs-1-4">Ruby</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/36ed8b8727561b92692939513d365fca.js?file=Example_v4.0_TranslateSpreadsheet.rb"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-5" /> <label for="tabs-1-5">Node.js</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/e82de2e4189bc27ae92abf73c36b4df0.js?file=Example_v4.0_TranslateSpreadsheet.ts"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-6" /> <label for="tabs-1-6">Python</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/61e922de11e6e7144db88adcad6501c1.js?file=Example_v4.0_TranslateSpreadsheet.py"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-7" /> <label for="tabs-1-7">Perl</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/f82a3a00251e34ff8766116282c8c9ca.js?file=Example_v4.0_TranslateSpreadsheet.pl"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-8" /> <label for="tabs-1-8">Go</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/2b824d4e13644368d12682856aa49185.js?file=Example_v4.0_TranslateSpreadsheet.go"></script> </div></div> </nav> https://docs.aspose.cloud/cells/ar/translate-text-file/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.cloud/cells/ar/translate-text-file/ <p>تستخدم نقطة النهاية <strong>TranslateTextFile</strong> خدمات الذكاء الاصطناعي الخاصة بـ Aspose.Cells Cloud لترجمة محتوى ملف نصي إلى لغة مستهدفة محددة. وتدعم هذه النقطة وضعَي التشغيل: (1) <strong>وضع رفع الملف</strong> – إرسال ملف نصي عبر multipart/form-data والحصول على ملف مُترجَم؛ (2) <strong>وضع المحتوى المباشر</strong> – نشر نص خام في جسم الطلب والحصول على النص المُترجَم مباشرةً. تحافظ الخدمة على فواصل الأسطر الأصلية والتنسيق، وتُلحِق تلقائيًا لاحقة &ldquo;_translated&rdquo; باسم الملف، وتعيد النتيجة كدفق قابل للتنزيل. مثالية لترجمة المستندات دفعة واحدة، أو دمجها في سير عمل متعدد اللغات، أو ترجمة المحتوى الذي يُنشئه المستخدمون في الوقت الفعلي.</p> <h2 id="واجهة-ترجمة-ملف-نصي"><strong>واجهة ترجمة ملف نصي</strong></h2> <h3 id="واجهة-الويب-api">واجهة الويب API</h3> <div class="highlight"><pre class="chroma"><code class="language-http" data-lang="http"><span class="err">PUT https://api.aspose.cloud/v4.0/cells/ai/translate/text-file </span></code></pre></div><h3 id="معلمات-الطلب"><strong>معلمات الطلب:</strong></h3> <table> <thead> <tr> <th style="text-align:left">اسم المعلمة</th> <th style="text-align:left">النوع</th> <th style="text-align:left">الموقع</th> <th style="text-align:left">إلزامي/اختياري</th> <th style="text-align:left">الوصف</th> </tr> </thead> <tbody> <tr> <td style="text-align:left">Spreadsheet</td> <td style="text-align:left">ملف</td> <td style="text-align:left">مطلوبة</td> <td style="text-align:left">FormData</td> <td style="text-align:left">الملف النصي المصدر المراد ترجمته. يجب أن يكون ملف نصي عادي (.txt) أو تنسيق جدول بيانات مدعوم. مثال: رفع <code>document.txt</code> عبر حقل multipart/form-data يُسمّى &ldquo;file&rdquo;.</td> </tr> <tr> <td style="text-align:left">targetLanguage</td> <td style="text-align:left">سلسلة نصية</td> <td style="text-align:left">مطلوبة</td> <td style="text-align:left">Query</td> <td style="text-align:left">رمز اللغة المستهدفة وفق معيار ISO-639-1 (مثل &ldquo;es&rdquo; للإسبانية، &ldquo;fr&rdquo; للفرنسية، &ldquo;de&rdquo; للألمانية). الرمز غير حساس لحالة الأحرف.</td> </tr> <tr> <td style="text-align:left">region</td> <td style="text-align:left">string</td> <td style="text-align:left">اختيارية</td> <td style="text-align:left">Query</td> <td style="text-align:left">معرّف منطقة جدول البيانات، الذي يؤثر في التنسيق المُعتمد على التهيئة الإقليمية مثل التواريخ والأرقام والعملات. القيم الشائعة: &ldquo;US&rdquo; و&quot;EU&quot; و&quot;CN&quot;. وفي حال عدم تحديده، تُستخدم إعدادات المنطقة الأصلية لورقة العمل.</td> </tr> <tr> <td style="text-align:left">password</td> <td style="text-align:left">سلسلة نصية</td> <td style="text-align:left">اختيارية</td> <td style="text-align:left">Query</td> <td style="text-align:left">كلمة المرور المطلوبة لفتح ملفات جداول البيانات المشفرة. غير مطلوبة للملفات النصية العادية.</td> </tr> </tbody> </table> <h3 id="الاستجابة"><strong>الاستجابة</strong></h3> <p>استجابة ناجحة (200 OK) الرؤوس: Content-Type: application/octet-stream // دفق ثنائي يحتوي على الملف المُترجَم Content-Disposition: attachment; filename=&quot;&lt;original_name&gt;_translated.txt&quot; Content-Length: &lt;الحجم بالبايت&gt;</p> <p>الجسم: دفق ثنائي يحتوي على النص المُترجَم مع الحفاظ على فواصل الأسطر الأصلية والتنسيق.</p> <p><strong>رموز حالة HTTP</strong></p> <table> <thead> <tr> <th>الرمز</th> <th>المعنى</th> <th>الوصف</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>OK (نجاح)</td> <td>تطبيق المرشح بنجاح؛ الاستجابة تحتوي على تفاصيل العملية.</td> </tr> <tr> <td>400</td> <td>Bad Request (طلب غير صالح)</td> <td>معلمات ناقصة أو غير صحيحة (مثل نوع ملف غير مدعوم).</td> </tr> <tr> <td>401</td> <td>Unauthorized (غير مصرّح)</td> <td>رمز JWT غير صحيح أو ناقص.</td> </tr> <tr> <td>413</td> <td>Payload Too Large (حمولة كبيرة جدًا)</td> <td>تجاوز حجم الملف المرفوع الحد المسموح به.</td> </tr> <tr> <td>500</td> <td>Internal Server Error (خطأ داخلي في الخادم)</td> <td>خطأ غير متوقع في الخادم.</td> </tr> </tbody> </table> <h2 id="أين-يجب-استخدام-واجهة-ترجمة-ملف-نصي">أين يجب استخدام واجهة ترجمة ملف نصي؟</h2> <ul> <li><strong>بوابات الوثائق متعددة اللغات</strong> – ترجمة أدلة المستخدم أو ملفات المساعدة تلقائيًا عند رفعها كمستندات نصية، وتقديم إصدارات مُترجَمة حسب الطلب.</li> <li><strong>أنظمة إدارة المحتوى (CMS)</strong> – دمجها في سير عمل CMS لترجمة منشورات المدونات أو المقالات قبل نشرها للجمهور الدولي.</li> <li><strong>خطوط أنابيب البيانات المؤسسية</strong> – استخدامها في مهام الدفعات التي تعالج كميات كبيرة من تقارير CSV أو TXT، وتحويلها إلى لغة المكاتب الإقليمية مع الحفاظ على التنسيق الأصلي.</li> <li><strong>منصات دعم العملاء</strong> – ترجمة التذاكر أو سجلات الدردشة النصية الواردة في الوقت الفعلي لمساعدة وكلاء الدعم العاملين بلغات مختلفة.</li> </ul> <h2 id="لماذا-يجب-استخدام-واجهة-ترجمة-ملف-نصي">لماذا يجب استخدام واجهة ترجمة ملف نصي؟</h2> <ul> <li><strong>دقة مدفوعة بالذكاء الاصطناعي</strong> – تستخدم نماذج ترجمة عصبية حديثة لتوليد مخرجات طبيعية وذات سياق دقيق.</li> <li><strong>مرونة في المدخلات المزدوجة</strong> – تقبل كل من رفع الملفات ونُشر المحتوى النصي الخام، مما يبسّط التكامل مع تطبيقات العميل المتنوعة.</li> <li><strong>الحفاظ على التصميم الأصلي</strong> – تحافظ على فواصل الأسطر والمسافات البادئة والأحرف الخاصة، ما يلغي الحاجة إلى تنظيف يدوي بعد الترجمة.</li> <li><strong>معالجة سلسة للملفات</strong> – تعيد ملفًا جاهزًا للتنزيل مع لاحقة &ldquo;_translated&rdquo; تُولّد تلقائيًا، مما يقلل من تعقيد كود جانب العميل.</li> </ul> <h2 id="كيفية-استخدام-واجهة-ترجمة-ملف-نصي-باستخدام-sdks">كيفية استخدام واجهة ترجمة ملف نصي باستخدام SDKs</h2> <h3 id="مواصفات-واجهة-ترجمة-ملف-نصي">مواصفات واجهة ترجمة ملف نصي</h3> <p>توفر <a href="https://reference.aspose.cloud/cells/#/AIController/TranslateTextFile">مواصفات واجهة ترجمة ملف نصي</a> واجهة برمجة تفاعلية مفتوحة للوصول مباشرةً عبر متصفح الويب.</p> <h2 id="واجهة-excel-api-sdk">واجهة Excel API SDK</h2> <h3 id="استخدام-sdks-الخاصة-بـ-asposecells-cloud">استخدام SDKs الخاصة بـ Aspose.Cells Cloud</h3> <p>استخدام SDK هو أسرع طريقة للتطوير، حيث يُجفل التفاصيل منخفضة المستوى ويسمح لك بدمج جدول بيانات داخل جدول بيانات آخر باستخدام كود قصير. يرجى الاطلاع على <a href="https://github.com/aspose-cells-cloud">مستودع GitHub</a> للاطلاع على القائمة الكاملة لـ SDKs الخاصة بـ Aspose.Cells Cloud. توضح الأمثلة التالية كيفية التفاعل مع خدمات Aspose.Cells الويبية باستخدام SDKs مختلفة:</p> <nav> <div class="book-tabs nav nav-tabs" id="nav-tab" role="tablist"> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-1" checked="checked" /> <label for="tabs-1-1">C#</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/8a5b324fdf3e574dbd747c1a1e24b05d.js?file=Example_v4.0_TranslateTextFile.cs"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-2" /> <label for="tabs-1-2">Java</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/c59aa5c02f735466a5e34751cee73f5f.js?file=Example_v4.0_TranslateTextFile.java"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-3" /> <label for="tabs-1-3">PHP</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/84283c8ba766ed815f47e6dfb0891152.js?file=Example_v4.0_TranslateTextFile.php"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-4" /> <label for="tabs-1-4">Ruby</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/36ed8b8727561b92692939513d365fca.js?file=Example_v4.0_TranslateTextFile.rb"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-5" /> <label for="tabs-1-5">Node.js</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/e82de2e4189bc27ae92abf73c36b4df0.js?file=Example_v4.0_TranslateTextFile.ts"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-6" /> <label for="tabs-1-6">Python</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/61e922de11e6e7144db88adcad6501c1.js?file=Example_v4.0_TranslateTextFile.py"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-7" /> <label for="tabs-1-7">Perl</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/f82a3a00251e34ff8766116282c8c9ca.js?file=Example_v4.0_TranslateTextFile.pl"></script> </div> <input type="radio" class="toggle" name="tabs-1" id="tabs-1-8" /> <label for="tabs-1-8">Go</label> <div class="book-tabs-content markdown-inner"><script type="application/javascript" src="https://gist.github.com/aspose-cells-cloud-gists/2b824d4e13644368d12682856aa49185.js?file=Example_v4.0_TranslateTextFile.go"></script> </div></div> </nav>