الخطوة 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 في عينة التفرع.
في GitHub، تفرع نموذج المستودع.
أكمل عملية التفرع في مستعرض الويب باستخدام حسابك GitHub. يستخدم هذا البرنامج التعليمي التفرع الخاص كجزء من التوزيع إلى Azure Static Web App.
في محطة Bash الطرفية، قم بتنزيل نموذج التطبيق المتشعب إلى الكمبيوتر المحلي.
استبدل
YOUR-GITHUB-ALIAS
باسمك المستعار في GitHub.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples
في نفس محطة Bash الطرفية، انتقل إلى المستودع المتشعب الخاص بك لمثال بحث موقع الويب هذا:
cd azure-search-dotnet-samples
استخدم الأمر Visual Studio Code،
code .
لفتح المستودع المتشعب. يتم إنجاز المهام المتبقية من Visual Studio Code، ما لم يتم تحديدها.code .
قم بإنشاء مجموعة موارد لموارد Azure الخاصة بك
في Visual Studio Code، افتح شريط النشاطوحدد أيقونة Azure.
سجل الدخول إلى Azure، إذا لم تكن قد سجلت الدخول بالفعل.
في قسم الموارد ، حدد إضافة (+)، ثم حدد إنشاء مجموعة موارد.
أدخل اسم مجموعة الموارد، مثل
cognitive-search-demo-rg
.أدخل منطقة:
- بالنسبة إلى Node.js، حدد
West US 2
. هذه هي المنطقة الموصى بها لمعاينة نموذج برمجة Azure Function (PM) v4. - بالنسبة إلى C# وPython، نوصي بالمناطق التالية، المدعومة من Azure Static Web Apps اعتبارا من هذه الكتابة:
West US 2
،East US 2
،West Europe
، ،Central US
East Asia
- بالنسبة إلى Node.js، حدد
استخدم مجموعة الموارد هذه لجميع الموارد التي تم إنشاؤها أثناء هذا البرنامج التعليمي. تمنحك مجموعة الموارد وحدة منطقية لإدارة الموارد، بما في ذلك حذفها عند الانتهاء.