أريد لصق قيمة JSON في حقل مخصص (metafield) في متجري على Shopify، هل أصغّرها أم أنسّقها، وكيف أتأكد أنها صالحة قبل الحفظ؟
الصيغتان المصغّرة والمنسّقة تحملان البيانات نفسها تمامًا، فالاختيار بينهما مسألة قراءة وحجم، لا صلاحية. المهم أن يكون النص JSON صالحًا. الصقه أولًا في منسّق JSON: إن كان صالحًا ترى نوعه وإحصاءاته، وإلا ترى السطر والعمود الذي فيه المشكلة، ثم انسخ الصيغة التي تريدها إلى الحقل.
الفرق بين الصيغتين بالأرقام
مثال الأداة المدمج قيمة بيانات متجر صغيرة: اسم المتجر والعملة ومنتجان ومعلومات شحن، وحجمها 284 بايت كما هي مكتوبة على ثلاثة أسطر. بعد التصغير تصبح 282 بايت في سطر واحد، وبعد التنسيق بمسافتين 436 بايت على أسطر كثيرة. البيانات في الحالات الثلاث واحدة: كائن عمقه 4 وفيه 16 مفتاحًا.
إذن أيهما تلصق؟ إن كان الحقل صغيرًا وستعدله بيدك لاحقًا فالمنسّقة أسهل للقراءة. وإن كنت تهتم بالحجم أو تنسخ القيمة بين أنظمة فالمصغّرة أخف. وهل للمنصة حد لطول القيمة أو تفضيل لصيغة معينة؟ هذا تجده في توثيق Shopify الحالي لنوع الحقل الذي أنشأته، لا نفترضه هنا.
لماذا تتحقق قبل الحفظ؟
لأن القيمة غالبًا مكتوبة بيدك أو معدلة من مثال، والخطأ الصغير فيها سهل: فاصلة بعد آخر عنصر، أو علامة تنصيص ناقصة. وقد ترفض المنصة الحفظ برسالة عامة، أو تقبل القيمة في حقل نصي عادي ثم يفشل القالب الذي يقرؤها. التحقق في الأداة يعطيك موضع الخطأ بالسطر والعمود قبل أن تصل إلى ذلك.
الخطوات
- اكتب القيمة أو الصقها في منسّق ومدقّق JSON.
- انتظر رسالة «JSON صالح. النوع في المستوى الأعلى: كائن» أو «مصفوفة»، وتأكد أن النوع هو ما يتوقعه القالب.
- إن ظهر خطأ، فاضغط «انتقل إلى موضع الخطأ» وصححه.
- اقرأ التحذيرات تحت النتيجة إن ظهرت: مفاتيح مكررة، أو أعداد صحيحة طويلة جدًا.
- اختر «تصغير» أو «تنسيق» حسب ما قررت، وانسخ الناتج إلى الحقل.
تحذير المفاتيح المكررة
هذا خطأ لا يمنع الصلاحية، ولذلك يمر دون أن تلاحظه. خذ قيمة كهذه:
{"size":"M","color":"black","color":"navy"}
هي JSON صالح، لكن المفتاح color مكرر. بعد التصغير يصبح الناتج {"size":"M","color":"navy"}: بقيت القيمة الأخيرة فقط وضاعت black. الأداة تعرض تحذيرًا بالمفتاح المكرر، فإن قصدت لونين فاجعلهما مصفوفة، مثل "colors": ["black", "navy"].
العربية داخل القيمة
لا تقلق على النصوص العربية: الأداة تبقيها حروفًا كما هي، ولا تحولها إلى رموز مثل \u0645. وإن ظهر سطر فيه عربية وأرقام مقلوبًا في خانة النص، فهذا أسلوب المتصفح في عرض النص ثنائي الاتجاه، والبيانات نفسها بترتيبها الصحيح عند النسخ. وإن كانت بياناتك أصلًا جدولًا، فحوّلها إلى JSON أولًا عبر محوّل CSV و JSON ثم تحقق منها هنا.
أسئلة شائعة
هل الصيغة المنسّقة أقل صلاحية من المصغّرة؟
لا. المسافات والأسطر خارج النصوص لا تغير البيانات، فكلتاهما صالحة بالقدر نفسه.
هل تتغير الأسعار بعد التصغير؟
القيمة لا تتغير، لكن الأعداد تُكتب بأقصر صيغة، فيصبح 45.50 هو 45.5. إن كان الشكل مهمًا فاكتب السعر نصًا.
هل تُرسل القيمة إلى شوبيفاي أو أي خادم؟
لا. الأداة تعمل داخل متصفحك، وأنت من ينسخ الناتج إلى المنصة.