تخطَّ إلى المحتوى الرئيسي

صيغة CSV للحقول الوصفية في Shopify: namespace وkey والأنواع

لا يتم رفع أي شيءتم اختباره حتى 200 MB

افهم عناوين الحقول الوصفية وقواعد namespace/key والأنواع المدعومة في CSV والقوائم وحدود القيم.

نُشر في: 2026-09-23محدّث: 2026-09-231 minتحقق من صيغة الحقول الوصفية
رسم توضيحي لسير عمل البيانات: صيغة CSV للحقول الوصفية في Shopify: namespace وkey والأنواع

لا تملك الحقول الوصفية لمنتجات Shopify قائمة ثابتة من الأعمدة. يصبح كل تعريف عنوان CSV ديناميكيًا يحدده namespace وkey.

صيغة عنوان الحقل

الصيغة القياسية هي product.metafields.<namespace>.<key>. قد يضيف تصدير Shopify اسمًا مقروءًا، لكن العنوان القياسي وحده يكفي لملف استيراد مُجهّز.

يسمح namespace وkey بالحروف والأرقام والشرطات والشرطات السفلية. طول namespace من 2 إلى 255 محرفًا، وkey من 2 إلى 64. تُدخل في Nablyx صيغة namespace.key ويُنشئ العنوان الكامل.

يجب أن يطابق النوع التعريف الموجود

يدعم CSV المنتجات أنواعًا مثل boolean واللون والتاريخ والأبعاد والمال والأرقام ومراجع المنتجات والنص وURL والحجم والوزن، إضافة إلى عدة أنواع قوائم. لا يُكتب النوع داخل العنوان، لذلك يبقى تعريف Shopify هو المرجع.

افصل عناصر القوائم بفاصلة منقوطة

تستخدم القوائم المدعومة عناصر مفصولة بفاصلة منقوطة. الحد الموثق لمعظم القوائم 128 عنصرًا، بينما لقوائم مراجع metaobject حد أعلى.

افحص فقط ما يمكن للملف إثباته

لا يحتوي CSV المستقل على قواعد التعريف الخاصة بالمتجر. يفحص Nablyx المخطط العام، ويبقى Shopify مسؤولًا عن الخيارات أو regex أو القيود المخصصة.

تحقق من صيغة الحقول الوصفية

شاهد التحويل

تتحول العناوين المربكة إلى أعمدة جاهزة للاستيراد.

أعد تسمية الأعمدة التي تحتاجها مع إبقاء كل قيمة تحت العنوان الصحيح.

cust_idcustomer_id
given_namefirst_name
mailemail

✓ تبقى القيم في العمود الصحيح