أدلة عملية معمقة

حفظ إصدار قابل لإعادة الإنتاج من البيانات العامة

ربط الملف المصدر والتواريخ والبنية والتحويلات للعثور على البيانات ومقارنتها وإعادة استخدامها دون الخلط بين التحديث والتصحيح وتغيير النطاق.

آخر تحديث :

فحص الملفات والجداول في محطة عمل منظمة.

رسم توضيحي مولّد بالذكاء الاصطناعي

هل يستطيع قارئ آخر إعادة بناء النتيجة؟

رابط إلى قاعدة متغيرة لا يحدد البيانات المستخدمة فعلًا. قد يراجع تصحيح سلسلة قديمة، أو يفقد التصدير أصفارًا أولية، أو يغيّر عمود جديد معنى المجموع. يشرح الإصدار المفيد المادة الأولية وطريق المعالجة. الهدف إعادة إنتاج العمل الموصوف لا تقديم ضمان شامل لجودة المصدر.

  1. تحديد النطاق

    تسمية المنتج والمجموعة والمنطقة والسكان والفترة والفلاتر. فصل تاريخ الرصد والنشر والتنزيل. ملف مستلم اليوم قد يصف فترة قديمة. تسجيل السؤال والاستبعادات المهمة للتفسير.

  2. حفظ المدخل المستخدم

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

  3. وصف البنية

    توثيق الحقول والأنواع والوحدات والمفاتيح والقيم الناقصة. في CSV فحص الفاصل والترميز وعلامات الاقتباس ونهايات الأسطر حسب التصدير الفعلي. حفظ المعرّفات ذات الأصفار الأولية كنص. التمييز بين صفر وقيمة مفقودة وغير منطبقة.

  4. تتبع التحويلات

    تسجيل التصفية والتوحيد والربط والتحويل وإزالة التكرار بالترتيب. فصل المدخل الخام والمخرج المجهز. الاحتفاظ بمفاتيح الربط والحالات غير المحسومة. اسم مشابه لا يكفي لدمج كيانين. توثيق القرارات بدل إخفائها في الملف النهائي.

  5. مقارنة الإصدارات

    قياس الصفوف المضافة والمحذوفة والمعدلة وفق مفتاح ثابت إن وجد. فحص البنية والوحدات والتعريفات أيضًا. تغير عدد الصفوف لا يثبت تغير الظاهرة؛ قد ينتج من فلاتر أو تغطية أو مراجعة المنتج.

  6. تجهيز إعادة الاستخدام

    ربط النتيجة بإصدار المصدر والخطوات والحدود. فحص روابط المنتج والسياق. إعداد جمع جديد بمعايير مقارنة. حفظ إصدار قديم منفصلًا إذا أسند استنتاجًا منشورًا مع احترام الشروط والبيانات التي يحتويها.

ورشة قراءة البيانات

تصحيح القيمة لا يعيد كتابة ما كان معلوماً

مجموعة DEMO افتراضية. تفصل إصداراتها تحليلاً تاريخياً عن تحليل يستخدم البيانات المصححة.

بيانات وسجلات افتراضية للتعلم: لا تأتي هذه النتائج من استعلام مباشر لأي خدمة.

80 في أبريل و82 بعد التصحيح في يونيو

يحمل الملفان المفتاح والفترة نفسيهما. ينشر المنتج الافتراضي ملاحظة تصحيح. لا يغير تعديل لاحق لوصف الفهرس ملف CSV.

إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.

80 في أبريل و82 بعد التصحيح في يونيو
الحالة الافتراضيةالوثيقة المتاحةما يتغيرالاستخدام المعلن
v1 متاح في أبريلالقيمة 80 للمفتاح المدروسالحالة المنشورة قبل التصحيحلوصف المتاح في أبريل استشهد بـv1.
v2 منشور في يونيوالقيمة المصححة 82 وملاحظة المراجعةتصحيح مشاهدة ماضية لا حدث جديدللتحليل المراجع استشهد بـv2 واشرح التصحيح.
تعديل الوصف بعد v2وصف أوضح وCSV دون تغيير في المثالبيانات وصفية فقطلا تستنتج قيمة جديدة من تاريخ الوصف.
حفظ التحليليننتيجة تاريخية مع v1 وأخرى مراجعة مع v2سؤال زمني وإصدار مصدرلا تخلط الإصدارات بصمت.

هل تستبدل نتيجة أبريل بصمت؟

افتح كل اقتراح لمقارنة تشخيصه. قد تبقى فحوص إضافية ضرورية.

نعم؛ أحدث ملف وحده يستحق الحفظ

لا؛ قد يلزم الإصدار السابق لفهم الاستنتاج المنشور آنذاك.

لا؛ وضح السؤال والإصدار والتصحيح

نعم. افصل المعلوم في أبريل عن تحليل يونيو المراجع واربط المخرجات بمدخلاتها.

البصمة المتطابقة تصادق على جودة البيانات

لا؛ تقارن البايتات بمرجع ولا تثبت صحة الرقم أو تمثيله.

سجل إصدارات افتراضي

المجموعة: DEMO؛ المفتاح والفترة ثابتان
v1: متاح في أبريل؛ القيمة=80
v2: منشور في يونيو؛ القيمة المصححة=82
السبب: تصحيح موثق من المنتج الافتراضي
الوصف اللاحق: نص فقط وCSV دون تغيير
المخرجات: التاريخية مرتبطة بـv1 والمراجعة بـv2

يحفظ السجل السؤالين التحليليين. تعرف البصمات الملفات المستخدمة دون جعل النسخة المحفوظة صحيحة حكماً.

توثيق القواعد منفصل عن الأمثلة الافتراضية

مقارنة حالات وتمارين أخرى

تغير المعرّفات بعد الفتح

يقرأ برنامج العمود كأرقام ويحذف الأصفار الأولية. الرجوع إلى التصدير الخام وتحديد النوع النصي للمفتاح ومراجعة الربط. تنسيق قيمة تغيرت بالفعل لا يعيد دائمًا المعرّف الأصلي.

مراجعة سلسلة تاريخية

يستبدل الملف الجديد قيمًا قديمة أيضًا. المقارنة حسب الفترة والمفتاح وحفظ الإصدارين وقراءة ملاحظات المنتج. التمييز بين التصحيحات والمشاهدات الجديدة قبل وصف اتجاه.

كبر الملف دون تحسن مقاس

أصبحت التغطية تشمل مناطق أو فئات إضافية. مقارنة النطاق المشترك وعرض التوسعة منفصلة. توثيق تغير الحقول والقيم الناقصة بدل افتراض قابلية مقارنة كل الصفوف.

الفصل بين الغياب والتعديل

مثال خيالي: تتغير A من 10 إلى 11، وتختفي B، وتظهر C. باستخدام id كمفتاح، تُحسب إضافة واحدة وحذف واحد وسجل مشترك معدل. يُعرض العمود الجديد منفصلاً دون اختلاق قيمة سابقة له. لا يؤدي تغيير الترتيب وحده إلى تعديلات.

تمرين مع الحل

فصل المراجعة عن الإضافة في الزيادة

مثال افتراضي: القيم والوثائق لتعلم الطريقة ولا تصف مؤسسة حقيقية.

المفتاح فريد والقيم قابلة للجمع والقاموس ثابت دون حذف؛ ويعني الغياب عدم وجود المفتاح في الإصدار.

إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.

المعطيات الأولية
المفتاحالإصدار V1الإصدار V2
A1010
B2025
Cغائب5

ما ينبغي التحقق منه

  1. قارن الصفوف بالمفتاح الدقيق.
  2. افصل مراجعة B عن إضافة C.
  3. طابق الفرق بين الإجماليين.
قراءة الحل

الحل والقرار

مجموع V1 هو 30 وV2 هو 40: زيادة 10. تفسر مراجعة B زيادة 5 ضمن المفاتيح المشتركة، وتضيف C الجديدة 5. تبقى A ثابتة. لا تنسب زيادة الإجمالي 33.33 % بالكامل لنمو العناصر الموجودة سابقاً.

إذا تغيرت الحالة

إذا تغيرت الوحدة أو التعريف في V2، فأوقف التفكيك حتى التحقق من قابلية المقارنة.

السجل الواجب حفظه

احفظ التصديرات والبصمات والقواميس والمفاتيح المضافة والمعدلة وصيغة المطابقة.

