الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

XML إلى محول JSON

جدول المحتويات

  • XML إلى محول JSON
    • جدول المحتويات
    • ملخص
    • سمات
    • هيكل المستودع
    • الاستخدام
      • هيكل مجلد بيانات الإدخال
    • تعليمات الإعداد
      • الخطوة 1: استنساخ المستودع
      • الخطوة 2: تشغيل التحويل
    • التغييرات والتحسينات

ملخص

يوفر هذا المشروع مجموعة من البرامج النصية والأدوات لتحويل ملفات XML إلى تنسيق JSON. إنه مصمم للعمل مع مصادر بيانات XML مختلفة ويمكن تخصيصها بالكامل ، مما يدعم وحدات تحويل متعددة. ينقسم المشروع إلى وحدات بيثون منفصلة للتعامل مع أنواع مختلفة من البيانات ، بما في ذلك المستندات والأشخاص والمحفوظات.

يشمل الحل:

  • طرق تحليل XML المختلفة لاستخراج البيانات من أنواع مختلفة من ملفات XML.
  • أدوات للتعامل مع أنواع مستندات محددة مثل المحفوظات والأعمال الفنية والأشخاص.
  • بنية مرنة لسهولة التحويل والتكامل مع الأنظمة الأخرى.

سمات

  • البرامج النصية للتحويل المخصصة : مصممة لتنسيقات XML المختلفة ، بما في ذلك المستندات والأشخاص وروابط الأرشيف.
  • معالجة البيانات المرنة : القدرة على التعامل مع النص والبيانات الوصفية والسمات المحددة مثل المستعارة والمراجع.
  • البنية المعيارية : يتم التعامل مع كل نوع XML بواسطة برامج نصية منفصلة ، مما يجعل من السهل تمديده أو تعديله.

هيكل المستودع 

convert/
  archiveLinkConvert.py      # Handles conversion of archive link XMLs
  artworkConvert.py          # Handles artwork XML data
  commonConvert.py           # Contains common conversion utilities
  personConvert.py           # Handles conversion of person-related XMLs
docs/
  pictures/                  # Picture documentation related to the project
  Analyza_SP.md              # Analysis related documentation
  documentaria_rudolphina.md # Project-specific documentation
model/
  ArchiveLink.py             # Data model for archive links
  Document.py                # Data model for documents
  Person.py                  # Data model for person records
scripts/
  main_convert.py            # Main script to execute conversion
  .gitignore                 # Git ignore configuration
  README.md                  # This documentation file

الاستخدام

لاستخدام هذه الأداة ، ستحتاج إلى تثبيت Python و PIP.

ثم ، قم بتشغيل الأمر التالي: 

pip install -r requirements.txt

سيؤدي ذلك إلى تثبيت المكتبات اللازمة لتشغيل البرنامج النصي. ثم قم ببساطة بتشغيل البرنامج النصي main_convert.py مع الخيارات المناسبة. فيما يلي الأوامر الرئيسية لتشغيل البرنامج من دليل XMLtoJSON :

  • عرض معلومات المساعدة: 

    python3 scripts/main_convert.py --help

    أو 

    python3 scripts/main_convert.py --h

  • تحويل جميع أنواع ملفات XML: 

    python3 scripts/main_convert.py --type all --input_path " path_for_input_data " --output_path " path_for_output_data "

  • تحويل ملفات XML المتعلقة بالاسم: 

    python3 scripts/main_convert.py --type names --input_path " path_for_input_data " --output_path " path_for_output_data "

  • تحويل ملفات XML المتعلقة بالسجل: 

    python3 scripts/main_convert.py --type registers --input_path " path_for_input_data " --output_path " path_for_output_data "

  • تحويل ملفات XML المتعلقة بالأرشيف: 

    python3 scripts/main_convert.py --type archive --input_path " path_for_input_data " --output_path " path_for_output_data "

هيكل مجلد بيانات الإدخال

يجب تنظيم مجلد بيانات الإدخال على النحو التالي: 

input_data/
  Archiv/                    # Archive-related XML files
  Regesten/                  # Register-related XML files
  Namen/                     # Name-related XML files
  Indicies/                  # Index-related XML files

تعليمات الإعداد

الخطوة 1: استنساخ المستودع 

git clone https://github.com/VandlJ.git
cd XMLtoJSON

الخطوة 2: تشغيل التحويل

لبدء التحويل ، استخدم نص التحويل الرئيسي. على سبيل المثال ، لتحويل جميع ملفات XML: 

python3 scripts/main_convert.py --type all --input_path " ../test_data " --output_path " ../test_data/output "

يمكنك أيضًا الاطلاع على جميع الخيارات المتاحة والحصول على معلومات مفصلة عن طريق التشغيل: 

python3 scripts/main_convert.py --help

