2026-07-23
تحويل استجابة JSON من واجهة برمجية إلى جدول Excel
بعض بيانات JSON تتحوّل إلى جدول بيانات مثالي فوراً. وبعضها يحتاج إعادة تشكيل بسيطة أولاً — إليك كيف تُميّز بينهما.
استجابة JSON من واجهة برمجية وجدول Excel كلاهما في الأساس قائمتان منظّمتان من السجلات، ولهذا يعمل التحويل بينهما جيداً عادة — لكن فقط عندما يكون JSON مُشكّلاً بالطريقة التي يتوقعها جدول البيانات: قائمة مسطّحة من كائنات متشابهة.
شكل JSON الذي يتحوّل بسلاسة
المدخل المثالي هو مصفوفة على المستوى الأعلى حيث كل عنصر فيها كائن له تقريباً نفس مجموعة المفاتيح — وهذا بالضبط ما تُعيده معظم واجهات REST من نقطة نهاية قائمة. يصبح كل مفتاح عموداً، وكل كائن صفاً، دون خطوات إضافية.
ما الذي يحدث مع JSON المتداخل
كثير من استجابات الواجهات البرمجية الحقيقية تُغلّف القائمة الفعلية داخل كائن خارجي — {"data": [...]} أو {"results": [...], "page": 2} — بدلاً من إعادة المصفوفة مباشرة في المستوى الأعلى. تتوقع أداة JSON to Excel أن تكون القيمة في المستوى الأعلى نفسها هي المصفوفة، لذا ستحتاج لاستخراج القائمة الداخلية فقط أولاً.
الكائنات أو المصفوفات المتداخلة داخل سجل واحد (كائن عنوان داخل سجل عميل مثلاً) لا يتم تسطيحها تلقائياً إلى أعمدة منفصلة أيضاً — بل تظهر كخلية واحدة غير قابلة للقراءة. سطّح الحقول التي تحتاجها فعلاً إلى مفاتيح منفصلة في المستوى الأعلى قبل الرفع.
كيف تعمل JSON to Excel فعلياً
تعمل الأداة بالكامل داخل متصفحك: تحلّل نص JSON الذي تُدخله، وتتأكد من أن المستوى الأعلى مصفوفة من الكائنات، وتبني ورقة عمل باستخدام مفاتيح بياناتك كعناوين أعمدة. لا يُرفع شيء إلى أي مكان — نفس النهج من جانب العميل المستخدم في معظم أدوات التحويل الأخرى في RowMint.
الأدوات المستخدمة في هذا الدليل
الأسئلة الشائعة
استجابة الواجهة البرمجية لديّ بها غلاف "data" في المستوى الأعلى — هل سيعمل هذا؟
ليس مباشرة — انسخ المصفوفة الداخلية فقط (قيمة مفتاح "data") إلى ملف خاص بها أولاً، لأن الأداة تتوقع أن تكون قيمة JSON في المستوى الأعلى هي بالفعل مصفوفة السجلات.
ماذا لو كانت لبعض الكائنات حقول مختلفة عن غيرها؟
تُؤخذ الأعمدة من مفاتيح بياناتك، لكن الكائنات غير المتسقة قد تُنتج خلايا فارغة أو غير متطابقة للحقول التي لا تتطابق. تحقق من الناتج بدلاً من افتراض أن كل حقل وصل بسلامة.
هل يتعامل هذا مع كائنات متداخلة بعمق داخل كل سجل؟
لا — لا يحدث تسطيح تلقائي عميق. الكائن أو المصفوفة المتداخلة داخل حقل لن يتم تقسيمها إلى أعمدة خاصة بها. سطّح ما تحتاجه قبل الرفع.