Files
SnapOtter/apps/docs/ar/tools/files/convert-spreadsheet.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.8 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
التحويل بين تنسيقات Excel وOpenDocument وCSV. b813b1b06962 human be8ee7d025b4

تحويل جدول البيانات

حوِّل جداول البيانات بين تنسيقات Excel (XLSX) وOpenDocument Spreadsheet (ODS) وCSV. تصدّر المصنّفات متعددة الأوراق الورقة الأولى عند التحويل إلى CSV.

نقطة نهاية API

POST /api/v1/tools/files/convert-spreadsheet

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف Excel/ODS/CSV وحقل JSON بصيغة settings.

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
format string نعم - تنسيق الخرج: xlsx، ods، csv

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/files/convert-spreadsheet \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@data.xlsx" \
  -F 'settings={"format": "csv"}'

مثال على الاستجابة

يُرجع 202 Accepted. تابع التقدم عبر SSE على /api/v1/jobs/{jobId}/progress.

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

ملاحظات

  • تنسيقات الدخل المقبولة: .xlsx، .xls، .ods، .csv.
  • عند تحويل مصنّف متعدد الأوراق إلى CSV، تُصدَّر الورقة الأولى فقط.
  • تُقيَّم الصيغ وتُصدَّر كقيم ثابتة في خرج CSV.
  • يجب أن يختلف تنسيق الخرج عن تنسيق الدخل.