Krok 1. Omówienie dodawania wyszukiwania do statycznej aplikacji internetowej przy użyciu platformy .NET
Ten samouczek tworzy witrynę internetową do wyszukiwania w katalogu książek, a następnie wdraża witrynę internetową w statycznej aplikacji internetowej platformy Azure.
Co robi przykład?
Ta przykładowa witryna internetowa zapewnia dostęp do katalogu 10 000 książek. Wykaz można przeszukiwać, wprowadzając tekst na pasku wyszukiwania. Podczas wprowadzania tekstu witryna internetowa używa funkcji sugestii indeksu wyszukiwania do automatycznego uzupełniania tekstu. Po zakończeniu zapytania zostanie wyświetlona lista książek z częścią szczegółów. Możesz wybrać książkę, aby wyświetlić wszystkie szczegóły przechowywane w indeksie wyszukiwania książki.
Środowisko wyszukiwania obejmuje:
- Wyszukiwanie — udostępnia funkcje wyszukiwania dla aplikacji.
- Sugerowanie — udostępnia sugestie, gdy użytkownik wpisuje na pasku wyszukiwania.
- Aspekty i filtry — udostępnia strukturę nawigacji aspektowej, która filtruje według autora lub języka.
- Wyniki podzielone na strony — udostępnia kontrolki stronicowania służące do przewijania wyników.
- Wyszukiwanie dokumentów — wyszukuje dokument według identyfikatora, aby pobrać całą jego zawartość dla strony szczegółów.
Jak jest zorganizowana próbka?
Przykładowy kod zawiera następujące składniki:
Aplikacja | Purpose | GitHub Repozytorium Lokalizacja |
---|---|---|
klient | Aplikacja React (warstwa prezentacji) do wyświetlania książek z wyszukiwaniem. Wywołuje aplikację funkcji platformy Azure. | /azure-search-static-web-app/client |
api | Aplikacja funkcji platformy Azure .NET (warstwa biznesowa) — wywołuje interfejs API wyszukiwania sztucznej inteligencji platformy Azure przy użyciu zestawu SDK platformy .NET | /azure-search-static-web-app/api |
wstawianie zbiorcze | Projekt .NET umożliwiający utworzenie indeksu i dodanie do niego dokumentów. | /azure-search-static-web-app/bulk-insert |
Konfigurowanie środowiska projektowego
Utwórz usługi i zainstaluj następujące oprogramowanie dla lokalnego środowiska programistycznego.
- Azure AI Search, dowolny region lub warstwa
- .NET 6 lub nowszy
- Usługa Git
- Visual Studio Code
- Rozszerzenie C# Dev Tools dla programu Visual Studio Code
- Rozszerzenie statycznej aplikacji internetowej platformy Azure dla programu Visual Studio Code
Ten samouczek nie uruchamia interfejsu API funkcji platformy Azure lokalnie, ale jeśli zamierzasz uruchomić go lokalnie, zainstaluj narzędzia azure-functions-core-tools.
Rozwidlenie i sklonowanie przykładu wyszukiwania za pomocą narzędzia git
Tworzenie rozwidlenia przykładowego repozytorium ma kluczowe znaczenie dla wdrożenia statycznej aplikacji internetowej. Aplikacje internetowe określają akcje kompilacji i zawartość wdrożenia na podstawie własnej lokalizacji rozwidlenia usługi GitHub. Wykonywanie kodu w statycznej aplikacji internetowej jest zdalne, a usługa Azure Static Web Apps odczytuje kod z rozwidlenia przykładu.
W witrynie GitHub rozwidlenie repozytorium azure-search-static-web-app.
Ukończ proces rozwidlenia w przeglądarce internetowej przy użyciu konta usługi GitHub. W tym samouczku używany jest rozwidlenie w ramach wdrożenia do statycznej aplikacji internetowej platformy Azure.
W terminalu powłoki Bash pobierz przykładową aplikację rozwidlenia na komputer lokalny.
Zastąp
YOUR-GITHUB-ALIAS
element aliasem usługi GitHub.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-static-web-app.git
W tym samym terminalu powłoki Bash przejdź do rozwidlenia repozytorium dla tego przykładu wyszukiwania w witrynie internetowej:
cd azure-search-static-web-app
Użyj polecenia programu Visual Studio Code,
code .
aby otworzyć rozwidlenie repozytorium. Pozostałe zadania są wykonywane z programu Visual Studio Code, chyba że określono.code .