محول تنسيقات البيانات

يقرأ المحول ويكتب JSON وJSON Lines وYAML وTOML وXML وCSV وTSV وINI وخصائص Java وExcel XLSX وOpenDocument ODS، ويمكن التحويل من أي منها إلى أي تنسيق آخر. اختر تنسيق المصدر في From والهدف في To. تتوفر أيضًا أدوات مخصصة مع خيارات إضافية للتحويلات التالية: JSON وYAML، وCSV إلى JSON، وJSON إلى CSV، وJSON إلى XML، وXML إلى JSON.

اختر XLSX أو ODS تنسيقًا للمصدر، وارفع المصنف بدلًا من لصق النص. يقرأ المحول الورقة الأولى أو الورقة التي تسميها في حقل Sheet name، ويعامل الصف الأول كرؤوس للأعمدة، ثم يحوّل كل صف تالٍ إلى سجل. تُقرأ الصيغ بقيمها المحسوبة الأخيرة، وتصبح خلايا التاريخ سلاسل ISO 8601.

لا يمكن لهذه التنسيقات استيعاب البنى المتداخلة، لذا تُسطّح الكائنات المتداخلة إلى مفاتيح منقوطة، وتُضاف فهارس العناصر إلى مفاتيح عناصر المصفوفة بين أقواس مربعة. مثلًا، يصبح {"user": {"name": "Ada", "tags": ["x"]}} المفاتيح user.name وuser.tags[0]. وعند قراءة properties مجددًا، تُعاد المفاتيح المنقوطة إلى بنى متداخلة إذا لم تتعارض، بينما تُحفظ ترويسات CSV وTSV كما كُتبت تمامًا.

عندما يكون التنسيق الهدف CSV أو TSV أو XLSX أو ODS، تصبح المصفوفة ذات المستوى الأعلى هي الصفوف. وإذا كان هناك كائن لا يغلّف سوى مصفوفة واحدة، مثل {"users": [...]} أو مستند XML يتكون من عناصر صفوف متكررة، تُستخرج تلك المصفوفة؛ وما عدا ذلك يصبح صفًا واحدًا. تتكون الأعمدة من اتحاد جميع المفاتيح وفق ترتيب ظهورها الأول، وتظل القيم المفقودة فارغة.

تحافظ JSON وJSON Lines وYAML وTOML على الأرقام والقيم المنطقية وقيم null، كما تحتفظ خلايا جداول البيانات بالأرقام والقيم المنطقية. لا أنواع للبيانات في CSV وTSV وINI وproperties وXML؛ لذلك تُقرأ القيم كنصوص وتظل نصوصًا في النتيجة. وتُحفظ أعداد TOML الصحيحة التي تتجاوز قدرة الأرقام في JavaScript كنصوص كي لا تُفقد أي أرقام.

يصبح كل عنصر مفتاحًا، وتصبح العناصر المتكررة مصفوفات، وتصبح السمات مفاتيح تبدأ بـ @، ويُخزّن النص المجاور للسمات تحت #text. عند كتابة XML، يستخدم كائن ذو مفتاح واحد في المستوى الأعلى ذلك المفتاح عنصرًا جذريًا؛ أما غير ذلك فيُغلّف بعنصر جذري، وتُكتب عناصر المصفوفة كعناصر صفوف. تُستبدل الأحرف غير المسموح بها في أسماء العناصر بشرطات سفلية، وتُرفض المستندات التي تعرّف كيانات حفاظًا على الأمان.

لا يحتوي TOML على قيمة null، لذلك تُستبعد المفاتيح التي تحتوي على null، وتصبح عناصر null داخل المصفوفات سلاسل فارغة. يحتاج TOML أيضًا إلى جدول في المستوى الأعلى؛ لذا تُكتب المصفوفة ذات المستوى الأعلى كمصفوفة جداول باسم rows، وتُكتب القيمة المفردة كمفتاح باسم value. وتُكتب التواريخ المقروءة من TOML إلى تنسيقات أخرى كسلاسل ISO 8601.

تصبح أقسام INI كائنات، وتجمع الأسطر بصيغة key[] القيم في قائمة، وتُعد الأسطر التي تبدأ بـ ; أو # تعليقات، وقد تستخدم القيم المحاطة بعلامتي اقتباس مزدوجتين تسلسلات هروب مثل \n. وتتبع properties قواعد Java: تفصل = أو : أو المسافات بين المفتاح والقيمة، وتُعد الأسطر التي تبدأ بـ # أو علامة تعجب تعليقات، ويواصل الخط المائل العكسي في نهاية السطر السطر التالي، وتُفك تسلسلات الهروب \uXXXX. تُكتب properties بصيغة UTF-8 عادية، وتقرأها Java 9 والإصدارات الأحدث في حزم الموارد.

تُقرأ مدخلات JSON Lines سطرًا سطرًا، وتُتجاوز الأسطر الفارغة، وتشكل القيم مصفوفة؛ بينما تكتب مخرجات JSON Lines كل عنصر من المصفوفة كقيمة JSON مضغوطة في سطر مستقل. وتصبح مدخلات YAML التي تضم عدة مستندات مفصولة بـ --- مصفوفةً لها مدخل لكل مستند. وتُظهر أخطاء تحليل YAML وTOML وXML غير الصالحة رقم السطر والعمود الذي توقف عنده التحليل، بينما تُظهر أخطاء JSON Lines غير الصالحة رقم السطر.

يمكن أن يصل حجم النصوص والملفات إلى 5 MiB، بحد أقصى 100,000 صفوف و1,000,000 خلية و64 مستوى من التداخل و50 MiB لمحتوى المصنف بعد فك ضغطه و16 MiB للنتيجة. تُرفض المدخلات الأكبر برسالة بدلًا من اقتطاعها. تُحوّل بياناتك في الذاكرة أثناء الطلب ولا تُخزّن.