في أيام الاختبارات تمتد أمام مكتب الإعارة في مكتبة الجامعة طوابير طويلة، وكل طالب معه كتابان أو ثلاثة، والموظف يمسح البطاقة ثم كل كتاب، ثم يزيل الشريط المغناطيسي، ثم يختم تاريخ الإرجاع. ولذلك تشتري المكتبات أجهزة الإعارة الذاتية Self-check: يضع الطالب بطاقته وكتبه على سطح الجهاز، فيقرأها كلها في ثانية، ويطبع إيصالاً بتاريخ الإرجاع. ويبدو المشروع شراء جهاز من مورد، ولكن الموظف التقني الذي يطلب منه «ربط الجهاز بالنظام» يكتشف أنه أمام بروتوكول اسمه SIP2 عمره ثلاثون سنة، ومنفذ TCP مفتوح على نظام المكتبة، وحساب بكلمة مرور مكتوبة في ملف نصي، وأسئلة لم يفكر فيها أحد: ماذا يرى الجهاز عن الطالب؟ وما الذي يحدث إذا كان اسم الطالب عربياً؟
وقد ذكرنا في دليل نظام المكتبة Koha أن الإعارة الذاتية تتصل به عبر SIP2 دون أن نجربها، وهذا المقال يكمل ذلك عملياً.
وفي هذا المقال سوف نناقش:
- طبقتا الإعارة الذاتية: الراديو بين الشريحة والجهاز RFID، والبروتوكول بين الجهاز ونظام المكتبة SIP2، ولماذا يجب أن تفصل بينهما في ذهنك.
- معايير شرائح المكتبات: ISO/IEC 18000-3 وISO/IEC 15693 للراديو، وISO 28560 لما يكتب على الشريحة، وما تقوله التوصية الأمريكية NISO RP-6-2012 عن الحماية والخصوصية.
- مختبر عملي: تشغيل خادم SIP2 في Koha 26.05.05، وكتابة عميل صغير يلعب دور الجهاز ويطبع كل رسالة كما هي: الدخول، وحالة القارئ، والإعارة، والإرجاع.
- ما يحدث في الحالات اليومية: رقم سري خطأ، وقارئ موقوف، وباركود غير موجود، وتجديد، ورسالة تالفة.
- مشكلتان عربيتان ظهرتا في المختبر: ترميز الحساب الذي يحول الأسماء إلى علامات استفهام، ورمز التحقق الذي يحسب على البايتات وليس الحروف.
وهذا أول مقال في مرحلة «خدمات المكتبة الحديثة»، وقبله مقالات المرحلة الأولى:
دليلخريطة أنظمة المكتبة: ILS والمستودع وبوابة البحثما الأنظمة التي تتكون منها المكتبة الحديثة وكيف تتكلم مع بعضها، مع مختبر ينسخ تسجيلة كتاب من مكتبة الكونغرس عبر Z39.50 ويحصد مستودعاً عبر OAI-PMH.
دليلنظام المكتبة Koha: فهرسة MARC21 بالعربية والإعارةكيف تثبت Koha من حزمه الرسمية بالعربية، وتفهرس كتباً عربية بـ MARC21 وتعيرها، وتصلح البحث العربي الذي لا يعمل في الإعداد الافتراضي.
دليلKoha أم Evergreen أم FOLIO؟ اختيار نظام المكتبةمقارنة عملية شغلنا فيها Koha وEvergreen على التسجيلات نفسها وقسنا الذاكرة والاستيراد والبحث العربي، مع FOLIO من توثيقه الرسمي وأرقام السوق لعام 2026.طبقتان: الراديو RFID والبروتوكول SIP2
أكثر خلط نراه في عروض الموردين أن «RFID» تستخدم اسماً للمشروع كله. والحقيقة أن الإعارة الذاتية طبقتان مستقلتان تماماً، ولكل منهما معاييره ومشكلاته، كما في الصورة التالية:

