Az adattár engedélyezése a Windows Összevont keresésben

Ebből a cikkből megtudhatja, hogyan engedélyezheti az adattár elérését egy OpenSearch-webszolgáltatás számára, és hogyan kerülheti el ennek lehetséges akadályait.

Ez a témakör a következőképpen van rendszerezve:

• Keresési kérelem elfogadásának feltételei
  • Támogatott lekérdezési szintaxis
  • Támogatott hitelesítési protokollok
• Lekérdezések küldése és keresési eredmények visszaadása RSS-ben vagy Atomban
  • Példa RSS-hírcsatorna kimenetére
• Automatikus leképezés a Windows Shell tulajdonságaihoz
• A Windows-elemek fájltípusokra való leképezésének ismertetése
• Az adattár engedélyezésének lehetséges akadályainak elkerülése
• További erőforrások
• Kapcsolódó témakörök

Keresési kérelem elfogadásának feltételei

A webkiszolgálón létrehozott OpenSearchwebszolgáltatásnak az alábbi két követelménynek kell megfelelnie:

• Fogadjon el egy lekérdezést GET URL az ügyféltől.

• Engedélyezze, hogy a keresési kifejezések beágyazódjanak az URL-címbe.

  Az alábbi példa bemutatja, hogyan ágyazható be egy keresési kifejezés egy URL-címbe.

  https://example.com/search.aspx?query=terms&param=mysearchword
  

További információ az URL-címek létrehozásáról: "URL-sablonparaméterek" az OpenSearch leírófájl létrehozása a Windows összevont keresésben című témakörben.

Támogatott lekérdezési szintaxis

A Windows 7-ben nincs konkrét lekérdezési szintaxis. Az OpenSearch szolgáltató bármilyen kifejezést elfogad, amelyet a felhasználó a Windows Explorer beviteli mezőjébe ír be, és az URL-címre kódolja. Ezt az "URL-sablon paraméterei" című szakaszban leírt URL-sablonnak megfelelően teszi, amely openSearch leírásfájlt hoz létre a Windows Összevont keresésben.

A felhasználók azt várják, hogy a különálló kifejezések implicit módon együtt lesznek kezelve. A "Microsoft Windows" lekérdezésnek például csak a "Windows" és a "Microsoft" szöveget tartalmazó eredményeket kell visszaadnia.

Támogatott hitelesítési protokollok

A Windows összevont keresés támogatja a Windows-alapú hitelesítést, és a következő protokollok használatával biztosíthat hitelesítő adatokat a webszolgáltatásoknak:

• NTLM.
• Kerberos.
• Alapszintű (csak https-en keresztül).
• A Windowsra telepített egyéb biztonsági támogatási szolgáltatók (SSP-k) további lekérdezési kapacitást biztosítanak. Az SSP Interface SDK dokumentációjában további SSP-k lehetséges hozzáadását tekintheti át.

Lekérdezések küldése és keresési eredmények visszaadása RSS-ben vagy atomban

Az OpenSearch-szolgáltató felel az XML-elemértékek Windows Shell-rendszertulajdonságokra való leképezéséért, amelyeket a Windows-alkalmazások használhatnak. A szabványos RSS- vagy Atom-elemek alapértelmezett leképezésére azonban nem korlátozódik, és az egyes tulajdonságokhoz egyéni XML-elemeket is belefoglalhat a Windows névterébe. Hozzáadhat például saját egyéni XML-elemeket az elemelemhez , hogy további metaadatokat biztosítson a Windows számára. Más XML-névterek, például az iTunes elemeit is megfeleltetheti

Példa RSS-hírcsatorna kimenetére

Az alábbi példa RSS-hírcsatorna kimenete egy elemet ad vissza.

