> ## 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.

# واجهة البحث Discovery مع VuFind فوق Koha
- URL: https://arabroot.io/articles/واجهة-البحث-discovery-مع-vufind-فوق-koha/
- Published: 2026-11-16T23:27:28.000Z
- Updated: 2026-11-17T00:26:54.000Z
- Description: كيف تضع VuFind فوق Koha والمستودع الرقمي ليبحث القارئ في مربع واحد، مع حالة الكتاب من Koha مباشرة وبحث عربي يجد العنوان المكتوب في الحقل 880.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, المكتبات ونظم المعلومات, تطبيقات لفريقك, الاستضافة الذاتية, VuFind

إذا كانت مكتبتك تعمل بنظام Koha، ولها مستودع رقمي على DSpace فيه رسائل الماجستير وأبحاث الأساتذة، فالطالب الذي يبحث عن موضوع يحتاج اليوم أن يفتح موقعين: الفهرس العام OPAC ليجد الكتب، والمستودع ليجد الرسائل، وكل موقع له مربع بحث مختلف وطريقة مختلفة في فهم الكلمة العربية، وأغلب الطلاب يكتفون بالأول ولا يعرفون أن الثاني موجود. وهذه هي المشكلة التي صنعت لها المكتبات ما يسمى طبقة الاكتشاف Discovery Layer، أي واجهة بحث واحدة فوق كل مصادر المكتبة، تجمع سجلاتها في فهرس بحث واحد، وتسأل نظام المكتبة عن حالة الكتاب لحظة عرضه. وفي دليل [نظام المكتبة 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/) ثبتنا النظام وأصلحنا البحث العربي في Zebra، وفي دليل [مستودع الجامعة مع DSpace](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D8%A7%D9%84%D8%B9%D9%84%D9%85%D9%8A-%D9%84%D9%84%D8%AC%D8%A7%D9%85%D8%B9%D8%A9-%D9%85%D8%B9-dspace/) شغلنا المستودع وبروتوكول الحصاد OAI-PMH، وفي هذا المقال سوف نضع فوقهما واجهة بحث واحدة هي [VuFind](https://vufind.org/vufind/?ref=arabroot.io)، وهي مشروع مفتوح المصدر بدأته مكتبة جامعة Villanova، ومكتوب بلغة PHP فوق محرك البحث Apache Solr.

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

- ما هي طبقة الاكتشاف، ولماذا لا يكفي الفهرس العام الذي يأتي مع Koha، ومتى لا تحتاجها أصلاً.
- تثبيت VuFind 11.1.1 من حزمة Debian الرسمية، ومعالج الإعداد وما يفشل فيه أول مرة.
- نقل تسجيلات Koha إلى VuFind عبر OAI-PMH، والخطأ الصامت في رقم التسجيلة الذي يجعل حالة الكتاب لا تظهر.
- ربط VuFind بـ Koha لعرض الحالة المباشرة للنسخ: متاحة أم معارة، وماذا يحدث للقارئ إذا توقف Koha.
- البحث بالعربية: ما يعالجه VuFind دون أي إعداد، وما لا يعالجه، والحقل 880 الذي يخفي العنوان العربي في تسجيلات المكتبات الكبرى.
- إضافة المستودع DSpace إلى البحث نفسه، ثم قائمة تحقق قبل الإطلاق.

[![](https://arabroot.io/content/images/2026/10/koha-cover-cover-1.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/10/dspace-cover-cover-1.webp)دليلمستودع الجامعة Institutional Repository مع DSpaceكيف تشغل DSpace لأرشفة رسائل الطلاب وأبحاث الجامعة، من الإيداع ومراجعته حتى الحصاد عبر OAI-PMH، وما يحتاج تعريباً قبل الإطلاق.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D8%A7%D9%84%D8%B9%D9%84%D9%85%D9%8A-%D9%84%D9%84%D8%AC%D8%A7%D9%85%D8%B9%D8%A9-%D9%85%D8%B9-dspace/)[![](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/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/)

## ما هي طبقة الاكتشاف Discovery Layer؟

نظام المكتبة المتكامل Integrated Library System، واختصاراً ILS، مثل Koha، صمم في الأساس لعمل الموظف: الفهرسة والإعارة والتزويد والدوريات، وفيه فهرس عام للقارئ، ولكن هذا الفهرس يبحث في الكتب التي في النظام فقط، أي أنه نافذة على قاعدة بيانات واحدة. أما طبقة الاكتشاف فهي نظام منفصل لا يدير الإعارة ولا الفهرسة، وإنما يأخذ نسخة من سجلات كل مصدر (نظام المكتبة، والمستودع الرقمي، والأرشيف، وقواعد البيانات المشتركة إن وجدت) ويبني منها فهرس بحث واحداً سريعاً، ثم يعرض للقارئ نتيجة واحدة مرتبة، وفيها حدود Facets يضيق بها النتائج حسب السنة واللغة والمؤلف والمصدر.

والتشبيه الأقرب هو محرك البحث على الإنترنت: Google لا يملك المواقع التي يبحث فيها، وإنما يزورها ويحفظ نسخة من محتواها في فهرسه، ولذلك يعطيك النتيجة في جزء من الثانية، ثم يحولك إلى الموقع الأصلي عندما تضغط عليها. وطبقة الاكتشاف تفعل الشيء نفسه مع مصادر المكتبة، مع فرق مهم: حالة الكتاب (هل هو على الرف أم معار) تتغير كل دقيقة، فلا يمكن أن تؤخذ من النسخة المحفوظة، لذلك تسأل طبقة الاكتشاف نظام المكتبة عنها لحظة عرض النتيجة. والصورة التالية تبين الأجزاء التي سوف نبنيها في هذا المقال:

![مخطط طبقة الاكتشاف: على اليمين مصادر البيانات، نظام المكتبة Koha للكتب والنسخ والإعارة، والمستودع DSpace للرسائل والأبحاث، ومن كل منهما سهم برتقالي إلى VuFind عبر OAI-PMH، الأول بصيغة marcxml ثم harvest_oai وSolrMarc، والثاني بصيغة oai_dc ثم harvest_oai وXSLT، وفي الوسط صندوق VuFind فيه الواجهة Apache وPHP وفهرس Solr باسم biblio core، وعلى اليسار القارئ بمربع بحث واحد، وفي الأسفل خط أخضر متقطع من VuFind إلى Koha عبر KohaILSDI وilsdi.pl وقاعدة البيانات لمعرفة حالة النسخة لحظة العرض](https://arabroot.io/content/images/2026/11/vufind-discovery-01-architecture.webp)

مساران للنقل إلى فهرس واحد، ومسار ثالث مباشر إلى Koha لحالة النسخة

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

- **البحث لا يلمس Koha:** كل عملية بحث، وكل حد من الحدود، وكل ترتيب، يأتي من فهرس Solr داخل VuFind، وبالتالي إذا بحث ألف طالب في وقت واحد أيام الاختبارات فالضغط Load يقع على VuFind وليس على النظام الذي يعمل عليه موظف الإعارة.
- **النقل دوري وليس لحظياً:** الكتاب الذي يفهرسه الموظف الآن لا يظهر في VuFind حتى يعمل الحصاد التالي، فإذا جعلته كل ساعة فأقصى تأخير ساعة، وهذا مقبول لأغلب المكتبات.
- **الحالة لحظية:** «متاح» و«معار ومستحق في تاريخ كذا» تأتي من Koha في كل مرة يعرض فيها القارئ التسجيلة، وهذا الجزء الوحيد الذي يعتمد على أن Koha يعمل في تلك اللحظة.

### الفهرس المحلي أم الفهرس المركزي Central Index؟

هناك نوعان من طبقات الاكتشاف، ومن المهم أن تعرف الفرق قبل أن تقارن العروض. النوع الأول يبني فهرساً محلياً من مصادرك أنت، وهذا ما يفعله VuFind وBlacklight وAspen Discovery، فيبحث في كتب مكتبتك ومستودعك وأي مصدر يمكنك حصاده. والنوع الثاني تجاري، مثل EBSCO Discovery Service وPrimo وSummon، وفيه فهرس مركزي يديره المورد ويضم مئات الملايين من المقالات من الناشرين، فيجد الطالب المقالة داخل المجلة وليس المجلة فقط، ولذلك تشترك فيه الجامعات التي عندها اشتراكات كبيرة في قواعد البيانات. وVuFind يستطيع أن يعرض نتائج بعض هذه الفهارس المركزية بجانب نتائجه إذا كان عندك اشتراك فيها، ولكنه لا يملك هذا المحتوى بنفسه، فلا تتوقع منه أن يجد المقالات داخل المجلات إذا لم يكن عندك هذا الاشتراك.

### متى لا تحتاج طبقة اكتشاف؟

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

### VuFind وبدائله

البدائل المفتوحة المصدر الأشهر ثلاثة، ولكل واحد منها مكانه:

| النظام          | اللغة والأساس          | نقاط القوة                                                                                                | نقاط الضعف                                                                                         |
| --------------- | ---------------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| VuFind          | PHP فوق Solr           | حزمة Debian جاهزة، ومحركات ILS لأغلب أنظمة المكتبات منها Koha وFOLIO وEvergreen، وترجمة عربية ضمن المشروع | تخصيص الواجهة يحتاج معرفة بالقوالب Themes، والتوثيق موزع على صفحات Wiki كثيرة                      |
| Aspen Discovery | PHP فوق Solr           | واسع الانتشار مع Koha في المكتبات العامة الأمريكية، وفيه حساب القارئ والكتب الإلكترونية في واجهة واحدة    | أغلب المكتبات التي تستخدمه تشغله عبر شركات الدعم كما في الأرقام أدناه، والتثبيت الذاتي أقل توثيقاً |
| Blacklight      | Ruby on Rails فوق Solr | مرن جداً لمن يبني واجهة خاصة، وتستخدمه جامعات كبيرة لمجموعاتها الرقمية                                    | إطار عمل Framework تبني عليه أكثر من كونه منتجاً جاهزاً، ويحتاج مطور Ruby                          |

وفي [تقرير أنظمة المكتبات لعام 2026](https://www.librarytechnology.org/pr/32512?ref=arabroot.io) من Library Technology Guides، تقول شركة ByWater إنها تدعم Aspen Discovery في 792 مكتبة، وإن التطبيقات الجديدة لـ Koha في المكتبات العامة الأمريكية تأتي معها Aspen تقريباً دائماً، وهذا يبين أن فكرة الطبقة المنفصلة فوق Koha أصبحت هي القاعدة وليست الاستثناء. واخترنا VuFind في هذا المقال لأن تثبيته الذاتي موثق وله حزمة رسمية، ولأنه يربط مصادر من أنواع مختلفة (MARC من Koha، وDublin Core من DSpace) بأدوات مدمجة.

## المتطلبات

VuFind 11.1.1 هو الإصدار الحالي، وقد [صدر في 9 نوفمبر 2026](https://github.com/vufind-org/vufind/releases/tag/v11.1.1?ref=arabroot.io) مع ملف tar وملف zip وحزمة Debian باسم `vufind_11.1.1.deb`. وملف `control` في الحزمة يطلب Apache، وPHP مع إضافات `php-intl` و`php-mbstring` و`php-mysql` و`php-xml` وغيرها، وMySQL أو MariaDB، وJava لأن Solr يأتي داخل VuFind نفسه. وهذه الإصدارات التي ثبتت على Debian 13 مع الحزمة:

- PHP 8.4.27 وApache 2.4.71 وMariaDB 11.8.6 من مستودعات Debian.
- OpenJDK 21.0.13 من الحزمة `default-jdk-headless`.
- Solr 9.8.1، وهو مضمن في المجلد `/usr/local/vufind/solr/vendor`، فلا تثبته منفصلاً.
- **الذاكرة:** بعد تحميل 589 تسجيلة كان الـ Container كله يستخدم 1.57GB، منها 1.3GB لعملية Java التي تشغل Solr، و514MB لعمليات Apache، و157MB لـ MariaDB. والسبب أن السكربت `solr.sh` يعطي Solr ذاكرة Heap مقدارها 1G إذا لم تحدد المتغير `SOLR_HEAP`، لذلك ابدأ بسيرفر فيه 4GB على الأقل، وارفع `SOLR_HEAP` عندما يتجاوز فهرسك مئات الآلاف من التسجيلات.

## التثبيت من حزمة Debian

في المختبر وضعنا VuFind في Container من Debian 13 يعمل فيه systemd، وKoha في Container آخر على الشبكة نفسها، والأوامر التالية هي نفسها التي تنفذها على سيرفر Debian عادي. أولاً نزل الحزمة وثبتها مع Java وMariaDB، والأداة `apt` تسحب بقية الاعتماديات من ملف `control`:

```bash
wget https://github.com/vufind-org/vufind/releases/download/v11.1.1/vufind_11.1.1.deb
sudo apt-get update
sudo apt-get install -y default-jdk-headless mariadb-server ./vufind_11.1.1.deb
```

والحزمة تضع VuFind في `/usr/local/vufind`، وتضيف ملف إعداد Apache باسم `vufind.conf` يجعل الواجهة على المسار `/vufind`، وتكتب متغيرات البيئة في الملف `/etc/profile.d/vufind.sh`:

```text
export JAVA_HOME="/usr/lib/jvm/default-java"
export VUFIND_HOME=/usr/local/vufind
export VUFIND_LOCAL_DIR=/usr/local/vufind/local
export SOLR_PORT=8983
```

في الإعداد أعلاه لاحظ التالي:

- `VUFIND_HOME` هو كود VuFind كما جاء من الحزمة، و`VUFIND_LOCAL_DIR` هو مكان تعديلاتك أنت: الإعدادات والقوالب والترجمات. والقاعدة الأهم في VuFind أنك لا تعدل أي ملف داخل `config/vufind` الأصلي، وإنما تنسخه إلى `local/config/vufind` وتعدل النسخة، والسبب أن التحديث يستبدل الملفات الأصلية، فإذا عدلتها ضاعت تعديلاتك مع أول تحديث.
- المنفذ 8983 هو منفذ Solr، وVuFind يتحدث معه من داخل السيرفر نفسه.

### تشغيل Solr بمستخدم خاص

Solr يرفض العمل بالمستخدم root إلا إذا أجبرته، وهذا صحيح من ناحية الأمان، لذلك أنشئ له مستخدماً واجعله مالك مجلده ثم شغله:

```bash
sudo useradd -r -m solr
sudo chown -R solr:solr /usr/local/vufind/solr
sudo -u solr bash -c '. /etc/profile.d/vufind.sh; /usr/local/vufind/solr.sh start'
```

```text
Java 21 detected. Incubating Panama Vector APIs have been enabled
Waiting up to 180 seconds to see Solr running on port 8983
Started Solr server on port 8983 (pid=282). Happy searching!
```

ثم سألنا Solr عن الفهارس Cores التي فيه، فظهرت فهارس VuFind كلها فارغة، ومنها `biblio` للتسجيلات الببليوغرافية و`authority` لملفات الإسناد. ولاحظ شيئاً مهماً جربناه: من داخل الـ Container رد Solr على `localhost:8983`، ومن خارج الـ Container لم يرد رغم أننا فتحنا المنفذ في Docker، والسبب أن Solr 9 يستمع افتراضياً على `127.0.0.1` فقط. وهذا السلوك هو ما تريده في الإنتاج، فلوحة إدارة Solr تسمح بحذف الفهرس كله بطلب واحد ولا تحتاج كلمة مرور في هذا الإعداد، لذلك لا تقم بتغييره ولا تفتح المنفذ 8983 في الجدار الناري Firewall. وعلى السيرفر الحقيقي اكتب وحدة systemd تشغل Solr عند الإقلاع بدلاً من الأمر اليدوي، كما شرحنا في [الخدمات Services والسجلات مع systemd](https://arabroot.io/articles/%D8%A7%D9%84%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-services-%D9%88%D8%A7%D9%84%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-logs-%D9%85%D8%B9-systemd-%D9%88-journalctl/).

### معالج الإعداد Auto Configure

افتح `http://server/vufind/Install/Home`، فيظهر معالج الإعداد ويفحص ثمانية أشياء، والصورة التالية من أول تشغيل عندنا:

![صفحة Auto Configure في VuFind بعد التثبيت مباشرة، وفيها ثمانية فحوص: Basic Configuration فشل وبجانبه زر Fix، وCache ناجح، وDatabase فشل مع زر Fix، وDependencies ناجح، وILS فشل مع زر Fix، وSolr ناجح، وSecurity فشل مع زر Fix، وSSL ناجح، وتحتها دعوة لتسجيل التثبيت في قائمة مجتمع VuFind](https://arabroot.io/content/images/2026/11/vufind-discovery-06-install-check.webp)

أول فحص بعد التثبيت: أربعة فحوص تفشل، وكلها متوقعة

والفحوص التي فشلت كلها متوقعة، وكل واحد له زر Fix:

- **Basic Configuration:** لا يوجد ملف `config.ini` في المجلد المحلي، وزر Fix ينسخه ويكتب فيه عنوان الموقع.
- **Database:** لا توجد قاعدة بيانات VuFind، وهي التي تحفظ حسابات القراء وقوائمهم المفضلة وسجل البحث، وليس فيها أي تسجيلة ببليوغرافية. وزر Fix ينشئها ويطلب حساب مدير MariaDB، وهنا المشكلة الأولى: المستخدم `root` في MariaDB على Debian يدخل عبر الـ Unix Socket فقط، فلا يقبله VuFind بكلمة مرور، لذلك أنشأنا حساب مدير مؤقتاً، ثم حذفناه بعد إنشاء القاعدة.
- **Security:** يفعل تشفير كلمات المرور المحفوظة في قاعدة البيانات، ولا تتركه دون إصلاح.
- **ILS:** المحرك الافتراضي هو `Sample` الذي يعطي بيانات وهمية، وسوف نغيره إلى Koha بعد قليل.

وحساب المدير المؤقت أنشأناه بهذين السطرين، واحذفه بعد أن ينجح الفحص:

```bash
sudo mariadb -e "CREATE USER 'vfsetup'@'localhost' IDENTIFIED BY 'change-me-now'; GRANT ALL ON *.* TO 'vfsetup'@'localhost' WITH GRANT OPTION;"
sudo mariadb -e "DROP USER 'vfsetup'@'localhost';"
```

⚠️

معالج الإعداد مفتوح لكل من يصل إلى الموقع حتى تقفله، لذلك بعد أن تصبح كل الفحوص ناجحة اجعل `autoConfigure = false` في قسم `[System]` من `local/config/vufind/config.ini`، والسبب أن من يصل إليه يستطيع أن يغير إعدادات قاعدة البيانات ومحرك ILS.

## نقل التسجيلات من Koha إلى VuFind

الآن نحتاج أن تصل تسجيلات Koha إلى فهرس Solr، وهناك طريقتان. الطريقة البسيطة أن تصدر الكتب من Koha في ملف MARC وتستورده في VuFind يدوياً، وهذا مناسب للتجربة الأولى، ولكنه لا يصلح للتشغيل اليومي، لأن الكتاب الذي يفهرس غداً يحتاج تصديراً جديداً، والكتاب الذي يحذف من Koha يبقى في VuFind. والطريقة الصحيحة هي الحصاد عبر بروتوكول OAI-PMH، وهو بروتوكول يسأل فيه الحاصد Harvester المصدر: «أعطني كل التسجيلات التي تغيرت منذ تاريخ كذا»، فيأخذ في المرة الأولى كل شيء، وفي المرات التالية الجديد والمعدل والمحذوف فقط.

وفي Koha هذه خدمة مدمجة تفعلها بتفضيل واحد من تفضيلات النظام System Preferences، وغير معها التفضيل `OAI-PMH:archiveID`، فقيمته الافتراضية `KOHA-OAI-TEST` وهي التي تظهر في معرف كل تسجيلة يحصدها أي نظام آخر:

```bash
sudo koha-shell library -c "perl /usr/share/koha/bin/admin/koha-preferences set OAI-PMH 1"
sudo koha-shell library -c "perl /usr/share/koha/bin/admin/koha-preferences set OAI-PMH:archiveID ARABLIB"
```

ثم نتأكد من الخدمة بالفعل `Identify`، وهو أول ما يرسله أي حاصد:

```bash
curl -s "http://koha/cgi-bin/koha/oai.pl?verb=Identify" | xmllint --format -
```

```xml
<Identify>
    <repositoryName/>
    <baseURL>http://koha/opac/oai.pl</baseURL>
    <protocolVersion>2.0</protocolVersion>
    <adminEmail>root@localhost</adminEmail>
    <earliestDatestamp>2026-11-16T21:16:08Z</earliestDatestamp>
    <deletedRecord>persistent</deletedRecord>
    <granularity>YYYY-MM-DDThh:mm:ssZ</granularity>
    <compression>gzip</compression>
</Identify>
```

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

- `deletedRecord` قيمته `persistent`، أي أن Koha يتذكر التسجيلات المحذوفة ويبلغ عنها الحاصد، وهذا هو الذي يجعل الكتاب المحذوف من Koha يختفي من VuFind في الحصاد التالي.
- `repositoryName` فارغ و`adminEmail` هو `root@localhost`، والأول يأتي من اسم المكتبة في التفضيل `LibraryName` والثاني من `KohaAdminEmailAddress`، فاضبطهما قبل أن تعلن عن الخدمة لأي جهة خارجية.
- الصيغ المتاحة كما ظهرت في `ListMetadataFormats` هي `oai_dc` و`marc21` و`marcxml`، ونحن نريد `marcxml` لأنه يحمل التسجيلة كاملة بكل حقولها، أما `oai_dc` فيختصرها إلى خمسة عشر عنصراً ويضيع منها الكثير.

### الحصاد ثم الفهرسة

في VuFind أداة حصاد جاهزة تقرأ مصادرها من الملف `local/harvest/oai.ini`، وكل قسم فيه مصدر:

```ini
[KohaLib]
url = http://koha/cgi-bin/koha/oai.pl
metadataPrefix = marcxml
dateGranularity = auto
harvestedIdLog = harvest.log
```

```bash
cd /usr/local/vufind
php harvest/harvest_oai.php KohaLib
```

```text
[400 records harvested] Processing 50 records...
[450 records harvested] Processing 3 records...
Completed without errors -- 1 source(s) processed.

real	0m41.787s
```

أي أن الأداة طلبت التسجيلات من Koha خمسين خمسين، وحفظت كل تسجيلة في ملف XML منفصل داخل `local/harvest/KohaLib`، فكانت 453 تسجيلة في 42 ثانية. ثم السكربت `batch-import-marc.sh` يأخذ هذه الملفات ويمررها على SolrMarc، وهو البرنامج الذي يقرأ حقول MARC ويحولها إلى حقول Solr حسب قواعد الملف `import/marc.properties`، ثم ينقل الملفات إلى مجلد `processed` حتى لا تفهرس مرتين:

```bash
cd /usr/local/vufind
MAX_BATCH_COUNT=500 ./harvest/batch-import-marc.sh KohaLib
```

```text
INFO [main] (IndexDriver.java:391) - 453 records read
INFO [main] (IndexDriver.java:392) - 453 records indexed  and
INFO [main] (IndexDriver.java:399) - 453 records sent to Solr in 21.40 seconds
```

والوقت الكلي كان دقيقة و22 ثانية، أغلبه بدء Java وتحميل SolrMarc وليس الفهرسة نفسها، فالفهرسة كانت 21 ثانية لـ 453 تسجيلة. وفي التشغيل اليومي تضع الأمرين في مهمة مجدولة Cron Job كل ساعة مثلاً، والحصاد التالي يأخذ فقط ما تغير بعد التاريخ المحفوظ في `last_harvest.txt`.

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

### رقم التسجيلة: الخطأ الصامت

هذه أهم نقطة في الربط كله. التسجيلة التي تأتي من مكتبة أخرى فيها رقم في الحقل 001 هو رقم التحكم Control Number في تلك المكتبة، ثم يضيف Koha عند الحفظ رقمه هو، وهو رقم التسجيلة `biblionumber`، في الحقل 999 الفرعي c. والإعداد الافتراضي في VuFind يأخذ معرف التسجيلة من الحقل 001، وهذا يعمل في البحث دون أي مشكلة، ولكن عندما يسأل VuFind نظام Koha عن نسخ التسجيلة فإنه يرسل هذا الرقم، وKoha لا يعرفه:

```bash
curl -s "http://koha/cgi-bin/koha/ilsdi.pl?service=GetAvailability&id=3822390&id_type=bib"
```

```xml
<dlf:collection xmlns:dlf="http://diglib.org/ilsdi/1.1" ...>
</dlf:collection>
```

لاحظ أن الرد ليس خطأ، وإنما قائمة فارغة، فلا يظهر في السجلات أي شيء، ويرى القارئ كل كتاب بلا نسخ، ويظن الموظف أن الربط لا يعمل لسبب في الشبكة أو الصلاحيات. والحل سطر واحد في الملف `import/marc_local.properties`، وهو الملف الذي تضع فيه تعديلاتك على قواعد الفهرسة دون أن تلمس `marc.properties` الأصلي:

```ini
# Records come from Koha: the biblionumber (999$c) is the id the ILS driver understands
id = 999c, first
institution = "مكتبة الجامعة"
building = "المكتبة المركزية"
```

![مخطط رقمان في التسجيلة نفسها: على اليمين التسجيلة كما خرجت من Koha وفيها الحقل 001 بالرقم 3822390 وهو رقم مكتبة الكونغرس، والحقل 245 al-Muqaddimah، والحقل 880 المقدمة، والحقل 999 فيه c 195 وd 195 وهو رقم Koha، ومن الحقل 001 سهم أحمر إلى صندوق id يساوي 001 والطلب GetAvailability برقم 3822390 والرد قائمة فارغة لا نسخ ولا خطأ، ومن الحقل 999 سهم أخضر إلى صندوق id يساوي 999c والطلب برقم 195 والرد نسختان واحدة متاحة وواحدة معارة، وفي الأسفل السطر id يساوي 999c, first في ملف marc_local.properties](https://arabroot.io/content/images/2026/11/vufind-discovery-02-record-id.webp)

الرقم 001 يأتي من المكتبة الأصلية، والرقم الذي يفهمه Koha في الحقل 999

وبعد هذا التعديل أعدنا الفهرسة، فأصبح رابط التسجيلة في VuFind `/vufind/Record/195`، وهو الرقم نفسه في رابط الفهرس العام لـ Koha، وهذا يسهل على الموظف أن ينتقل بين النظامين. ولاحظ أن تسجيلات OAI-PMH من Koha لم يكن فيها الحقل 952 الذي يحمل النسخ، وفيها الحقل 999 فقط، وهذا لا يضر، لأن VuFind لا يأخذ النسخ من الفهرس وإنما من Koha مباشرة كما في القسم التالي.

## حالة النسخة من Koha مباشرة

محرك ILS في VuFind هو الكود الذي يعرف كيف يسأل نظام مكتبة بعينه عن النسخ وحالتها، وعن حساب القارئ وإعاراته وحجوزاته. ولـ Koha محركان في VuFind، والصورة التالية تبين الفرق بينهما:

![مخطط طريقان من VuFind إلى Koha: الطريق العلوي الأزرق KohaRest عبر api v1 وOAuth2 ويحتاج الإضافة koha-plugin-rest-di ومفتاح API للعميل، والطريق السفلي الأخضر KohaILSDI عبر ilsdi.pl وهي خدمة مدمجة في Koha مع MariaDB SELECT بحساب قراءة فقط، وعلى اليسار ما تفتحه في Koha لكل طريق: KohaRest منفذ الويب فقط والصلاحيات على حساب API، وKohaILSDI تفعيل ILS-DI وعنوان VuFind في ILS-DI:AuthorizedIPs ومنفذ قاعدة البيانات 3306 لعنوان VuFind وحده، وعند توقف ويب Koha يقرأ KohaILSDI النسخ من قاعدة البيانات، وعند توقف قاعدة البيانات رسالة النظام قيد الصيانة والبحث يستمر](https://arabroot.io/content/images/2026/11/vufind-discovery-03-ils-drivers.webp)

KohaRest يمر من REST API وحده، وKohaILSDI يجمع خدمة ILS-DI المدمجة مع قراءة قاعدة البيانات

- **KohaRest:** كما يقول ملف إعداده [KohaRest.ini](https://github.com/vufind-org/vufind/blob/v11.1.1/config/vufind/KohaRest.ini?ref=arabroot.io)، يستخدم REST API الخاص بـ Koha فقط، ولا يحتاج الوصول إلى قاعدة البيانات، ولكنه يحتاج تفعيل الإضافات Plugins في Koha، وتثبيت الإضافة [koha-plugin-rest-di](https://github.com/NatLibFi/koha-plugin-rest-di?ref=arabroot.io) من المكتبة الوطنية الفنلندية، وتفعيل مصادقة OAuth2 بالتفضيل `RestOAuth2ClientCredentials`، وإنشاء مفتاح API لحساب موظف له صلاحيات محددة. وهذا الطريق أنظف أمنياً، ولكنه يضيف إضافة خارجية يجب أن تتابع توافقها مع كل إصدار رئيسي من Koha.
- **KohaILSDI:** يستخدم خدمة ILS-DI المدمجة في Koha، وهي واجهة قديمة مبنية على توصية مجموعة Digital Library Federation لربط أنظمة المكتبات بواجهات البحث، ويكمل ما لا توفره هذه الخدمة بالقراءة المباشرة من قاعدة بيانات Koha. ولا يحتاج أي إضافة، وهو الذي استخدمناه في المختبر.

### إعداد KohaILSDI خطوة بخطوة

أولاً فعل الخدمة في Koha بالتفضيل `ILS-DI` الموثق في [تفضيلات خدمات الويب](https://koha-community.org/manual/26.05/en/html/webservicespreferences.html?ref=arabroot.io). وعندما جربناها من VuFind كان الرد:

```xml
<ilsdi>
  <code>NotAllowed</code>
  <message>Unauthorized IP address: 172.24.0.2.</message>
</ilsdi>
```

والسبب أن التفضيل `ILS-DI:AuthorizedIPs` يحدد العناوين المسموح لها، فكتبنا فيه عنوان VuFind. ثم جربنا مرة أخرى فجاء الرد نفسه، ولم يتغير حتى أعدنا تشغيل Memcached وPlack، والسبب أن Koha يحفظ تفضيلات النظام في الذاكرة المؤقتة، فالتعديل المباشر في قاعدة البيانات لا يظهر حتى تمسحها، أما التعديل من صفحة الإدارة أو بالأداة `koha-preferences` فيمسحها بنفسه، لذلك عدل التفضيلات دائماً من هذين الطريقين:

```bash
sudo koha-shell library -c "perl /usr/share/koha/bin/admin/koha-preferences set ILS-DI 1"
sudo koha-shell library -c "perl /usr/share/koha/bin/admin/koha-preferences set ILS-DI:AuthorizedIPs 172.24.0.2"
```

وبعدها رد Koha بالنسخة وحالتها ومكانها ورقم الطلب Call Number:

```xml
<dlf:record>
    <dlf:bibliographic id="152" />
    <dlf:items>
      <dlf:item id="182">
        <dlf:simpleavailability>
          <dlf:identifier>182</dlf:identifier>
          <dlf:availabilitystatus>available</dlf:availabilitystatus>
          <dlf:location>المكتبة المركزية</dlf:location>
          <dlf:itemcallnumber>901</dlf:itemcallnumber>
        </dlf:simpleavailability>
      </dlf:item>
    </dlf:items>
</dlf:record>
```

ثانياً أنشئ في MariaDB الخاص بـ Koha حساباً للقراءة فقط، مسموحاً له من عنوان VuFind وحده، واجعل MariaDB يستمع على عنوان الشبكة الداخلية، لأنه في Debian يستمع على `127.0.0.1` فقط:

```bash
sudo sed -i 's/^bind-address.*/bind-address = 0.0.0.0/' /etc/mysql/mariadb.conf.d/50-server.cnf
sudo systemctl restart mariadb
sudo mariadb -e "CREATE USER 'vufind_ro'@'172.24.0.2' IDENTIFIED BY 'change-me'; GRANT SELECT ON koha_library.* TO 'vufind_ro'@'172.24.0.2';"
```

وهنا يجب أن تكون صريحاً مع نفسك في الأمان: هذا الحساب يقرأ كل جداول Koha، ومنها بيانات القراء وأرقام هواتفهم وإعاراتهم، فإذا اخترق سيرفر VuFind فهذه البيانات مكشوفة. لذلك افتح المنفذ 3306 في الجدار الناري لعنوان VuFind وحده، ولا تقم بنشره على الإنترنت أبداً، وإذا كانت سياسة جامعتك لا تسمح بأي وصول مباشر لقاعدة البيانات من نظام آخر فالطريق المناسب لك هو KohaRest.

ثالثاً اكتب إعداد المحرك في `local/config/vufind/KohaILSDI.ini`، وغير المحرك في `config.ini`:

```ini
[Catalog]
host        = koha
port        = 3306
username    = vufind_ro
password    = change-me
database    = koha_library
url         = http://koha/cgi-bin/koha/ilsdi.pl

[Holds]
HMACKeys = item_id:id:level
defaultRequiredDate = 0:1:0
extraHoldFields = pickUpLocation
```

```ini
; local/config/vufind/config.ini, section [Catalog]
driver          = KohaILSDI
```

بعدها أصبح فحص ILS في معالج الإعداد ناجحاً. ولنجرب الربط بشيء يتغير فعلاً، أعرنا من Koha نسخة من «المقدمة» طبعة تونس 1984، وهي التسجيلة رقم 195 ولها نسختان، فرد Koha بتاريخ الإرجاع بعد 14 يوماً:

```text
{"checkout_date":"2026-11-16T21:43:18+00:00","checkout_id":1,"due_date":"2026-11-30T23:59:00+00:00","item_id":233,"library_id":"MAIN","patron_id":2,"renewals_count":0, ...}
```

ثم فتحنا التسجيلة نفسها في VuFind:

![صفحة تسجيلة في VuFind بالواجهة العربية: العنوان بالحروف اللاتينية al-Muqaddimah tarikh al-Allamah Ibn Khaldun وتحته العنوان بالحروف العربية المقدمة تاريخ العلامة إبن خلدون كتاب العبر، والمؤلف الرئيسي Ibn Khaldun 1332-1406، والتنسيق كتاب، واللغة العربية، ومنشور في تونس 1984، والموضوعات History وCivilization، وتبويب المقتنيات مفتوح وفيه المكتبة المركزية ورقم الاستدعاء D16.7 .I23 1984، والنسخة الأولى متاح مع رابط أحجز النسخة، والنسخة الثانية Checked out مستحق 11-30-2026 مع رابط إستدعي هذه النسخة، وعلى الجانب مواد مشابهة](https://arabroot.io/content/images/2026/11/vufind-discovery-08-record-holdings.webp)

الوصف من فهرس Solr، والنسختان من Koha لحظة فتح الصفحة: واحدة متاحة وواحدة معارة حتى 30 نوفمبر

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

- العنوان العربي ظهر تحت العنوان اللاتيني دون أي إعداد منا، وهو من الحقل 880 الذي سوف نشرحه في قسم البحث العربي.
- النسخة المعارة ظهرت بعبارة «Checked out» بالإنجليزية وسط واجهة عربية، لأن هذه الحالة تأتي من محرك ILS ولا ترجمة لها في ملف `languages/ar.ini` لهذا الإصدار. والحل أن تضيف السطر المترجم في ملف لغة محلي داخل `local/languages`، ولا تقم بتعديل الملف الأصلي لأنه يستبدل مع التحديث.
- «أحجز النسخة» و«إستدعي هذه النسخة» روابط تعمل فقط بعد أن يدخل القارئ بحسابه، وهذا يحتاج ربط حسابات القراء بين VuFind وKoha، وأغلب الجامعات تفعله عبر الدخول الموحد SSO كما في [ما هو الدخول الموحد SSO](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%A7%D9%84%D8%AF%D8%AE%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%88%D8%AD%D8%AF-sso-%D9%88%D8%A7%D9%84%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA/).

### ماذا يحدث إذا توقف Koha؟

هذا سؤال يجب أن تعرف جوابه قبل الإطلاق، لأن Koha يتوقف للتحديث مرتين في السنة على الأقل. جربنا حالتين. في الأولى أوقفنا Apache في Koha، أي أن الفهرس العام وواجهة الموظفين وخدمة ILS-DI كلها متوقفة، فظهرت النسخ في VuFind كما هي، متاحة ومعارة، والسبب أن KohaILSDI يقرأ النسخ من قاعدة البيانات مباشرة وليس من ILS-DI. وفي الثانية أوقفنا MariaDB في Koha، فاستمر البحث يعمل بشكل طبيعي لأنه من Solr، وفي صفحة التسجيلة ظهرت رسالة بدلاً من النسخ:

![صفحة التسجيلة نفسها في VuFind وقاعدة بيانات Koha متوقفة: الوصف كامل بالعنوان اللاتيني والعربي والمؤلف واللغة والموضوعات، وفي تبويب المقتنيات صندوق أصفر بعنوان النظام قيد الصيانة وفيه نظام إدارة مكتبتنا قيد الصيانة حاليا، ومعلومات إتاحة المواد والمقتنيات غير متاحة حاليا، ثم البريد support@myuniversity.edu](https://arabroot.io/content/images/2026/11/vufind-discovery-09-record-ils-down.webp)

البحث والوصف يستمران من Solr، والنسخ تتحول إلى رسالة صيانة فيها بريد افتراضي يجب تغييره

وفي صفحة النتائج ظهر تحت كل كتاب «لقد حدث خطأ» و«الحالة المباشرة غير متاحة» بدلاً من «متاح». وهذا سلوك جيد في رأينا، فالقارئ يجد الكتاب ويعرف رقم الطلب ويذهب إلى الرف، ولكن لاحظ البريد في الرسالة: `support@myuniversity.edu`، وهو القيمة الافتراضية للإعداد `email` في قسم `[Site]`، وكثير من المكتبات تطلق النظام وهذا البريد فيه، فيرسل القراء رسائلهم إلى نطاق لا وجود له. غيره قبل الإطلاق، وغير معه `title` الذي قيمته الافتراضية `"Library Catalog"`.

## البحث بالعربية في VuFind

في دليل Koha رأينا أن محرك Zebra في إعداده الافتراضي لا يعرف الحروف العربية أصلاً، فيعيد كل الكتب لأي كلمة عربية حتى نفعل ICU. ولذلك أول ما أردنا معرفته في VuFind: ماذا يفعل بالكلمة العربية دون أي إعداد؟ والجواب في ملف [schema.xml](https://github.com/vufind-org/vufind/blob/v11.1.1/solr/vufind/biblio/conf/schema.xml?ref=arabroot.io) للفهرس `biblio`، فنوع الحقل `text` الذي تستخدمه أغلب حقول البحث يمر على سلسلة من المرشحات Filters عند الفهرسة وعند البحث، ويمكنك أن ترى أثرها على أي كلمة من واجهة التحليل Analysis في Solr:

```bash
curl -s -G "http://localhost:8983/solr/biblio/analysis/field" \
  --data-urlencode "analysis.fieldtype=text" \
  --data-urlencode "analysis.fieldvalue=المقدمة" --data-urlencode "wt=json"
```

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

```text
المقدمة => المقدمه
المقدمه => المقدمه
المتنبي => المتنبي
المتنبى => المتنبي
الآداب => الاداب
إبن => ابن
أحمد => احمد
مُقَدِّمَة => مقدمه
Khaldūn => khaldun
```

وهذه نتيجة أفضل بكثير مما توقعنا، والسبب هو المرشح `icuFolding`، وهو مرشح من مكتبة ICU يطبق قواعد طي الحروف Character Folding الموصوفة في معيار Unicode، فيحذف التشكيل، ويحول أشكال الهمزة على الألف إلى ألف، والتاء المربوطة إلى هاء، والألف المقصورة إلى ياء، والمد إلى ألف، ويحذف علامات الحروف اللاتينية مثل ū في Khaldūn. أي أن ما أصلحناه في Koha بقاعدة تحويل يدوية موجود هنا في الإعداد الافتراضي:

![مخطط سلسلة المحلل في VuFind من اليمين إلى اليسار: ICU Tokenizer لتقسيم الكلمات، ثم WordDelimiter للأرقام والشرطات، ثم Stop words بقائمة إنجليزية، ثم ICU Folding حيث يحدث التوحيد، ثم Snowball English الذي لا أثر له على العربية، وتحته جدول: إبن وأحمد تصبح ابن واحمد والهمزة موحدة، والمقدمة والمقدمه تصبحان المقدمه والتاء المربوطة موحدة، والمتنبى والمتنبي تصبحان المتنبي والألف المقصورة موحدة، ومقدمة المشكلة والآداب تصبحان مقدمه والاداب والتشكيل والمد يحذفان، وبالأحمر بخلاء مقابل البخلاء كلمة مختلفة لأن ال لا تحذف وصفر نتائج، والآداب مقابل والآداب كلمة مختلفة لأن الواو لا تحذف وصفر نتائج](https://arabroot.io/content/images/2026/11/vufind-discovery-04-analyzer.webp)

ICU Folding يوحد الهمزة والتاء المربوطة والألف المقصورة والتشكيل، ولا يفصل «ال» و«و» عن الكلمة

ثم جربنا البحث نفسه من واجهة VuFind على التسجيلات الـ 453، والجدول التالي من المخرج الحقيقي للبحث عبر API الخاص بـ VuFind:

| كلمة البحث             | النتائج | التعليق                                    |
| ---------------------- | ------- | ------------------------------------------ |
| المقدمة                | 2       | تسجيلتان فيهما العنوان العربي في الحقل 880 |
| المقدمه (بالهاء)       | 2       | النتيجة نفسها، التاء المربوطة موحدة        |
| ابن خلدون / إبن خلدون  | 9 / 9   | الهمزة لا تغير شيئاً                       |
| المتنبي / المتنبى      | 13 / 13 | الألف المقصورة موحدة                       |
| البخلاء                | 1       | «كتاب البخلاء» للجاحظ                      |
| بخلاء (دون ال)         | 0       | لا يوجد تجذيع Stemming عربي                |
| والآداب / الآداب       | 1 / 0   | الكلمة في التسجيلة مسبوقة بالواو           |
| Muqaddimah / muqaddima | 17 / 7  | صيغ الكتابة اللاتينية لا تتوحد             |
| Mutanabbi / Mutanabbī  | 50 / 50 | العلامة فوق الحرف تحذف                     |

في الجدول أعلاه لاحظ التالي:

- «ال» التعريف وحرف العطف «و» يبقيان جزءاً من الكلمة، فالقارئ الذي يكتب «بخلاء» لا يجد «البخلاء»، والذي يكتب «الآداب» لا يجد «والآداب». والسبب أن المحلل الافتراضي فيه مجذع Snowball للإنجليزية فقط، أي أنه يحول «histories» إلى «histori» ولا يلمس العربية. ويمكنك أن تضيف مرشحات Solr العربية مثل `ArabicNormalizationFilter` و`ArabicStemFilter` الموثقة في [دليل مرشحات Solr](https://solr.apache.org/guide/solr/latest/indexing-guide/filters.html?ref=arabroot.io)، ولكن هذا تعديل في `schema.xml` يحتاج إعادة فهرسة كاملة واختباراً على بياناتك، لأن المجذع الخفيف يحذف «ال» و«و» من كل كلمة، فيطابق كلمات لم تقصدها. وقد قسنا هذا الأثر بالتفصيل في [البحث في النصوص العربية مع OpenSearch وMeilisearch](https://arabroot.io/articles/%D8%A7%D9%84%D8%A8%D8%AD%D8%AB-%D9%81%D9%8A-%D8%A7%D9%84%D9%86%D8%B5%D9%88%D8%B5-%D8%A7%D9%84%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9-%D9%85%D8%B9-opensearch-%D9%88-meilisearch/)، والنتائج تنطبق على Solr لأن المحلل نفسه من Lucene.
- الكتابة بالحروف اللاتينية Romanization لها مشكلتها الخاصة، فـ «Muqaddimah» و«muqaddima» صيغتان لكلمة واحدة، ولا يوحدهما أي مرشح، وهذا ليس مشكلة VuFind وإنما مشكلة قواعد النقل الحرفي التي تغيرت عبر العقود، وحلها في ملفات الإسناد Authority Records وليس في محرك البحث.

### الحقل 880: العنوان العربي الذي لا يبحث فيه أحد

هنا السبب الذي اخترنا من أجله تسجيلات مكتبة الكونغرس. المكتبات الكبرى في العالم تفهرس الكتاب العربي بحقول رئيسية مكتوبة بالحروف اللاتينية، فالعنوان في الحقل 245 هو «al-Muqaddimah»، والمؤلف في الحقل 100 هو «Ibn Khaldūn»، ثم تضع الكتابة الأصلية بالحروف العربية في حقل مستقل رقمه 880، واسمه في معيار MARC21 [التمثيل الخطي البديل Alternate Graphic Representation](https://www.loc.gov/marc/bibliographic/bd880.html?ref=arabroot.io)، ويربط بين الحقلين حقل فرعي رقمه 6\. وعندما تشتري المكتبة العربية تسجيلات جاهزة أو تنسخها عبر Z39.50 من هذه المكتبات، فهذا هو الشكل الذي يصلها:

![مخطط العنوان بالحروف اللاتينية والعربي في الحقل 880: على اليمين تسجيلة مكتبة الكونغرس رقم 3822390 وفيها الحقل 100 مع 6 880-01 وa Ibn Khaldun، والحقل 245 مع 6 880-02 وa al-Muqaddimah، والحقل 880 مع 6 100-01/(3/r وa ابن خلدون، والحقل 880 مع 6 245-02/(3/r وa المقدمة، وأسهم تربط كل حقل بحقل 880 الخاص به، وعلى اليسار أين يذهب النص العربي في Solr: في الإعداد الافتراضي allfields من 100 إلى 900 يبحث، وtitle 245ab لا يبحث، وauthor 100abcqd لا يبحث، وبعد marc_local.properties حقل title_alt مع LNK245abnp يبحث وauthor_additional مع LNK100abcd يبحث، وفي الأسفل نتائج البحث في 453 تسجيلة: العنوان المقدمة قبل 0 وبعد 2، والمؤلف ابن خلدون قبل 0 وبعد 7](https://arabroot.io/content/images/2026/11/vufind-discovery-05-880.webp)

الحرف اللاتيني في الحقول الرئيسية والعربي في 880، والربط بينهما في الحقل الفرعي 6

والقاعدة الافتراضية في [marc.properties](https://github.com/vufind-org/vufind/blob/v11.1.1/import/marc.properties?ref=arabroot.io) تضع في حقل `allfields` كل الحقول من 100 إلى 900، ومنها 880، لذلك وجد البحث في «كل الحقول» كلمة «المقدمة». ولكن عندما اخترنا من القائمة «العنوان» أو «المؤلف» كانت النتيجة صفراً، لأن حقل العنوان يأخذ 245 فقط، وحقل المؤلف يأخذ 100 و700 فقط:

```text
Title     المقدمة      0  -
Title     Muqaddimah   7  The Muqaddimah : an introduction to history /
Author    ابن خلدون    0  -
Author    Ibn Khaldun 50  Teoria de la sociedad y de la historia /
```

أي أن الطالب العربي الذي يختار «المؤلف» ويكتب «ابن خلدون» لا يجد شيئاً، والطالب الأجنبي الذي يكتب «Ibn Khaldun» يجد خمسين كتاباً، في مكتبة عربية! والحل في SolrMarc نفسه، فهو يفهم البادئة `LNK` التي تعني «حقول 880 المرتبطة بهذا الحقل»، فأضفنا إلى `marc_local.properties`:

```ini
# Arabic script lives in 880 fields linked to 245/246/100/700: index them too
title_alt = 100t:130adfgklnpst:240a:246abnp:505t:700t:710t:711t:730adfgklnpst:740a:LNK245abnp:LNK246abnp
author_additional = 505r:LNK100abcd:LNK700abcd:LNK110ab
```

واخترنا هذين الحقلين بالذات لأن ملف `searchspecs.yaml` يجعل `title_alt` من حقول بحث العنوان، و`author_additional` من حقول بحث المؤلف، فلا نحتاج تعديل قواعد البحث. وفي `title_alt` كتبنا القائمة الأصلية كاملة ثم أضفنا عليها، لأن السطر في الملف المحلي يستبدل السطر الأصلي ولا يضيف إليه. ثم أعدنا الفهرسة بنقل الملفات من `processed` وتشغيل `batch-import-marc.sh` مرة أخرى، فأصبحت النتيجة:

```text
Title     المقدمة      2  al-Muqaddimah /
Title     Muqaddimah   7  The Muqaddimah : an introduction to history /
Author    ابن خلدون    7  Hākadhā takallama Ibn Khaldūn /
Author    Ibn Khaldun 50  Teoria de la sociedad y de la historia /
```

والفرق بين 7 بالعربية و50 باللاتينية ليس خطأ، فأغلب تسجيلات مكتبة الكونغرس القديمة لكتب ابن خلدون فيها الحروف اللاتينية فقط دون حقل 880، لأن إضافة الحرف العربي بدأت متأخرة، وهذه حقيقة في بياناتك يجب أن تعرفها: البحث بالعربية لن يجد إلا ما فهرس بالعربية. والصورة التالية للبحث عن «ابن خلدون» في «كل الحقول» من الواجهة العربية:

![صفحة نتائج VuFind بالواجهة العربية لكلمة ابن خلدون في كل الحقول: يعرض 1 إلى 9 نتائج من 9، وفوق النتائج الموضوعات المستخلصة History وCivilization وPhilosophy وغيرها، والنتيجة الأولى Hakadha takallama Ibn Khaldun وتحتها هكذا تكلم ابن خلدون منشور في 2025 مع تظليل كلمتي ابن خلدون ورقم الاستدعاء غير مصنف والمكان المكتبة المركزية وشارة متاح، والثانية Autobiographie مع ابن خلدون السيرة الذاتية، والثالثة كتاب بالفارسية باريابى ابن خلدون به حضور امير تيمور، وعلى الجانب تنقيح النتائج: المؤسسة مكتبة الجامعة 9، والمكتبة المكتبة المركزية 9، والتنسيق كتاب 9، ورقم الاستدعاء، والمؤلف، واللغة](https://arabroot.io/content/images/2026/11/vufind-discovery-07-results-arabic.webp)

البحث العربي يجد العنوان من الحقل 880 ويظلله، والحدود Facets على الجانب

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

### كيف يرتب VuFind النتائج؟

عندما يكتب القارئ كلمة ويختار «العنوان»، لا يبحث VuFind في حقل واحد، وإنما في مجموعة حقول لكل منها وزن، وهذه الأوزان مكتوبة في الملف `config/vufind/searchspecs.yaml`. وهذا جزء بحث العنوان كما هو في الإصدار الذي جربناه:

```yaml
Title:
  DismaxFields:
    - title_short^500
    - title_full_unstemmed^450
    - title_full^400
    - title^300
    - title_alt^200
    - title_new^100
    - title_old
    - series^100
    - series2
  DismaxHandler: edismax
```

في الإعداد أعلاه لاحظ التالي:

- الرقم بعد العلامة `^` هو وزن الحقل Boost، فالكلمة التي توجد في العنوان المختصر `title_short` ترفع التسجيلة أكثر من الكلمة نفسها في العنوان البديل `title_alt` بمرتين ونصف تقريباً، والسبب منطقي: من يكتب عنوان الكتاب كما هو يريد هذا الكتاب أولاً، وليس كتاباً آخر ذكر العنوان في محتوياته.
- العنوان العربي الذي أدخلناه من الحقل 880 ذهب إلى `title_alt` بوزن 200، أما العنوان اللاتيني ففي `title_short` بوزن 500\. وهذا يعني أن ترتيب النتائج في البحث العربي يعتمد على حقل أضعف، فإذا كانت مكتبتك تفهرس كتبها العربية بالحروف العربية مباشرة في الحقل 245، كما تفعل أغلب المكتبات العربية، فلا تحتاج هذا التعديل أصلاً، لأن العنوان العربي سوف يكون في `title_short` من البداية. أما إذا كانت أغلب تسجيلاتك منقولة من مكتبات أجنبية بحقول 880، فأنشئ نسخة محلية من `searchspecs.yaml` وارفع وزن `title_alt` بعد أن تجرب أسئلة حقيقية من القراء وتقارن الترتيب قبل التعديل وبعده.
- `edismax` هو محلل الأسئلة في Solr الذي يسمح بالبحث في عدة حقول بأوزان مختلفة، ويفهم علامات البحث مثل الاقتباس للعبارة الكاملة والنجمة للبحث بالبداية، وقد جربنا النجمة على كتاب البخلاء: `البخلا*` وجد الكتاب، و`بخلا*` لم يجد شيئاً، و`*بخلاء` لم يجد شيئاً أيضاً، والسبب أن النجمة تكمل نهاية الكلمة فقط، و«ال» في بدايتها جزء منها في الفهرس.

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

## إضافة المستودع DSpace إلى البحث نفسه

الآن نصل إلى السبب الذي من أجله نبني طبقة الاكتشاف. تسجيلات DSpace ليست MARC، وإنما Dublin Core، وهو معيار أبسط فيه عناصر مثل `dc:title` و`dc:creator` و`dc:subject`، وكل عنصر فيه قابل للتكرار ودون حقول فرعية، فلا يوجد فيه فرق بين المؤلف الأول والمؤلف المشارك كما في الحقلين 100 و700 في MARC، ولا يوجد فيه مكان لرقم الطلب أو النسخ، وهذا مناسب لرسالة جامعية لها ملف PDF وليس لها رف. لذلك لا يمر على SolrMarc، وإنما على ملف تحويل XSLT يأتي مع VuFind باسم `dspace.xsl`، وإعداده في `import/dspace.properties`. وفي المختبر استخدمنا [نسخة DSpace التجريبية الرسمية](https://demo.dspace.org/server/oai/request?verb=Identify&ref=arabroot.io) كمصدر حقيقي يعمل على الإنترنت، وأضفنا لها قسماً في `oai.ini`:

```ini
[DSpaceDemo]
url = https://demo.dspace.org/server/oai/request
metadataPrefix = oai_dc
injectId = identifier
idSearch[] = "/^oai:demo.dspace.org:/"
idReplace[] = "dspace-"
dateGranularity = auto
```

في الإعداد أعلاه لاحظ التالي:

- `injectId` يضع معرف OAI داخل التسجيلة، لأن ملف XSLT يأخذ منه معرف التسجيلة في Solr.
- `idSearch` و`idReplace` يحولان `oai:demo.dspace.org:10673/24266` إلى `dspace-10673/24266`، والسبب أن معرفات Koha أرقام مثل 195، فإذا جاء من مصدر آخر معرف يساوي رقماً موجوداً فإن التسجيلة الثانية تستبدل الأولى في Solr دون أي رسالة.

وفي المحاولة الأولى أضفنا السطر `set = col_10673_50406` لنحصد مجموعة Collection واحدة فقط، لأن المستودع التجريبي فيه أكثر من 25 ألف تسجيلة، فرد الحاصد «No new records found»، ولما سألنا المستودع مباشرة كان الرد `noRecordsMatch`، رغم أن هذه المجموعة نفسها ظاهرة في رأس تسجيلة حصدناها قبل دقائق. والسبب أن DSpace يبني فهرس المجموعات الخاص بـ OAI بمهمة منفصلة، فإذا لم تعمل هذه المهمة بعد إضافة المحتوى فإن الحصاد بالمجموعة يعود فارغاً، وهذا ما شرحناه في قسم المهام المجدولة في دليل DSpace. لذلك حصدنا بالتاريخ بدلاً من المجموعة:

```bash
php harvest/harvest_oai.php --from=2026-11-12T07:57:00Z --until=2026-11-12T07:58:00Z DSpaceDemo
./harvest/batch-import-xsl.sh DSpaceDemo dspace.properties
```

```text
[0 records harvested] Processing 100 records...
[100 records harvested] Processing 36 records...
Completed without errors -- 1 source(s) processed.
```

وقبل الاستيراد نسخنا `dspace.properties` إلى `local/import` وغيرنا فيه `institution` إلى «المستودع الرقمي»، فأصبح عندنا في الفهرس 589 تسجيلة: 453 من Koha و136 من DSpace، وكل تسجيلة تعرف مصدرها في الحقل `institution`، وهذا الحقل يظهر للقارئ حداً على الجانب اسمه «المؤسسة»:

![صفحة نتائج VuFind لكلمة education: يعرض 1 إلى 12 نتائج من 12، وعلى الجانب حد المؤسسة وفيه مكتبة الجامعة 11 والمستودع الرقمي 1، ثم المكتبة المكتبة المركزية 11، والتنسيق كتاب 11 ووقائع المؤتمر 1، ورقم الاستدعاء، والمؤلف، والنتائج كتب منها Ilm al-tarbiyah لطه حسين وKitab al-taj للجاحظ والتعليم في المغرب ورهانات القرن الجديد، وكل منها بشارة كتاب ومتاح](https://arabroot.io/content/images/2026/11/vufind-discovery-10-mixed-sources.webp)

نتيجة واحدة من مصدرين: 11 كتاباً من Koha وتسجيلة من المستودع، وحد «المؤسسة» يفصل بينهما

ولاحظ في حصاد DSpace شيئاً آخر: من أول مئة تسجيلة رجعت كان فيها 48 تسجيلة فقط لها عنوان، والباقي فيه التاريخ والرابط فقط، وهذه تسجيلات محذوفة أو فارغة في المستودع التجريبي. وفي مستودعك الحقيقي قد يحدث الشيء نفسه مع الرسائل المحجوبة Embargoed أو المسحوبة Withdrawn، فراجع عينة من التسجيلات المحصودة قبل أن تفهرسها، لأن التسجيلة دون عنوان تظهر للقارئ سطراً فارغاً في النتائج.

## الواجهة العربية

الترجمة العربية جزء من VuFind في الملف `languages/ar.ini`، والقالب الافتراضي `sandal5` يقلب الصفحة من اليمين إلى اليسار عندما تكون اللغة عربية، كما ترى في الصور أعلاه. ولتجعل العربية لغة الموقع الافتراضية غير السطر `language` في قسم `[Site]`:

```ini
language        = ar
```

والترجمة ليست كاملة، فقد رأينا «Checked out» في حالة النسخة، وبعض عبارات المساعدة، والموضوعات نفسها بالإنجليزية لأنها من رؤوس موضوعات مكتبة الكونغرس، وهذه بيانات وليست واجهة. وإذا كنت ستطلق النظام لجامعة عربية فخصص وقتاً لمراجعة الترجمة صفحة صفحة، وضع تعديلاتك في `local/languages/ar.ini`، وأرسل ما تصلحه إلى المشروع، فهذا أسهل طريق للمساهمة في مشروع مفتوح المصدر دون كتابة كود.

## قبل الإنتاج: النطاق والمهام والنسخ الاحتياطي

- **النطاق والشهادة:** ضع VuFind خلف Reverse Proxy بشهادة HTTPS كما في [تثبيت Caddy](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-caddy-reverse-proxy/)، وغير `url` في قسم `[Site]` إلى العنوان النهائي، لأن VuFind يبني منه روابط التسجيلات في البريد والتصدير. وهذا الجزء لم نختبره في المختبر لأنه يحتاج نطاقاً حقيقياً.
- **المهام المجدولة:** الحصاد من Koha ومن DSpace ثم الفهرسة كل ساعة أو كل ليلة، ومعها حذف التسجيلات التي أبلغ عنها المصدر أنها محذوفة، والسكربت `batch-delete.sh` مع الحصاد يفعل ذلك.
- **النسخ الاحتياطي:** انسخ المجلد `local` كله، فيه إعداداتك وقواعد الفهرسة وملفات اللغة، وانسخ قاعدة بيانات VuFind بالأداة `mariadb-dump` لأن فيها حسابات القراء وقوائمهم. أما فهرس Solr فلا تحتاج نسخه إذا كانت مصادرك تعمل، لأنك تستطيع إعادة بنائه بالحصاد الكامل، وقد استغرق عندنا أقل من دقيقتين لـ 453 تسجيلة، فاحسب الوقت على حجم مكتبتك وقرر.
- **التحديث:** ثبت حزمة الإصدار الجديد، ثم افتح معالج الإعداد ليرقي قاعدة البيانات، وراجع ملفات `local/config` مقابل الملفات الأصلية الجديدة، لأن الإعدادات الجديدة تظهر في الأصلية فقط. وإذا تغير `schema.xml` بين الإصدارات فأعد الفهرسة كاملة.

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

| العرض                                                           | السبب                                    | الحل                                                                                 |
| --------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------ |
| كل الكتب تظهر دون نسخ ودون أي خطأ                               | معرف التسجيلة من 001 وليس رقم Koha       | id = 999c, first في marc\_local.properties ثم إعادة الفهرسة                          |
| Unauthorized IP address من ILS-DI                               | عنوان VuFind ليس في ILS-DI:AuthorizedIPs | أضفه بالأداة koha-preferences، فالتعديل المباشر في الجدول لا يظهر حتى تمسح Memcached |
| البحث بالعنوان أو المؤلف بالعربية يعيد صفراً، و«كل الحقول» يعمل | النص العربي في 880 فقط                   | حقول LNK245 وLNK100 في marc\_local.properties                                        |
| «بخلاء» لا تجد «البخلاء»                                        | لا يوجد تجذيع عربي في المحلل الافتراضي   | علم القراء البحث بالكلمة كاملة أو بالنجمة، أو أضف مرشحات Solr العربية بعد اختبارها   |
| حصاد مجموعة من DSpace يعيد noRecordsMatch                       | فهرس OAI في DSpace لم يحدث               | شغل dspace oai import في المستودع، أو احصد بالتاريخ                                  |
| تسجيلة من DSpace اختفت تسجيلة من Koha                           | معرفان متساويان من مصدرين                | بادئة لكل مصدر عبر idSearch وidReplace                                               |
| القراء يراسلون support@myuniversity.edu                         | البريد الافتراضي في \[Site\]             | غير email وtitle قبل الإطلاق                                                         |
| إعداداتك ضاعت بعد التحديث                                       | عدلت الملفات الأصلية في config/vufind    | كل تعديل في local/config/vufind                                                      |

## قائمة تحقق قبل الإطلاق

- كل فحوص معالج الإعداد ناجحة، ثم `autoConfigure = false`.
- Solr لا يرد من خارج السيرفر، والمنفذ 3306 في Koha مفتوح لعنوان VuFind وحده.
- رابط تسجيلة في VuFind فيه رقم Koha نفسه، وصفحتها تعرض النسخ وحالتها.
- كتاب تعيره من Koha يظهر معاراً في VuFind دون إعادة فهرسة، وكتاب تفهرسه اليوم يظهر بعد الحصاد التالي.
- البحث بالعنوان والمؤلف بالعربية يجد التسجيلات التي فيها 880، والبحث بالهمزة ودونها والتاء المربوطة والهاء يعطي النتيجة نفسها.
- حد «المؤسسة» يفصل بين المكتبة والمستودع، ولا توجد في النتائج تسجيلات بلا عنوان.
- البريد والعنوان في `[Site]` للمكتبة الحقيقية، والترجمة العربية مراجعة في الصفحات الأساسية.
- جربت إيقاف Koha وعرفت ماذا يرى القارئ، وأعلنت للموظفين أن البحث يستمر أثناء الصيانة.

## تدريب عملي

- أضف إلى `marc_local.properties` حقل الموضوع من 880 المرتبط بالحقل 650، ثم ابحث عن موضوع بالعربية وقارن النتيجة قبل التعديل وبعده.
- أعر نسخة من Koha، ثم اجعل VuFind يعرض حالة «Checked out» بالعربية عبر ملف لغة محلي.

## الخلاصة

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

- طبقة الاكتشاف تبحث في نسخة من سجلات كل مصادرك داخل Solr، وتسأل Koha عن حالة النسخة فقط لحظة العرض، لذلك يستمر البحث حتى عندما يتوقف Koha.
- VuFind 11.1.1 يثبت من حزمة Debian الرسمية ومعه Solr 9.8.1، واستخدم في المختبر 1.57GB من الذاكرة، أغلبها لـ Solr.
- النقل من Koha بالحصاد OAI-PMH بصيغة `marcxml`، ومعرف التسجيلة يجب أن يكون من الحقل 999c، وإلا تظهر الكتب بلا نسخ دون أي خطأ.
- KohaILSDI لا يحتاج إضافة ولكنه يحتاج حساب قراءة في قاعدة بيانات Koha، وKohaRest يعمل عبر REST API وحده ويحتاج إضافة koha-plugin-rest-di.
- المحلل الافتراضي يوحد الهمزة والتاء المربوطة والألف المقصورة والتشكيل، ولا يفصل «ال» و«و»، والعنوان العربي في الحقل 880 لا يدخل بحث العنوان والمؤلف حتى تضيف `LNK245` و`LNK100`.
- DSpace يدخل الفهرس نفسه عبر `dspace.xsl`، مع بادئة لمعرفاته، وحد «المؤسسة» يفصل المصادر للقارئ.

وفي مقالات قادمة بإذن الله سوف نشرح معيار MARC21 وحقوله بالتفصيل، وكيف تجمع البوابات سجلات المستودعات بالحصاد OAI-PMH:

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

- نوفمبر 2026: كتابة الدليل وتجربته على VuFind 11.1.1 مع Solr 9.8.1 فوق Koha 26.05.05 وDSpace التجريبي، بـ 453 تسجيلة حقيقية من فهرس مكتبة الكونغرس.