في الصورة أعلاه لاحظ التالي:
- الطبقة الأولى، الراديو: الشريحة 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 إن المعيارين التقنيين المهمين للمكتبات هما ISO/IEC 15693 وISO/IEC 18000-3 Mode 1، وإنهما متقاربان وليسا متطابقين، وإن المكتبات اعتمدت الثاني على نطاق واسع، وتنصح بالتركيز عليه لأنه يدار ضمن معايير «إدارة المواد» Item Management. وهذان المعياران يحددان كيف يتكلم القارئ والشريحة، أي الطبقة الفيزيائية، ولا يحددان ماذا يكتب في ذاكرة الشريحة.
وهنا يأتي المعيار الخاص بالمكتبات ISO 28560 بأجزائه، ويحدد عناصر البيانات وطريقة كتابتها على الشريحة: الجزء الأول للعناصر نفسها، والجزء الثاني لطريقة ترميز مرنة مبنية على ISO/IEC 15962، والجزء الثالث لطريقة ترميز بطول ثابت أصلها النموذج الدنماركي. والتوصية الأمريكية تختار الجزء الثاني. وقبل هذا المعيار كان لكل مورد طريقته في الكتابة على الشريحة، فالمكتبة التي غيرت المورد كانت تعيد ترميز كل كتبها، أي أن الشرائح كانت تحبس المكتبة عند المورد بالطريقة نفسها التي تحبسها بها البيانات في نظام مغلق. والصورة التالية تبين ما يكتب على الشريحة وما لا يكتب:

وأهم ما في الصورة سجل التعريف بالتطبيق Application Family Identifier، واختصاراً AFI، وهو بايت واحد في الشريحة. والتوصية تذكر أن ISO 28560-1 خصص للمكتبات قيمتين: C2 للمادة المعارة التي تخرج من المكتبة، و07 للمادة الموجودة داخل المكتبة في الأنظمة التي تستخدم AFI للحماية. وبوابة الحماية عند الباب تقرأ هذه القيمة فقط: إذا كانت «داخل المكتبة» أطلقت الإنذار. وبعض الأنظمة تستخدم بدلاً منها بتاً مستقلاً للحماية اسمه EAS، أي مراقبة المواد إلكترونياً Electronic Article Surveillance. وفي الحالتين، الجهاز هو الذي يغير هذه القيمة بعد أن يوافق نظام المكتبة على الإعارة، وسوف ترى في رد Koha حقلاً اسمه «فك الحماية» Desensitize يقول للجهاز افعل ذلك.
الخصوصية: لماذا لا يكتب اسم القارئ على الشريحة؟
الشريحة تقرأ بأي قارئ يعمل على التردد نفسه، والكتاب يخرج مع الطالب إلى الحافلة والمقهى. لذلك يخصص قسم كامل في التوصية الأمريكية للخصوصية، ومعه إرشادات جمعية المكتبات الأمريكية ALA عن RFID، والقاعدة المتفق عليها: لا يكتب على الشريحة إلا ما يلزم لتعريف النسخة، أي الباركود ورمز المكتبة، ولا يكتب أبداً اسم القارئ أو رقمه أو تاريخ إعاراته. وبالتالي فمن يقرأ الشريحة من مسافة يعرف أن هذه نسخة رقمها LIB-0001 من مكتبة ما، ولا يعرف من يحملها إلا إذا دخل نظام المكتبة. وهذا يذكرك بأن أهم حماية لخصوصية القراء ليست في الشريحة، وإنما في نظام المكتبة وفي البروتوكول الذي يصل إليه، كما سوف نرى.
كيف تقرأ الشريحة بلا بطارية؟
الشريحة في الكتاب ليس فيها بطارية، وإنما شريحة إلكترونية صغيرة متصلة بهوائي على شكل ملف مسطح. وعندما يقترب الكتاب من القارئ، يولد هوائي القارئ مجالاً مغناطيسياً على تردد 13.56 MHz، فيأخذ هوائي الشريحة منه طاقة تكفي لتشغيلها، كما يشحن الهاتف لاسلكياً، ثم ترد الشريحة بتغيير بسيط في هذا المجال يقرؤه القارئ. ولهذا السبب تقرأ الشريحة من مسافة قصيرة فقط، وتضعف قراءتها قرب المعادن، فالأقراص المدمجة DVD والكتب ذات الأغلفة المعدنية تحتاج شرائح خاصة أو موضعاً مختلفاً للشريحة.
والقدرة التي تغير عمل المكتبة فعلاً هي منع التصادم Anti-collision: القارئ يكتشف عدة شرائح في مجاله ويقرؤها واحدة بعد الأخرى في جزء من الثانية، وبالتالي يضع الطالب خمسة كتب فوق بعضها على سطح الجهاز فتقرأ كلها، ويمر موظف الجرد بقارئ محمول بجانب الرف فيقرأ الكتب دون أن يسحبها. ولكن هذه القدرة لها حد: الشرائح في الموضع نفسه من كتب متراصة فوق بعضها تماماً قد يفقد بعضها القراءة، لذلك ينصح الموردون عادة بتغيير موضع الشريحة قليلاً من كتاب لآخر، واسأل المورد عن ذلك قبل بدء الترميز.
بروتوكول SIP2
بروتوكول التبادل القياسي Standard Interchange Protocol، واختصاراً SIP، قدمته شركة 3M سنة 1993 لتتكلم أجهزتها مع أنظمة المكتبات، كما يذكر موقع NISO، فأصبح المعيار الفعلي حول العالم. والنسخة المنتشرة هي 2.00، وآخر مراجعة لوثيقتها «3M Standard Interchange Protocol Version 2.00» مؤرخة في 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 يلعب دور الجهاز.
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 [email protected] 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 ومعالج التثبيت، أضفنا مكتبة واحدة وقواعد إعارة بهذا الملف:
-- 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 بصلاحية الإعارة فقط، وطالباً، وطالبة موقوفة بسبب كتاب مفقود، ومعهم ثلاثة كتب عربية بباركود:
#!/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، فيه حسابات مثل term1 بكلمة المرور term1 وkoha بكلمة المرور koha، ومؤسسات مثل CPL، وهي أمثلة للتوضيح. واستبدلناه بملف صغير فيه ما نحتاجه فقط:
<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، ولكن العميل لم يحصل على أي رد:
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، والعنوان 0.0.0.0 ليس منها، فيغلق الاتصال. والحل الشكل *:6001/tcp/IPv4 كما في الملف أعلاه. وهذه من المشكلات التي تأخذ يوماً كاملاً من فريق المورد وفريق المكتبة، كل منهما يظن أن المشكلة عند الآخر، لأن المنفذ مفتوح والاتصال يصل.
جلسة كاملة كما يرسلها الجهاز
هذا هو العميل، وهو يرسل الرسائل بالترتيب الذي يرسله أغلب الأجهزة عندما يضع الطالب بطاقته ثم كتاباً، ثم يعيده:
"""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()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:
--- 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
والآن نقرأ الجلسة سطراً سطراً:
- 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مكان النسخة الدائم، فإذا كانت لفرع آخر عرف الجهاز أن يضعها في صندوق النقل.
والصورة التالية تفصل رسالة الإعارة وردها حقلاً حقلاً:

ولاحظ في رد الإعارة الحرف الأخير من NNY، وهو «فك الحماية» Desensitize بقيمة نعم. هذا هو الحقل الذي يقول للجهاز: غير قيمة AFI أو بت EAS على شريحة هذا الكتاب الآن، وإلا أطلقت البوابة الإنذار عند خروج الطالب. أي أن الطبقتين تلتقيان هنا فقط: القرار من SIP2، والتنفيذ على الشريحة.
رمز التحقق Checksum
آخر حقلين في كل رسالة AY وAZ: رقم تسلسل من 0 إلى 9، ورمز تحقق يكتشف الرسالة التي تلفت في الطريق. وطريقة حسابه في الوثيقة، صفحة 16: اجمع قيم كل الحروف من أول الرسالة إلى AZ، وخذ أدنى 16 بت من المجموع، ثم المتمم الثنائي Two's Complement، واكتبه بأربعة أرقام ست عشرية. وهذا السطر في العميل يفعل ذلك:
return format((-sum(msg.encode("utf-8"))) & 0xFFFF, "04X")والتحقق عند الاستلام أبسط: مجموع كل الحروف مع رمز التحقق يجب أن يكون صفراً. وقد يتساءل البعض: لماذا يحتاج اتصال TCP رمز تحقق، وTCP نفسه يكتشف الأخطاء؟ والإجابة أن البروتوكول صمم في 1993 لأجهزة كانت تتصل بالمكتبة عبر منافذ تسلسلية Serial وأجهزة مودم، حيث تتلف البايتات فعلاً. واليوم فائدته أن تكتشف خطأ برمجياً في الجهاز أو في نظام المكتبة، كما سوف ترى مع العربية.
الحالات اليومية: رقم سري خطأ، وقارئ موقوف، وتجديد
الجلسة الناجحة لا تكفي، فالجهاز في المكتبة يقابل كل يوم الحالات التالية، وكتبنا لها سكربتاً يرسلها بالترتيب، ومعها رسالة برمز تحقق خاطئ عن قصد:
"""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()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، وهذا ما سوف نستخدمه في مقال التقارير لنعرف كم إعارة تتم عبر الأجهزة وكم عبر المكتب:
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وهذه المعاملات نفسها كما يراها موظف المكتبة في سجل إعارات الطالب في واجهة الموظفين:

كتاب عليه حجز لقارئ آخر
بقيت حالة يسأل عنها كل موظف إعارة: طالب يحمل كتاباً حجزه شخص آخر. فأضفنا حجزاً على «مقدمة ابن خلدون» باسم موظف المكتبة بسكربت 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";"""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)}")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، وأعدنا التشغيل، وأرسلنا الجلسة نفسها:
--- 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؟ كتبنا سكربتاً يعيد حساب رمز التحقق لكل رد في الجلسة بالطريقتين:
"""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}")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
أي أن Koha يحسب رمز التحقق على بايتات UTF-8. والجهاز الذي برمجه مورده ليجمع الحروف سوف يجد رمز التحقق خاطئاً في كل رد فيه اسم عربي، فيطلب إعادة الإرسال، فيأتيه الرد نفسه، فيتوقف أو يظهر «خطأ في الاتصال»، بينما يعمل كل شيء مع الطلاب الذين أسماؤهم مكتوبة بالحروف اللاتينية. وهذه مشكلة لا تظهر في عرض المورد إذا جربها بقارئ تجريبي اسمه Test. لذلك اجعل من شروط الاستلام: إعارة وإرجاع لقارئ اسمه عربي وكتاب عنوانه عربي، مع تفعيل كشف الأخطاء error-detect.
رسائل الشاشة بالعربية
في الوثيقة حقل لغة من ثلاثة أرقام في رسائل القارئ، وفيه رمز لكل لغة، ومنها 016 للعربية، والجهاز يرسله ليطلب من نظام المكتبة أن يكتب رسائل الشاشة بلغة القارئ. فأرسلنا حالة القارئ نفسها مرة بالإنجليزية 001 ومرة بالعربية 016:
"""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 النهائي أعلاه:
<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>وبعد إعادة تشغيل الخادم أرسلنا الرسائل نفسها:
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 التي تشمل SIP، وسوف نعود إلى ذلك في مقال الوصول إلى قواعد البيانات من خارج الحرم. وكل خدمة من هذه تحتاج حساباً خاصاً بها بالقواعد نفسها.

هل تحتاج RFID أصلاً؟
قد يتساءل البعض: إذا كان SIP2 يعمل مع الباركود، فلماذا ندفع ثمن الشرائح؟ والإجابة تعتمد على ما تريد أن يتغير في المكتبة، والجدول التالي يضع الخيارين جنباً إلى جنب:
| ما تريده | جهاز بالباركود | جهاز بـ RFID |
|---|---|---|
| تقليل طابور المكتب | نعم، كتاب بعد كتاب | نعم، عدة كتب معاً دون البحث عن الباركود |
| الحماية عند الباب | شريط مغناطيسي منفصل يفك بجهاز آخر | من الشريحة نفسها عبر AFI أو EAS |
| الجرد | مسح كل كتاب بيده | قارئ محمول يمر على الرف |
| صناديق الإرجاع الآلية وفرزها | صعبة | مناسبة |
| التكلفة الأولى | جهاز فقط | جهاز وبوابات وشريحة لكل نسخة ومشروع ترميز |
| التكامل مع نظام المكتبة | SIP2 | SIP2 نفسه |
والسطر الأخير هو المهم لموظف التقنية: من جهة نظام المكتبة لا يوجد فرق، فكل ما في هذا المقال عن SIP2 ينطبق على الجهازين. لذلك تستطيع مكتبة صغيرة أن تبدأ بجهاز باركود يتكلم SIP2، وتتعلم منه، ثم تنتقل إلى RFID لاحقاً دون أن تغير شيئاً في Koha. أما المكتبة الكبيرة التي يرهقها الجرد السنوي أو تريد صناديق إرجاع خارج ساعات الدوام، فالشرائح هي التي تعطيها ذلك.
مشروع الترميز: من الباركود إلى الشريحة
إذا قررت الانتقال إلى RFID، فالعمل الأكبر ليس شراء الأجهزة، وإنما وضع شريحة في كل نسخة وكتابة رقمها عليها. والخطوات المعتادة:
- التعشيب Weeding أولاً: لا تدفع ثمن شريحة لكتاب سوف تستبعده بعد سنة، فراجع المجموعة قبل الترميز.
- محطة الترميز: قارئ مكتبي متصل بجهاز، يمسح الموظف الباركود الموجود على الكتاب، فيكتب البرنامج الرقم نفسه على الشريحة بصيغة ISO 28560 مع رمز المكتبة، ويضبط الحماية.
- الرقم نفسه: الشريحة تحمل الباركود الحالي نفسه وليس رقماً جديداً، حتى لا يتغير شيء في Koha، وحتى يبقى الباركود المطبوع صالحاً إذا تعطلت الشريحة.
- التحقق بالعينة: عشرة كتب من كل صندوق تقرأ بقارئ آخر ويبحث عنها في Koha، لأن خطأ في إعداد محطة الترميز يتكرر على آلاف الكتب قبل أن يلاحظه أحد.
- الجرد الأول: بعد الترميز يكون أول جرد بالقارئ المحمول اختباراً للمشروع كله، فالكتاب الموجود على الرف ولم يقرأ إما بلا شريحة أو شريحته تالفة.
وفي Koha أداة للجرد Inventory ضمن الأدوات، كما في دليل الأدوات، تقبل ملفاً نصياً بالباركودات المقروءة وتقارنها بما يجب أن يكون على الرف، والقارئ المحمول يصدر عادة هذا الملف، فيصبح الجرد قراءة للرف ثم رفع ملف.
عندما يتوقف نظام المكتبة: وضع عدم الاتصال
ماذا يفعل الجهاز إذا توقف Koha للتحديث، أو انقطعت الشبكة؟ الوثيقة تعرف وضع عدم الاتصال Offline، أو التخزين ثم الإرسال Store and Forward: الجهاز يسجل الإعارات والإرجاعات عنده، ثم يرسلها عندما يعود النظام، ومعها الحقل no block بقيمة Y. وتقول الوثيقة إن هذا الحقل يخبر نظام المكتبة أن المعاملة نفذت فعلاً والنظام متوقف، فلا يجب أن يرفضها. وفي ملف الإعداد عندنا offline="false" ضمن سياسة المؤسسة، أي أن مكتبتنا لا تعلن دعم هذا الوضع.
والقرار هنا قرار سياسة أكثر منه قراراً تقنياً: إذا سمحت بالإعارة دون اتصال، فقد يأخذ طالب موقوف كتاباً لأن الجهاز لا يعرف أنه موقوف، ثم يقبل Koha المعاملة لاحقاً لأن no block بقيمة Y. وإذا منعتها، توقفت الإعارة الذاتية كلما توقف النظام. والحل الوسط المعتاد أن تسمح بالإرجاع دون اتصال لأنه لا يضر، وتمنع الإعارة أو تسمح بها بحد صغير. واكتب القرار، واضبط الجهاز عليه، وجربه بإيقاف koha-sip فعلاً قبل التشغيل.
SIP2 وNCIP وواجهات REST
SIP2 ليس الطريقة الوحيدة لتتكلم الأنظمة عن الإعارة. فهناك معيار NISO للتبادل في الإعارة NCIP، وهو أحدث ومبني على XML، ويستخدم أكثر في الإعارة بين المكتبات Interlibrary Loan وفي ربط الأنظمة ببعضها، وموقع NISO نفسه يذكر الصلة الوثيقة بين المعيارين. وفي Koha أيضاً واجهة REST حديثة. ولكن أجهزة الإعارة الذاتية في السوق تتكلم SIP2 قبل أي شيء آخر، وهذا سبب بقاء بروتوكول من 1993 حياً، كما بقي Z39.50 في الفهرسة: قيمته في عدد من يتكلمه.
سجلات خادم SIP2: ماذا يحفظ Koha؟
كل رسالة تصل إلى خادم SIP2 تكتب في السجل /var/log/koha/library/sip-output.log، وهو أول مكان تنظر فيه عندما يشتكي جهاز. وهذان سطران من السجل نفسه أثناء جلسة المختبر:
[2026/11/18 09:18:27] [1850] [INFO] [email protected]: INPUT MSG: '9900302.00AY1AZFCA5'
[2026/11/18 09:18:27] [1850] [INFO] [email protected]: 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، وهي بيانات مقال التقارير.
وفي المقالين التاليين بإذن الله نخرج من مبنى المكتبة: الوصول إلى قواعد البيانات من البيت، ثم قياس الاستخدام:
دليلقواعد البيانات من خارج الحرم: الوكيل Proxy وSSOلماذا يرفض الناشر طالب الجامعة في بيته، وكيف يحل ذلك وكيل يعيد كتابة الروابط أو الدخول الموحد، مع مختبر يبني وكيلاً بـ nginx ودخولاً عبر SAML.
دليلتقارير المكتبة وقياس الاستخدام COUNTER وSUSHIكيف تقيس المكتبة استخدام اشتراكاتها وكتبها بأرقام تدافع عنها: معيار COUNTER 5.1 وسحب التقارير بـ SUSHI وتقارير SQL في Koha، مع مختبر لكل منها.سجل التحديثات
- 18 نوفمبر 2026: كتابة المقال، وتشغيل خادم SIP2 في Koha 26.05.05 على Debian 13 مع عميل Python يرسل الرسائل 93 و99 و23 و63 و11 و17 و09 والحالات الخاطئة، واختبار الترميز ورمز التحقق مع الأسماء العربية.