<rss version="2.0" xmlns:media="https://search.yahoo.com/mrss/" xmlns:example="https://example.com/namespace">
   <channel>
      <title>Search Results</title>
      <item>
         <title>An example result</title>
         <link>https://example.com/pictures.aspx?id=01</link>
         <description>This is a test of the emergency search results system. If this were a real emergency result, you'd be reading something more useful.</description>
         <pubDate>Wed, 1 Oct 2008 23:12:00 GMT</pubDate>
         <media:content url="https://example.com/pictures/picture01.jpg" fileSize="212889" type="image/jpeg" height="768" width="1024"/>
         <media:thumbnail url="https://example.com/thumbnails/picture01.jpg" height="120" width="160"/>
         <example:dateTaken>Mon, 22 Sep 2008 23:12:00 GMT</example:dateTaken>
      </item>
   </channel>
</rss>

A tulajdonságleképezéssel kapcsolatos további információkért tekintse meg az OpenSearch leírásfájl létrehozása a Windows Összevont keresésben című szakasz "Bővített elemek a WIndows összevont keresésben" és az "Egyéni tulajdonságleképezések" című szakaszát.

Automatikus térképzés a Windows Shell attribútumaihoz

Az RSS-hírcsatorna elemein belül választhat, hogy más XML-elemeket is tartalmazzon, amelyek automatikusan megfeleltetik a Windows Shell rendszertulajdonságait. Ehhez adjon meg egy elemet, amely a Windows Shell tulajdonsága után van elnevezve és a Windows Shell rendszertérközzel rendelkezik. Az alábbi példa a névtér deklarációját win=" http://schemas.microsoft.com/windows/2008/propertynamespace" és a tulajdonságleképezés win:System.Contact.PrimaryEmailAddress egyik elemének felvételét mutatja be.

<rss version="2.0" xmlns:example="https://example.com/schema/2009" xmlns:win="http://schemas.microsoft.com/windows/2008/propertynamespace">
...
   <item>
      <title>Someone</title>
      <win:System.Contact.PrimaryEmailAddress>[email protected]
   </win:System.Contact.PrimaryEmailAddress>
   </item>

Az itt használt névtér-előtag ("win") egy javaslat. Bármilyen előtagot használhat. Azonban a Windows Shell pontos tulajdonságnevét kell használnia, és tartalmaznia kell a pontos egységes erőforrás-azonosítót (URI) az alábbi példában látható módon:

http://schemas.microsoft.com/windows/2008/propertynamespace

Tudnivalók a Windows Shell rendszertulajdonságairól

A Windows a rendszertulajdonságok teljes listáját és az egyes tulajdonságokhoz szükséges értéktípus-formátumot határozza meg. A System.FileExtension Window Shell tulajdonság dokumentációja például azt határozza meg, hogy az értéknek tartalmaznia kell a kezdő elemet (".docx" és nem a "docx").

Dátum- és időértékek

Az előnyben részesített dátum- és időformátum az ISO-8601, ahogy az alábbi példában is látható:

2008-01-16T 19:20:30:.45+01:00

A .NET-fejlesztőknek a DateTime osztályt ToString("R") kell használniuk a megfelelő formátum kimenetéhez.

A tulajdonságleképezéssel kapcsolatos további információkért lásd: "Bővített elemek a Windows összevont keresésben" című témakör az OpenSearch description file létrehozása a Windows Összevont keresésben című témakörben.

Annak ismertetése, hogy a Windows hogyan képez le elemeket fájltípusokra

A Windows Intéző felhasználói felületén végzett keresés lehetővé teszi, hogy a felhasználók fájlként kezeljék az eredményeket, amikor egy RSS-elem távolról tárolt fájlra mutat. A felhasználó áthúzhatja az elemeket az asztalra, a Windows Intéző felhasználói felülete pedig megjeleníti a megfelelő ikont, és megadja a megfelelő műveleti menüt. Ha az RSS-elem nem mutat távolról tárolt fájlra, a rendszer hivatkozásként kezeli a fájlt, és a felhasználók műveleteket hajthatnak végre rajta, például létrehozhatnak egy parancsikont, vagy megnyithatják a böngészőben.

