Freigeben über


Schritt 1 – Übersicht über das Hinzufügen von Suchfunktionen zu einer statischen Web-App mit .NET

Dieses Lernprogramm erstellt eine Website, die einen Katalog von Büchern durchsucht und die Website dann in einer Azure Static Web App bereitstellt.

Wozu dient das Beispiel?

Diese Beispielwebsite bietet Zugriff auf einen Katalog mit 10.000 Büchern. Sie können den Katalog durchsuchen, indem Sie Text in die Suchleiste eingeben. Während Sie Text eingeben, verwendet die Website das Vorschlagfeature des Suchindexes zum AutoVervollständigen des Textes. Nach Abschluss der Abfrage zeigt die Website die Liste der Bücher mit einem Teil der Details an. Sie können ein Buch auswählen, um alle im Suchindex gespeicherten Details des Buchs anzuzeigen.

Screenshot: Beispiel-App in einem Browserfenster.

Die Suchfunktion umfasst Folgendes:

  • Suche: Stellt Suchfunktionen für die Anwendung bereit.
  • Vorschlag: Gibt während der Benutzereingabe über die Suchleiste Vorschläge an.
  • Facetten und Filter: Stellt eine Facettennavigationsstruktur bereit, die nach Ersteller oder Sprache filtert.
  • Paginierte Ergebnisse: Stellt Paginierungssteuerelemente zum Scrollen durch Ergebnisse bereit.
  • Dokumentsuche: Sucht ein Dokument anhand der ID, um den gesamten Inhalt für die Detailseite abzurufen.

Wie ist das Beispiel organisiert?

Der Beispielcode enthält die folgenden Komponenten:

App Zweck GitHub
Repository
Standort
Client React-App (Darstellungsebene) zum Anzeigen von Büchern mit der Suche. Sie ruft die Azure-Funktions-App auf. /azure-search-static-web-app/client
api Azure-.NET-Funktions-App (Geschäftsebene): Ruft die Azure KI Search-API mithilfe des .NET SDK auf /azure-search-static-web-app/api
Masseneinfügung .NET-Projekt zum Erstellen des Indexes und zum Hinzufügen von Dokumenten zu diesem Index /azure-search-static-web-app/bulk-insert

Einrichten der Entwicklungsumgebung

Erstellen Sie Dienste, und installieren Sie die folgende Software in Ihrer lokalen Entwicklungsumgebung:

In diesem Lernprogramm wird die Azure-Funktions-API nicht lokal ausgeführt. Wenn Sie es lokal ausführen möchten, installieren Sie azure-functions-core-tools.

Forken und Klonen des Suchbeispiels mit Git

Um die Static Web App bereitzustellen, müssen Sie das Beispiel-Repository forken. Die Webanwendungen verwenden den Speicherort Ihres GitHub-Forks, um die Build-Aktionen und Bereitstellungsinhalte festzulegen. Die Codeausführung in der Static Web App erfolgt remote, wobei Azure Static Web Apps den Code aus Ihrem geforkten Beispiel liest.

  1. Forken Sie auf GitHub das Repository azure-search-static-web-app.

    Schließen Sie den Fork-Prozess in Ihrem Webbrowser mit Ihrem GitHub-Konto ab. In diesem Tutorial wird der Fork als Teil der Bereitstellung in einer statischen Azure-Web-App verwendet.

  2. Laden Sie an einem Bash-Terminal Ihre verzweigte Beispielanwendung auf Ihren lokalen Computer herunter.

    Ersetzen Sie YOUR-GITHUB-ALIAS durch Ihren GitHub-Alias.

    git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-static-web-app.git
    
  3. Wechseln Sie am gleichen Bash-Terminal in Ihr verzweigtes Repository für dieses Beispiel zur Websitesuche:

    cd azure-search-static-web-app
    
  4. Verwenden Sie den Visual Studio Code-Befehl code ., um Ihr verzweigtes Repository zu öffnen. Sie führen die verbleibenden Aufgaben aus Visual Studio Code aus, sofern nicht angegeben.

    code .
    

Nächste Schritte