الدليل المطلوب حفظه

  • المنتج والرابط والمعلمات العامة والترخيص والتواريخ المنفصلة.
  • الإصدار والبصمة والبنية والوحدات وقواعد القيم الناقصة.
  • التحويلات المرتبة ومفاتيح الربط والحالات غير المحسومة.
  • مقارنة الإصدارات والنتيجة المعاد بناؤها وحدود التفسير.

مراجع رسمية

بروتوكولات ذات صلة

فحوص قبل الاستنتاج

  • هل يحفظ المعرف حروفه وأرقامه بالضبط بعد الاستيراد والتصدير بما فيها الأصفار في البداية؟
  • هل تفصل المقارنة بين تغير القيم والبنية والتغطية بدلاً من اختزال كل اختلاف في عدد الصفوف؟
  • هل يستطيع قارئ آخر إعادة بناء المخرجات من النسخة المحفوظة وترتيب التحويلات الموثق؟

أسئلة شائعة

هل يجب حفظ كل تصدير؟

حفظ الإصدارات اللازمة للعمل والاستنتاجات المنشورة وفق قاعدة محددة. تجنب النسخ بلا غرض واحترام شروط الحفظ وإعادة الاستخدام.

هل تضمن البصمة الجودة؟

لا. تحدد محتوى الملف وتساعد على كشف التغيير لكنها لا تتحقق من المنشأ أو التفسير أو القيم.

هل يمكن دمج صفوف على أساس الاسم؟

فحص المفاتيح والسياق والأسماء المتطابقة أولًا. يجب أن تتعامل القاعدة مع الغموض وأن تسجل الدمج.

كيف تُعرض بيانات مصححة؟

بيان الإصدار والتصحيح وفصل النتيجة المراجعة عن السابقة. عدم تقديم المراجعة باعتبارها رصدًا جديدًا.

لماذا تُرفض المفاتيح المتكررة؟

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

ما الذي يمكن حفظه مع نسخة بيانات؟

الملف، ومصدرها، وتاريخها، ومصطلحها، ووثائق مفيدة. إضافة قواعد المعالجة ومراجعة النتائج المنتجة يسهل التكاثر والمقارنة في وقت لاحق.

مرجع موثق

⁦PROV⁩: نسخة وعملية ومسؤولية

يصف ⁦PROV-O⁩ من ⁦W3C⁩ منشأ البيانات. تتبع الأسهم الخصائص لا ترتيباً زمنياً من اليسار. ⁦E0⁩ و⁦A⁩ و⁦E1⁩ علامات تعليمية.

E0 · EntityA · ActivityE1 · EntityusedwasGeneratedBywasDerivedFrom
⁦PROV⁩: نسخة وعملية ومسؤولية
المرجعالقيمة أو الصيغةما الذي يحدده
prov:Entityبيانات أو وثيقة بحالة موصوفةالكيان بيانات بحالة موصوفة؛ ميز النسخ لا الرابط المتغير فقط.
prov:Activityعملية عبر الزمنالنشاط عملية عبر الزمن لا منتجها.
prov:Agentشخص أو منظمة أو وكيل برمجيالوكيل مسؤولية؛ تربط ⁦wasAttributedTo⁩ الكيان بالوكيل و⁦wasAssociatedWith⁩ النشاط بالوكيل دون إثبات ترخيص.
prov:used⁦Activity⁩ → ⁦Entity⁩تذهب ⁦used⁩ من النشاط للكيان: يستخدم ⁦A⁩ المصدر ⁦E0⁩.
prov:wasGeneratedBy⁦Entity⁩ → ⁦Activity⁩تذهب ⁦wasGeneratedBy⁩ من الكيان للنشاط: أنتج ⁦A⁩ النسخة ⁦E1⁩.
prov:wasDerivedFrom⁦Entity⁩ → ⁦Entity⁩تذهب ⁦wasDerivedFrom⁩ من الناتج للمصدر دون صيغة أو أوزان أو إثبات أمانة.
prov:wasRevisionOf⁦Entity⁩ → ⁦Entity⁩تحتفظ المراجعة بمحتوى جوهري من الأصل؛ ليست كل إحالة مراجعة.
prov:wasQuotedFromEntity → Entityيتكرر مقطع من مصدر أطول. احتفظ بالنص الدقيق وموضعه؛ فالعلاقة وحدها لا تحدد الكلمات.

