التحقّق من صحة الكيانات باستخدام مخططات JSON

للتحقّق من صحة الكيانات أثناء إنشاء خلاصتك أو تعديلها، استخدِم ملف JSON التالي المخططات. تستند المخططات إلى مواصفات مخطط JSON. عن طريق إضافة اختبار وحدة للتحقق من صحة الكيانات التي تنشئها، يمكنك اكتشاف قد تؤثر في جودة الخلاصة يمكنك أيضًا استخدام هذه المخططات أثناء تطوير خلاصتك لتجنُّب الأخطاء الشائعة.

اختيار مخطط لمهام الوسائط

• يتحقّق مخطط الفيديو عند الطلب من صحة الكيانات Movie وTVEpisode وTVSeries وTVSeason.
• يتحقّق مخطط البث التلفزيوني المباشر من صحة الكيانات BroadcastEvent وBroadcastService وCableOrSatelliteService وMovie وOrganization وSportsEvent وTelevisionChannel وTVEpisode وTVSeason وTVSeries.
• يتحقّق مخطط الموسيقى من صحة الكيانات MusicAlbum وMusicGroup وMusicPlaylist وMusicRecording.
• يتحقّق المخطط الراديو من صحة كيانات RadioBroadcastService.

استخدِم المواصفات على هذا الموقع الإلكتروني باعتبارها مصدرًا للحقيقة، حيث قد لا يتم تنفيذ جميع الميزات في هذه المخططات.

اختيار مدقّق

يمكنك العثور على قائمة بعمليات تنفيذ أداة التحقّق من الصحة على json-schema.org.

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

مثال على عملية التحقّق

يوضّح المثال التالي كيفية التحقّق من صحة جميع الكيانات المتوفّرة في ملف. feed.json باستخدام ملف المخطط schema.json ووحدة python jsonschema. تقع الكيانات في السمة dataFeedElement كما هو موضح في مستند مغلف خلاصة البيانات.

    import json
    from jsonschema import validate

    # Loading the schema file
    with open("schema.json", "r") as fp:
        schema = json.load(fp)

    # Opening the feed
    with open("feed.json", "r") as fp:
        feed = json.load(fp)

    # Validating each entity in the feed
    for entity in feed["dataFeedElement"] :
        try:
            validate(schema=schema, instance=entity)
            print("Entity validated successfully")
        except Exception as e:
            # e may contain an explanation as to why the entity wasn't valid
            print("Failed to validate the entity")