الخطوة 1 - نظرة عامة على إضافة بحث إلى موقع ويب باستخدام .NET

  • مقالة

ينشئ هذا البرنامج التعليمي موقع ويب للبحث من خلال كتالوج من الكتب ثم ينشر موقع الويب إلى تطبيق ويب ثابت Azure.

ماذا تفعل العينة؟

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

لقطة شاشة لنموذج التطبيق في نافذة مستعرض.

تتضمن تجربة البحث ما يلي:

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

كيف يتم تنظيم العينة؟

يتضمن نموذج التعليمات البرمجية المجلدات التالية:

التطبيق الغرض GitHub
المستودع
الموقع
العميل تطبيق التفاعل (طبقة العرض التقديمي) لعرض الكتب، مع البحث. وهي تستدعي تطبيق Azure Function. /search-website-functions-v4/client
الخادم تطبيق Azure .NET Function (طبقة الأعمال) - يستدعي Azure الذكاء الاصطناعي Search API باستخدام .NET SDK /search-website-functions-v4/api
إدراج مجمع ملف .NET لإنشاء الفهرس وإضافة المستندات إليه. /search-website-functions-v4/bulk-insert

إعداد بيئة التطوير

تثبيت البرنامج التالي لبيئة التطوير المحلية الخاصة بك.

  • .NET 6 أو أحدث
  • بوابه
  • Visual Studio Code والملحقات التالية
    • Azure Static Web App
    • استخدم المحطة الطرفية المتكاملة لعمليات سطر الأوامر.
  • اختياري:
    • لا يقوم هذا البرنامج التعليمي بتشغيل Azure Function API محليًا، ولكن إذا كنت تنوي تشغيلها محليًا، فأنت بحاجة إلى تثبيت azure-function-core-tools.

تفرع ونسخ نموذج البحث باستخدام git

يعد تفرع مستودع العينة أمراً بالغ الأهمية لتتمكن من توزيع Static Web App. تحدد تطبيقات الويب إجراءات الإنشاء ومحتوى التوزيع استناداً إلى موقع تفرع GitHub الخاص بك. يعد تنفيذ التعليمات البرمجية في Static Web App بعيداً، مع Azure Static Web Apps في عينة التفرع.

  1. في GitHub، تفرع نموذج المستودع.

    أكمل عملية التفرع في مستعرض الويب باستخدام حسابك GitHub. يستخدم هذا البرنامج التعليمي التفرع الخاص كجزء من التوزيع إلى Azure Static Web App.

  2. في محطة Bash الطرفية، قم بتنزيل نموذج التطبيق المتشعب إلى الكمبيوتر المحلي.

    استبدل YOUR-GITHUB-ALIAS باسمك المستعار في GitHub.

    git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples

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

    cd azure-search-dotnet-samples

  4. استخدم الأمر Visual Studio Code، code . لفتح المستودع المتشعب. يتم إنجاز المهام المتبقية من Visual Studio Code، ما لم يتم تحديدها.

    code .

قم بإنشاء مجموعة موارد لموارد Azure الخاصة بك

  1. في Visual Studio Code، افتح شريط النشاطوحدد أيقونة Azure.

  2. سجل الدخول إلى Azure، إذا لم تكن قد سجلت الدخول بالفعل.

  3. في قسم الموارد ، حدد إضافة (+)، ثم حدد إنشاء مجموعة موارد.

    لقطة شاشة ل Visual Studio Code، في مستكشف Azure، تعرض خيار **Create Resource Group**.

  4. أدخل اسم مجموعة الموارد، مثل cognitive-search-demo-rg.

  5. أدخل منطقة:

    • بالنسبة إلى Node.js، حدد West US 2. هذه هي المنطقة الموصى بها لمعاينة نموذج برمجة Azure Function (PM) v4.
    • بالنسبة إلى C# وPython، نوصي بالمناطق التالية، المدعومة من Azure Static Web Apps اعتبارا من هذه الكتابة: West US 2، East US 2، West Europe، ، Central USEast Asia

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

الخطوات التالية