اقتباس أم ترجمة أم مراجعة؟

توضح أربع حالات افتراضية ضرورة وصف التحويل الفعلي. النتيجة هي موضوع كل علاقة، والمصدر أو الوكيل على يمينها في الصيغة المعروضة من اليسار إلى اليمين.

مقطع منسوخ

quote → prov:wasQuotedFrom → source-v1

يتكرر مقطع من مصدر أطول. احتفظ بالنص الدقيق وموضعه؛ فالعلاقة وحدها لا تحدد الكلمات.

ترجمة

translation → prov:wasDerivedFrom → source-v1

الترجمة كيان مشتق جديد. احتفظ بلغتي المصدر والهدف والنسخة وفحص الأمانة؛ ويجب تمييز النص المترجم عن المقطع الأصلي.

تصحيح الوثيقة

source-v2 → prov:wasRevisionOf → source-v1

تحافظ النسخة المصححة على محتوى جوهري من السابقة. احتفظ بالحالتين والتغييرات؛ فالعلاقة لا تحدد أي نسخة صحيحة.

إسناد النتيجة

analysis → prov:wasAttributedTo → editor

يُنسَب الكيان إلى وكيل. أما مسؤولية العملية فتربط النشاط بالوكيل عبر prov:wasAssociatedWith. لا يثبت الإسناد حقوق إعادة الاستخدام.

يصف المنشأ سلسلة معلنة. لا يجعل الترجمة دليلاً مستقلاً ولا يحول الإسناد إلى تحقق من المحتوى.

ما يُحفظ في الملف

صف المعروف دون اختراع. لا يصادق المنشأ على الحساب أو الحقوق أو الأصالة تلقائياً. احفظ النسخ والمصادر.

هل تكفي ⁦wasDerivedFrom⁩ لإعادة مؤشر؟

لا؛ تلزم النسخ والفلاتر والصيغة والمعلمات وقواعد الغياب.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

مرجع موثق

جمع الأجزاء: التغطية والفجوات وهوية التمثيل

قد يخفي جمع الأطوال المستلمة نقلًا ناقصًا لأن التداخل يعد المواضع نفسها مرات متعددة. يجب حساب اتحاد الفترات ومقارنته بالتمثيل المقصود. يظل هذا الفحص الهندسي منفصلًا عن التحقق من البايتات ومصدرها.

جمع الأجزاء: التغطية والفجوات وهوية التمثيل
المرجعالقيمة أو الصيغةما الذي يحدده
0-399,300-599,700-999Σ = 1000; ∪ = 900عندما يكون ⁦L = 1 000⁩ تجمع الأجزاء ⁦0–399⁩ و⁦300–599⁩ و⁦700–999⁩ ما قدره ⁦1 000⁩ بايت معلن. لكن الاتحاد يغطي 900 موضع فقط: يغيب النطاق ⁦600–699⁩ وتوجد 100 عملية استلام بايت زائدة.
0-499,500-999∪ = 1000تندمج الفترات المتجاورة بلا فجوة: يغطي ⁦0–499⁩ و⁦500–999⁩ عددًا قدره ⁦1 000⁩ موضع. استلام البايت نفسه ثلاث مرات يضيف عمليتي استلام زائدتين، وليس موضعين مختلفين متداخلين.
Content-Rangefirst ≤ last < Lيجب ألا تكون نهاية Content-Range في الرد أصغر من بدايته، ويجب أن يتجاوز الطول الكلي المعلوم النهاية تجاوزًا صارمًا. الطول المجهول المشار إليه بعلامة * لا يتيح استنتاج تغطية كاملة.
ETagstrong validatorيجب أن تنتمي الأجزاء إلى التمثيل نفسه. تشترط RFC 9111 مدققًا قويًا مشتركًا وشروط إعادة الجمع في HTTP عندما تجمع الذاكرة المخبئية ردودًا جزئية. تطابق الرابط أو الحجم لا يغني عن ذلك.
If-Rangestrong comparisonيستخدم If-Range مقارنة قوية لـ ETag. لا يجوز للعميل إرسال ETag ضعيف فيه. إذا فشل الشرط يُتجاهل Range ويُطلب النقل الكامل. لا يُقبل التاريخ إلا وفق شروط المدقق القوي في HTTP.

فحص تغطية الأجزاء

أمثلة تعليمية أصلية؛ ليست قياسات لخادم فعلي.

L عدد صحيح من 1 إلى ⁦1 000 000 000 000⁩. من 1 إلى 20 فترة شاملة بصيغة ⁦a-b⁩، واحدة في كل سطر، ضمن التمثيل. تُهمل الأسطر الفارغة وتُقبل المسافات والجدولة حولها. الحد ⁦2 000⁩ محرف؛ دون ترويسة HTTP.

يُجرى الحساب محليًا في المتصفح؛ لا تُرسل البيانات المدخلة ولا تُحفظ.

تم تحديث الحساب.

مجموع الأطوال المعلنة
1000
المواضع المختلفة المغطاة
900
عمليات استلام البايت الزائدة
100
المواضع المفقودة
100

تغطية حسابية فقط: لا تزال هوية التمثيل وسلامة البايتات بحاجة إلى تحقق.

تغطية التمثيلشريط من اليسار إلى اليمين للمواضع من 0 إلى ⁦L − 1⁩. الأجزاء المصمتة مغطاة والمخططة مفقودة. يعطي الجدول الحدود الدقيقة؛ قد لا تظهر النطاقات الصغيرة جدًا بهذا المقياس.0999
شريط من اليسار إلى اليمين للمواضع من 0 إلى ⁦L − 1⁩. الأجزاء المصمتة مغطاة والمخططة مفقودة. يعطي الجدول الحدود الدقيقة؛ قد لا تظهر النطاقات الصغيرة جدًا بهذا المقياس.
اتحاد الأجزاء
الفترة الشاملةالطول
0–599600
700–999300
الفترات المفقودة
الفترة الشاملةالطول
600–699100

قواعد الحساب

sum = Σ(lastᵢ − firstᵢ + 1)
unique = |∪ intervals|
redundant = sum − unique
missing = L − unique
ثماني حالات تغطية
ثماني حالات تغطية
Lالأجزاء المعلنة (⁦a-b⁩، جزء في كل سطر)مجموع الأطوال المعلنةالمواضع المختلفة المغطاةعمليات استلام البايت الزائدةالمواضع المفقودةالفترات المفقودة
10000–399; 300–599; 700–9991000900100100600–699
10000–499; 500–9991000100000لا يوجد
10000–999; 0–9992000100010000لا يوجد
100–0; 0–0; 0–031291–9
109–9; 0–022081–8
102–7; 3–486240–1; 8–9
10–01100لا يوجد
10000000000000–999999999998; 999999999999–9999999999991000000000000100000000000000لا يوجد

ما يُحفظ في الملف

تفترض التغطية مواضع معلنة في تمثيل واحد. لا تقرأ الأداة ملفات ولا تتحقق من ETag أو Content-Encoding أو الذاكرة المخبئية أو البصمة. لا تثبت تساوي البايتات المتداخلة. التغطية الكاملة ليست شهادة سلامة.

هل يثبت تطابق ETag أصالة الوثيقة؟

لا. ETag مدقق HTTP وليس بالضرورة بصمة تشفيرية أو توقيع المؤلف. تحقق أيضًا من النسخة والأطوال والبايتات المستلمة فعليًا، وسجل أدلة المصدر وفحوص السلامة على نحو منفصل.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

مرجع موثق

JSON Patch: تتبع العمليات على الوثيقة الحالية

تُقيّم قائمة JSON Patch بالترتيب. يشير كل مسار إلى الوثيقة الناتجة عن العمليات السابقة، وليس إلى لقطة ثابتة من الأصل. تبين تسعة مسارات تعليمية أصلية حالات الحساب وشروط التوقف.

JSON Patch: تتبع العمليات على الوثيقة الحالية
المرجعالقيمة أو الصيغةما الذي يحدده
addinsert / replaceتدرج add قيمة عند فهرس المصفوفة وتزيح العناصر اللاحقة، وتضيف الشرطة النهائية بعد آخر عنصر. في الكائن تستبدل add أيضًا عضوًا موجودًا. يجب وجود الحاوية الأم.
remove / replaceexisting targetتتطلب remove وreplace وجود الهدف. يؤدي حذف عنصر مصفوفة إلى إزاحة الفهارس الأعلى نحو اليسار، فيمكن للمسار نفسه أن يشير لاحقًا إلى عنصر آخر.
moveremove → addتحذف move أولًا قيمة from ثم تضيفها في path على الوثيقة المعدلة. يتطلب النقل إلى موضع لاحق استخدام الفهارس الناتجة. يُحظر النقل إلى فرع تابع للموضع نفسه.
copy / testvalue / equalityتضيف copy القيمة دون ربط الموضعين. تقارن test وفق قواعد JSON ولا تكتب شيئًا، ويوقف فشلها التقييم. لا يؤثر ترتيب أعضاء الكائن في المساواة.
HTTP PATCHatomicيوقف الخطأ التسلسل. يشترط HTTP PATCH تطبيق جميع التغييرات كوحدة ذرية: عند فشل الرقعة لا يُطبق أي تغيير. تشرح الحالات الوسيطة الحساب ولا تمثل كتابات اعتُمدت بالفعل.
Content-Typepatch formatيميز Content-Type بين application/json-patch+json وapplication/merge-patch+json. دعم PATCH وحده لا يضمن الصيغتين. قد يمنع شرط HTTP مثل If-Match تعديل إصدار قديم، ولا تستبدله test تلقائيًا.

قراءة تسلسل JSON Patch

أمثلة تعليمية أصلية؛ لا تُعدل أي وثيقة فعلية.

اختر مسارًا وخطوة. تستهدف كل عملية النتيجة السابقة. عند الفشل يعيد القارئ عرض الهدف الأولي لتوضيح ذرية HTTP ولا تُنفذ العمليات اللاحقة.

قراءة مسارات محددة مسبقًا؛ لا تُنفذ رقعة حرة هنا.

الحالة الأولية · 0 / 2

الهدف الأولي

{
    "items": [
        "A",
        "B",
        "C"
    ]
}

العملية

لا توجد عملية في هذه الخطوة.

حالة الحساب

{
    "items": [
        "A",
        "B",
        "C"
    ]
}
تسعة مسارات بجميع حالاتها
الحذف وتغير الفهارس
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "items": [
            "A",
            "B",
            "C"
        ]
    }
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "remove",
        "path": "/items/0"
    }

    حالة الحساب

    {
        "items": [
            "B",
            "C"
        ]
    }
  3. نجح التسلسل

    العملية

    {
        "op": "replace",
        "path": "/items/1",
        "value": "X"
    }

    حالة الحساب

    {
        "items": [
            "B",
            "X"
        ]
    }
الإدراج والإلحاق بالنهاية
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    [
        "A",
        "C"
    ]
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "add",
        "path": "/1",
        "value": "B"
    }

    حالة الحساب

    [
        "A",
        "B",
        "C"
    ]
  3. نجح التسلسل

    العملية

    {
        "op": "add",
        "path": "/-",
        "value": "D"
    }

    حالة الحساب

    [
        "A",
        "B",
        "C",
        "D"
    ]
قيمة null ثم حذفها
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "note": "old",
        "keep": true
    }
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "replace",
        "path": "/note",
        "value": null
    }

    حالة الحساب

    {
        "note": null,
        "keep": true
    }
  3. نجح التسلسل

    العملية

    {
        "op": "remove",
        "path": "/note"
    }

    حالة الحساب

    {
        "keep": true
    }
نسخ دون ربط
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "source": {
            "n": 1
        }
    }
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "copy",
        "from": "/source",
        "path": "/backup"
    }

    حالة الحساب

    {
        "source": {
            "n": 1
        },
        "backup": {
            "n": 1
        }
    }
  3. نجح التسلسل

    العملية

    {
        "op": "replace",
        "path": "/source/n",
        "value": 2
    }

    حالة الحساب

    {
        "source": {
            "n": 2
        },
        "backup": {
            "n": 1
        }
    }
النقل بعد الحذف
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    [
        "A",
        "B",
        "C",
        "D"
    ]
  2. نجح التسلسل

    العملية

    {
        "op": "move",
        "from": "/1",
        "path": "/3"
    }

    حالة الحساب

    [
        "A",
        "C",
        "D",
        "B"
    ]
