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
- Ahhoz, hogy követni tudja az oktatóanyagot, szüksége lesz egy előfizetői azonosítóra a Bing Custom Search API-hoz. Kulcs lekéréséhez hozzon létre egy Bing Custom Search-erőforrást a Azure Portal.
- Ha még nincs telepítve a Visual Studio 2017 vagy újabb verziója, letöltheti és használhatja az ingyenesVisual Studio 2019 Community Editiont.
Egyéni keresési példány létrehozása
Bing Custom Search-példány létrehozása:
Nyisson meg egy internetböngészőt.
Navigáljon a Custom Search portálra.
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.
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.
Kattintson az OK gombra, adja meg az URL-címet, és hogy az URL aloldalait is figyelembe kívánja-e venni.
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.
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.
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.
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.
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.
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.
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.
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:
Kattintson a Hosted UI (Üzemeltetett felhasználói felület) lapra.
Válasszon ki egy elrendezést.
Válasszon ki egy színtémát.
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.
Adja meg a további beállítási lehetőségeket.
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.
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ö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
Nyissa meg a Visual Studiót a számítógépén.
A Fájl menüben válassza az Új, majd a Projekt elemet.
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.
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.
Az index.cshtml szerkesztése
A Megoldáskezelőben bontsa ki a Pages (Oldalak) elemet, és kattintson duplán az index.cshtml fájlra a megnyitásához.
Az index.cshtml fájlban töröljön mindent a 7. sortól kezdve.
@page @model IndexModel @{ ViewData["Title"] = "Home page"; }
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>
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.
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>
A Megoldáskezelőben kattintson a jobb gombbal a wwwroot elemre, majd a View in Browser (Megtekintés böngészőben) parancsra.
Az új Custom Search-weboldal a következőhöz hasonlóan néz ki:
A keresés végrehajtásakor a következőkhöz hasonló eredmények jelennek meg: