كيف أحول عناوين أعمدة ملف المنتجات مثل Product Name إلى صيغة product_name لاستخدامها في كود أو API؟
انسخ صف العناوين، والصقه في محوّل حالة الأحرف عنوانًا في كل سطر، واختر snake_case: كل سطر يصبح كلمات صغيرة تصلها شرطة سفلية، وتُحذف الرموز مثل الأقواس. Product Name يصبح product_name، وPrice (SAR) يصبح price_sar. وإن كانت مفاتيح JSON عندك بصيغة productName فاختر camelCase.
مثال من ملف منتجات
ثلاثة عناوين أعمدة كما تأتي من ملف تصدير عادي: Product Name، وPrice (SAR)، وStock Qty. هذه نتائج الأداة لكل صيغة من صيغ المبرمجين:
- snake_case: product_name، price_sar، stock_qty.
- camelCase: productName، priceSar، stockQty.
- kebab-case: product-name، price-sar، stock-qty.
لاحظ ما حدث للقوسين في Price (SAR): حُذفا تمامًا وبقيت الكلمتان. الأداة تقسم السطر إلى كلمات عند المسافات وعلامات الترقيم، ثم تصلها بالفاصل الذي اخترته.
أي صيغة أختار؟
لا توجد صيغة صحيحة واحدة، والمعيار هو ما يتوقعه الطرف الآخر. أعمدة قواعد البيانات ولغة بايثون تستخدم snake_case غالبًا. مفاتيح JSON في تطبيقات جافاسكربت تستخدم camelCase كثيرًا. وkebab-case أنسب لأسماء الملفات وأجزاء الروابط منها للمفاتيح، لأن الشرطة لا تصلح في أسماء المتغيرات في أغلب اللغات. إن كانت لديك وثيقة API من المنصة التي تتكامل معها، فانسخ صيغتها كما هي.
عناوين تحتاج مراجعة
جربت أربعة عناوين أصعب: Customer's Email، وVAT %، وSKU / Barcode، وعنوانًا عربيًا هو «اسم المنتج». خرجت بصيغة snake_case هكذا:
- customers_email: حُذفت الفاصلة العليا فالتصقت s بالكلمة.
- vat: علامة % حُذفت كما تُحذف كل الرموز، فضاع معنى أن العمود نسبة. سمّه vat_rate أو vat_percent بنفسك.
- sku_barcode: الشرطة المائلة حُذفت وبقيت الكلمتان.
- اسم_المنتج: الحروف العربية تبقى كلمات لكنها بلا حالة، فتُلصق بالشرطة السفلية كما هي. أغلب الأنظمة البرمجية تتوقع مفاتيح لاتينية، فاكتب عنوانًا إنجليزيًا بدلًا منه.
والأداة تعرف حدود الكلمات داخل الكلمة المركبة أيضًا: productName تصبح product_name، وHTTPServer تصبح http_server. هذا مفيد حين تحول مفاتيح camelCase موجودة إلى snake_case.
الخطوات
- انسخ صف العناوين من جدولك. إن نسخته أفقيًا فحوّل الفواصل إلى أسطر، أو انسخ العناوين من عمود بعد تبديل الصفوف والأعمدة، ليكون كل عنوان في سطر.
- الصقها في تحويل حالة الأحرف واختر snake_case أو camelCase من «الحالة المطلوبة».
- راجع العناوين التي فيها رموز أو حروف عربية وعدّلها يدويًا.
- انسخ النتيجة واستخدمها في الكود أو في صف العناوين الجديد.
الخطوة التالية: من جدول إلى JSON
إن كان هدفك تحويل ملف المنتجات كله إلى JSON لإرساله إلى API، فغيّر صف العناوين أولًا بالصيغة الجديدة، ثم حوّل الملف في محوّل CSV و JSON. عناوين الأعمدة تصبح مفاتيح الكائنات كما هي، فالأفضل أن تكون بالصيغة التي يتوقعها النظام الآخر قبل التحويل.
أسئلة شائعة
هل تعمل صيغ المبرمجين على كل سطر وحده؟
نعم. كل سطر يُحوَّل وحده، والسطر الفارغ يبقى فارغًا، فيبقى عدد الأسطر وترتيبها كما هو.
لماذا لا تظهر «حروف تغيّرت» مع هذه الصيغ؟
لأن التحويل يحذف رموزًا ويضيف فواصل، فلا يمكن مقارنة الحروف واحدًا مقابل واحد. تعرض الأداة عدد الأسطر التي تغيّرت بدلًا من ذلك.