Az alábbi folyamatábra bemutatja, hogyan határozza meg a Windows egy elem fájltípusát.

Az OpenSearch szolgáltató az alábbi lépéseket hajtja végre egy elem fájltípusra való leképezéséhez:

• Annak azonosítása, hogy az elemet fájlként vagy webes hivatkozásként kell-e kezelni.
• Azonosítsa a megfelelő fájlnévkiterjesztést.

Ha például az elem rendelkezik egy fájlrendszer elérési útját használó hivatkozás URL-címével (például file:///\\server\share\etc\item.ext), az OpenSearch-szolgáltató fájlként kezeli a hivatkozást, és az elérési úton használt fájlnévkiterjesztés alapján határozza meg a típust (ebben a példában.ext).

Ha az elem a standard RSS mellékletet vagy a MediaRSS media:content elemet használja, az OpenSearch szolgáltató feltételezi, hogy az elem egy fájl, és az alábbiak szerint azonosítja a fájlnevének kiterjesztését.

• Ha az elemhez a System.FileExtension Windows Shell tulajdonság van megfeleltetve, a szolgáltató ezt a fájlnévkiterjesztést használja.
• Ha a System.FileExtension Windows Shell tulajdonság nincs megfeleltetve, a szolgáltató a Type attribútumot használja, amely a csatolmányban vagy a tartalomelemben van megadva. Ennek az elemnek tartalmaznia kell egy sztringet MIMEType , például "image/jpeg". Ha az MIMEType ügyfélszámítógépen regisztrált fájlnévkiterjesztéshez van társítva, az elem ilyen típusú fájlnak minősül. Ha a MIMEType fájl nincs társítva az ügyfélszámítógépen regisztrált fájlnévkiterjesztéssel, a rendszer webhivatkozás-típusként kezeli az elemet. Az OpenSearch szolgáltató nem próbálja elemezni az URL-attribútumot a fájlnévkiterjesztés megkereséséhez.
• Ha az MIMEType ügyfélszámítógépen regisztrált fájlnévkiterjesztéshez van társítva, a szolgáltató határozza meg, hogy a fájlnévkiterjesztés ismert webes fájltípus-e (.htm, .html, .asp, .aspx, .php, .swf, .stm). Ha igen, akkor a fájltípus webes hivatkozástípusnak minősül; más esetben fájltípusnak minősül. Ha például a MIMEType "text/html" .htm fájlnévkiterjesztéshez van társítva, akkor az elem nem .htm fájltípusként, hanem webes hivatkozásnak minősül.

Az adattár engedélyezésének lehetséges akadályainak elkerülése

Egyes adattárak nem biztosítanak OpenSearch-kompatibilis webszolgáltatást, de továbbra is csatlakoztathatók a Windows összevont kereséshez. Az ilyen adattárak a következők:

• A Windows 7 összevont keresésben nem támogatott hitelesítési módszerekkel rendelkező távoli indexek.

  Ilyenek például az űrlapalapú hitelesítés és más egyéni hitelesítési módszerek.

• Ha egy nagy értékű nyilvános áruház nyilvános webes API-kkal rendelkezik, bárki írhat egy másik, OpenSearch-kompatibilis webszolgáltatást, és meghívhatja ezeket az API-kat a színfalak mögött.

  Ilyenek például a Kongresszusi Könyvtár és az orvosi kutatási adatbázisok.

• Védett vállalati adattárak vagy indexek, valamint örökölt tartalomkezelő tárolók, amelyek esetében lehetetlen lehet előtérbeli megoldást megvalósítani.

Vannak azonban olyan alternatívák, amelyek elkerülhetik az adattárak engedélyezésének akadályait. Az alábbi lehetőségek közül választhat:

Középszintű webszolgáltatás írása, ha nem tudja módosítani a meglévő adatforrás webszolgáltatását, vagy a webszolgáltatás egyéni API-t biztosít:

1. Írjon egy középemberes webszolgáltatást, amely elfogad egy Windows 7-lekérdezést.
2. Csatlakozzon az adatforráshoz, és kérje le a lekérdezés eredményeit.
3. Formázza át az eredményeket RSS vagy Atom formátumra.
4. Adja vissza az eredményeket a Windows 7-ügyfélnek.
5. Vegye figyelembe, hogy a vállalati adatszolgáltatások és számos internetes adatszolgáltatás esetében előfordulhat, hogy a felhasználói hitelesítő adatokat a webszolgáltatás nevében kell átadnia, hogy a felhasználó engedélyei alapján végezhesse el az eredménymegszűnést.

Meglévő keresőmotor használata, ha nem tud nyilvános adattárat engedélyezni:

1. Olyan nyilvános keresőmotort használjon, amely már támogatja az OpenSearch-et RSS-lel. Ezt úgy teheti meg, hogy egy .osdx-fájlt biztosít a felhasználóknak, amely egy URL-sablonnal rendelkezik, amely az eredményeket csak az adott tartományra korlátozza.

2. Tekintse meg az OpenSearch leírását az alábbi példában, amely csak a Windows súgótartalmait keresi egy live.com lekérdezés használatával.

   <?xml version="1.0" encoding="UTF-8"?>
   <OpenSearchDescription xmlns="https://a9.com/-/spec/opensearch/1.1/">
     <ShortName>Windows Help</ShortName>
     <Description>Search Windows Help using the live.com search engine</Description>
     <Language></Language>
     <Url type="text/html" template="https://windowshelp.microsoft.com/windows/search.aspx?=&amp;qu={searchTerms}"/>
     <Url type="application/rss+xml" template="https://api.search.live.com/rss.aspx?source=web&amp;query={searchTerms} site:windowshelp.microsoft.com&amp;web.count=50"/>
   </OpenSearchDescription>
   

Ha olyan meglévő indexelő kiszolgálót szeretne használni, amely támogatja az OpenSearch-t, ha nem tudja engedélyezni a védett vállalati adattárakat vagy indexeket:

1. Válasszon ki egy meglévő indexelő kiszolgálót, amely támogatja az OpenSearch-et a tartalom indexeléséhez, például a SharePoint Search Servert.
2. Hozzon létre egy .osdx-fájlt, amely a SharePoint-index eredményeit csak a kiszolgálóról származókra korlátozza az URL-sablonban található KeyWord szintaxissal.

Ügyféloldali adattár írása, ha egy kiszolgálóoldali megoldás nem működik:

1. Írjon egy ügyféloldali OpenSearch-adatforrást , amely a Windows OpenSearch szolgáltató és a külső adatforrás között helyezkedik el.
2. A Windows SDK IOpenSearchSource Interface API-jával hozzon létre egy megfelelően konfigurált .searchconnector-ms fájlt, amelyen keresztül a Windows Intéző meghívhatja a megvalósítást a lekérdezési paraméterekkel. Az implementáció ezután RSS vagy Atom formátumban formázott eredményeket adhat vissza. Ezzel lehetővé teszi, hogy az implementáció egyéni hitelesítési felhasználói felületet biztosítson, és a saját api-jával csatlakozzon az adatforráshoz.

További erőforrások

További információ a keresési federáció távoli adattárakban történő megvalósításáról OpenSearch-technológiákkal Windows 7 és újabb verziók esetén: lásd a "További információk" részt a Federációs keresés Windows-ben.

Kapcsolódó témakörök

Összevont keresés a Windowsban

Kezdő lépések az összevont kereséssel a Windowsban

A webszolgáltatás csatlakoztatása a Windows összevont keresésben

OpenSearch leírásfájl létrehozása a Windows Összevont keresési szolgáltatásban

A legjobb gyakorlatok követése a Windows azonosított keresés során

Keresési összekötők üzembe helyezése a Windows összevont keresési