دورة حياة SIM: الملفات، الإصدار والتقارب

OmniWeb هو نظام السجل لعقار SIM. أنت تعرف ملفًا، ثم تصدر بطاقات بناءً عليه، ثم تطبع الناقلات، وبعد ذلك تدير تلك البطاقات عبر الهواء لبقية حياتها.

الفكرة التنظيمية هي أن ملف الإصدار هو الحالة المرغوبة. نفس الأداة المصدرة التي صنعت بطاقة هي التي يعود OmniWeb لتقارب تلك البطاقة إليها. يتبع ذلك شيئين، وهما سبب التصميم:

• يصبح OTA محرك اختلافات. قم بنشر إصدار جديد من الملف، وكل بطاقة صدرت ضد إصدار أقدم تكون، بحكم التعريف، خلفه. لا تحتاج إلى كتابة نصوص التحديث يدويًا.
• الأساس معروف، وليس مُخمنًا. لا يحتاج OmniWeb إلى قراءة بطاقة لمعرف�� ما هو موجود عليها، لأن OmniWeb وضعه هناك. قراءة البطاقة مرة أخرى هي تدقيق: خطوة تحقق تقوم بها عندما تريد دليلاً، وليست شرطًا مسبقًا لكل كتابة.

تتناول هذه الصفحة مراحل التعريف والإصدار والتقارب. مرحلة التسليم - الحزم المؤمنة التي تحمل تغييرًا إلى بطاقة - موثقة في إدارة SIM OTA. إصدار eSIM موثق في eSIM (SGP.22).

---

دورة الحياة

تحتوي سجل البطاقة على مؤشرين للإصدارات:

المؤشر	المعنى
إصدار مُصدر	إصدار المل�� الذي تم فلاش الشريحة به عند التصنيع.
إصدار مُطبق	الإصدار الذي يعتقد OmniWeb أنه موجود على البطاقة الآن.
إصدار مستهدف	الإصدار الحالي المنشور للملف. مشتق، وليس مخزنًا.

تكون البطاقة خلف عندما يكون إصدارها المُطبق أقل من الإصدار المستهدف. يعزز التقارب الإصدار المُطبق، وفقط بعد عملية نظيفة وموثقة.

---

أين تجدها

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

الصفحة	المسار	الغرض منها
ملفات SIM	/sim-profiles	تعريف ما يجب أن تحتويه البطاقة. إصدارها. نشرها.
منتجات البطاقة	/card-products	تسجيل كيفية معالجة شريحة عبر كل ناقل.
دفعات	/sim-batches	طلب بطاقات، تخصيص هويات، تبادل الملفات مع البائع والطابعة.
العقار	/sim-estate	كل بطاقة تم إصدارها، وأي منها خلف.
التقارب	/ota/sync	الحملات التي تعيد البطاقات إلى الخطوة، وانجراف الأسطول.

---

منتجات البطاقة

منتج البطاقة هو نوع بطاقة يمكنك طلبه: خط منتج مادي، أو منتج eSIM. يحمل عنوان OTA لكل بطاقة مصنوعة عليه.

تعتبر العناوين مهمة لأن نفس عملية الملف تحتاج إلى عناوين مختلفة على شرائح مختلفة، وعلى نفس الشريحة عبر ناقلات مختلفة. يقوم SMS المؤمّن بالتوجيه على TAR؛ جلسة إدارة HTTP تسمي التطبيق بواسطة AID الخاص به. يجيب تطبيق واحد على فئة أمر GSM، ويجيب آخر على فئة UICC. تقبل بطاقة واحدة نص أمر موسع فقط في شكلها المحدد الطول، ولا ترد على الإطلاق على الشكل غير المحدد. أي من تلك الأخطاء يبدو متطابقًا من مقعد المشغل: بطاقة تجاهلتك.

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

حقول المنتج

الحقل	الوصف
name	اسم المنتج، كما تطلبه. فريد.
vendor	الشركة المصنعة للبطاقة.
form	physical لبطاقة بلاستيكية، esim لمنتج eSIM.
atr_hint	الإجابة على إعادة تعيين يتوقع أن تعطيها هذه المنتج. يقارن العقار بها مع ATR المقروء من البطاقة.
platform_notes	نص حر. سجل أي شيء تفعله المنصة لا تقوله ورقة البيانات الخاصة بها.