فشل test والذرية
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "rev": 1,
        "label": "A"
    }
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "replace",
        "path": "/label",
        "value": "B"
    }

    حالة الحساب

    {
        "rev": 1,
        "label": "B"
    }
  3. فشل: لا يطبق HTTP PATCH أي تغيير

    العملية

    {
        "op": "test",
        "path": "/rev",
        "value": 2
    }

    حالة الحساب

    {
        "rev": 1,
        "label": "A"
    }
  4. لم تُنفذ بعد الفشل

    العملية

    {
        "op": "add",
        "path": "/extra",
        "value": true
    }

    حالة الحساب

    {
        "rev": 1,
        "label": "A"
    }
غياب الحاوية الأم
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "a": []
    }
  2. فشل: لا يطبق HTTP PATCH أي تغيير

    العملية

    {
        "op": "add",
        "path": "/missing/x",
        "value": 1
    }

    حالة الحساب

    {
        "a": []
    }
ترميز المسار والجذر
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "a/b": {
            "~key": 1
        }
    }
  2. حالة وسيطة غير معتمدة

    العملية

    {
        "op": "test",
        "path": "/a~1b/~0key",
        "value": 1
    }

    حالة الحساب

    {
        "a/b": {
            "~key": 1
        }
    }
  3. نجح التسلسل

    العملية

    {
        "op": "add",
        "path": "",
        "value": [
            "root"
        ]
    }

    حالة الحساب

    [
        "root"
    ]
add لعضو موجود
  1. الحالة الأولية

    لا توجد عملية في هذه الخطوة.

    حالة الحساب

    {
        "x": 1
    }
  2. نجح التسلسل

    العملية

    {
        "op": "add",
        "path": "/x",
        "value": 2
    }

    حالة الحساب

    {
        "x": 2
    }

ما يُحفظ في الملف

يعرض القارئ مسارات موثقة وليس منفذًا عامًا لـ JSON Patch. لا يتصل بخادم ولا يتنبأ برمز استجابة. الذرية المعروضة تخص HTTP PATCH، وعلى المكتبة المحلية توثيق تعاملها مع الأخطاء وتغيير البيانات.

هل تحدد كلمة PATCH وحدها كيفية معالجة المتن؟

لا. يلزم نوع الوسائط وعقد المورد. يمكن لـ Accept-Patch إعلان الصيغ المقبولة. لا يثبت اسم الطريقة أو مثال محلي أن API البعيد يقبل الصيغة أو يسمح بالتعديل.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

مرجع موثق

SemVer: مقارنة الأسبقية دون افتراض الهوية

تحدد SemVer 2.0.0 بنية الإصدارات وأسبقيتها لبرمجيات تعلن API عامة. تؤدي مقارنتها كسلاسل عادية أو أعداد عشرية إلى أخطاء. لا يتبنى تاريخ مجموعة بيانات أو اسم وسم هذا العقد تلقائيًا.

SemVer: مقارنة الأسبقية دون افتراض الهوية
المرجعالقيمة أو الصيغةما الذي يحدده
MAJOR.MINOR.PATCH0 | [1-9][0-9]*يتألف الأساس من ثلاثة أعداد صحيحة غير سالبة: ⁦MAJOR.MINOR.PATCH⁩. تُمنع الأصفار البادئة باستثناء 0 وحده. قد يدل الوسم v1.2.3 على إصدار، لكن سلسلته الكاملة ليست إصدار SemVer صارمًا.
1.9.0 / 1.10.0numericتُقارن أعداد الأساس عدديًا من اليسار إلى اليمين، لذا تسبق 1.9.0 الإصدار 1.10.0. لا تحد SemVer طول العدد؛ تقارن الأداة الأرقام دون تحويل إلى فاصلة عائمة.
-alpha.1pre-releaseعند تساوي الأساس يسبق الإصدار التمهيدي الإصدار العادي. لا يجوز أن تكون معرفاته المفصولة بنقاط فارغة. يمنع المعرف العددي البحت الأصفار البادئة، بينما يخضع المعرف المحتوي على حرف أو شرطة لحالة أخرى.
-2 / -alphanumeric < non-numericتُقارن المعرفات العددية عدديًا وغيرها بترتيب ASCII. يسبق المعرف العددي غير العددي. وعند تساوي المعرفات المشتركة تكون الأسبقية للتمهيدي ذي المعرفات الأكثر.
+001ignored in precedenceلا تؤثر بيانات البناء بعد + في الأسبقية إطلاقًا. وقد تحتوي على 001 خلافًا لمعرفات التمهيدي العددية. لذلك قد تتساوى أسبقية سلسلتين مختلفتين دون أن تحددا ملفين متطابقين أو منتجين قابلين للتبادل.

