Oktatóanyag: Custom Search-weboldal létrehozása

Figyelmeztetés

2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search Servicesbe. Ez a dokumentáció csak referenciaként szolgál. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos útmutatásért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.

A Bing Custom Search szolgáltatással személyre szabott keresési funkciókat hozhat létre olyan témakörökhöz kapcsolódóan, amelyek jelentőséggel bírnak az Ön számára. Ha például rendelkezik egy keresési felületet biztosító harcművészeti webhelytel, megadhatja a Bing által keresett tartományokat, alwebhelyeket és weblapokat. A felhasználók az érdeklődési körükhöz igazított keresési eredményeket látnak ahelyett, hogy több oldalnyi általános találatot kellene átnézniük, amelyben irreleváns tartalom is lehet.

Az oktatóanyag bemutatja, hogyan állíthat be egy Custom Search-példányt, és hogyan integrálhatja egy új weboldalba.

Az oktatóanyag az alábbi feladatokat tárgyalja:

  • Egyéni keresési példány létrehozása
  • Aktív bejegyzések hozzáadása
  • Blokkolt bejegyzések hozzáadása
  • Rögzített bejegyzések hozzáadása
  • Egyéni keresés integrálása egy weboldalba

Előfeltételek

Egyéni keresési példány létrehozása

Bing Custom Search-példány létrehozása:

  1. Nyisson meg egy internetböngészőt.

  2. Navigáljon a Custom Search portálra.

  3. Egy Microsoft-fiók (MSA) használatával jelentkezzen be a portálra. Ha nem rendelkezik MSA-vel, kattintson a Microsoft-fiók létrehozása elemre. Ha első alkalommal használja a portált, engedélyt kér az adatok eléréséhez. Kattintson a Yes (Igen) gombra.

  4. A bejelentkezés után kattintson a New custom search (Új egyéni keresés) elemre. A Create a new custom search instance (Új egyéni keresési példány létrehozása ) ablakban adjon meg egy értelmes nevet, és írja le, hogy milyen típusú tartalmat ad vissza a keresés. A nevet bármikor módosíthatja.

    A Create a new custom search (Új Custom Search-példány) mező képernyőképe

  5. Kattintson az OK gombra, adja meg az URL-címet, és hogy az URL aloldalait is figyelembe kívánja-e venni.

    Az URL-meghatározó oldal képernyőképe

Aktív bejegyzések hozzáadása

Ha adott webhelyekről vagy URL-címekről származó eredményeket szeretne figyelembe venni, adja hozzá a címeket az Active (Aktív) laphoz.

  1. A Configuration (Konfiguráció) oldalon kattintson az Active (Aktív) lapra, és adja meg a keresésbe belefoglalni kívánt egy vagy több webhely URL-címét.

    A Definíciószerkesztő aktív lapjának képernyőképe

  2. Ha meg kíván győződni arról, hogy a példány visszaad eredményeket, akkor adjon meg egy lekérdezést a jobb oldalon található előnézet panelen. A Bing csak az általa indexelt nyilvános webhelyekről jelenít meg eredményeket.

Blokkolt bejegyzések hozzáadása

Ha szeretné kizárni egyes webhelyek vagy URL-címek eredményeit, adja hozzá a címeket a Blocked (Letiltott) laphoz.

  1. A Configuration (Konfiguráció) oldalon kattintson a Blocked (Letiltva) lapra, és adja meg a keresésből kihagyni kívánt egy vagy több webhely URL-címét.

    A Definíciószerkesztő letiltva lapjának képernyőképe

  2. Ha meg kíván győződni arról, hogy a példány nem ad vissza eredményeket a blokkolt webhelyekről, akkor adjon meg egy lekérdezést a jobb oldalon található előnézet panelen.

Rögzített bejegyzések hozzáadása

Ha egy adott weblapot szeretne rögzíteni a keresési eredmények tetején, adja hozzá a weblapot és a lekérdezési kifejezést a Rögzített laphoz. A Rögzített lap a weblapok és a lekérdezési kifejezéspárok listáját tartalmazza, amelyek egy adott lekérdezés felső eredményeként megjelenő weblapot adják meg. A weblap csak akkor van rögzítve, ha a felhasználó lekérdezési sztringje megfelel a pin-kód lekérdezési sztringjének a PIN-kód egyeztetési feltétele alapján. Csak az indexelt webhelyek jelennek meg a keresésekben. További információt az Egyéni nézet definiálása című témakörben talál.

  1. A Configuration (Konfiguráció) lapon kattintson a Pinned (Rögzített) lapra, és adja meg az első helyen megjeleníteni kívánt weblapot és a hozzá tartozó lekérdezési kifejezést.

  2. Ahhoz, hogy a Bing az első helyen jelenítse meg a webhelyet alapértelmezés szerint a felhasználói lekérdezési sztringnek pontosan egyeznie kell a rögzített elem lekérdezési sztringjével. Az egyezési feltétel módosításához szerkessze a rögzített elemet (kattintson a ceruza ikonra), a Query match condition (Lekérdezés egyezési feltétele) oszlopban kattintson az Exact (Pontos) elemre, és válassza ki az alkalmazása számára megfelelő egyezési állapotot.

    A Definíciószerkesztő rögzített lapjának képernyőképe

  3. Ha meg szeretne győződni arról, hogy a példány a megadott weblapot adja vissza az első helyen, a jobb oldalon található előnézet panelen adja meg a rögzített lekérdezési kifejezést.

Üzemeltetett felhasználói felületi konfigurálása

A Custom Search üzemeltetett felhasználói felületet biztosít, amelyen megjelenítheti a Custom Search-példány JSON-válaszát. A felhasználói felület testreszabása:

  1. Kattintson a Hosted UI (Üzemeltetett felhasználói felület) lapra.

  2. Válasszon ki egy elrendezést.

    A Hosted UI (Üzemeltetett felhasználói felület) elrendezéskiválasztó lépésének képernyőképe

  3. Válasszon ki egy színtémát.

    A Hosted UI (Üzemeltetett felhasználói felület) színtémaválasztásának képernyőképe

    Ha a webalkalmazással való jobb integráció érdekében szeretné még részletesebben beállítani a színtémát, kattintson a Customize theme (Téma testreszabása) elemre. Nem minden színbeállítás alkalmazható minden elrendezési témára. Ha módosítani szeretné egy színt, a megfelelő mezőben adja meg a szín HEXADECIMÁLIS RGB-értékét (például #366eb8). Vagy kattintson a szín gombra, majd a megfelelő árnyalatra. A színek kiválasztásánál mindig gondoljon a kisegítő lehetőségekre.

    Képernyőkép az üzemeltetett felhasználói felület színtéma-testreszabásáról

  4. Adja meg a további beállítási lehetőségeket.

    Képernyőkép az üzemeltetett felhasználói felület további beállítási lépéséről

    A speciális konfigurációkat a Show advanced configurations (Speciális konfigurációk megjelenítése) elemre kattintva érheti el. Ezzel olyan beállításokat adhat hozzá, mint például a Link target (Hivatkozási cím) a webkeresési beállításokhoz, az Enable filters (Szűrők engedélyezése) a kép- és videobeállításokhoz, valamint a Search box text placeholder (Keresőmező szöveges helyőrzője) az egyéb beállításokhoz.

    Képernyőkép az üzemeltetett felhasználói felület speciális beállítási lépéséről

  5. Válassza ki előfizetési kulcsait a legördülő listákból. Másik lehetőségként manuálisan is megadhatja az előfizetési kulcsot.

    Képernyőkép a üzemeltetett felhasználói felület előfizetési kulcsáról

Közzététel vagy visszaállítás

Az egyéni keresési példányon végrehajtott módosítások a Konfiguráció lapon történnek, így ellenőrizheti a módosításokat. Ha végzett a módosításokkal, és készen áll a közzétételre, kattintson a Közzététel gombra. A módosítások csak a közzététel után jelennek meg az éles végpontokon.

Ha a közzététel előtt úgy dönt, hogy nem szeretné megtartani a végrehajtott módosításokat, kattintson a Visszaállítás gombra. A módosítások visszaállításakor az élő állapot konfigurációja változatlan marad, és a Konfiguráció lap visszaáll az élő állapotnak megfelelően.

Üzemeltetett felhasználói felületi felhasználása

Az üzemeltetett felhasználói felület kétféleképpen használható fel.

  • 1. lehetőség: A megadott JavaScript-kódrészlet integrálása az alkalmazásba.
  • 2. lehetőség: A megadott HTML-végpont használata.

Az oktatóanyag hátralévő részében az 1. lehetőség: JavaScript-kódrészlet látható.

A Visual Studio-megoldás beállítása

  1. Nyissa meg a Visual Studiót a számítógépén.

  2. A Fájl menüben válassza az Új, majd a Projekt elemet.

  3. A New Project (Új projekt) párbeszédpanelen válassza a Visual C# / Web / ASP.NET Core Web Application (Visual C#- / Web / ASP.NET Core-webalkalmazás) elemet, nevezze el a projektet, majd kattintson az OK gombra.

    Az új projekt ablak képernyőképe

  4. A New ASP.NET Core Web Application (Új ASP.NET Core-webalkalmazás) ablakban válassza a Web Application (Webalkalmazás) lehetőséget, majd kattintson az OK gombra.

    Képernyőkép az új webalkalmazás ablakáról

Az index.cshtml szerkesztése

  1. A Megoldáskezelőben bontsa ki a Pages (Oldalak) elemet, és kattintson duplán az index.cshtml fájlra a megnyitásához.

    Képernyőkép a megoldáskezelőről kibontott oldalakkal és a kiválasztott index.cshtml fájllal

  2. Az index.cshtml fájlban töröljön mindent a 7. sortól kezdve.

    @page
    @model IndexModel
    @{
       ViewData["Title"] = "Home page";
    }    
    
  3. Adjon hozzá egy sörtörés elemet és egy tárolóként működő div elemet.

    @page
    @model IndexModel
    @{
       ViewData["Title"] = "Home page";
    }
    <br />
    <div id="customSearch"></div>
    
  4. A Hosted UI (Üzemeltetett felhasználói felület) oldalon görgessen le a Consuming the UI (Felhasználói felület felhasználása) szakaszhoz. A JavaScript-kódrészlet eléréséhez kattintson az Endpoints (Végpontok) elemre. A kódrészletet úgy is elérheti, ha először a Production (Termelés), majd a Hosted UI (Üzemeltetett felhasználói felület) lapra kattint.

  5. A szkriptrészletet illessze be a hozzáadott tárolóba.

    @page
    @model IndexModel
    @{
       ViewData["Title"] = "Home page";
    }
    <br />
    <div id="customSearch">
       <script type="text/javascript" 
           id="bcs_js_snippet"
           src="https://ui.customsearch.ai /api/ux/rendering-js?customConfig=<YOUR-CUSTOM-CONFIG-ID>&market=en-US&safeSearch=Moderate&version=latest&q=">
       </script>
    </div>
    
  6. A Megoldáskezelőben kattintson a jobb gombbal a wwwroot elemre, majd a View in Browser (Megtekintés böngészőben) parancsra.

    Képernyőkép a megoldáskezelőről, a wwwroot helyi menü View in Browser (Megtekintés böngészőben) lehetőségének kiválasztásával

Az új Custom Search-weboldal a következőhöz hasonlóan néz ki:

Képernyőkép a Custom Search-weboldalról

A keresés végrehajtásakor a következőkhöz hasonló eredmények jelennek meg:

Képernyőkép az egyéni keresés eredményeiről

Következő lépések