كيفية إعادة تسمية أوراق العمل في إكسل – تغيير أسماء الأوراق
إعادة تسمية أوراق العمل في ملفات عمل إكسل برمجيًّا باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud. غيّر أسماء الأوراق، وحدّث تسميات علامات التبويب ديناميكيًّا، وأتمتة تنظيم جداول البيانات عبر استدعاءات واجهة برمجة تطبيقات REST. مفيد في توحيد الوثائق وأتمتة سير العمل.
إعادة تسمية اسم ورقة العمل في واجهة برمجة تطبيقات جدول البيانات
واجهة برمجة تطبيقات الويب
PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName={sourceName}&targetName={targetName}&outPath={outPath}&outStorageName={outStorageName}®ion={region}&password={password}
مثال باستخدام cURL
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Report_Q1" \
-H "Authorization: Bearer {access_token}" \
-F "spreadsheet=@myWorkbook.xlsx"
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud أمانًا وتستلزم مصادقة تعتمد على رمز JWT.
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | إلزامي. ملف ملف عمل إكسل (.xlsx، .xls، إلخ) الذي يحتوي على ورقة العمل المراد إعادة تسميتها. |
| sourceName | نص | استعلام | إلزامي. الاسم الحالي لورقة العمل التي ترغب في إعادة تسميتها. |
| targetName | نص | استعلام | إلزامي. الاسم الجديد المراد تعيينه لورقة العمل. يجب أن يتوافق مع قواعد تسمية إكسل (بدون : أو \ أو ? أو * أو [ أو ]) وأن يكون فريدًا داخل ملف العمل. |
| outPath | نص | استعلام | اختياري. مسار المجلد الوجهة في التخزين السحابي حيث سيتم حفظ ملف العمل بعد إعادة التسمية. إذا كانت القيمة null أو حُذفت، تحفظ الخدمة الملف في نفس المجلد الذي يحتوي على ملف العمل الأصلي (أو مسار افتراضي). |
| outStorageName | نص | استعلام | اختياري. المُعرّف الاسمي لخدمة التخزين السحابي المُعدّة مسبقًا (مثل ArchiveStorage). إذا حُذف، يُستخدم التخزين الافتراضي. |
| region | نص | استعلام | اختياري. إعداد_locale (مثل ko-KR) الذي قد يؤثر على ترميز الأحرف أو المعايير التسمية الإقليمية. |
| password | نص | استعلام | اختياري. كلمة المرور اللازمة لفك تشفير ملف عمل محمي بكلمة مرور وتعديله. احذفها إذا لم يكن الملف مشفرًا. |
ملاحظات: تقتصر أسماء أوراق العمل على 31 حرفًا ولا يمكن أن تحتوي على الأحرف التالية: : أو \ أو ? أو * أو [ أو ].
الاستجابة
يُعيد الطلب الناجح كائن JSON يحتوي على معلومات الحالة ورابط للملف المُعاد تسميته.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات إعادة تسمية ورقة العمل في جدول البيانات؟
- توليد التقارير وتوحيد العلامة التجارية – عند توليد تقارير العملاء تلقائيًّا، تُعاد تسمية أسماء أوراق العمل العامة (مثل
Sheet1) بأسماء مخصصة للعميل (مثلAcmeCorp_Q1_Summary) لضمان تسليم احترافي. - توحيد خطوط أنابيب معالجة البيانات – في سير عمل ETL، تُعاد تسمية أوراق العمل المصدرة بأسماء غير منتظمة لتتوافق مع أسماء موحدة مثل
Raw_DataأوCleaned_Dataلتلبية متطلبات التحليل اللاحق. - توصيل المحتوى بلغات متعددة – بناءً على تفضيل لغة المستخدم، تُترجم أسماء أوراق العمل (مثل
数据أوData) قبل تسليم الملف، لتقديم تجربة مخصصة.
لماذا يجب استخدام واجهة برمجة تطبيقات إعادة تسمية ورقة العمل في جدول البيانات؟
- سهل الاستخدام للمطورين – توفر SDKs بعدة لغات مع توثيق شامل، مما يبسّط التكامل مقارنة ببناء حل مخصص.
- تقليل الجهد اليدوي – تُ automátِز إعادة تسمية أوراق العمل، مما يقلل من الجهد اليدوي المطلوب.
- نموذج الدفع حسب الاستخدام – تحصل فقط على الرسوم مقابل استدعاءات واجهة برمجة التطبيقات، مما يلغي تكاليف الترخيص المسبق.
- لا صيانة للخوادم – وبكونها خدمة سحابية، تلغي الحاجة إلى استضافة وصيانة الخوادم أو تطبيق تحديثات البرمجيات.
- دعم الأتمتة – تسهّل توحيد الوثائق تلقائيًّا ضمن سير العمل.
كيفية استخدام واجهة برمجة تطبيقات إعادة تسمية ورقة العمل في جدول البيانات مع SDKs
مواصفات OpenAPI
مواصفات OpenAPI تُفصّل واجهة برمجة تطبيقات متاحة عمومًا، مما يسمح بالتفاعل عبر REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء استدعاءات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة لتسريع التطوير. يُجرّدك SDK من تفاصيل HTTP الكامنة، ويسمح بإعادة تسمية أوراق العمل برمز موجز. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: