Snabbstart: Skapa en demoapp i portalen (Azure Cognitive Search)

Använd guiden Azure Portal skapa demoapp för att generera en nedladdningsbar "localhost"-webbapp som körs i en webbläsare. Beroende på dess konfiguration fungerar den genererade appen vid första användning, med en live-skrivskyddade anslutning till ett fjärrindex. En standardapp kan innehålla ett sökfält, ett resultatområde, sidofältfilter och stöd för typhuvud.

Demoappen kan hjälpa dig att visualisera hur ett index kommer att fungera i en klientapp, men det är inte avsett för produktionsscenarier. Klientappar bör innehålla säkerhet, felhantering och värdlogik som den genererade HTML-sidan inte tillhandahåller. När du är redo att skapa en klientapp kan du gå till Skapa din första sökapp med .NET SDK för nästa steg.

Förutsättningar

Innan du börjar måste du ha följande:

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

• En Azure Cognitive Search tjänst. Skapa en tjänst eller hitta en befintlig tjänst under din aktuella prenumeration. Du kan använda en kostnadsfri tjänst för den här snabbstarten.

• Microsoft Edge (senaste versionen) eller Google Chrome.

• Ett sökindex som ska användas som grund för ditt genererade program.

  Den här snabbstarten använder inbyggda exempeldata och index för real estate eftersom den har miniatyrbilder (guiden har stöd för att lägga till bilder på resultatsidan). Om du vill skapa indexet som används i den här övningen kör du guiden Importera data och väljer datakällan realestate-us-sample.

  

När indexet är klart att användas går du vidare till nästa steg.

Starta guiden

1. Logga in på Azure-portalen med ditt Azure-konto.

2. Leta upp din söktjänst och välj Index på sidan Översikt på länkarna i mitten av sidan.

3. Välj realestate-us-sample-index i listan över befintliga index.

4. På indexsidan högst upp väljer du Skapa demoapp (förhandsversion) för att starta guiden.

5. På den första guidesidan väljer du Aktivera resursdelning för korsande ursprung (CORS) för att lägga till CORS-stöd i indexdefinitionen. Det här steget är valfritt, men din lokala webbapp ansluter inte till fjärrindexet utan det.

Konfigurera sökresultat

Guiden innehåller en grundläggande layout för renderade sökresultat som innehåller utrymme för en miniatyrbild, en rubrik och beskrivning. Stöd för vart och ett av dessa element är ett fält i ditt index som tillhandahåller data.

1. I Miniatyr väljer du miniatyrfältet i indexet realestate-us-sample. Det här exemplet inkluderar bildminiatyrer i form av URL-adresserade bilder som lagras i ett fält som kallas miniatyrbild. Lämna det här fältet tomt om ditt index inte har bilder.

2. I Rubrik väljer du ett fält som förmedlar det unika för varje dokument. I det här exemplet är list-ID:t ett rimligt val.

3. I Beskrivning väljer du ett fält som innehåller information som kan hjälpa någon att bestämma om de vill klicka vidare till det specifika dokumentet.

   

Lägga till en sidopanel

Söktjänsten stöder fasettad navigering, som ofta återges som en sidopanel. Fasetter baseras på filtrerbara och fasetterbara fält, som de uttrycks i indexschemat.

I Azure Cognitive Search är fasetterad navigering en kumulativ filtreringsupplevelse. Om du väljer flera filter i en kategori expanderas resultatet (till exempel Seattle och Bellevue i City). Om du väljer flera filter mellan kategorier blir resultatet smalare.

1. I guiden väljer du fliken Sidopanel längst upp på sidan. Du ser en lista över alla fält som tillskrivs som filtrerbara och faserbara i indexet.

2. Acceptera det aktuella valet av fasetterade fält och fortsätt till nästa sida.

Lägg till typeahead

Typeahead-funktioner är tillgängliga i form av automatisk komplettering och frågeförslag. Guiden stöder frågeförslag. Baserat på indata vid tangenttryckning som tillhandahålls av användaren returnerar söktjänsten en lista med "slutförda" frågesträngar som kan väljas som indata.

Förslag aktiveras för specifika fältdefinitioner. Guiden ger dig alternativ för att konfigurera hur mycket information som ingår i ett förslag.

Följande skärmbild visar alternativ i guiden, tillsammans med en renderad sida i appen. Du kan se hur fältval används och hur "Visa fältnamn" används för att inkludera eller exkludera etiketter i förslaget.

Lägga till förslag

Förslag refererar till automatiska frågeupp prompter som är kopplade till sökrutan. Cognitive Search två: automatisk komplettering av en delvis angivet sökterm och förslag på en listr listrutan över potentiella matchande dokument baserat på.

Guiden stöder förslag, och fälten som kan ge föreslagna resultat härleds från en Suggesters konstruktion i indexet:

  "suggesters": [
    {
      "name": "sg",
      "searchMode": "analyzingInfixMatching",
      "sourceFields": [
        "number",
        "street",
        "city",
        "region",
        "postCode",
        "tags"
      ]

1. I guiden väljer du fliken Förslag överst på sidan. Du ser en lista över alla fält som har angetts i indexschemat som förslagsprovidrar.

2. Acceptera det aktuella valet och fortsätt till nästa sida.

Skapa, ladda ned och köra

1. Välj Skapa demoapp längst ned på sidan för att generera HTML-filen.

2. När du uppmanas väljer du Ladda ned din app för att ladda ned filen.

3. Öppna filen och klicka på knappen Sök. Den här åtgärden kör en fråga, som kan vara en tom fråga ( * ) som returnerar en godtycklig resultatuppsättning. Sidan bör se ut ungefär som på följande skärmbild. Ange en term och använd filter för att begränsa resultatet.

Det underliggande indexet består av fiktiva, genererade data som har duplicerats mellan dokument och beskrivningar matchar ibland inte bilden. Du kan förvänta dig en mer sammanhängande upplevelse när du skapar en app baserat på dina egna index.

Rensa resurser

När du arbetar i din egen prenumeration kan det dock vara klokt att i slutet av ett projekt kontrollera om du fortfarande behöver de resurser som du skapade. Resurser som fortsätter att köras kostar pengar. Du kan ta bort resurser individuellt eller ta bort resursgruppen om du vill ta bort hela uppsättningen resurser.

Du kan hitta och hantera resurser i portalen med hjälp av länken Alla resurser eller Resursgrupper i det vänstra navigeringsfönstret.

Om du använder en kostnadsfri tjänst bör du komma ihåg att du är begränsad till tre index, indexerare och datakällor. Du kan ta bort enskilda objekt i portalen för att hålla dig under gränsen.

Nästa steg

Demoappen är användbar för prototyper eftersom du kan simulera en slutanvändarupplevelse utan att behöva skriva JavaScript eller frontend-kod, men när du kommer närmare konceptbeviset i ditt eget projekt kan du granska ett av de kodexempel från slutet till slut som är närmare fasaden för en verklig app: