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

رسم توضيحي مولّد بالذكاء الاصطناعي
رابط إلى قاعدة متغيرة لا يحدد البيانات المستخدمة فعلًا. قد يراجع تصحيح سلسلة قديمة، أو يفقد التصدير أصفارًا أولية، أو يغيّر عمود جديد معنى المجموع. يشرح الإصدار المفيد المادة الأولية وطريق المعالجة. الهدف إعادة إنتاج العمل الموصوف لا تقديم ضمان شامل لجودة المصدر.
تسمية المنتج والمجموعة والمنطقة والسكان والفترة والفلاتر. فصل تاريخ الرصد والنشر والتنزيل. ملف مستلم اليوم قد يصف فترة قديمة. تسجيل السؤال والاستبعادات المهمة للتفسير.
تسجيل الرابط أو المعلمات العامة وتاريخ الاسترجاع والملف عند السماح بذلك. منح معرّف إصدار وحساب بصمة للملف. تساعد البصمة في تمييز المحتوى لكنها لا تثبت صحة القيم. حفظ معلومات الترخيص.
توثيق الحقول والأنواع والوحدات والمفاتيح والقيم الناقصة. في CSV فحص الفاصل والترميز وعلامات الاقتباس ونهايات الأسطر حسب التصدير الفعلي. حفظ المعرّفات ذات الأصفار الأولية كنص. التمييز بين صفر وقيمة مفقودة وغير منطبقة.
تسجيل التصفية والتوحيد والربط والتحويل وإزالة التكرار بالترتيب. فصل المدخل الخام والمخرج المجهز. الاحتفاظ بمفاتيح الربط والحالات غير المحسومة. اسم مشابه لا يكفي لدمج كيانين. توثيق القرارات بدل إخفائها في الملف النهائي.
قياس الصفوف المضافة والمحذوفة والمعدلة وفق مفتاح ثابت إن وجد. فحص البنية والوحدات والتعريفات أيضًا. تغير عدد الصفوف لا يثبت تغير الظاهرة؛ قد ينتج من فلاتر أو تغطية أو مراجعة المنتج.
ربط النتيجة بإصدار المصدر والخطوات والحدود. فحص روابط المنتج والسياق. إعداد جمع جديد بمعايير مقارنة. حفظ إصدار قديم منفصلًا إذا أسند استنتاجًا منشورًا مع احترام الشروط والبيانات التي يحتويها.
ورشة قراءة البيانات
مجموعة DEMO افتراضية. تفصل إصداراتها تحليلاً تاريخياً عن تحليل يستخدم البيانات المصححة.
بيانات وسجلات افتراضية للتعلم: لا تأتي هذه النتائج من استعلام مباشر لأي خدمة.
يحمل الملفان المفتاح والفترة نفسيهما. ينشر المنتج الافتراضي ملاحظة تصحيح. لا يغير تعديل لاحق لوصف الفهرس ملف CSV.
إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.
| الحالة الافتراضية | الوثيقة المتاحة | ما يتغير | الاستخدام المعلن |
|---|---|---|---|
| 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 |
|---|---|---|
| A | 10 | 10 |
| B | 20 | 25 |
| C | غائب | 5 |
مجموع V1 هو 30 وV2 هو 40: زيادة 10. تفسر مراجعة B زيادة 5 ضمن المفاتيح المشتركة، وتضيف C الجديدة 5. تبقى A ثابتة. لا تنسب زيادة الإجمالي 33.33 % بالكامل لنمو العناصر الموجودة سابقاً.
إذا تغيرت الوحدة أو التعريف في V2، فأوقف التفكيك حتى التحقق من قابلية المقارنة.
احفظ التصديرات والبصمات والقواميس والمفاتيح المضافة والمعدلة وصيغة المطابقة.
حفظ الإصدارات اللازمة للعمل والاستنتاجات المنشورة وفق قاعدة محددة. تجنب النسخ بلا غرض واحترام شروط الحفظ وإعادة الاستخدام.
لا. تحدد محتوى الملف وتساعد على كشف التغيير لكنها لا تتحقق من المنشأ أو التفسير أو القيم.
فحص المفاتيح والسياق والأسماء المتطابقة أولًا. يجب أن تتعامل القاعدة مع الغموض وأن تسجل الدمج.
بيان الإصدار والتصحيح وفصل النتيجة المراجعة عن السابقة. عدم تقديم المراجعة باعتبارها رصدًا جديدًا.
يجعل صفان بالمعرّف نفسه المطابقة ملتبسة. افحص مستوى التفصيل والفترة والمنشأ وحدد مفتاحاً مركباً عند الحاجة. لا تحذف صفاً قبل التمييز بين التكرار والمشاهدة المستقلة.
الملف، ومصدرها، وتاريخها، ومصطلحها، ووثائق مفيدة. إضافة قواعد المعالجة ومراجعة النتائج المنتجة يسهل التكاثر والمقارنة في وقت لاحق.
مرجع موثق
يصف PROV-O من W3C منشأ البيانات. تتبع الأسهم الخصائص لا ترتيباً زمنياً من اليسار. E0 وA وE1 علامات تعليمية.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| 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:wasQuotedFrom | Entity → Entity | يتكرر مقطع من مصدر أطول. احتفظ بالنص الدقيق وموضعه؛ فالعلاقة وحدها لا تحدد الكلمات. |
توضح أربع حالات افتراضية ضرورة وصف التحويل الفعلي. النتيجة هي موضوع كل علاقة، والمصدر أو الوكيل على يمينها في الصيغة المعروضة من اليسار إلى اليمين.
quote → prov:wasQuotedFrom → source-v1
يتكرر مقطع من مصدر أطول. احتفظ بالنص الدقيق وموضعه؛ فالعلاقة وحدها لا تحدد الكلمات.
translation → prov:wasDerivedFrom → source-v1
الترجمة كيان مشتق جديد. احتفظ بلغتي المصدر والهدف والنسخة وفحص الأمانة؛ ويجب تمييز النص المترجم عن المقطع الأصلي.
source-v2 → prov:wasRevisionOf → source-v1
تحافظ النسخة المصححة على محتوى جوهري من السابقة. احتفظ بالحالتين والتغييرات؛ فالعلاقة لا تحدد أي نسخة صحيحة.
analysis → prov:wasAttributedTo → editor
يُنسَب الكيان إلى وكيل. أما مسؤولية العملية فتربط النشاط بالوكيل عبر prov:wasAssociatedWith. لا يثبت الإسناد حقوق إعادة الاستخدام.
يصف المنشأ سلسلة معلنة. لا يجعل الترجمة دليلاً مستقلاً ولا يحول الإسناد إلى تحقق من المحتوى.
صف المعروف دون اختراع. لا يصادق المنشأ على الحساب أو الحقوق أو الأصالة تلقائياً. احفظ النسخ والمصادر.
لا؛ تلزم النسخ والفلاتر والصيغة والمعلمات وقواعد الغياب.
تاريخ الاطلاع على الوثائق .
مرجع موثق
قد يخفي جمع الأطوال المستلمة نقلًا ناقصًا لأن التداخل يعد المواضع نفسها مرات متعددة. يجب حساب اتحاد الفترات ومقارنته بالتمثيل المقصود. يظل هذا الفحص الهندسي منفصلًا عن التحقق من البايتات ومصدرها.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| 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-Range | first ≤ last < L | يجب ألا تكون نهاية Content-Range في الرد أصغر من بدايته، ويجب أن يتجاوز الطول الكلي المعلوم النهاية تجاوزًا صارمًا. الطول المجهول المشار إليه بعلامة * لا يتيح استنتاج تغطية كاملة. |
| ETag | strong validator | يجب أن تنتمي الأجزاء إلى التمثيل نفسه. تشترط RFC 9111 مدققًا قويًا مشتركًا وشروط إعادة الجمع في HTTP عندما تجمع الذاكرة المخبئية ردودًا جزئية. تطابق الرابط أو الحجم لا يغني عن ذلك. |
| If-Range | strong comparison | يستخدم If-Range مقارنة قوية لـ ETag. لا يجوز للعميل إرسال ETag ضعيف فيه. إذا فشل الشرط يُتجاهل Range ويُطلب النقل الكامل. لا يُقبل التاريخ إلا وفق شروط المدقق القوي في HTTP. |
أمثلة تعليمية أصلية؛ ليست قياسات لخادم فعلي.
L عدد صحيح من 1 إلى 1 000 000 000 000. من 1 إلى 20 فترة شاملة بصيغة a-b، واحدة في كل سطر، ضمن التمثيل. تُهمل الأسطر الفارغة وتُقبل المسافات والجدولة حولها. الحد 2 000 محرف؛ دون ترويسة HTTP.
يُجرى الحساب محليًا في المتصفح؛ لا تُرسل البيانات المدخلة ولا تُحفظ.
تم تحديث الحساب.
تغطية حسابية فقط: لا تزال هوية التمثيل وسلامة البايتات بحاجة إلى تحقق.
| الفترة الشاملة | الطول |
|---|---|
| 0–599 | 600 |
| 700–999 | 300 |
| الفترة الشاملة | الطول |
|---|---|
| 600–699 | 100 |
sum = Σ(lastᵢ − firstᵢ + 1) unique = |∪ intervals| redundant = sum − unique missing = L − unique
| L | الأجزاء المعلنة (a-b، جزء في كل سطر) | مجموع الأطوال المعلنة | المواضع المختلفة المغطاة | عمليات استلام البايت الزائدة | المواضع المفقودة | الفترات المفقودة |
|---|---|---|---|---|---|---|
| 1000 | 0–399; 300–599; 700–999 | 1000 | 900 | 100 | 100 | 600–699 |
| 1000 | 0–499; 500–999 | 1000 | 1000 | 0 | 0 | لا يوجد |
| 1000 | 0–999; 0–999 | 2000 | 1000 | 1000 | 0 | لا يوجد |
| 10 | 0–0; 0–0; 0–0 | 3 | 1 | 2 | 9 | 1–9 |
| 10 | 9–9; 0–0 | 2 | 2 | 0 | 8 | 1–8 |
| 10 | 2–7; 3–4 | 8 | 6 | 2 | 4 | 0–1; 8–9 |
| 1 | 0–0 | 1 | 1 | 0 | 0 | لا يوجد |
| 1000000000000 | 0–999999999998; 999999999999–999999999999 | 1000000000000 | 1000000000000 | 0 | 0 | لا يوجد |
تفترض التغطية مواضع معلنة في تمثيل واحد. لا تقرأ الأداة ملفات ولا تتحقق من ETag أو Content-Encoding أو الذاكرة المخبئية أو البصمة. لا تثبت تساوي البايتات المتداخلة. التغطية الكاملة ليست شهادة سلامة.
لا. ETag مدقق HTTP وليس بالضرورة بصمة تشفيرية أو توقيع المؤلف. تحقق أيضًا من النسخة والأطوال والبايتات المستلمة فعليًا، وسجل أدلة المصدر وفحوص السلامة على نحو منفصل.
تاريخ الاطلاع على الوثائق .
مرجع موثق
تُقيّم قائمة JSON Patch بالترتيب. يشير كل مسار إلى الوثيقة الناتجة عن العمليات السابقة، وليس إلى لقطة ثابتة من الأصل. تبين تسعة مسارات تعليمية أصلية حالات الحساب وشروط التوقف.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| add | insert / replace | تدرج add قيمة عند فهرس المصفوفة وتزيح العناصر اللاحقة، وتضيف الشرطة النهائية بعد آخر عنصر. في الكائن تستبدل add أيضًا عضوًا موجودًا. يجب وجود الحاوية الأم. |
| remove / replace | existing target | تتطلب remove وreplace وجود الهدف. يؤدي حذف عنصر مصفوفة إلى إزاحة الفهارس الأعلى نحو اليسار، فيمكن للمسار نفسه أن يشير لاحقًا إلى عنصر آخر. |
| move | remove → add | تحذف move أولًا قيمة from ثم تضيفها في path على الوثيقة المعدلة. يتطلب النقل إلى موضع لاحق استخدام الفهارس الناتجة. يُحظر النقل إلى فرع تابع للموضع نفسه. |
| copy / test | value / equality | تضيف copy القيمة دون ربط الموضعين. تقارن test وفق قواعد JSON ولا تكتب شيئًا، ويوقف فشلها التقييم. لا يؤثر ترتيب أعضاء الكائن في المساواة. |
| HTTP PATCH | atomic | يوقف الخطأ التسلسل. يشترط HTTP PATCH تطبيق جميع التغييرات كوحدة ذرية: عند فشل الرقعة لا يُطبق أي تغيير. تشرح الحالات الوسيطة الحساب ولا تمثل كتابات اعتُمدت بالفعل. |
| Content-Type | patch format | يميز Content-Type بين application/json-patch+json وapplication/merge-patch+json. دعم PATCH وحده لا يضمن الصيغتين. قد يمنع شرط HTTP مثل If-Match تعديل إصدار قديم، ولا تستبدله test تلقائيًا. |
أمثلة تعليمية أصلية؛ لا تُعدل أي وثيقة فعلية.
اختر مسارًا وخطوة. تستهدف كل عملية النتيجة السابقة. عند الفشل يعيد القارئ عرض الهدف الأولي لتوضيح ذرية HTTP ولا تُنفذ العمليات اللاحقة.
قراءة مسارات محددة مسبقًا؛ لا تُنفذ رقعة حرة هنا.
الحالة الأولية · 0 / 2
{
"items": [
"A",
"B",
"C"
]
}nullلا توجد عملية في هذه الخطوة.
{
"items": [
"A",
"B",
"C"
]
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"items": [
"A",
"B",
"C"
]
}حالة وسيطة غير معتمدة
{
"op": "remove",
"path": "/items/0"
}{
"items": [
"B",
"C"
]
}نجح التسلسل
{
"op": "replace",
"path": "/items/1",
"value": "X"
}{
"items": [
"B",
"X"
]
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
[
"A",
"C"
]حالة وسيطة غير معتمدة
{
"op": "add",
"path": "/1",
"value": "B"
}[
"A",
"B",
"C"
]نجح التسلسل
{
"op": "add",
"path": "/-",
"value": "D"
}[
"A",
"B",
"C",
"D"
]الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"note": "old",
"keep": true
}حالة وسيطة غير معتمدة
{
"op": "replace",
"path": "/note",
"value": null
}{
"note": null,
"keep": true
}نجح التسلسل
{
"op": "remove",
"path": "/note"
}{
"keep": true
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"source": {
"n": 1
}
}حالة وسيطة غير معتمدة
{
"op": "copy",
"from": "/source",
"path": "/backup"
}{
"source": {
"n": 1
},
"backup": {
"n": 1
}
}نجح التسلسل
{
"op": "replace",
"path": "/source/n",
"value": 2
}{
"source": {
"n": 2
},
"backup": {
"n": 1
}
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
[
"A",
"B",
"C",
"D"
]نجح التسلسل
{
"op": "move",
"from": "/1",
"path": "/3"
}[
"A",
"C",
"D",
"B"
]الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"rev": 1,
"label": "A"
}حالة وسيطة غير معتمدة
{
"op": "replace",
"path": "/label",
"value": "B"
}{
"rev": 1,
"label": "B"
}فشل: لا يطبق HTTP PATCH أي تغيير
{
"op": "test",
"path": "/rev",
"value": 2
}{
"rev": 1,
"label": "A"
}لم تُنفذ بعد الفشل
{
"op": "add",
"path": "/extra",
"value": true
}{
"rev": 1,
"label": "A"
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"a": []
}فشل: لا يطبق HTTP PATCH أي تغيير
{
"op": "add",
"path": "/missing/x",
"value": 1
}{
"a": []
}الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"a/b": {
"~key": 1
}
}حالة وسيطة غير معتمدة
{
"op": "test",
"path": "/a~1b/~0key",
"value": 1
}{
"a/b": {
"~key": 1
}
}نجح التسلسل
{
"op": "add",
"path": "",
"value": [
"root"
]
}[
"root"
]الحالة الأولية
لا توجد عملية في هذه الخطوة.
{
"x": 1
}نجح التسلسل
{
"op": "add",
"path": "/x",
"value": 2
}{
"x": 2
}يعرض القارئ مسارات موثقة وليس منفذًا عامًا لـ JSON Patch. لا يتصل بخادم ولا يتنبأ برمز استجابة. الذرية المعروضة تخص HTTP PATCH، وعلى المكتبة المحلية توثيق تعاملها مع الأخطاء وتغيير البيانات.
لا. يلزم نوع الوسائط وعقد المورد. يمكن لـ Accept-Patch إعلان الصيغ المقبولة. لا يثبت اسم الطريقة أو مثال محلي أن API البعيد يقبل الصيغة أو يسمح بالتعديل.
تاريخ الاطلاع على الوثائق .
مرجع موثق
تحدد SemVer 2.0.0 بنية الإصدارات وأسبقيتها لبرمجيات تعلن API عامة. تؤدي مقارنتها كسلاسل عادية أو أعداد عشرية إلى أخطاء. لا يتبنى تاريخ مجموعة بيانات أو اسم وسم هذا العقد تلقائيًا.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| MAJOR.MINOR.PATCH | 0 | [1-9][0-9]* | يتألف الأساس من ثلاثة أعداد صحيحة غير سالبة: MAJOR.MINOR.PATCH. تُمنع الأصفار البادئة باستثناء 0 وحده. قد يدل الوسم v1.2.3 على إصدار، لكن سلسلته الكاملة ليست إصدار SemVer صارمًا. |
| 1.9.0 / 1.10.0 | numeric | تُقارن أعداد الأساس عدديًا من اليسار إلى اليمين، لذا تسبق 1.9.0 الإصدار 1.10.0. لا تحد SemVer طول العدد؛ تقارن الأداة الأرقام دون تحويل إلى فاصلة عائمة. |
| -alpha.1 | pre-release | عند تساوي الأساس يسبق الإصدار التمهيدي الإصدار العادي. لا يجوز أن تكون معرفاته المفصولة بنقاط فارغة. يمنع المعرف العددي البحت الأصفار البادئة، بينما يخضع المعرف المحتوي على حرف أو شرطة لحالة أخرى. |
| -2 / -alpha | numeric < non-numeric | تُقارن المعرفات العددية عدديًا وغيرها بترتيب ASCII. يسبق المعرف العددي غير العددي. وعند تساوي المعرفات المشتركة تكون الأسبقية للتمهيدي ذي المعرفات الأكثر. |
| +001 | ignored in precedence | لا تؤثر بيانات البناء بعد + في الأسبقية إطلاقًا. وقد تحتوي على 001 خلافًا لمعرفات التمهيدي العددية. لذلك قد تتساوى أسبقية سلسلتين مختلفتين دون أن تحددا ملفين متطابقين أو منتجين قابلين للتبادل. |
أمثلة تعليمية أصلية؛ لا يُقيَّم أي إصدار فعلي.
إصداران صارمان وفق SemVer 2.0.0، بحد 256 محرف ASCII لكل منهما. دون مسافات أو بادئة v أو معاملات قيود. تُقارن المعرفات العددية بدقة دون تقريب.
حساب محلي في المتصفح؛ لا يُرسل الإدخال ولا يُحفظ.
يسبق A الإصدار B في ترتيب SemVer.
1.9.0 < 1.10.0
أول معيار حاسم : MINOR
| المكون | الإصدار A | الإصدار B |
|---|---|---|
| MAJOR | 1 | 1 |
| MINOR | 9 | 10 |
| PATCH | 0 | 0 |
| الإصدار التمهيدي | لا يوجد | لا يوجد |
| بيانات البناء | لا يوجد | لا يوجد |
| الإصدار A | < / = / > | الإصدار B | أول معيار حاسم |
|---|---|---|---|
| 1.9.0 | < | 1.10.0 | MINOR |
| 2.0.0 | > | 1.99.99 | MAJOR |
| 1.0.9 | < | 1.0.10 | PATCH |
| 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.0 | MAJOR |
| الإدخال | التشخيص |
|---|---|
| 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 لكن بيانات البناء قد تميز البناءين. تبقى البصمة وعقد النشر فحصين مستقلين.
تاريخ الاطلاع على الوثائق .
قراءة موسعة / تطبيق عملي
يتم استبدال ملف عام في نفس الموقع. يجب أن يسمح النسخ باستعادة الحالة المستخدمة في الحساب وفهم التغييرات اللاحقة.
آخر تحديث في .
الحفاظ على الملف، التاريخ، المصدر، بصمات الطابع والنمط. مقارنة الخطوط والأعمدة والتعريفات والقيم قبل تخصيص الاختلافات لتطور الظاهرة المقياس.
تاريخ تحميل جديد لا يعني بالضرورة محتوى جديد. يمكن أن يجعل تغيير الهيكل مقارنة قاسية صعبة التفسير.
مجلة الإصدارات تجمع بين حالة، بصمات، التغيير، وتأثير على التحليلات. وتشير الحسابات بوضوح إلى النسخة المستخدمة.