مقارنة إصدارين وفق SemVer

أمثلة تعليمية أصلية؛ لا يُقيَّم أي إصدار فعلي.

إصداران صارمان وفق SemVer 2.0.0، بحد 256 محرف ASCII لكل منهما. دون مسافات أو بادئة v أو معاملات قيود. تُقارن المعرفات العددية بدقة دون تقريب.

حساب محلي في المتصفح؛ لا يُرسل الإدخال ولا يُحفظ.

يسبق A الإصدار B في ترتيب SemVer.

1.9.0 < 1.10.0

أول معيار حاسم : MINOR

مكونات الإصدارين
المكونالإصدار Aالإصدار B
MAJOR11
MINOR910
PATCH00
الإصدار التمهيديلا يوجدلا يوجد
بيانات البناءلا يوجدلا يوجد
عشر مقارنات أسبقية
عشر مقارنات أسبقية
الإصدار A< / = / >الإصدار Bأول معيار حاسم
1.9.0<1.10.0MINOR
2.0.0>1.99.99MAJOR
1.0.9<1.0.10PATCH
1.2.3-rc.9<1.2.3تمهيدي مقابل إصدار عادي
1.2.3-alpha.2<1.2.3-alpha.11معرف تمهيدي
1.2.3-9<1.2.3-alphaمعرف تمهيدي
1.2.3-alpha<1.2.3-alpha.0عدد المعرفات التمهيدية
1.2.3-Beta<1.2.3-alphaمعرف تمهيدي
1.2.3+linux.001=1.2.3+windows.002بيانات البناء مستبعدة من الأسبقية
9007199254740992.0.0<9007199254740993.0.0MAJOR
عشر حالات للبنية الصارمة
عشر حالات للبنية الصارمة
الإدخالالتشخيص
1.2.3صحيح
0.0.0-0صحيح
1.2.3+001صحيح
1.2.3-01aصحيح
1.2.3--صحيح
v1.2.3غير صحيح
1.02.3غير صحيح
1.2.3-01غير صحيح
1.2.3-alpha..1غير صحيح
1.2.3+غير صحيح

تفسير وأمثلة أصلية وفق SemVer 2.0.0 التي كتبها أولًا Tom Preston-Werner؛ النص المرجعي بترخيص CC BY 3.0. SemVer 2.0.0 · CC BY 3.0

متابعة الفحص

ما يُحفظ في الملف

يفحص المقارن البنية والأسبقية ولا يفحص ملاحظات الإصدار أو المحتوى أو الأمان أو التوافق الفعلي. لا يعالج قيود الاعتماديات أو نطاقات npm أو إصدارات Python وDebian. حد 256 محرفًا يخص النموذج وليس SemVer.

هل تُدمج الإصدارات متساوية الأسبقية في الجرد؟

ليس تلقائيًا. احتفظ بالسلسلة الكاملة ومرجع المنتج؛ تتساوى أسبقية 1.2.3+linux و1.2.3+windows لكن بيانات البناء قد تميز البناءين. تبقى البصمة وعقد النشر فحصين مستقلين.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

قراءة موسعة / تطبيق عملي

حفظ الاختلافات بين نسخ مجموعة البيانات

يتم استبدال ملف عام في نفس الموقع. يجب أن يسمح النسخ باستعادة الحالة المستخدمة في الحساب وفهم التغييرات اللاحقة.

آخر تحديث في .

الفحوص ذات الأولوية

الحفاظ على الملف، التاريخ، المصدر، بصمات الطابع والنمط. مقارنة الخطوط والأعمدة والتعريفات والقيم قبل تخصيص الاختلافات لتطور الظاهرة المقياس.

أخطاء التفسير

تاريخ تحميل جديد لا يعني بالضرورة محتوى جديد. يمكن أن يجعل تغيير الهيكل مقارنة قاسية صعبة التفسير.

وثيقة العمل التي ينبغي حفظها

مجلة الإصدارات تجمع بين حالة، بصمات، التغيير، وتأثير على التحليلات. وتشير الحسابات بوضوح إلى النسخة المستخدمة.