Krok 1 : Přehled přidání vyhledávání do statické webové aplikace pomocí .NET
Tento kurz vytvoří web pro vyhledávání v katalogu knih a pak nasadí web do statické webové aplikace Azure.
Co ukázka dělá?
Tento ukázkový web poskytuje přístup k katalogu 10 000 knih. Katalog můžete prohledávat zadáním textu na panelu hledání. Při zadávání textu používá web funkci návrhu indexu vyhledávání k automatickému dokončování textu. Po dokončení dotazu se zobrazí seznam knih s částí podrobností. Výběrem knihy můžete zobrazit všechny podrobnosti uložené v indexu vyhledávání knihy.
Vyhledávací prostředí zahrnuje:
- Vyhledávání – poskytuje funkci vyhledávání pro aplikaci.
- Navrhnout – poskytuje návrhy, když uživatel píše na panelu hledání.
- Fasety a filtry – poskytuje fasetovou navigační strukturu, která filtruje podle autora nebo jazyka.
- Stránkované výsledky – poskytuje ovládací prvky stránkování pro posouvání výsledků.
- Vyhledávání dokumentů – vyhledá dokument podle ID a načte veškerý jeho obsah stránky podrobností.
Jak je ukázka uspořádaná?
Vzorový kód obsahuje následující komponenty:
| Aplikace | Účel | GitHub Repository Umístění |
|---|---|---|
| klient | Aplikace React (prezentační vrstva) k zobrazení knih s hledáním Volá aplikaci Funkcí Azure. | /azure-search-static-web-app/client |
| api | Aplikace funkcí Azure .NET (obchodní vrstva) – volá rozhraní API služby Azure AI Search pomocí sady .NET SDK. | /azure-search-static-web-app/api |
| hromadné vložení | Projekt .NET pro vytvoření indexu a přidání dokumentů do něj. | /azure-search-static-web-app/bulk-insert |
Nastavení vývojového prostředí
Vytvořte služby a nainstalujte následující software pro místní vývojové prostředí.
- Azure AI Search, libovolná oblast nebo úroveň
- .NET 6 nebo novější
- Git
- Visual Studio Code
- Rozšíření C# Dev Tools pro Visual Studio Code
- Rozšíření Azure Static Web App pro Visual Studio Code
Tento kurz nespouští rozhraní API služby Azure Functions místně, ale pokud ho chcete spustit místně, nainstalujte nástroje azure-functions-core-tools.
Vytvoření forku a naklonování ukázky hledání pomocí Gitu
Vytvoření forku ukázkového úložiště je důležité, aby bylo možné nasadit statickou webovou aplikaci. Webové aplikace určují akce sestavení a obsah nasazení na základě vlastního umístění forku GitHubu. Spouštění kódu ve statické webové aplikaci je vzdálené a služba Azure Static Web Apps čte z kódu ve vaší forkované ukázce.
Na GitHubu forkujte úložiště azure-search-static-web-app.
Dokončete proces forku ve webovém prohlížeči pomocí účtu GitHub. Tento kurz používá váš fork jako součást nasazení do azure Static Web Appu.
V terminálu Bash si stáhněte rozvětvovanou ukázkovou aplikaci do místního počítače.
Nahraďte
YOUR-GITHUB-ALIASaliasem GitHubu.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-static-web-app.gitVe stejném terminálu Bash přejděte do vašeho forku úložiště pro tento příklad vyhledávání na webu:
cd azure-search-static-web-appK otevření rozvětvovaného úložiště použijte příkaz
code .editoru Visual Studio Code. Zbývající úlohy se provádějí v editoru Visual Studio Code, pokud nejsou zadané.code .