عنوان الناقل

يحمل المنتج صفًا واحدًا لكل تطبيق يمكن الوصول إليه لكل ناقل. صف واحد لكل ناقل هو الافتراضي.

الحقل	الوصف
bearer	SMS (SCP80) أو HTTP (SCP81).
label	اسم لهذا التطبيق، على سبيل المثال rfm-gsm.
is_default	ما إذا كانت هذه الصف هي المستخدمة عندما لا يتم اختيار أي شيء آخر.
enabled	ما إذا كانت هذه الصف يمكن استخدامها على الإطلاق.
tar	مرجع تطبيق Toolkit المكون من 3 باي�� الذي يتجه عليه SMS المؤمّن.
rfm_aid	AID الخاص بتطبيق RFM، الذي تسميه جلسة HTTP مباشرة. عندما يتم تسجيل AID فقط، يتم قراءة TAR منه.
cla	فئة الأمر التي يجيب عليها التطبيق: 00 لـ UICC، A0 لـ GSM. يتماشى التطبيق والفئة معًا.
remote_format	compact، expanded_definite أو expanded_indefinite.
keyset_index	أي مجموعة مفاتيح OTA (1، 2 أو 3) على البطاقة يستخدمها هذا التطبيق.
tls_kvn / tls_kid	أي مجموعة مفاتيح على البطاقة تحمل مفتاح TLS المشترك مسبقًا لجلسات HTTP.
reachable_paths	أي أشجار ملفات يمكن لهذا التطبيق الوصول إليها، كأسبقية مسار. تعني فارغة غير معروفة أو غير مقيدة.

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

---

ملفات SIM والإصدارات

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

لا تخلط بين ملف SIM و ملف OTA. ملف OTA هو إعداد أمان - TAR، مجموعة المفاتيح، الخوارزميات، مستوى الأمان - وهو موثق في إدارة SIM OTA.

حالة الملف	المعنى
draft	قيد الكتابة. لم يتم استخدامه بعد للإصدار.
active	في الخدمة. يتم طلب دفعات جديدة ضد الإصدار الحالي له.
retired	لم يعد يُصدر. تحتفظ البطاقات الموجودة بالفعل في الميدان بملفها.

الإصدارات

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

النشر يقوم بثلاثة أشياء، وهو اتجاه واحد:

1. يقوم بفهرسة كل ملف في الملف، بحيث يمكن مقارنة إصدار لاحق ضده.
2. يقوم بتأسيس سياسة الملف لذلك الإصدار.
3. يصبح الإصدار الحالي للملف، مما يجع�� كل بطاقة أدناه خلف.

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

استخدم Diff لرؤية ما ستغيره حملة بين إصدارين منشورين، ملفًا بملف، قبل أن تنشر أو تصف أي شيء.

سياسة الملف

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

النوع	المعنى	هل تكتبها الحملة؟
fixed	نفس الشيء على كل بطاقة صدرت ضد هذا الإصدار. اسم مشغل، قائمة PLMN، جدول خدمات.	نعم، عندما تُدار بواسطة OTA.
personalized	مختلفة على كل بطاقة. ICCID، IMSI، MSISDN، PIN. تأتي من سجل الإصدار.	لا.
card_owned	البطاقة تكتبها بنفسها. معلومات الموقع، قوائم PLMN المحظورة، العدادات.	لا.

تحمل كل صف أيضًا مفتاح م��ار بواسطة OTA. يمكن أن يكون الملف قابلًا للكتابة بواسطة حملة فقط عندما يكون fixed و مدار بواسطة OTA. كل شيء آخر هو قراءة فقط، وهو ما يمنع عملية التقارب من إعادة تعيين حالة المشترك الخاصة أو الكتابة فوق هوية.

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

هناك قاعدتان تستحقان أن تُذكر بوضوح:

• لا تدع حملة تكتب ICCID البطاقة. ICCID هو كيفية معالجة النظام بالكامل للبطاقة، وهو الهوية التي يتطابق عليها مفتاح TLS المشترك مسبقًا. تثبت السياسة المزروعة ذلك.
• تصحيح مشغل لصف سياسة يبقى بعد إعادة الزرع. إذا قمت بإعادة تصنيف ملف، فإنه يبقى معاد تصنيفه.

---

الإصدار: الدفعا��

الدفعة هي أمر إنتاج: N بطاقات مصنعة ضد إصدار ملف منشور واحد.

طلب دفعة

الحقل	الوصف
اسم الدفعة	اسمك لهذه العملية الإنتاجية.
إصدار الملف	الإصدار المنشور الذي تم فلاش البطاقات به. لا يتم عرض الإصدارات المسودة.
العميل	لمن البطاقات.
البائع	من يصنعها.
مرجع الطلب / مرجع PO	مراجعك التجارية، لمطابقة الأوراق لاحقًا.
الكمية	عدد البطاقات.
أول ICCID	أول ICCID في السلسلة.
أول IMSI	أول IMSI في السلسلة.
أول MSISDN	أول MSISDN في السلسلة، عندما تحمل الدفعة أرقامًا.
ملاحظات	نص حر.

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

حالة الدفعة	المعنى
draft	تم إنشاؤها، ولم يتم تخصيصها بعد.
allocated	توجد هويات وأسرار لكل بطاقة.
sent	تم إرسال ملف إدخال البائع إلى الشركة المصنعة.
in_production	يقوم البائع بصنعها.
delivered	وصلت البطاقات.
cancelled	لن تستمر الطلبية.

تخصيص

تخصيص ينشئ سجل بطاقة واحدة لكل وحدة وينتج أسرار تلك البطاقة:

• مادة مفتاح المصادقة،
• PIN 1، PUK 1، PIN 2، PUK 2 ومفتاح ADM،
• جميع ثلاث مجموعات مفاتيح OTA،
• مفتاح TLS مشترك مسبقًا مستقل لجلسات إدارة HTTP.

يتم إنشاء كل قيمة لكل بطاقة. تعني دفعة تشحن مجموعة مفاتيح واحدة عبر كل بطاقة أن أي شخص يقرأ بطاقة واحدة يمكنه قيادة OTA ضد جميعها، ولن يلاحظ أي شيء في الأسفل، لأن مجموعة المفاتيح المشتركة تعمل.

تعمل عملية التخصيص مرة واحدة. ستؤدي عملية ثانية إلى حرق كتلة أخرى من الهويات وتيتم الأولى، لذا يتم رفضها.

الملفات خارج، الملفات داخل، والملفات إلى الطابعة

تتبادل دفعة ��لاثة أنواع من الملفات مع العالم الخارجي.

التصدير	ما تحمله	ما تحذفه عمدًا
ملف البائع	ICCID، IMSI، PIN 1، PUK 1، PIN 2، PUK 2، ADM، ومفاتيح المصادقة، في مجموعة أعمدة البائع.	مجموعات مفاتيح OTA.
بيانات الطباعة	ICCID، IMSI، MSISDN، PIN 1، PUK 1، PIN 2، PUK 2، ولـ eSIM EID ورمز التفعيل.	مفتاح ADM وكل مفتاح OTA. لا تحتاج أي شيء يصل إلى الطابعة.

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

استيراد المفاتيح يقرأ ملفات التخصيص مرة أخرى من البائع إلى مخزن المفاتيح. يتم ق��ول تنسيقين:

التنسيق	الملاحظات
مفصول مع صف رأس (CSV أو TSV)	مجموعة أعمدة البائع الشائعة. كن على علم بأن ملف عمود بهذا الشكل يحمل عادةً لا مفاتيح OTA، ولا يمكن إدارة بطاقة بدون مفاتيح OTA عبر الهواء.
ملف متغير للبائع	التنسيق الذي يحمل مجموعات مفاتيح OTA ومفتاح TLS المشترك مسبقًا.

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

التصميم والموافقة

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

نوع التصميم	الاستخدام النموذجي
card_face	الوجه المطبوع للبطاقة.
card_back	العكس.
carrier	الناقل الذي يتم ثقب البطاقة فيه.
qr_sheet	ورقة رمز التفعيل لدفعة eSIM.
packaging	التعبئة الخارجية.
other	أي شيء آخر.

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

---

مجموعات المفاتيح والصورة التي تم بناؤها عليها

تحمل مجموعة المفاتيح أسرار بطاقة واحدة. بمفردها لا تقول على أي نظام ملفات توجد تلك الأسرار، ولا يقول الملف أي البطاقات تحملها. اربط الاثنين، وكلا السؤالين لهما إجابة.

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

تقوم صفحة الملف بعد ذلك بإدراج البطاقات المبنية على تلك الصورة:

العمود	المعنى
ICCID / IMSI	هويات البطاقة.
الدفعة	عملية الإنتاج، عندما تكون البطاقة في العقار.
المفاتيح المحتفظ بها	أي ماد�� مفتاح موجودة: مفاتيح المصادقة، أي مجموعات مفاتيح OTA، ومفتاح TLS المشترك مسبقًا.
عند الإصدار	المراجعة التي توجد البطاقة عندها فعليًا.
الحالة	في الخطوة، خلف، أو مفاتيح فقط.

تظهر القائمة أي مادة مفتاح موجودة، وليس قيمتها. افتح مجموعة المفاتيح نفسها لرؤية القيم.

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

الرابط هو إلى الملف، وليس إلى أحد مراجعاته. لا تتغير مفاتيح البطاقة عندما تنشر مراجعة جديدة؛ يتغير نظام الملفات. يتم تتبع المراجعة التي توجد البطاقة عندها لكل بطاقة، لذا لا يتم تسجيلها مرتين.

العقار

تكون صفحة العقار هي كل بطاقة أصدرها OmniWeb، مع احتساب الانجراف لكل ب��اقة.

العمود	المعنى
ICCID / IMSI / MSISDN	هويات البطاقة، كما تم تخصيصها.
الدفعة	عملية الإنتاج التي جاءت منها.
الإصدار	الإصدار الذي تم فلاشه عند التصنيع.
على البطاقة	الإصدار الذي يعتقد OmniWeb أنه موجود على البطاقة الآن.
يجب أن يكون	الإصدار الحالي المنشور للملف.
الحالة	في الخطوة، أو خلف عندما تكون البطاقة أدنى من الإصدار المستهدف.
الشكل	مادي أو esim.
ATR	الإجابة على إعادة تعيين التي تمت قراءتها فعليًا من البطاقة، أو لم تُرَ.
الحالة	مخصص، مُصدر، نشط، معلق أو منتهي.
آخر مزامنة	متى لمست حملة البطاقة آخر مرة، أو آخر خطأ باللون الأحمر.

قم بالتصفية حسب الملف، حسب بادئة ICCID، حسب الشكل، أو باستخدام خلف ملفهم فقط.

عمود ATR هو دليل، وليس زينة. يتم ملؤه في المرة الأولى التي تظهر فيها بطاقة في قارئ. إذا لم يتطابق مع ما يتوقعه منتج البطاقة، يتحول العمود إلى اللون الأحمر. هذا يعني أن الشريحة في اليد ليست المنصة التي طلبتها، مما يغير كيفية معالجة OTA لها. من الأفضل بكثير رؤية ذلك هنا من اكتشافه لاحقًا كبطاقة تتجاهل كل حزمة.

تحرير البطاقة يصحح سجل البطاقة: حالتها، MSISDN، ولـ eSIM EID، عنوان SM-DP+، ID المطابقة، رمز التأكيد وحالة التنزيل. الأعمدة الخاصة بالإصدار ليست قابلة للتحرير عمدًا. إنها سجل لما حدث، ولا يتحرك إلا إصدار أو حملة موثقة.

---

حملات التقارب

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

هذا شيء مختلف عن حملة OTA، التي هي أمرية: قم بتشغيل هذه العملية ضد هذه البطاقات. يتم توثيق حملات OTA في إدارة SIM OTA. استخدم حملة التقارب لتدوير تغيير الملف عبر العقار. استخدم حمل�� OTA لعملية لمرة واحدة ليست تغييرًا في الملف.

إنشاء حملة

الحقل	الوصف
الاسم	اسمك للعملية.
الملف	يتم عرض الملفات فقط التي لديها إصدار حالي منشور.
الدفعات	أي دفعات في النطاق. مجموعة الهدف الفارغة لا تتطابق مع أي شيء، عمدًا.
كل SIM على هذه الصورة	كل بطاقة ترتبط مجموعة مفاتيحها بهذا الملف. استخدم هذا للوصول إلى بطاقات تم إصدارها في أماكن أخرى، والتي لديها مفاتيح هنا ولكن لا توجد دفعة.
الناقل	Auto، SMS (SCP80) أو HTTP (SCP81). يختار Auto من ناقلات منتج البطاقة.
الإكمال	تحقق من خلال القراءة مرة أخرى، أو أطلق وانس.
REFRESH	لا شيء، إعادة تعيين UICC، أو إخطار تغيير الملف. ما يُطلب من البطاقة القيام به بمجرد تغيير الملفات.
الحد الأقصى في الساعة	سقف أسطول على التسليمات. 0 تعني غير محدو��.
الحد الأدنى للفجوة	الحد الأدنى من المسافة بالثواني بين تسليمين لنفس البطاقة. 0 تعني لا شيء.
الحد الأقصى من المحاولات	عدد المرات التي يتم فيها محاولة بطاقة واحدة قبل أن تفشل المهمة.
موعد الرد	عدد الدقائق التي يجب الانتظار فيها لرد البطاقة قبل التخلي عن المحاولة. 0 يعطل الموعد النهائي.
تشغيل جاف	تخطيط وتشغيل جاف، ويرفض الإرسال. تكون الحملة الجديدة دائمًا تشغيلًا جافًا.

قم بتعيين الإيقاع عمدًا. يحتوي رابط الإشارة الذي يحمل حركة مرور OTA على ميزانية محدودة، والبطاقة التي تفشل في جلسات الإدارة بشكل متكرر تتوقف على فترة تصل إلى 24 ساعة لا شيء يزيلها. تنتهي الحملة التي تعمل ببطء؛ الحملة التي تغمر لا تفعل.

تكون الحملة محدودة بـ 5000 بطاقة مستهدفة. إذا تطابق الفلتر مع المزيد، قم بتضييقه وتشغيل الباقي كحملة ثانية.

مراجعة التغيير قبل تسليحها

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

استخدم المعاينة على صفحة الملف لرؤية ما يرسله التغيير. تُظهر المعاينة، لكل ناقل:

• الملفات التي تختلف، وعدد الأوامر التي تكلفها كل واحدة
• نص الأمر، تمامًا كما سيتم بناؤه
• المسارات التي لا يمكن لهذا الناقل الوصول إليها، والتي تحتاج إلى تطبيق إدارة ملفات عن بُعد مختلف
• عدد البطاقات التي تتطابق، وعدد البطاقات التي خلف الإصدار المستهدف

تقرأ المعاينة أي مادة مفتاح. يصبح النص حزمة مؤمنة فقط في وقت الإرسال، باستخدام مفاتيح البطاقة الخاصة بها، لذا فإن المعاينة آمنة للتشغيل ضد عقار حي.

قم بتسليح الحملة فقط بعد قراءة المعاينة. الضرر الذي يمكن أن تسببه الحملة يتناسب مع عدد البطاقات التي تتطابق معها.

جدولة، ثم تشغيل

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

حالة المهمة	المعنى
pending	تم جدولتها، ولم يتم المطالبة بها بعد.
claimed	يحملها عامل. لا يلتقط عاملان نفس البطاقة أبدًا.
sent	تم إرسال النص إلى البطاقة.
awaiting result	في انتظار رد البطاقة.
verifying	التحقق مما فعلته البطاقة فعليًا.
done	تم التطبيق والتحقق. يتقدم الإصدار المطبق للبطاقة.
failed	تم استنفاد المحاولات. الخطأ في الصف.
skipped	لم يكن هناك شيء لتغييره، أو لا شيء يمكن تغييره بأمان.

تحكم الحملة موجود في كل صف: إيقاف مؤقت يترك العمل في قائمة الانتظار، استئناف يستمر فيه، و إلغاء يسحب العمل الذي لم يبدأ.

حالة الحملة	المعنى
draft	تم إنشاؤه، لا يوجد شيء في قائمة الانتظار.
running	يتم تسليم الوظائف.
paused	تم إيقاف التسليم. تبقى الوظائف في قائمة الانتظار.
complete	وصلت كل وظيفة إلى حالة نهائية.
failed	انتهت العملية بفشل.
cancelled	تم سحبها.

عندما لا يرد بطاقة

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

الحالة	النتيجة
البطاقة ترد	يتم تسوي�� الوظيفة بناءً على ما أبلغت عنه البطاقة.
لا إجابة داخل الموعد النهائي، لا تزال المحاولات قائمة	يتم التخلي عن المحاولة. تعود الوظيفة إلى pending ويتم تجربتها مرة أخرى بعد فترة الانتظار.
لا إجابة داخل الموعد النهائي، لا توجد محاولات متبقية	تفشل الوظيفة، وتُسجل أن البطاقة لم ترد أبدًا.
خطأ في التسليم يمكن إعادة المحاولة	نفس فترة الانتظار تنطبق.

تزداد فترات الانتظار بين المحاولات، لذا فإن البطاقة التي تكون مطفأة لفترة طويلة لا يتم تجربتها بقوة. تظهر قائمة الوظائف الحالة، ورقم المحاولة ومتى من المقرر أن تكون المحاولة التالية.

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

ما يُسمح للحملة بفعله

يتضمن النص المُعَد فقط اختيارات الملفات وتحديثات الملفات، على المسارات التي تحددها سياسة الملف كقابلة للكتابة. هذا القيد هو ما يجعل إعادة قائمة الانتظار آمنة: تشغيل نفس النص مرتين يترك البطاقة في نفس المكان، لذا يمكن ببساطة إعادة محاولة الوظيفة التي توقفت في منتصف الطريق.

يتبع سلوكان من البطاقة، وليس من OmniWeb، وكلاهما يستحق التوقع:

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

انحراف الأسطول

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

القيود الحالية

يتم تسجيل خيارين للحملة ويتم احترامهما من قبل قائمة الانتظار، ولكن لم يتم تنفيذها تلقائيًا بعد من قبل عامل التسليم:

• Verify by reading back لا يقرأ بعد كل ملف مرة أخرى بعد الكتابة. للتحقق من بطاقة اليوم، قم بتشغيل تدقيق (أدناه).
• REFRESH مخزنة على الحملة ولكن لم يتم إرسالها بعد إلى البطاقة.

---

تدقيق: تصحيح ما تعتقده OmniWeb

الإصدار المُطبق هو اعتقاد. التدقيق هو ما يصححه.

يقوم التدقيق بقراءة الملفات المدارة للبطاقة مرة أخرى عبر الهواء ويقارن كل واحدة مع الإصدار الذي تتوقعه OmniWeb. يُبلغ، ل��ل ملف، عن القيمة المتوقعة، القيمة الموجودة فعليًا على البطاقة، وما إذا كانت تتطابق. يتم بدءه من قبل المشغل، وليس جزءًا من الحملة، لأن كل ملف يتم التحقق منه يكلف رحلة ذهاب وإياب عبر OTA.

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

التدقيق متاح عبر POST /api/ota/sync/audit. التدقيق المنفصل تدقيق الوصول على صفحات OTA يجيب على سؤال مختلف: أي العمليات يُسمح لمجموعة المفاتيح بتنفيذها على كل ملف.

---

واجهة برمجة التطبيقات REST

تتطلب جميع المسارات JWT. راجع مرجع API.

منتجات البطاقة

الطريقة	المسار	الغرض
GET, POST	/api/simbank/card-products	قائمة أو إنشاء منتج بطاقة.
GET, PUT, DELETE	/api/simbank/card-products/<id>	قراءة أو تحديث أو حذف واحد.
POST	/api/simbank/card-products/<id>/bearers	إضافة عنوان الحامل.
PUT, DELETE	/api/simbank/card-products/<id>/bearers/<bearer_id>	تحديث أو إزالة صف حامل واحد.

