> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# الإعارة الذاتية RFID ومعيار SIP2 في المكتبة
- URL: https://arabroot.io/articles/الاعارة-الذاتية-rfid-ومعيار-sip2-في-المكتبة/
- Published: 2026-11-18T10:04:11.000Z
- Updated: 2026-11-18T11:02:58.000Z
- Description: كيف تعمل أجهزة الإعارة الذاتية من الشريحة إلى نظام المكتبة، مع مختبر يشغل خادم SIP2 في Koha ويطبع كل رسالة، ويكشف مشكلتين مع الأسماء العربية.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, المكتبات ونظم المعلومات, تطبيقات لفريقك, الاستضافة الذاتية, Koha

في أيام الاختبارات تمتد أمام مكتب الإعارة في مكتبة الجامعة طوابير طويلة، وكل طالب معه كتابان أو ثلاثة، والموظف يمسح البطاقة ثم كل كتاب، ثم يزيل الشريط المغناطيسي، ثم يختم تاريخ الإرجاع. ولذلك تشتري المكتبات أجهزة الإعارة الذاتية Self-check: يضع الطالب بطاقته وكتبه على سطح الجهاز، فيقرأها كلها في ثانية، ويطبع إيصالاً بتاريخ الإرجاع. ويبدو المشروع شراء جهاز من مورد، ولكن الموظف التقني الذي يطلب منه «ربط الجهاز بالنظام» يكتشف أنه أمام بروتوكول اسمه SIP2 عمره ثلاثون سنة، ومنفذ TCP مفتوح على نظام المكتبة، وحساب بكلمة مرور مكتوبة في ملف نصي، وأسئلة لم يفكر فيها أحد: ماذا يرى الجهاز عن الطالب؟ وما الذي يحدث إذا كان اسم الطالب عربياً؟

وقد ذكرنا في [دليل نظام المكتبة Koha](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-koha-%D9%84%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%83%D8%AA%D8%A8-%D9%88%D8%A7%D9%84%D8%A7%D8%B9%D8%A7%D8%B1%D8%A9/) أن الإعارة الذاتية تتصل به عبر SIP2 دون أن نجربها، وهذا المقال يكمل ذلك عملياً.

وفي هذا المقال سوف نناقش:

- طبقتا الإعارة الذاتية: الراديو بين الشريحة والجهاز RFID، والبروتوكول بين الجهاز ونظام المكتبة SIP2، ولماذا يجب أن تفصل بينهما في ذهنك.
- معايير شرائح المكتبات: ISO/IEC 18000-3 وISO/IEC 15693 للراديو، وISO 28560 لما يكتب على الشريحة، وما تقوله التوصية الأمريكية NISO RP-6-2012 عن الحماية والخصوصية.
- مختبر عملي: تشغيل خادم SIP2 في Koha 26.05.05، وكتابة عميل صغير يلعب دور الجهاز ويطبع كل رسالة كما هي: الدخول، وحالة القارئ، والإعارة، والإرجاع.
- ما يحدث في الحالات اليومية: رقم سري خطأ، وقارئ موقوف، وباركود غير موجود، وتجديد، ورسالة تالفة.
- مشكلتان عربيتان ظهرتا في المختبر: ترميز الحساب الذي يحول الأسماء إلى علامات استفهام، ورمز التحقق الذي يحسب على البايتات وليس الحروف.

وهذا أول مقال في مرحلة «خدمات المكتبة الحديثة»، وقبله مقالات المرحلة الأولى:

