الانتقال إلى المحتوى الرئيسي
PulsarKit

تحويل JSON إلى CSV

حوّل استجابة API أو ملف NDJSON مُصدَّرًا إلى جدول بيانات مسطّح، يبقى فيه كل حقل من كل سجل عمودًا مستقلًا.

أفلت ملفاتك هنا

⁦.json, .ndjson, .txt⁩ · حتى 300 م.ب

إعدادات إضافية

طريقة تحويل إلى CSV

  1. 1

    إفلات ملف JSON

    اسحب ملف .json أو .ndjson إلى الصفحة وأفلته. تُقبل المصفوفة العادية، والكائن الواحد، وسجل واحد في كل سطر.

  2. 2

    تحديد المصفوفة واختيار الفاصل

    إذا كانت السجلات داخل كائن يغلّفها، فاكتب المسار إليها، مثل data.items. ثم اختر الفاصل الذي يتوقعه برنامج الجداول لديك.

  3. 3

    التحويل وتنزيل ملف CSV

    انقر على الزر واحفظ الجدول، وهو جاهز للفتح في Excel أو Numbers أو Google Sheets.

صف العناوين يُبنى من كل السجلات

المحوّل الذي يقرأ المفاتيح من السجل الأول وحده يفقد بصمت أي حقل يظهر لأول مرة في السجل رقم 900، ولا ينتبه أحد لذلك حتى يظهر عمود فارغ بعد أسابيع. أما هنا فيُفحص الملف كله أولًا، ويصير اتحاد كل المفاتيح صف العناوين بترتيب ظهورها الأول، وبعد ذلك فقط تُكتب الصفوف.

الكائنات المتداخلة تصير أعمدة بأسماء مفصولة بنقاط

لا مكان في CSV لبنية متداخلة، لذلك يُفرد الكائن الموجود داخل سجل إلى أعمدة بأسماء مثل user.address.city. وما يتجاوز حد العمق يُكتب كنص JSON مختصر بدلًا من حذفه. أما المصفوفات فيمكن دمجها في خلية واحدة، أو توزيعها على أعمدة مرقمة، أو إبقاؤها نصًا بصيغة JSON.

ملف يفتحه Excel دون نافذة استيراد

الإخراج الافتراضي بترميز UTF-8 مع علامة ترتيب البايتات (BOM) ونهايات أسطر CRLF، وهذا ما يجعل Excel يعرض الأحرف ذات العلامات والنص السيريلي صحيحًا عند فتح الملف بنقرة مزدوجة. ويتوفر ترميز Windows-1251 للأدوات الأقدم؛ والأحرف التي لا يستطيع تمثيلها تصير علامات استفهام، وتُخبَر بعددها.

بياناتك تبقى في علامة التبويب

تحليل JSON وجمع صف العناوين وتسطيح السجلات وترميز CSV، كل ذلك يجري محليًا في متصفحك. لا يُرفع شيء، ولا ينتظر شيء في طابور على جهاز لا تتحكم فيه، ولا حاجة إلى حساب. والملف المُصدَّر المليء بسجلات العملاء أو مفاتيح API لا ينتقل إلى أي مكان.

الأسئلة الشائعة

ماذا يحدث للكائنات المتداخلة داخل السجلات؟

تُسطَّح إلى أعمدة بأسماء مفصولة بنقاط، فالمدينة المدفونة داخل user.address تصير عمودًا اسمه user.address.city. ويمنع حد العمق تضخم الأعمدة مع البيانات شديدة التداخل: ما يقع تحته يُكتب في خلية واحدة كنص JSON، فتبقى المعلومة موجودة وإن لم تبقَ البنية.

السجلات داخل كائن يغلّفها. كيف أصل إليها؟

استخدم حقل المسار في الأعلى. اكتب سلسلة المفاتيح مفصولة بنقاط، مثل data.items أو result.0.rows، فيبدأ المحوّل من هناك. وإذا لم يؤدِّ المسار إلى شيء، تسرد رسالة الخطأ المفاتيح الموجودة فعلًا في المستوى الأعلى من الملف لتصحح المسار.

لماذا يضع Excel الصف كله في عمود واحد؟

يقسم Excel الأعمدة حسب الفاصل المضبوط في الإعدادات الإقليمية لنظامك، وهو في كثير من دول أوروبا الفاصلة المنقوطة لا الفاصلة. أعد التحويل مع اختيار الفاصلة المنقوطة فاصلًا، فتصطف الأعمدة. أما Google Sheets فيكتشف الفاصل عند الاستيراد، فلا يتأثر في الحالتين.

ما فائدة علامة BOM في بداية الملف؟

هذه البايتات الثلاثة تخبر Excel أن الملف بترميز UTF-8 قبل أن يبدأ التخمين. ومن دونها يفترض Excel كثيرًا صفحة ترميز قديمة، فيعرض الأحرف ذات العلامات أو النص السيريلي رموزًا مشوهة. وإذا كان النظام الذي ستنقل إليه الملف لا يقبل هذه العلامة، فإن UTF-8 العادي بلا BOM على بعد إعداد واحد.

ماذا يحدث للمصفوفات داخل السجل؟

افتراضيًا تُدمج في خلية واحدة بفاصل تختاره، وهذا يناسب قوائم الوسوم القصيرة. ويمكن بدلًا من ذلك توزيعها على أعمدة مرقمة مثل tags.0 حتى tags.4، بحد أقصى 50 عمودًا مع تحذير، أو كتابتها كنص JSON حين يكون المحتوى أهم من شكل الجدول.

هل يقبل المحوّل ملفات NDJSON؟

نعم. إذا لم يُحلَّل الملف كمستند JSON واحد، يُحلَّل كل سطر غير فارغ كسجل مستقل، وهذا يغطي ملفات NDJSON وJSON Lines المُصدَّرة دون تغيير أي إعداد.

لماذا تظهر علامة اقتباس قبل القيمة التي تبدأ بعلامة يساوي؟

يعامل Excel كل خلية تبدأ بأحد الرموز = أو + أو @ على أنها صيغة، والقيمة المصنوعة بعناية في ملف من مصدر غير موثوق قد تتحول إلى أمر يُنفَّذ حين يفتح أحدهم الملف. والفاصلة العليا (') في البداية تعطل ذلك. أما الأرقام السالبة العادية مثل -5 أو -12.5 فتبقى كما هي تمامًا.

هل يُرفع ملف JSON إلى أي مكان؟

لا. المحلل وأداة التسطيح والمرمّز، كلها شيفرة JavaScript تعمل داخل هذه الصفحة. لا طلبات إلى أي خادم، ولا تخزين، ولا تسجيل لمحتواك في أي مرحلة.

أدوات ذات صلة