الملفات الشخصية والإصدارات

الطريقة	المسار	الغرض
GET, POST	/api/simbank/profiles	قائمة أو إنشاء ملفات تعريف.
GET, PUT, DELETE	/api/simbank/profiles/<id>	تفاصيل الملف الشخصي، بما في ذلك إصداراته.
GET, POST	/api/simbank/profiles/<id>/versions	قائمة الإصدارات، أو إنشاء مسودة من صورة أو حزمة ملف تعريف ملصقة.
GET, DELETE	/api/simbank/profiles/<id>/versions/<vid>	قراءة إصدار، أو حذف مسودة.
POST	/api/simbank/profiles/<id>/versions/<vid>/publish	نشر. اتجاه واحد.
GET, PUT	/api/simbank/profiles/<id>/versions/<vid>/policy	قراءة أو تحديث سياسة الملف.
GET	/api/simbank/profiles/<id>/versions/<vid>/diff	ما يختلف بين إصدارين.

الدفعات والعقار

الطريقة	المسار	الغرض
GET, POST	/api/simbank/batches	قائمة أو إنشاء دفعات.
GET, PUT, DELETE	/api/simbank/batches/<id>	تفاصيل الدفعة، بما في ذلك الأعمال الفنية.
POST	/api/simbank/batches/<id>/allocate	تخصيص الهويات والأسرار. غير قابل للتكرار.
GET	/api/simbank/batches/<id>/export	تنزيل بيانات الطباعة أو ملف البائع.
POST	/api/simbank/batches/<id>/artwork	تحميل ملف عمل فني.
POST, DELETE	/api/simbank/batches/<id>/artwork/<aid>	الموافقة أو حذف عنصر عمل فني.
POST	/api/simbank/keys/import	استيراد مواد مفتاح البائع.
GET	/api/simbank/issued	العقار، مع حساب الانحراف لكل بطاقة.
GET, PUT	/api/simbank/issued/<iccid>	قراءة أو تصحيح سجل بطاقة واحدة.

التقارب

الطريقة	المسار	الغرض
GET, POST	/api/ota/sync/campaigns	قائمة أو إنشاء حملات.
GET, PUT, DELETE	/api/ota/sync/campaigns/<id>	قراءة أو تحديث أو حذف واحد.
GET	/api/ota/sync/campaigns/<id>/targets	أي البطاقات تتطابق، وعدد البطاقات الم��أخرة.
POST	/api/ota/sync/preview	عرض ما قد يرسله تغيير، لزوج من الإصدارات. لا يقرأ أي مفاتيح ولا يرسل شيئًا.
POST	/api/ota/sync/campaigns/<id>/enqueue	حساب الفروقات وتqueue الوظائف.
POST	/api/ota/sync/campaigns/<id>/control	إيقاف مؤقت، استئناف أو إلغاء.
GET	/api/ota/sync/jobs	قائمة الوظائف.
GET	/api/ota/sync/drift	انحراف الأسطول لكل ملف تعريف.
POST	/api/ota/sync/audit	قراءة بطاقة واحدة مرة أخرى ومقارنتها مع إصدارها المتوقع.

التحكم في الوصول

الصفحات	نوع عنصر RBAC
ملفات تعريف SIM، منتجات البطاقة، الدفعات، العقار	simbank
التقارب	ota

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

---

ذات صلة

• إدارة SIM OTA - كيف يصل تغيير إلى بطاقة، عبر SMS و عبر HTTP، وأي المنصات تم اختبارها.
• eSIM (SGP.22) - طلب، تسليم وإدارة ملفات تعريف eSIM.
• SIM Bank - القارئ وجرد البطاقات، ومخزن المفاتيح.
• صور SIM - أنظمة الملفات المحفوظة، التي يمكن إنشاء إصدار ملف تعريف منها.
• أدوات بطاقة SIM - أدوات لكل بطاقة في قارئ.