[![](https://arabroot.io/content/images/2026/11/library-systems-map-cover-cover.webp)دليلخريطة أنظمة المكتبة: ILS والمستودع وبوابة البحثما الأنظمة التي تتكون منها المكتبة الحديثة وكيف تتكلم مع بعضها، مع مختبر ينسخ تسجيلة كتاب من مكتبة الكونغرس عبر Z39.50 ويحصد مستودعاً عبر OAI-PMH.](https://arabroot.io/articles/%D8%AE%D8%B1%D9%8A%D8%B7%D8%A9-%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-ils-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D9%88%D8%A8%D9%88%D8%A7%D8%A8%D8%A9-%D8%A7%D9%84%D8%A8%D8%AD%D8%AB/)[![](https://arabroot.io/content/images/2026/11/koha-cover-cover.webp)دليلنظام المكتبة Koha: فهرسة MARC21 بالعربية والإعارةكيف تثبت Koha من حزمه الرسمية بالعربية، وتفهرس كتباً عربية بـ MARC21 وتعيرها، وتصلح البحث العربي الذي لا يعمل في الإعداد الافتراضي.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-koha-%D9%84%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%83%D8%AA%D8%A8-%D9%88%D8%A7%D9%84%D8%A7%D8%B9%D8%A7%D8%B1%D8%A9/)[![](https://arabroot.io/content/images/2026/11/ils-compare-cover-cover.webp)دليلKoha أم Evergreen أم FOLIO؟ اختيار نظام المكتبةمقارنة عملية شغلنا فيها Koha وEvergreen على التسجيلات نفسها وقسنا الذاكرة والاستيراد والبحث العربي، مع FOLIO من توثيقه الرسمي وأرقام السوق لعام 2026.](https://arabroot.io/articles/koha-%D8%A7%D9%85-evergreen-%D8%A7%D9%85-folio-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9/)

## طبقتان: الراديو RFID والبروتوكول SIP2

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

![مخطط طبقتي الإعارة الذاتية: على اليمين الطبقة الأولى الراديو RFID فيها كتاب عليه شريحة tag وموجات راديو إلى قارئ تحت سطح الجهاز بتردد 13.56 MHz حسب ISO/IEC 18000-3 Mode 1 أو ISO 15693، وما يكتب على الشريحة حسب ISO 28560 مثل الباركود ورمز المكتبة ISIL مع بت الحماية أو قيمة AFI، وفي الوسط جهاز الإعارة الذاتية SC أي Self-check يقرأ بطاقة القارئ ورقمه السري والكتب على السطح ويحولها إلى رسائل نصية مثل 11YN...AASTU-1001|ABLIB-0001، وعلى اليسار الطبقة الثانية SIP2 حيث ACS هو Koha SIPServer على المنفذ TCP 6001 ونظام المكتبة يقرر هل القارئ مسموح له وهل النسخة قابلة للإعارة وما تاريخ الإرجاع، وفي الأسفل: الشريحة لا تعرف شيئاً عن القارئ ولا عن الإعارة فيها رقم النسخة وبت الحماية فقط، والجهاز لا يقرر شيئاً فكل قرار يأتي من نظام المكتبة عبر SIP2، وجهاز بباركود يتكلم SIP2 نفسه](https://arabroot.io/content/images/2026/11/library-rfid-01-layers.webp)

الراديو يقرأ رقم النسخة، وSIP2 ينقل القرار من نظام المكتبة

في الصورة أعلاه لاحظ التالي:

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

والنتيجة العملية: عند شراء أجهزة، اسأل عن الطبقتين منفصلتين. هل الشرائح وفق المعايير الدولية فتقرؤها أجهزة مورد آخر بعد خمس سنوات؟ وهل الجهاز يتكلم SIP2 مع نظامك تحديداً، وجربتم ذلك؟

## معايير الشريحة: ISO 18000-3 وISO 15693 وISO 28560

شرائح المكتبات تعمل في الغالب على التردد العالي High Frequency، أي 13.56 MHz، وتقرأ من مسافة قصيرة، عشرات السنتيمترات، وهذا مقصود: لا تريد أن يقرأ جهاز الإعارة كتب الطالب الذي يقف خلفك. وتقول التوصية الأمريكية [NISO RP-6-2012، RFID in U.S. Libraries](https://www.niso.org/publications/niso-rp-6-2012-rfid-us-libraries?ref=arabroot.io) إن المعيارين التقنيين المهمين للمكتبات هما ISO/IEC 15693 وISO/IEC 18000-3 Mode 1، وإنهما متقاربان وليسا متطابقين، وإن المكتبات اعتمدت الثاني على نطاق واسع، وتنصح بالتركيز عليه لأنه يدار ضمن معايير «إدارة المواد» Item Management. وهذان المعياران يحددان كيف يتكلم القارئ والشريحة، أي الطبقة الفيزيائية، ولا يحددان ماذا يكتب في ذاكرة الشريحة.

وهنا يأتي المعيار الخاص بالمكتبات ISO 28560 بأجزائه، ويحدد عناصر البيانات وطريقة كتابتها على الشريحة: الجزء الأول للعناصر نفسها، والجزء الثاني لطريقة ترميز مرنة مبنية على ISO/IEC 15962، والجزء الثالث لطريقة ترميز بطول ثابت أصلها النموذج الدنماركي. والتوصية الأمريكية تختار الجزء الثاني. وقبل هذا المعيار كان لكل مورد طريقته في الكتابة على الشريحة، فالمكتبة التي غيرت المورد كانت تعيد ترميز كل كتبها، أي أن الشرائح كانت تحبس المكتبة عند المورد بالطريقة نفسها التي تحبسها بها البيانات في نظام مغلق. والصورة التالية تبين ما يكتب على الشريحة وما لا يكتب:

![ذاكرة شريحة المكتبة HF: المعرف الفريد UID من المصنع لا يتغير، وسجل AFI بطول 8 بت قيمته 07 داخل المكتبة وC2 عند الإعارة، وذاكرة المستخدم فيها عناصر ISO 28560 مثل رقم النسخة الأساسي وهو الباركود LIB-0001 ورمز المكتبة المالكة ISIL وعدد أجزاء المادة وقد يقفل جزء منها Lock، والأجهزة من شركتين تقرأ الشريحة نفسها إذا اتبعتا ISO 28560-2، وفي الجهة الأخرى ما لا يكتب على الشريحة: اسم القارئ أو رقمه، وما استعاره من قبل، وعنوان الكتاب في الغالب، لأن الشريحة تقرأ من مسافة بأي قارئ HF والكتاب يخرج مع القارئ إلى الشارع، والربط بين الرقم والقارئ في Koha وحده، وفي الأسفل: بوابة الحماية عند الباب تقرأ AFI أو بت EAS فقط](https://arabroot.io/content/images/2026/11/library-rfid-06-tag.webp)

الشريحة تحمل رقم النسخة والحماية، والربط بالقارئ في نظام المكتبة وحده

وأهم ما في الصورة سجل التعريف بالتطبيق Application Family Identifier، واختصاراً AFI، وهو بايت واحد في الشريحة. والتوصية تذكر أن ISO 28560-1 خصص للمكتبات قيمتين: `C2` للمادة المعارة التي تخرج من المكتبة، و`07` للمادة الموجودة داخل المكتبة في الأنظمة التي تستخدم AFI للحماية. وبوابة الحماية عند الباب تقرأ هذه القيمة فقط: إذا كانت «داخل المكتبة» أطلقت الإنذار. وبعض الأنظمة تستخدم بدلاً منها بتاً مستقلاً للحماية اسمه EAS، أي مراقبة المواد إلكترونياً Electronic Article Surveillance. وفي الحالتين، الجهاز هو الذي يغير هذه القيمة بعد أن يوافق نظام المكتبة على الإعارة، وسوف ترى في رد Koha حقلاً اسمه «فك الحماية» Desensitize يقول للجهاز افعل ذلك.

### الخصوصية: لماذا لا يكتب اسم القارئ على الشريحة؟

الشريحة تقرأ بأي قارئ يعمل على التردد نفسه، والكتاب يخرج مع الطالب إلى الحافلة والمقهى. لذلك يخصص قسم كامل في التوصية الأمريكية للخصوصية، ومعه [إرشادات جمعية المكتبات الأمريكية ALA](https://www.ala.org/advocacy/intfreedom/statementspols/otherpolicies/rfidguidelines?ref=arabroot.io) عن RFID، والقاعدة المتفق عليها: لا يكتب على الشريحة إلا ما يلزم لتعريف النسخة، أي الباركود ورمز المكتبة، ولا يكتب أبداً اسم القارئ أو رقمه أو تاريخ إعاراته. وبالتالي فمن يقرأ الشريحة من مسافة يعرف أن هذه نسخة رقمها LIB-0001 من مكتبة ما، ولا يعرف من يحملها إلا إذا دخل نظام المكتبة. وهذا يذكرك بأن أهم حماية لخصوصية القراء ليست في الشريحة، وإنما في نظام المكتبة وفي البروتوكول الذي يصل إليه، كما سوف نرى.

### كيف تقرأ الشريحة بلا بطارية؟

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

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

## بروتوكول SIP2

بروتوكول التبادل القياسي Standard Interchange Protocol، واختصاراً SIP، قدمته شركة 3M سنة 1993 لتتكلم أجهزتها مع أنظمة المكتبات، كما يذكر [موقع NISO](https://www.niso.org/standards-committees/sip?ref=arabroot.io)، فأصبح المعيار الفعلي حول العالم. والنسخة المنتشرة هي 2.00، وآخر مراجعة لوثيقتها [«3M Standard Interchange Protocol Version 2.00»](https://developers.exlibrisgroup.com/wp-content/uploads/2020/01/3M-Standard-Interchange-Protocol-Version-2.00.pdf?ref=arabroot.io) مؤرخة في 11 أبريل 2006\. ثم أصدرت 3M النسخة 3.0 في نهاية 2011، ونقلت في 2012 إدارة البروتوكول إلى NISO، ولكن أغلب الأجهزة والأنظمة ما زالت تتكلم 2.00.

والبروتوكول بسيط بطريقة الثمانينيات: كل رسالة سطر نصي ينتهي بحرف رجوع العربة Carriage Return، يبدأ برقم من خانتين يحدد نوعها، ثم حقول بطول ثابت، ثم حقول متغيرة كل منها يبدأ برمز من حرفين وينتهي بالفاصل `|`. وفي الوثيقة طرفان: جهاز الخدمة الذاتية Self-check، ويسمى SC، ونظام المكتبة الذي يسمى ACS أي Automated Circulation System. وكل طلب له رد برقم يليه: 93 للدخول ورده 94، و11 للإعارة ورده 12، و09 للإرجاع ورده 10، وهكذا.

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

## المختبر: خادم SIP2 في Koha وعميل يطبع كل رسالة

لا نملك جهاز إعارة ذاتية، ولكننا لا نحتاجه لنرى ما يحدث في الطبقة الثانية، فالجهاز من جهة نظام المكتبة ليس إلا برنامجاً يفتح اتصال TCP ويرسل أسطراً نصية. لذلك شغلنا Koha 26.05.05 من حزمه الرسمية في Container يعمل بـ systemd كما في دليل Koha، وكتبنا عميلاً صغيراً بلغة Python يلعب دور الجهاز.

```dockerfile
FROM debian:trixie-slim
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y --no-install-recommends systemd systemd-sysv dbus procps curl ca-certificates wget gnupg2 less netcat-openbsd python3 \
 && systemctl mask getty@.service console-getty.service systemd-logind.service \
 && rm -rf /var/lib/apt/lists/*
RUN apt-get update && apt-get install -y apache2 mariadb-server \
 && wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg \
 && echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 26.05 main' > /etc/apt/sources.list.d/koha.list \
 && apt-get update && apt-get install -y koha-common \
 && rm -rf /var/lib/apt/lists/*
STOPSIGNAL SIGRTMIN+3
CMD ["/lib/systemd/systemd"]
```

وبعد `koha-create` ومعالج التثبيت، أضفنا مكتبة واحدة وقواعد إعارة بهذا الملف:

```sql
-- run with: koha-mysql library --default-character-set=utf8mb4 < setup.sql (without it the Arabic name is stored double-encoded)
-- One library, loan rules, and the onboarding values the web installer would ask for
INSERT INTO branches (branchcode, branchname, pickup_location, public) VALUES ('MAIN', 'المكتبة المركزية', 1, 1);
INSERT INTO circulation_rules (branchcode, categorycode, itemtype, rule_name, rule_value) VALUES
 (NULL, NULL, NULL, 'issuelength', '14'), (NULL, NULL, NULL, 'maxissueqty', '5'), (NULL, NULL, NULL, 'renewalsallowed', '2'),
 (NULL, NULL, NULL, 'renewalperiod', '14'), (NULL, NULL, NULL, 'lengthunit', 'days'), (NULL, NULL, NULL, 'reservesallowed', '3'),
 (NULL, NULL, NULL, 'holds_per_record', '1'), (NULL, NULL, NULL, 'onshelfholds', '1'), (NULL, NULL, NULL, 'fine', '0'),
 (NULL, NULL, NULL, 'chargeperiod', '1');
UPDATE systempreferences SET value = '0' WHERE variable = 'OnboardingCompleted';
```

ولاحظ السطر الأول، فقد جاء من مشكلة حقيقية: نفذنا الملف أول مرة دون الخيار `--default-character-set=utf8mb4`، فظهر اسم المكتبة في الواجهة هكذا «Ø§Ù„Ù…ÙƒØªØ¨Ø©»، لأن عميل MySQL أرسل البايتات العربية على أنها Latin-1، فحفظتها قاعدة البيانات مرمزة مرتين. وأي ملف SQL فيه عربية يجب أن ينفذ بهذا الخيار.

ثم أنشأنا بسكربت Perl عبر `koha-shell` ثلاثة قراء: حساباً للجهاز اسمه `sipkiosk` بصلاحية الإعارة فقط، وطالباً، وطالبة موقوفة بسبب كتاب مفقود، ومعهم ثلاثة كتب عربية بباركود:

```perl
#!/usr/bin/perl
# Run with koha-shell: a SIP account, a student, a staff member and three books with barcodes
use Modern::Perl;
use C4::Context;
use Koha::Patrons;
use C4::Biblio qw(AddBiblio);
use Koha::Item;
use MARC::Record;
use MARC::Field;

sub patron {
    my (%a) = @_;
    my $pw = delete $a{password};
    my $p = Koha::Patron->new({ branchcode => 'MAIN', dateexpiry => '2030-12-31', %a })->store;
    $p->set_password({ password => $pw, skip_validation => 1 });
    return $p;
}
my $kiosk = patron(surname => 'Self-check kiosk 1', cardnumber => 'SIP-KIOSK-1', userid => 'sipkiosk', categorycode => 'S', password => 'Kiosk-2026!');
# the kiosk needs the circulate permission (flag bit 1) and nothing else
$kiosk->flags(2)->store;
patron(surname => 'الطالب', firstname => 'خالد', cardnumber => 'STU-1001', userid => 'stu1001', categorycode => 'ST', password => 'Reader-2026!');
patron(surname => 'المحمد', firstname => 'سارة', cardnumber => 'STU-1002', userid => 'stu1002', categorycode => 'ST', password => 'Reader-2026!', debarred => '2030-01-01', debarredcomment => 'Lost book not returned');

my @books = (['مقدمة ابن خلدون', 'ابن خلدون', 'LIB-0001'], ['البيان والتبيين', 'الجاحظ', 'LIB-0002'], ['الأيام', 'طه حسين', 'LIB-0003']);
for my $b (@books) {
    my $r = MARC::Record->new;
    $r->encoding('UTF-8');
    $r->append_fields(MARC::Field->new('100', '1', ' ', a => $b->[1]), MARC::Field->new('245', '1', '0', a => $b->[0]));
    my ($bn) = AddBiblio($r, '');
    Koha::Item->new({ biblionumber => $bn, homebranch => 'MAIN', holdingbranch => 'MAIN', barcode => $b->[2], itype => 'BK' })->store;
    say "biblio $bn item $b->[2] $b->[0]";
}
```

لاحظ في السكربت أن حساب الجهاز قارئ عادي في Koha، وأن صلاحيته العلم `flags=2`، أي الإعارة Circulate فقط. والسبب أن كلمة مرور هذا الحساب سوف تكتب نصاً في ملف إعداد، وتمر على الشبكة بلا تشفير، فإذا كانت لحساب مدير أصبح كل من يرى حركة الشبكة مديراً للنظام.

### ملف الإعداد SIPconfig.xml

يفعل SIP2 لكل نسخة من Koha بالأمر `koha-enable-sip library`، الذي ينسخ ملفاً نموذجياً إلى `/etc/koha/sites/library/SIPconfig.xml`. والملف النموذجي، كما في [مستودع Koha](https://github.com/Koha-Community/Koha/blob/main/etc/SIPconfig.xml?ref=arabroot.io)، فيه حسابات مثل `term1` بكلمة المرور `term1` و`koha` بكلمة المرور `koha`، ومؤسسات مثل CPL، وهي أمثلة للتوضيح. واستبدلناه بملف صغير فيه ما نحتاجه فقط:

```xml
<acsconfig xmlns="http://openncip.org/acs-config/1.0/">
  <error-detect enabled="true" />
  <server-params min_servers='1' min_spare_servers='0' />
  <listeners>
    <!-- RAW TCP, the transport self-check machines use; only the library network should reach it -->
    <service port="*:6001/tcp/IPv4" transport="RAW" protocol="SIP/2.00" client_timeout="600" timeout="60" />
  </listeners>
  <accounts>
    <!-- id and password are a real Koha user with the circulate permission -->
    <login id="sipkiosk" password="Kiosk-2026!" delimiter="|" error-detect="enabled"
           institution="MAIN" encoding="utf8" checked_in_ok="1">
      <!-- the screen messages Koha sends are English; replace the ones the reader sees -->
      <screen_msg_regex find="Greetings from Koha." replace="أهلاً بك في المكتبة المركزية" />
      <screen_msg_regex find="Patron debarred" replace="حسابك موقوف، راجع مكتب الإعارة" />
    </login>
  </accounts>
  <institutions>
    <institution id="MAIN" implementation="ILS" parms="">
      <policy checkin="true" renewal="true" checkout="true" status_update="false" offline="false" timeout="100" retries="5" />
    </institution>
  </institutions>
</acsconfig>
```

في الملف أعلاه لاحظ التالي:

- **login:** المعرف وكلمة المرور هما اسم المستخدم وكلمة مرور حساب `sipkiosk` في Koha، والخادم يتحقق منهما مقابل قاعدة البيانات، فأي حساب في الملف ليس له مستخدم حقيقي لا يستطيع الدخول.
- **institution:** رمز المؤسسة، وهو هنا رمز مكتبتنا MAIN، والجهاز يرسله في كل رسالة في الحقل `AO`.
- **encoding="utf8":** ترميز النصوص في الردود، وسوف ترى بعد قليل ما يحدث إذا تركته `ascii`.
- **error-detect:** يفعل رقم التسلسل ورمز التحقق في كل رسالة.

### خيارات الحساب: قرارات مكتبية مكتوبة في XML

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

- **checked\_in\_ok:** ماذا يحدث إذا أعاد الطالب كتاباً غير معار أصلاً؟ بالقيمة 1، كما في ملفنا، يرد Koha بنجاح الإرجاع، فلا يقف الطالب أمام الجهاز برسالة خطأ لا يفهمها، والكتاب يعود إلى الرف في الحالتين.
- **holds\_block\_checkin وholds\_get\_captured:** هل يرفض الجهاز إرجاع كتاب محجوز ليأخذه الموظف بنفسه، أم يقبله ويخصصه لصاحب الحجز آلياً؟ والثاني أسرع، ولكنه يعتمد على أن الجهاز أو الصندوق يضع الكتاب في مكان منفصل كما رأينا مع `CV01`.
- **overdues\_block\_checkout:** هل يمنع الجهاز الإعارة لمن عليه كتب متأخرة، حتى لو كانت قواعد المكتبة في المكتب تسمح بذلك بموافقة الموظف؟ والجهاز لا يستطيع أن يقدر الظروف كما يقدرها الموظف، لذلك تميل أغلب المكتبات إلى أن يكون الجهاز أشد قليلاً من المكتب.
- **format\_due\_date:** شكل تاريخ الإرجاع الذي يطبع على الإيصال، والقيمة الافتراضية الشكل الخام الذي رأيته `20261202 235900`، فإذا كان الجهاز يطبعه كما هو فغير هذا الخيار.
- **inhouse\_item\_types:** أنواع المواد التي تستخدم داخل المكتبة فقط، مثل المراجع، فلا يعيرها الجهاز.

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

### ماذا يحدث إذا كتبت المنفذ بالطريقة المعتادة؟

في المحاولة الأولى كتبنا المنفذ بالشكل الذي يكتبه أي مدير أنظمة ليستمع على كل الواجهات: `port="0.0.0.0:6001/tcp/IPv4"`. فشغلنا الخادم بالأمر `koha-sip --start library`، وكان يستمع فعلاً على المنفذ 6001، ولكن العميل لم يحصل على أي رد:

```text
ConnectionResetError: [Errno 104] Connection reset by peer
[2026/11/18 09:43:21] [4382] [ERROR] [undef]@[undef]: process_request: Unknown recognized server connection: 127.0.0.1:6001/TCP C4::SIP::Sip::siplog /usr/share/koha/lib/C4/SIP/Sip.pm (327)
[2026/11/18 09:43:21] [4382] [ERROR] [undef]@[undef]: process_request: Bad server connection at /usr/share/koha/lib/C4/SIP/SIPServer.pm line 305. C4::SIP::Trapper::__ANON__ /usr/share/koha/lib/C4/SIP/Trapper.pm (70)
```

والسبب في طريقة مطابقة الاتصال بالإعداد. فعندما يصل اتصال، يأخذ Koha العنوان الذي وصل عليه فعلاً، وهو 127.0.0.1، ويبحث في الإعداد عن نص مطابق بأحد الأشكال `6001/tcp` أو `*:6001/tcp` أو `127.0.0.1:6001/tcp`، كما في الدالة `find_service` في [ملف Configuration.pm](https://github.com/Koha-Community/Koha/blob/main/C4/SIP/Sip/Configuration.pm?ref=arabroot.io)، والعنوان `0.0.0.0` ليس منها، فيغلق الاتصال. والحل الشكل `*:6001/tcp/IPv4` كما في الملف أعلاه. وهذه من المشكلات التي تأخذ يوماً كاملاً من فريق المورد وفريق المكتبة، كل منهما يظن أن المشكلة عند الآخر، لأن المنفذ مفتوح والاتصال يصل.

### جلسة كاملة كما يرسلها الجهاز

هذا هو العميل، وهو يرسل الرسائل بالترتيب الذي يرسله أغلب الأجهزة عندما يضع الطالب بطاقته ثم كتاباً، ثم يعيده:

```python
"""A tiny SIP2 client that prints every raw message: python3 sip2.py HOST PORT
It plays a self-check machine: login, status, patron, checkout, item info, checkin."""
import socket, sys, time, datetime

HOST, PORT = sys.argv[1], int(sys.argv[2])
USER, PASS, INST = "sipkiosk", "Kiosk-2026!", "MAIN"
PATRON, PIN = "STU-1001", "Reader-2026!"
ITEM = sys.argv[3] if len(sys.argv) > 3 else "LIB-0001"
seq = 0

def checksum(msg):
    # 3M SIP2 spec: add every character, keep the lower 16 bits, two's complement, four hex digits
    return format((-sum(msg.encode("utf-8"))) & 0xFFFF, "04X")

def send(sock, body, label):
    global seq
    msg = f"{body}AY{seq}AZ"
    msg += checksum(msg)
    seq = (seq + 1) % 10
    sock.sendall((msg + "\r").encode("utf-8"))
    t = time.time()
    data = b""
    while b"\r" not in data:            # every SIP2 message ends with a carriage return
        data += sock.recv(4096)
    ms = (time.time() - t) * 1000
    reply = data.decode("utf-8").rstrip("\r\n")
    print(f"--- {label}  ({ms:.0f} ms)")
    print(f">>> {msg}")
    print(f"<<< {reply}")
    return reply

now = lambda: datetime.datetime.now().strftime("%Y%m%d    %H%M%S")
s = socket.create_connection((HOST, PORT), timeout=30)
send(s, f"9300CN{USER}|CO{PASS}|CP{INST}|", "93 Login")
send(s, "9900302.00", "99 SC Status")
send(s, f"23001{now()}AO{INST}|AA{PATRON}|AC|AD{PIN}|", "23 Patron Status")
send(s, f"63001{now()}          AO{INST}|AA{PATRON}|AC|AD{PIN}|BP1|BQ5|", "63 Patron Information")
send(s, f"11YN{now()}{now()}AO{INST}|AA{PATRON}|AB{ITEM}|AC|AD{PIN}|", "11 Checkout")
send(s, f"17{now()}AO{INST}|AB{ITEM}|AC|", "17 Item Information")
send(s, f"09N{now()}{now()}AP{INST}|AO{INST}|AB{ITEM}|AC|", "09 Checkin")
s.close()
```

```bash
docker cp sip2.py lb3-koha:/opt/lab/sip2.py
docker exec lb3-koha python3 /opt/lab/sip2.py 127.0.0.1 6001 LIB-0001
```

والمخرج سوف يكون كما يلي، والسطر الذي يبدأ بـ `>>>` ما أرسله الجهاز، والذي يبدأ بـ `<<<` رد Koha:

```text
--- 93 Login  (746 ms)
>>> 9300CNsipkiosk|COKiosk-2026!|CPMAIN|AY0AZF2FA
<<< 941AY0AZFDFD
--- 99 SC Status  (41 ms)
>>> 9900302.00AY1AZFCA5
<<< 98YYYYNN10000520261118    0918272.00AOMAIN|BXYYYYYYYYYYYNYYYY|AY1AZEE27
--- 23 Patron Status  (1286 ms)
>>> 2300120261118    091827AOMAIN|AASTU-1001|AC|ADReader-2026!|AY2AZEFCD
<<< 24              00120261118    091829AEخالد الطالب|AASTU-1001|BLY|CQY|BV0|AFGreetings from Koha. |AOMAIN|AY2AZD724
--- 63 Patron Information  (443 ms)
>>> 6300120261118    091829          AOMAIN|AASTU-1001|AC|ADReader-2026!|BP1|BQ5|AY3AZEC03
<<< 64              00120261118    091829000000000000000000000000AOMAIN|AASTU-1001|AEخالد الطالب|BLY|CQY|BV0|CC5|PCST|PIY|AFGreetings from Koha. |AY3AZCE44
--- 11 Checkout  (4148 ms)
>>> 11YN20261118    09182920261118    091829AOMAIN|AASTU-1001|ABLIB-0001|AC|ADReader-2026!|AY4AZE9A0
<<< 121NNY20261118    091833AOMAIN|AASTU-1001|ABLIB-0001|AJمقدمة ابن خلدون|AH20261202    235900|AY4AZD9AE
--- 17 Item Information  (308 ms)
>>> 1720261118    091833AOMAIN|ABLIB-0001|AC|AY5AZF4EC
<<< 1804020120261118    091833ABLIB-0001|AJمقدمة ابن خلدون|AQMAIN|APMAIN|BGMAIN|AH20261202    235900|AY5AZD831
--- 09 Checkin  (2174 ms)
>>> 09N20261118    09183420261118    091834APMAIN|AOMAIN|ABLIB-0001|AC|AY6AZEF1B
<<< 101YNN20261118    091836AOMAIN|ABLIB-0001|AQMAIN|AJمقدمة ابن خلدون|AASTU-1001|AY6AZDBBF
```

![مخطط تسلسل جلسة SIP2 الحقيقية بين الجهاز SC على اليمين وKoha ACS على اليسار: 93 Login باسم sipkiosk وكلمة المرور والمؤسسة MAIN ورده 94 ok=1 في 746 ملي ثانية، و99 SC Status ورده 98 بقائمة الرسائل المدعومة BX في 41 ملي ثانية، و23 Patron Status برقم البطاقة STU-1001 والرقم السري ورده 24 بالاسم وBLY وCQY في 1286 ملي ثانية، و63 Patron Information ورده 64 بحد الإعارة CC5 والفئة PCST في 443 ملي ثانية، و11 Checkout للنسخة LIB-0001 ورده 12 ok=1 بالعنوان وتاريخ الإرجاع 20261202 في 4148 ملي ثانية، و17 Item Information ورده 18 بالحالة 04 أي معارة في 308 ملي ثانية، و09 Checkin ورده 10 ok=1 والمكتبة MAIN في 2174 ملي ثانية](https://arabroot.io/content/images/2026/11/library-rfid-03-sip-session.webp)

سبع رسائل كل منها سطر نصي، وكل قرار في الرد

والآن نقرأ الجلسة سطراً سطراً:

- **93 و94، الدخول:** الجهاز يرسل اسم الحساب `CN` وكلمة المرور `CO` والمؤسسة `CP` نصاً واضحاً، والرد `941` يعني نجح الدخول. والرسالة الأولى أخذت 746 ملي ثانية لأن الخادم يحمل مكتبات Koha عند أول اتصال.
- **99 و98، حالة الخدمة:** الجهاز يسأل ماذا يدعم النظام، والرد فيه سلسلة `BX` من نعم ولا لكل نوع من الرسائل، مثل الإعارة والإرجاع والتجديد والدفع، والجهاز يخفي من شاشته ما لا يدعمه النظام.
- **23 و24، حالة القارئ:** رقم البطاقة `AA` والرقم السري `AD`، والرد فيه الاسم `AE` بالعربية، و`BLY` أي القارئ معروف، و`CQY` أي الرقم السري صحيح، و`AF` رسالة تعرض على الشاشة.
- **63 و64، معلومات القارئ:** أطول، وفيها `CC5` أي حد الإعارة خمسة كتب، كما في قاعدة الإعارة التي أضفناها، و`PCST` أي فئة القارئ Student.
- **11 و12، الإعارة:** الرد `121` يعني تمت الإعارة، وفيه العنوان العربي `AJ` وتاريخ الإرجاع `AH` بعد 14 يوماً كما في القاعدة. وهذه الرسالة أبطأ الرسائل، أربع ثوان في هذا المختبر، لأن Koha يتحقق فيها من كل شيء: القواعد والحجوزات والإيقاف والغرامات، ثم يسجل الإعارة.
- **17 و18، معلومات النسخة:** الحالة `04` وهي في الوثيقة «معارة» Charged.
- **09 و10، الإرجاع:** الرد `101` يعني تم الإرجاع، و`AQMAIN` مكان النسخة الدائم، فإذا كانت لفرع آخر عرف الجهاز أن يضعها في صندوق النقل.

والصورة التالية تفصل رسالة الإعارة وردها حقلاً حقلاً:

![تشريح رسالة الإعارة 11YN20261118 091829 20261118 091829 AOMAIN|AASTU-1001|ABLIB-0001|AC|ADReader-2026!|AY4AZE9A0: الرقم 11 طلب إعارة Checkout، وY وN الجهاز يسمح بالتجديد والمعاملة حية وليست مخزنة من وضع عدم الاتصال، والتاريخ والوقت بطول ثابت 18 حرفاً، والحقول المتغيرة AO وAA وAB وAD للمكتبة والقارئ والنسخة والرقم السري، وAY4 رقم التسلسل من 0 إلى 9، وAZE9A0 رمز التحقق Checksum بأربعة أرقام ست عشرية، وتحتها الرد 121NNY20261118 091833 ثم AJ مقدمة ابن خلدون وAH20261202 235900: الرقم 1 تمت الإعارة و0 يعني رفضها، وN N Y ليست تجديداً ولا وسائط مغناطيسية وفك الحماية Desensitize مطلوب، وAJ عنوان الكتاب للإيصال والشاشة، وAH تاريخ الإرجاع 2 ديسمبر أي 14 يوماً حسب قاعدة الإعارة، وفي الأسفل: الجهاز لا يحسب تاريخ الإرجاع ولا يعرف القواعد يطبع ما أرسله Koha](https://arabroot.io/content/images/2026/11/library-rfid-04-anatomy.webp)

حقول ثابتة الطول ثم حقول برمز من حرفين، والتسلسل ورمز التحقق في آخر كل رسالة

ولاحظ في رد الإعارة الحرف الأخير من `NNY`، وهو «فك الحماية» Desensitize بقيمة نعم. هذا هو الحقل الذي يقول للجهاز: غير قيمة AFI أو بت EAS على شريحة هذا الكتاب الآن، وإلا أطلقت البوابة الإنذار عند خروج الطالب. أي أن الطبقتين تلتقيان هنا فقط: القرار من SIP2، والتنفيذ على الشريحة.

### رمز التحقق Checksum

آخر حقلين في كل رسالة `AY` و`AZ`: رقم تسلسل من 0 إلى 9، ورمز تحقق يكتشف الرسالة التي تلفت في الطريق. وطريقة حسابه في الوثيقة، صفحة 16: اجمع قيم كل الحروف من أول الرسالة إلى `AZ`، وخذ أدنى 16 بت من المجموع، ثم المتمم الثنائي Two's Complement، واكتبه بأربعة أرقام ست عشرية. وهذا السطر في العميل يفعل ذلك:

```python
return format((-sum(msg.encode("utf-8"))) & 0xFFFF, "04X")
```

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

### الحالات اليومية: رقم سري خطأ، وقارئ موقوف، وتجديد

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

```python
"""Things a self-check machine meets every day, sent as raw SIP2: python3 sip_cases.py HOST PORT"""
import socket, sys, datetime

def checksum(msg, unit):
    data = msg.encode("utf-8") if unit == "bytes" else [ord(c) for c in msg]
    return format((-sum(data)) & 0xFFFF, "04X")

def talk(sock, msg):
    sock.sendall((msg + "\r").encode("utf-8"))
    data = b""
    while b"\r" not in data:
        data += sock.recv(4096)
    return data.decode("utf-8").rstrip("\r\n")

def framed(body, seq):
    m = f"{body}AY{seq}AZ"
    return m + checksum(m, "bytes")

now = datetime.datetime.now().strftime("%Y%m%d    %H%M%S")
s = socket.create_connection((sys.argv[1], int(sys.argv[2])), timeout=30)
print("login:", talk(s, framed("9300CNsipkiosk|COKiosk-2026!|CPMAIN|", 0)))
cases = [
    ("wrong PIN, patron status",  f"23001{now}AOMAIN|AASTU-1001|AC|ADwrong-pin|"),
    ("blocked patron, checkout",  f"11YN{now}{now}AOMAIN|AASTU-1002|ABLIB-0002|AC|ADReader-2026!|"),
    ("unknown barcode, checkout", f"11YN{now}{now}AOMAIN|AASTU-1001|ABLIB-9999|AC|ADReader-2026!|"),
    ("first checkout",            f"11YN{now}{now}AOMAIN|AASTU-1001|ABLIB-0003|AC|ADReader-2026!|"),
    ("same book again (renewal)", f"11YN{now}{now}AOMAIN|AASTU-1001|ABLIB-0003|AC|ADReader-2026!|"),
    ("return it",                 f"09N{now}{now}APMAIN|AOMAIN|ABLIB-0003|AC|"),
]
for i, (label, body) in enumerate(cases, 1):
    print(f"--- {label}\n<<< {talk(s, framed(body, i % 10))}")
# a message whose checksum does not match: the server should ask for a resend (96)
bad = f"9900302.00AY7AZ0000"
print(f"--- wrong checksum\n>>> {bad}\n<<< {talk(s, bad)}")
s.close()
```

```text
login: 941AY0AZFDFD
--- wrong PIN, patron status
<<< 24              00120261118    091907AEخالد الطالب|AASTU-1001|BLY|CQN|BV0|AFGreetings from Koha.  -- Invalid password|AOMAIN|AY1AZD03F
--- blocked patron, checkout
<<< 120NUN20261118    091908AOMAIN|AASTU-1002|ABLIB-0002|AJالبيان والتبيين|AH|AFPatron debarred|BLY|AY2AZD385
--- unknown barcode, checkout
<<< 120NUN20261118    091908AOMAIN|AASTU-1001|ABLIB-9999|AJ|AH|AFInvalid Item|BLY|AY3AZE8DB
--- first checkout
<<< 121NNY20261118    091909AOMAIN|AASTU-1001|ABLIB-0003|AJالأيام|AH20261202    235900|AY4AZE3F8
--- same book again (renewal)
<<< 121YNY20261118    091910AOMAIN|AASTU-1001|ABLIB-0003|AJالأيام|AH20261216    235900|AFItem already checked out to you: renewing item.|AY5AZD1C6
--- return it
<<< 101YNN20261118    091910AOMAIN|ABLIB-0003|AQMAIN|AJالأيام|AASTU-1001|AY6AZE614
--- wrong checksum
>>> 9900302.00AY7AZ0000
<<< 96AZFEF6
```

في المخرج أعلاه لاحظ التالي:

- **الرقم السري الخطأ:** الرد ما زال 24، والقارئ معروف `BLY`، ولكن `CQN` أي الرقم السري غير صحيح، ومعه الرسالة «Invalid password». والقرار هنا عند الجهاز: لا يسمح بالإعارة. ولاحظ أن الرد أعاد اسم الطالب رغم أن الرقم السري خطأ، أي أن من يعرف رقم بطاقة شخص يستطيع أن يعرف اسمه من الجهاز، وهذا سلوك يجب أن تعرفه.
- **القارئ الموقوف:** `120` أي لم تتم الإعارة، والسبب في `AF`: «Patron debarred». والجهاز يعرض هذه الرسالة على الشاشة كما هي بالإنجليزية، وقد كتبنا سبب الإيقاف «Lost book not returned» في Koha ولكنه لم يرسله، وسوف نترجم هذه الرسالة بعد قليل.
- **الباركود غير الموجود:** «Invalid Item»، وهي حالة كتاب من مكتبة أخرى، أو شريحة رمزت خطأ.
- **الكتاب نفسه مرتين:** في المرة الثانية `121Y`، أي تمت، والحرف الثاني Y يعني أنها تجديد Renewal، وتاريخ الإرجاع أصبح 16 ديسمبر، والرسالة «Item already checked out to you: renewing item». وهذا سلوك Koha عندما يضع الطالب كتاباً معاراً له أصلاً.
- **رمز التحقق الخاطئ:** الرد `96`، وهو في الوثيقة طلب إعادة الإرسال Request SC Resend، أي أن الخادم لم يقبل الرسالة ولم ينفذها.

وكل هذه المعاملات سجلها Koha في جدول الإحصاءات `statistics` مع العمود `interface` بالقيمة `sip`، وهذا ما سوف نستخدمه في مقال التقارير لنعرف كم إعارة تتم عبر الأجهزة وكم عبر المكتب:

```text
datetime	branch	type	itemnumber	borrowernumber	interface
2026-11-18 09:18:33	MAIN	issue	1	2	sip
2026-11-18 09:18:35	MAIN	return	1	2	sip
2026-11-18 09:19:09	MAIN	issue	3	2	sip
2026-11-18 09:19:10	MAIN	renew	3	2	sip
2026-11-18 09:19:10	MAIN	return	3	2	sip
2026-11-18 09:19:39	MAIN	issue	2	2	sip
2026-11-18 09:19:39	MAIN	return	2	2	sip
```

وهذه المعاملات نفسها كما يراها موظف المكتبة في سجل إعارات الطالب في واجهة الموظفين:

![لقطة شاشة حقيقية من واجهة موظفي Koha 26.05: صفحة سجل الإعارات Circulation history للطالب خالد الطالب STU-1001 من المكتبة المركزية، وجدول بثلاثة صفوف: الأيام لطه حسين بالباركود LIB-0003 وعدد تجديدات 1 وتاريخ الإرجاع المستحق 12/16/2026 وأعيد في 11/18/2026، والبيان والتبيين للجاحظ LIB-0002 بتاريخ استحقاق 12/02/2026 وأعيد في اليوم نفسه، ومقدمة ابن خلدون LIB-0001 أعيد في اليوم نفسه، وكلها من المكتبة المركزية](https://arabroot.io/content/images/2026/11/library-rfid-07-koha-history.webp)

ما فعله «الجهاز» عبر SIP2 يظهر في Koha كأي إعارة من المكتب

### كتاب عليه حجز لقارئ آخر

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

```perl
#!/usr/bin/perl
# Run with koha-shell: the staff member (borrowernumber 4) places a hold on «مقدمة ابن خلدون» (biblio 1)
use Modern::Perl;
use C4::Context;
use C4::Reserves qw(AddReserve);
my $id = AddReserve({ branchcode => 'MAIN', borrowernumber => 4, biblionumber => 1, priority => 1 });
say "hold $id placed on biblio 1 for borrower 4";
```

```python
"""A book with a hold for someone else: the student returns it at the kiosk, then tries to borrow it again"""
import socket, sys, datetime
def ck(m): return format((-sum(m.encode("utf-8"))) & 0xFFFF, "04X")
def talk(s, body, seq):
    m = f"{body}AY{seq}AZ"; m += ck(m)
    s.sendall((m + "\r").encode()); d = b""
    while b"\r" not in d: d += s.recv(4096)
    return d.decode().rstrip("\r\n")
now = datetime.datetime.now().strftime("%Y%m%d    %H%M%S")
s = socket.create_connection((sys.argv[1], int(sys.argv[2])), timeout=30)
talk(s, "9300CNsipkiosk|COKiosk-2026!|CPMAIN|", 0)
steps = [
    ("checkout before the hold is filled", f"11YN{now}{now}AOMAIN|AASTU-1001|ABLIB-0001|AC|ADReader-2026!|"),
    ("return at the kiosk",                f"09N{now}{now}APMAIN|AOMAIN|ABLIB-0001|AC|"),
    ("try to borrow it again",             f"11YN{now}{now}AOMAIN|AASTU-1001|ABLIB-0001|AC|ADReader-2026!|"),
]
for i, (label, body) in enumerate(steps, 1):
    print(f"--- {label}\n<<< {talk(s, body, i)}")
```

```text
hold 1 placed on biblio 1 for borrower 4
--- checkout before the hold is filled
<<< 120NUN20261118    095331AOMAIN|AASTU-1001|ABLIB-0001|AJمقدمة ابن خلدون|AH|AFItem is reserved for another patron upon return.|BLY|AY1AZC88E
--- return at the kiosk
<<< 101YNY20261118    095332AOMAIN|ABLIB-0001|AQMAIN|AJمقدمة ابن خلدون|CYSTAFF-1|CTMAIN|DALibrarian|CV01|AY2AZD379
--- try to borrow it again
<<< 120NUN20261118    095332AOMAIN|AASTU-1001|ABLIB-0001|AJمقدمة ابن خلدون|AH|AFItem is on hold for another patron.|BLY|AY3AZCDE9
```

في المخرج أعلاه لاحظ التالي:

- **الإعارة الأولى رفضت:** الكتاب على الرف ولم يخصص بعد لصاحب الحجز، ومع ذلك رفض Koha الإعارة برسالة «Item is reserved for another patron upon return»، أي أن الحجز يمنع إعارة النسخة لغيره. وهذا السلوك يعتمد على إعدادات الحجز في مكتبتك، فجربه بإعداداتك أنت.
- **الإرجاع فيه تنبيه:** الرد `101YNY`: تم الإرجاع، وأعيدت الحماية Resensitize، والحرف الأخير Y هو التنبيه Alert، وتقول الوثيقة إنه يصدر صوتاً في الجهاز لحالات مثل الكتب المحجوزة. ومعه الحقل `CV01` لنوع التنبيه، وهو من الإضافات التي جاءت بعد وثيقة 2.00 ويرسله Koha، والقيمة 01 تعني حجزاً في هذه المكتبة. والجهاز الذي يفهم هذا الحقل يطبع إيصالاً يقول ضع الكتاب على رف الحجوزات، وصندوق الإرجاع الآلي يرسله إلى سلة منفصلة.
- **اسم صاحب الحجز في الرد:** في الحقول `CY` و`DA` رقم بطاقة صاحب الحجز واسمه، وصلت إلى جهاز يقف أمامه طالب آخر. والجهاز الجيد لا يعرض هذا للطالب، ولكنه موجود في حركة الشبكة وفي سجلات الجهاز، وهذا سبب آخر لحماية الاتصال، ولسؤال المورد عما يحفظه الجهاز في سجلاته ومدة حفظها.
- **المحاولة الثانية:** بعد الإرجاع أصبحت النسخة محجوزة فعلاً، فتغيرت الرسالة إلى «Item is on hold for another patron».

## العربية في SIP2: مشكلتان قبل أن يشتكي القراء

### الترميز: أسماء من علامات استفهام

الوثيقة الأصلية من 1993 لا تذكر الترميز أصلاً، والأجهزة القديمة تفترض ASCII. وفي Koha يحدد الترميز لكل حساب في `SIPconfig.xml`، والملف النموذجي فيه أمثلة بـ `encoding="ascii"`. فغيرنا حسابنا إلى ascii، وأعدنا التشغيل، وأرسلنا الجلسة نفسها:

```text
--- 23 Patron Status  (172 ms)
>>> 2300120261118    091938AOMAIN|AASTU-1001|AC|ADReader-2026!|AY2AZEFCA
<<< 24              00120261118    091938AE???? ??????|AASTU-1001|BLY|CQY|BV0|AFGreetings from Koha. |AOMAIN|AY2AZE35D
--
--- 11 Checkout  (583 ms)
>>> 11YN20261118    09193820261118    091938AOMAIN|AASTU-1001|ABLIB-0002|AC|ADReader-2026!|AY4AZE99D
<<< 121NNY20261118    091939AOMAIN|AASTU-1001|ABLIB-0002|AJ?????? ????????|AH20261202    235900|AY4AZE8FB
```

أي أن اسم «خالد الطالب» وصل «???? ??????»، وعنوان «البيان والتبيين» وصل علامات استفهام، والإعارة نفسها تمت بنجاح. فالطالب يأخذ إيصالاً لا يقرؤه، والمكتبة تظن أن المشكلة في طابعة الجهاز. لذلك اجعل الترميز `utf8`، ثم اسأل المورد صراحة: هل يعرض الجهاز العربية ويطبعها من UTF-8؟ وجرب بقارئ اسمه عربي وكتاب عنوانه عربي قبل الاستلام.

### رمز التحقق: الحروف أم البايتات؟

الوثيقة تقول «اجمع الحروف»، وكانت الحروف والبايتات شيئاً واحداً في ASCII. أما في UTF-8 فالحرف العربي بايتان، فما الذي يجمعه Koha؟ كتبنا سكربتاً يعيد حساب رمز التحقق لكل رد في الجلسة بالطريقتين:

```python
"""Check the checksums the server sent, counting characters and counting UTF-8 bytes: python3 verify.py session.txt"""
import sys
for line in open(sys.argv[1], encoding="utf-8"):
    if not line.startswith("<<< "): continue
    m = line[4:].rstrip("\n")
    body, sent = m[:-4], m[-4:]
    by_bytes = format((-sum(body.encode("utf-8"))) & 0xFFFF, "04X")
    by_chars = format((-sum(ord(c) for c in body)) & 0xFFFF, "04X")
    arabic = any("\u0600" <= c <= "\u06ff" for c in body)
    print(f"{m[:3]}  sent {sent}  bytes {by_bytes} {'OK ' if by_bytes == sent else 'BAD'}  chars {by_chars} {'OK ' if by_chars == sent else 'BAD'}  arabic={arabic}")
```

```text
941  sent FDFD  bytes FDFD OK   chars FDFD OK   arabic=False
98Y  sent EE27  bytes EE27 OK   chars EE27 OK   arabic=False
24   sent D724  bytes D724 OK   chars A7D7 BAD  arabic=True
64   sent CE44  bytes CE44 OK   chars 9EF7 BAD  arabic=True
121  sent D9AE  bytes D9AE OK   chars 9B6D BAD  arabic=True
180  sent D831  bytes D831 OK   chars 99F0 BAD  arabic=True
101  sent DBBF  bytes DBBF OK   chars 9D7E BAD  arabic=True
```

![مقارنة الترميز في SIP2: مع encoding utf8 في SIPconfig.xml يصل الرد 24 بالاسم خالد الطالب والرد 12 بعنوان مقدمة ابن خلدون كما هما بشرط أن يفهم الجهاز UTF-8 ويعرض العربية، ومع encoding ascii يصل الاسم والعنوان علامات استفهام فيطبع الإيصال ؟؟؟؟ بدل اسم الكتاب، وتحتها جدول رمز التحقق: الردود 941 و98Y دون عربية صحيحة بالطريقتين، والردود 24 و121 التي فيها عربية صحيحة بجمع بايتات UTF-8 فقط وخاطئة بجمع الحروف، وفي الأسفل: Koha يجمع البايتات والجهاز الذي يجمع الحروف يرفض كل رد فيه اسم عربي ويطلب إعادة الإرسال](https://arabroot.io/content/images/2026/11/library-rfid-05-arabic.webp)

الردود بلا عربية تمر بالطريقتين، والردود التي فيها اسم عربي لا تمر إلا بجمع البايتات

أي أن Koha يحسب رمز التحقق على بايتات UTF-8\. والجهاز الذي برمجه مورده ليجمع الحروف سوف يجد رمز التحقق خاطئاً في كل رد فيه اسم عربي، فيطلب إعادة الإرسال، فيأتيه الرد نفسه، فيتوقف أو يظهر «خطأ في الاتصال»، بينما يعمل كل شيء مع الطلاب الذين أسماؤهم مكتوبة بالحروف اللاتينية. وهذه مشكلة لا تظهر في عرض المورد إذا جربها بقارئ تجريبي اسمه Test. لذلك اجعل من شروط الاستلام: إعارة وإرجاع لقارئ اسمه عربي وكتاب عنوانه عربي، مع تفعيل كشف الأخطاء error-detect.

### رسائل الشاشة بالعربية

في الوثيقة حقل لغة من ثلاثة أرقام في رسائل القارئ، وفيه رمز لكل لغة، ومنها `016` للعربية، والجهاز يرسله ليطلب من نظام المكتبة أن يكتب رسائل الشاشة بلغة القارئ. فأرسلنا حالة القارئ نفسها مرة بالإنجليزية 001 ومرة بالعربية 016:

```python
"""Ask for the patron status in English (001) and in Arabic (016): does the screen message change?"""
import socket, sys, datetime
def ck(m): return format((-sum(m.encode("utf-8"))) & 0xFFFF, "04X")
def talk(s, body, seq):
    m = f"{body}AY{seq}AZ"; m += ck(m)
    s.sendall((m + "\r").encode()); d = b""
    while b"\r" not in d: d += s.recv(4096)
    return d.decode().rstrip("\r\n")
now = datetime.datetime.now().strftime("%Y%m%d    %H%M%S")
s = socket.create_connection((sys.argv[1], int(sys.argv[2])), timeout=30)
talk(s, "9300CNsipkiosk|COKiosk-2026!|CPMAIN|", 0)
for i, lang in enumerate(["001", "016"], 1):
    print(f"language {lang}: {talk(s, f'23{lang}{now}AOMAIN|AASTU-1001|AC|ADReader-2026!|', i)}")
```

وكان الرد في المرتين الرسالة نفسها «Greetings from Koha.»، أي أن Koha يعيد رمز اللغة كما هو ولا يغير الرسالة. والحل في ملف الإعداد نفسه: الوسم `screen_msg_regex` داخل الحساب، الذي يستبدل نص أي رسالة بنص آخر، وهو موجود في الملف النموذجي. وهذا هو الحساب بعد الإضافة، كما في `SIPconfig.xml` النهائي أعلاه:

```xml
<login id="sipkiosk" password="Kiosk-2026!" delimiter="|" error-detect="enabled"
       institution="MAIN" encoding="utf8" checked_in_ok="1">
  <screen_msg_regex find="Greetings from Koha." replace="أهلاً بك في المكتبة المركزية" />
  <screen_msg_regex find="Patron debarred" replace="حسابك موقوف، راجع مكتب الإعارة" />
</login>
```

وبعد إعادة تشغيل الخادم أرسلنا الرسائل نفسها:

```text
language 001: 24              00120261118    095023AEخالد الطالب|AASTU-1001|BLY|CQY|BV0|AFأهلاً بك في المكتبة المركزية |AOMAIN|AY1AZBBA2
language 016: 24              01620261118    095023AEخالد الطالب|AASTU-1001|BLY|CQY|BV0|AFأهلاً بك في المكتبة المركزية |AOMAIN|AY2AZBB9B
--- blocked patron, checkout
<<< 120NUN20261118    095023AOMAIN|AASTU-1002|ABLIB-0002|AJالبيان والتبيين|AH|AFحسابك موقوف، راجع مكتب الإعارة|BLY|AY2AZB2EA
```

أي أن الطالب يرى الترحيب بالعربية، والطالبة الموقوفة ترى سبباً مفهوماً بدلاً من «Patron debarred». ولاحظ أن رمز التحقق تغير مع تغير النص، لأنه يحسب على البايتات العربية الجديدة، وهذا ما يجب أن يحسبه الجهاز بالطريقة نفسها. واجمع قائمة الرسائل التي يرسلها Koha من السجل `sip-output.log` بعد أسبوع من التشغيل التجريبي، وترجم ما يظهر للقراء منها.

## الأمان: منفذ مفتوح وكلمات مرور نصية

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

- **الشبكة:** لا تفتح منفذ SIP2 إلا لعناوين أجهزة الإعارة، بجدار ناري Firewall على سيرفر Koha، ويفضل أن تكون الأجهزة في شبكة خاصة بها VLAN. والإعداد في الملف `*:6001` يعني كل الواجهات، فالجدار الناري هو الذي يحدد من يصل.
- **التشفير:** إذا كان الجهاز في فرع بعيد ويمر اتصاله على شبكة لا تملكها، فضعه داخل نفق مشفر مثل VPN أو stunnel بين الفرع والسيرفر.
- **حساب الجهاز:** صلاحية الإعارة فقط، وكلمة مرور قوية خاصة بكل جهاز، حتى تعرف من سجلات Koha أي جهاز نفذ أي معاملة، وتستطيع أن توقف جهازاً واحداً.
- **الأمثلة في الملف النموذجي:** احذف كل الحسابات والمؤسسات التي لا تستخدمها، فالملف الذي فيه `term1/term1` اليوم قد يصبح ثغرة إذا أنشأ أحدهم غداً مستخدماً بهذا الاسم.

وSIP2 لا يستخدم للأجهزة فقط، فخدمات أخرى تستخدمه للتحقق من القراء، ومنها [طرق الدخول في EZproxy](https://help.oclc.org/Library%5FManagement/EZproxy/Authenticate%5Fusers/EZproxy%5Fauthentication%5Fmethods?ref=arabroot.io) التي تشمل SIP، وسوف نعود إلى ذلك في مقال الوصول إلى قواعد البيانات من خارج الحرم. وكل خدمة من هذه تحتاج حساباً خاصاً بها بالقواعد نفسها.

![صورة حقيقية لجهاز إعارة ذاتية في مكتبة عامة في برشلونة: شاشة لمس كبيرة عليها أزرار الإعارة والتجديد والإرجاع وحساب القارئ، وتحتها سطح أبيض عليه رسم كتابين يوضع فوقه الكتاب ليقرأ القارئ RFID تحته، وقارئ باركود بخط ضوئي أحمر للبطاقة، وطابعة إيصالات على اليمين، واسم الشركة المصنعة على الجهاز](https://arabroot.io/content/images/2026/11/library-rfid-02-kiosk-photo.webp)

جهاز إعارة ذاتية في مكتبة Les Corts في برشلونة: القارئ تحت السطح، وماسح البطاقة، والطابعة. تصوير Manuel C.، [ويكيميديا كومنز](https://commons.wikimedia.org/wiki/File:RFID%5FBiblioteca%5FLes%5FCorts-Miquel%5FLlongueras%5F122847.jpg?ref=arabroot.io)، رخصة [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/?ref=arabroot.io)

## هل تحتاج RFID أصلاً؟

قد يتساءل البعض: إذا كان SIP2 يعمل مع الباركود، فلماذا ندفع ثمن الشرائح؟ والإجابة تعتمد على ما تريد أن يتغير في المكتبة، والجدول التالي يضع الخيارين جنباً إلى جنب:

| ما تريده                     | جهاز بالباركود                    | جهاز بـ RFID                              |
| ---------------------------- | --------------------------------- | ----------------------------------------- |
| تقليل طابور المكتب           | نعم، كتاب بعد كتاب                | نعم، عدة كتب معاً دون البحث عن الباركود   |
| الحماية عند الباب            | شريط مغناطيسي منفصل يفك بجهاز آخر | من الشريحة نفسها عبر AFI أو EAS           |
| الجرد                        | مسح كل كتاب بيده                  | قارئ محمول يمر على الرف                   |
| صناديق الإرجاع الآلية وفرزها | صعبة                              | مناسبة                                    |
| التكلفة الأولى               | جهاز فقط                          | جهاز وبوابات وشريحة لكل نسخة ومشروع ترميز |
| التكامل مع نظام المكتبة      | SIP2                              | SIP2 نفسه                                 |

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

## مشروع الترميز: من الباركود إلى الشريحة

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

1. **التعشيب Weeding أولاً:** لا تدفع ثمن شريحة لكتاب سوف تستبعده بعد سنة، فراجع المجموعة قبل الترميز.
2. **محطة الترميز:** قارئ مكتبي متصل بجهاز، يمسح الموظف الباركود الموجود على الكتاب، فيكتب البرنامج الرقم نفسه على الشريحة بصيغة ISO 28560 مع رمز المكتبة، ويضبط الحماية.
3. **الرقم نفسه:** الشريحة تحمل الباركود الحالي نفسه وليس رقماً جديداً، حتى لا يتغير شيء في Koha، وحتى يبقى الباركود المطبوع صالحاً إذا تعطلت الشريحة.
4. **التحقق بالعينة:** عشرة كتب من كل صندوق تقرأ بقارئ آخر ويبحث عنها في Koha، لأن خطأ في إعداد محطة الترميز يتكرر على آلاف الكتب قبل أن يلاحظه أحد.
5. **الجرد الأول:** بعد الترميز يكون أول جرد بالقارئ المحمول اختباراً للمشروع كله، فالكتاب الموجود على الرف ولم يقرأ إما بلا شريحة أو شريحته تالفة.

وفي Koha أداة للجرد Inventory ضمن الأدوات، كما في [دليل الأدوات](https://koha-community.org/manual/26.05/en/html/tools.html?ref=arabroot.io)، تقبل ملفاً نصياً بالباركودات المقروءة وتقارنها بما يجب أن يكون على الرف، والقارئ المحمول يصدر عادة هذا الملف، فيصبح الجرد قراءة للرف ثم رفع ملف.

## عندما يتوقف نظام المكتبة: وضع عدم الاتصال

ماذا يفعل الجهاز إذا توقف Koha للتحديث، أو انقطعت الشبكة؟ الوثيقة تعرف وضع عدم الاتصال Offline، أو التخزين ثم الإرسال Store and Forward: الجهاز يسجل الإعارات والإرجاعات عنده، ثم يرسلها عندما يعود النظام، ومعها الحقل `no block` بقيمة `Y`. وتقول الوثيقة إن هذا الحقل يخبر نظام المكتبة أن المعاملة نفذت فعلاً والنظام متوقف، فلا يجب أن يرفضها. وفي ملف الإعداد عندنا `offline="false"` ضمن سياسة المؤسسة، أي أن مكتبتنا لا تعلن دعم هذا الوضع.

والقرار هنا قرار سياسة أكثر منه قراراً تقنياً: إذا سمحت بالإعارة دون اتصال، فقد يأخذ طالب موقوف كتاباً لأن الجهاز لا يعرف أنه موقوف، ثم يقبل Koha المعاملة لاحقاً لأن `no block` بقيمة Y. وإذا منعتها، توقفت الإعارة الذاتية كلما توقف النظام. والحل الوسط المعتاد أن تسمح بالإرجاع دون اتصال لأنه لا يضر، وتمنع الإعارة أو تسمح بها بحد صغير. واكتب القرار، واضبط الجهاز عليه، وجربه بإيقاف `koha-sip` فعلاً قبل التشغيل.

## SIP2 وNCIP وواجهات REST

SIP2 ليس الطريقة الوحيدة لتتكلم الأنظمة عن الإعارة. فهناك معيار NISO للتبادل في الإعارة [NCIP](https://www.niso.org/standards-committees/ncip?ref=arabroot.io)، وهو أحدث ومبني على XML، ويستخدم أكثر في الإعارة بين المكتبات Interlibrary Loan وفي ربط الأنظمة ببعضها، وموقع NISO نفسه يذكر الصلة الوثيقة بين المعيارين. وفي Koha أيضاً واجهة REST حديثة. ولكن أجهزة الإعارة الذاتية في السوق تتكلم SIP2 قبل أي شيء آخر، وهذا سبب بقاء بروتوكول من 1993 حياً، كما بقي Z39.50 في الفهرسة: قيمته في عدد من يتكلمه.

### سجلات خادم SIP2: ماذا يحفظ Koha؟

كل رسالة تصل إلى خادم SIP2 تكتب في السجل `/var/log/koha/library/sip-output.log`، وهو أول مكان تنظر فيه عندما يشتكي جهاز. وهذان سطران من السجل نفسه أثناء جلسة المختبر:

```text
[2026/11/18 09:18:27] [1850] [INFO] sipkiosk@127.0.0.1: INPUT MSG: '9900302.00AY1AZFCA5'
[2026/11/18 09:18:27] [1850] [INFO] sipkiosk@127.0.0.1: INPUT MSG: '2300120261118    091827AOMAIN|AASTU-1001|AC***|AD***|AY2AZEFCD'
```

ولاحظ أن Koha يخفي كلمة المرور والرقم السري في السجل، فيكتب `AC***` و`AD***` بدلاً منهما، وكذلك كلمة مرور حساب الجهاز في رسالة الدخول `CO***`. وهذا تصرف صحيح، ولكن رقم البطاقة `AASTU-1001` يبقى ظاهراً، ومعه في الردود أسماء القراء وعناوين ما استعاروه. أي أن هذا السجل سجل قراءة لكل من يستخدم الأجهزة، وحمايته جزء من حماية خصوصية القراء التي بدأنا بها هذا المقال. وحزمة Koha تدير السجلات بملف `/etc/logrotate.d/koha-common` الذي يحتفظ بخمسة أسابيع مضغوطة، فقرر إن كانت هذه المدة مناسبة لسياسة الخصوصية في مؤسستك، ولا تنسخ هذه السجلات إلى أنظمة مراقبة خارجية دون أن تعرف من يقرؤها هناك.

ولمراقبة الخادم نفسه، يكفي في البداية أمران: الأمر `koha-sip --status library` في مهمة دورية تنبهك إذا توقف، واختبار حقيقي كل بضع دقائق من سيرفر المراقبة يرسل رسالة الدخول 93 ثم 99 بحساب مراقبة خاص، ويتأكد أن الرد `941`. والسبب أن المنفذ قد يكون مفتوحاً والخادم لا يقبل الاتصالات، كما رأينا في مشكلة `0.0.0.0`، فمراقبة المنفذ وحدها تقول لك إن كل شيء يعمل وهو لا يعمل.

## قبل الشراء: ماذا تسأل المورد؟

| السؤال                                                 | لماذا                                                                     |
| ------------------------------------------------------ | ------------------------------------------------------------------------- |
| هل الشرائح وفق ISO 28560-2، وهل تقرؤها أجهزة مورد آخر؟ | حتى لا تعيد ترميز كل الكتب إذا غيرت المورد                                |
| ما الذي يكتب على الشريحة بالضبط؟                       | رقم النسخة ورمز المكتبة فقط، دون أي بيانات عن القارئ                      |
| AFI أم EAS للحماية، وما القيم المستخدمة؟               | للتوافق مع البوابات والمكتبات الأخرى، والقيمتان المخصصتان للمكتبات 07 وC2 |
| هل جربتم SIP2 مع Koha أو نظامنا، وأي نسخة؟             | كل نظام يفسر بعض الحقول بطريقته                                           |
| هل يعرض الجهاز العربية ويطبعها من UTF-8؟               | حتى لا تصل الأسماء علامات استفهام                                         |
| كيف يحسب الجهاز رمز التحقق مع UTF-8؟                   | Koha يجمع البايتات، والجهاز الذي يجمع الحروف يرفض الردود العربية          |
| هل يدعم الاتصال عبر TLS أو نفق مشفر؟                   | البروتوكول نفسه بلا تشفير                                                 |
| ماذا يفعل الجهاز إذا توقف نظام المكتبة؟                | بعض الأجهزة تخزن المعاملات وترسلها لاحقاً Offline، وهذا يحتاج سياسة واضحة |

## سيناريو الاستلام: عشر حالات من المختبر

عندما يركب المورد الجهاز ويقول «يعمل»، فهذا يعني غالباً أنه أعار كتاباً واحداً لقارئ تجريبي. والجدول التالي يحول ما جربناه في المختبر إلى سيناريو استلام تنفذه أنت على الجهاز الحقيقي، والعمود الأخير هو ما رد به Koha 26.05.05 في المختبر، فإذا رأى الطالب على الشاشة شيئاً مختلفاً فالمشكلة في الجهاز أو في إعداده:

| الحالة                                 | ما يجب أن يحدث                            | رد Koha في المختبر                   |
| -------------------------------------- | ----------------------------------------- | ------------------------------------ |
| إعارة كتاب عنوانه عربي لطالب اسمه عربي | الاسم والعنوان صحيحان على الشاشة والإيصال | 121 مع AJ بالعربية                   |
| رقم سري خطأ                            | لا إعارة، ورسالة واضحة                    | CQN                                  |
| طالب موقوف                             | رفض بسبب مفهوم                            | 120 مع رسالة الإيقاف                 |
| كتاب من مكتبة أخرى                     | رفض، وتوجيه للمكتب                        | «Invalid Item»                       |
| كتاب معار للطالب نفسه                  | تجديد وتاريخ جديد                         | 121Y                                 |
| كتاب محجوز لقارئ آخر                   | رفض الإعارة                               | «Item is on hold for another patron» |
| إرجاع كتاب محجوز                       | إيصال «ضعه على رف الحجوزات»               | CV01                                 |
| خمسة كتب معاً على السطح                | خمس إعارات، وفك حماية كل منها             | رد 12 لكل كتاب                       |
| الخروج بكتاب معار من البوابة           | لا إنذار                                  | الجهاز فك الحماية بعد NNY            |
| إيقاف خادم SIP أثناء العمل             | سلوك وضع عدم الاتصال الذي قررته           | بحسب الإعداد                         |

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

## أخطاء شائعة وحلولها

| الخطأ                                | ما الذي يحدث                                                           | الحل                                   |
| ------------------------------------ | ---------------------------------------------------------------------- | -------------------------------------- |
| المنفذ 0.0.0.0:6001 في SIPconfig.xml | الخادم يستمع ولكنه يغلق كل اتصال: Unknown recognized server connection | \*:6001/tcp/IPv4 أو عنوان الواجهة نفسه |
| حساب الجهاز بصلاحيات واسعة           | كلمة مرور مدير تمر نصاً على الشبكة                                     | حساب لكل جهاز بصلاحية الإعارة فقط      |
| encoding="ascii"                     | الأسماء والعناوين العربية علامات استفهام                               | utf8 وتجربة على جهاز حقيقي             |
| التجربة بقارئ اسمه Test              | مشكلة رمز التحقق لا تظهر إلا مع الأسماء العربية                        | شروط استلام بأسماء وعناوين عربية       |
| منفذ SIP2 مفتوح للشبكة كلها          | أي جهاز يستطيع تجربة أرقام البطاقات ومعرفة الأسماء                     | جدار ناري لعناوين الأجهزة فقط          |
| ملف SQL عربي دون ترميز               | أسماء مرمزة مرتين في الواجهة                                           | \--default-character-set=utf8mb4       |
| بيانات القارئ على الشريحة            | أي قارئ HF في الشارع يقرؤها                                            | رقم النسخة ورمز المكتبة فقط            |

## قائمة تحقق قبل تشغيل أول جهاز

- حساب Koha خاص بكل جهاز، بصلاحية الإعارة فقط، وكلمة مرور قوية.
- SIPconfig.xml فيه حساباتك ومؤسستك فقط، والمنفذ بشكل يطابقه Koha، والترميز utf8، وكشف الأخطاء مفعل.
- جدار ناري على المنفذ لعناوين الأجهزة فقط، ونفق مشفر للفروع البعيدة.
- جلسة كاملة بعميل مثل sip2.py قبل وصول الجهاز، حتى تعرف أن مشكلة اليوم الأول ليست عندك.
- إعارة وإرجاع وتجديد بقارئ اسمه عربي وكتاب عنوانه عربي على الجهاز الحقيقي.
- رسائل الإيقاف والغرامات مكتوبة بلغة تصلح أن تظهر على شاشة الجهاز.
- عينة شرائح من المورد قرئت بجهاز مستقل، والتحقق من أنها لا تحمل إلا رقم النسخة ورمز المكتبة.

## تدريب عملي

- شغل `sip2.py` على نسخة اختبار من نظام مكتبتك، وغير رقم الباركود إلى كتاب عليه حجز لقارئ آخر، واقرأ رد Koha.
- أضف إلى `sip_cases.py` رسالة 29 للتجديد Renew، وقارن ردها برد الإعارة الثانية للكتاب نفسه.

## الخلاصة

وصلنا لنهاية الموضوع، وأهم ما فيه:

- الإعارة الذاتية طبقتان: RFID يقرأ رقم النسخة من الشريحة، وSIP2 ينقل الطلب والقرار بين الجهاز ونظام المكتبة، وكل قرار في نظام المكتبة.
- الشرائح على 13.56 MHz وفق ISO/IEC 18000-3 Mode 1 وISO 15693، وما يكتب عليها وفق ISO 28560، والقيمتان المخصصتان للمكتبات في AFI هما 07 داخل المكتبة وC2 عند الإعارة، ولا يكتب على الشريحة شيء عن القارئ.
- SIP2 أسطر نصية بحقول ثابتة وحقول برمز من حرفين، بلا تشفير، وفيها الرقم السري وكلمة مرور الجهاز، فحمايته في الشبكة وفي صلاحيات الحساب.
- في Koha 26.05.05 كان المنفذ بالشكل `0.0.0.0:6001` سبباً لإغلاق كل اتصال، والشكل الصحيح `*:6001/tcp/IPv4`.
- الترميز ascii يحول الأسماء العربية إلى علامات استفهام، وKoha يحسب رمز التحقق على بايتات UTF-8، فاشترط في الاستلام تجربة بأسماء وعناوين عربية.
- الكتاب المحجوز لقارئ آخر يرفض عند الإعارة ويعود بتنبيه `CV01` عند الإرجاع، ومعه اسم صاحب الحجز، وسجل الخادم يحفظ أرقام البطاقات ويخفي الأرقام السرية، فاحم الاتصال والسجلات معاً.
- خيارات الحساب في SIPconfig.xml، مثل منع الإعارة لمن عليه متأخرات وطريقة التعامل مع الحجوزات، قرارات يكتبها مسؤول الإعارة مع موظف التقنية.
- كل معاملة عبر الجهاز تسجل في Koha بواجهة sip، وهي بيانات مقال التقارير.

وفي المقالين التاليين بإذن الله نخرج من مبنى المكتبة: الوصول إلى قواعد البيانات من البيت، ثم قياس الاستخدام:

[![](https://arabroot.io/content/images/2026/11/eresources-access-cover-cover.webp)دليلقواعد البيانات من خارج الحرم: الوكيل Proxy وSSOلماذا يرفض الناشر طالب الجامعة في بيته، وكيف يحل ذلك وكيل يعيد كتابة الروابط أو الدخول الموحد، مع مختبر يبني وكيلاً بـ nginx ودخولاً عبر SAML.](https://arabroot.io/articles/%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84-%D8%A7%D9%84%D9%89-%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D9%85%D9%86-%D8%AE%D8%A7%D8%B1%D8%AC-%D8%A7%D9%84%D8%AD%D8%B1%D9%85-proxy-%D9%88-sso/)[![](https://arabroot.io/content/images/2026/11/library-analytics-cover-cover.webp)دليلتقارير المكتبة وقياس الاستخدام COUNTER وSUSHIكيف تقيس المكتبة استخدام اشتراكاتها وكتبها بأرقام تدافع عنها: معيار COUNTER 5.1 وسحب التقارير بـ SUSHI وتقارير SQL في Koha، مع مختبر لكل منها.](https://arabroot.io/articles/%D8%AA%D9%82%D8%A7%D8%B1%D9%8A%D8%B1-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-%D9%88%D9%82%D9%8A%D8%A7%D8%B3-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-counter/)

## سجل التحديثات

- 18 نوفمبر 2026: كتابة المقال، وتشغيل خادم SIP2 في Koha 26.05.05 على Debian 13 مع عميل Python يرسل الرسائل 93 و99 و23 و63 و11 و17 و09 والحالات الخاطئة، واختبار الترميز ورمز التحقق مع الأسماء العربية.