سيبدأ هذا الأمر في معالجة ملفات XML في الدليل المحدد --input_path وإخراج النتائج إلى دليل --output_path .

التغييرات والتحسينات

ورث هذا المشروع من فريق آخر ، وقمنا بإجراء العديد من التحسينات والإصلاحات المهمة لتعزيز وظائفه وموثوقيته:

  1. معالجة الأخطاء: المسافات/الأحرف الفارغة للمسافة البادئة في النص - في ملفات Regesten

    • في السابق ، واجهت ملفات Regesten JSON مشكلات مع المساحات والأحرف الفارغة التي تسبب أخطاء المسافة البادئة. لقد تناولنا هذا عن طريق تقسيم حقل "النص" إلى قيمتين مفتاحين متميزين:
      • display : يتم استخدام هذا الحقل لعرض النص على الواجهة الأمامية ، مما يضمن أنه يحتفظ بالتنسيق الأصلي لقابلية القراءة.
      • processable : يحتوي هذا الحقل على نسخة أنظف من النص ، وتم تحسينها لمعالجة الكمبيوتر وتحليله.

  2. معالجة البيانات الوصفية: بيانات التعريف في ريجنستن

    • كانت هناك تناقضات في التقاط عناصر البيانات الوصفية مثل .p في ملفات Regesten. كانت بعض العناصر مفقودة أو تم التقاطها بشكل غير صحيح. أجرينا مراجعة شاملة وتأكد من أن جميع عناصر البيانات الوصفية يتم التقاطها الآن بدقة ومعالجتها في تكرارنا للبرنامج.

  3. التفاعل المحسّن: إضافة معلومات onmouseover="highlightWords(event, '...')" في Regesten

    • لتحسين تجربة المستخدم ، أضفنا التفاعل إلى ملفات Regesten. تمت إضافة سمة onmouseover لتسليط الضوء على الكلمات عند تحومها. تتضمن البيانات المعالجة الآن: 
       "names" : [
  {
    "Aichholz_Johann" : " Johann Aichholz " ,
    "alias" : " Johann Aichholz Ehrzney doctor "
  },
  {
    "Strauben_Franz" : " Franz Strauben " ,
    "alias" : " Frannzen Strauben "
  }
]

  4. معالجة الاسم: تقسيم الاسم الأول والاسم الأخير عبر الأداة الخارجية - Gettyulan

    • قمنا بدمج المشروع باستخدام أداة خارجية ، Gettyulan ، لتعزيز معالجة الأسماء. توفر هذه الأداة أو API روابط URL للمؤلفين وإرجاع طلب واحد للشخص الواحد. يستفسر التطبيق من نقطة نهاية sparql ، حيث يتم التحقق من صحة كل اسم ومعالجته. يضمن هذا التكامل معلومات مؤلف دقيقة ومخصبة.
    • بالإضافة إلى ذلك ، قمنا بإجراء API لتقسيم الاسم بشكل غير متزامن مع التخزين المؤقت ، وزيادة الأداء بشكل كبير عن طريق تقليل الطلبات الزائدة وتحسين أوقات الاستجابة.

  5. البرنامج النصي الرئيسي الموحد للتحويل

    • قمنا بتبسيط عملية التحويل عن طريق توحيد البرامج النصية الثلاثة الرئيسية للثعبان (المستخدمة سابقًا لأنواع المستندات المختلفة) في برنامج نصي واحد موحد. أصبح هذا البرنامج النصي الرئيسي قابلاً للتكوين الآن عبر خيارات المحطة الطرفية ، مما يسمح للمستخدمين بتحديد --type ، --input_path ، و --output_path . هذا التغيير يبسط التنفيذ ويعزز مرونة عملية التحويل.

  6. تحسين تعليمات الوثائق والإعداد

    • تم تحديث الوثائق لتعكس التغييرات الجديدة وتوفير إرشادات إعداد واضحة. يتضمن ذلك أمثلة استخدام مفصلة وهيكل مجلد بيانات الإدخال المتوقع لضمان أن يتمكن المستخدمون من البدء بسهولة مع المشروع.

  7. تحسينات الأداء وإصلاحات الأخطاء

    • أجرت مراجعة شاملة لقاعدة الكود لتحديد الحشرات وإصلاحها. تحسينات الأداء المنفذة لضمان أن تكون عملية التحويل فعالة وموثوقة.

  8. إصلاحات في إخراج نوع Archiv JSON

    • تصحيح معالجة متغيرات hasSublink و linkTo و next_link في ملفات JSON الإخراج لنوع الأرشيف. هذا يضمن تمثيل هذه المتغيرات وربطها بدقة في إخراج JSON.

عززت هذه التحسينات بشكل كبير من وظائف وسهولة الاستخدام وموثوقية مشروع محول XML إلى JSON ، مما يجعلها أكثر قوة وسهولة في الاستخدام.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل