A Windows Search tulajdonságkezelőinek fejlesztése

A Microsoft Windows Search tulajdonságkezelőkkel kinyeri a tulajdonságok értékeit az elemekből, és a tulajdonságrendszersémával határozza meg, hogyan kell indexelni egy adott tulajdonságot. A tulajdonságértékek olvasásához és indexeléséhez a Windows Search folyamaton kívüli tulajdonságkezelőket hív meg a biztonság és a robusztusság javítása érdekében. Ezzel szemben a tulajdonságkezelőket a Windows Intéző folyamat közben hívja meg a tulajdonságértékek olvasásához és írásához.

Ez a témakör kiegészíti a Tulajdonságrendszer témakört a Windows Search szolgáltatásra vonatkozó információkkal, és a következő szakaszokat tartalmazza:

• tervezési döntések a tulajdonságkezelők
  • Ingatlantulajdon-döntések
  • Full-Text támogatás
  • operációs rendszer implementálásának szempontjai
• tulajdonságleírás-fájlok írása
• Tulajdonságkezelők implementálása
  • IInitializeWithStream
  • IPropertyStore
  • IPropertyStoreCapabilities
• Annak biztosítása, hogy az elemek indexelve legyenek
• Tulajdonságkezelők telepítése és regisztrálása
• tulajdonságkezelők tesztelése és hibaelhárítása
  • telepítési és beállítási tesztek
  • Tulajdonságkezelők hibaelhárítása
• System-Supplied tulajdonságkezelők használata
• Kapcsolódó témakörök

Tervezési döntések a tulajdonságkezelők számára

A tulajdonságkezelők implementálása a következő lépéseket foglalja magában:

1. Tervezési döntések meghozatala a támogatni kívánt tulajdonságokról.
2. Tulajdonságleírási (.propdesc) fájl létrehozása a tulajdonságrendszerben még nem szereplő tulajdonságokhoz.
3. A tulajdonságkezelő implementálása és tesztelése.
4. A tulajdonságkezelő és a tulajdonságleírás-fájlok telepítése és regisztrálása.
5. A tulajdonságkezelő telepítésének és regisztrációjának tesztelése.

Mielőtt hozzákezdene, fontolja meg a következő tervezési kérdéseket:

• Milyen tulajdonságokat támogat/támogat a fájlformátum?
• Ezek a tulajdonságok már szerepelnek a rendszersémában?
• Használhatok meglévő rendszer által biztosított tulajdonságkezelőt?
• Mely tulajdonságok jeleníthetők meg a végfelhasználók számára?
• Mely tulajdonságokat szerkeszthetik a felhasználók?
• A teljes szöveges keresés támogatása tulajdonságkezelőből vagy szűrőből származik?
• Támogatni kell az örökölt alkalmazásokat? Ha igen, mit valósíthatok meg?

Miután meghozta ezeket a döntéseket, megírhatja az egyéni tulajdonságok hivatalos leírását, hogy a Windows keresőmotor elkezdhesse indexelni a fájlokat és tulajdonságokat. Ezek a formális leírások XML-fájlok, amelyeket a Tulajdonságleírás Sémaír le.

Vagyonnal kapcsolatos döntések

Ha figyelembe veszi, hogy mely tulajdonságokat támogatja, meg kell határoznia a felhasználók indexelési és keresési igényeit. Előfordulhat például, hogy száz potenciálisan hasznos tulajdonságot tud azonosítani a fájltípushoz, de a felhasználók csak néhányat szeretnének keresni. Emellett előfordulhat, hogy a tulajdonságok egy másik, nagyobb vagy kisebb csoportját szeretné megjeleníteni a Windows Intéző felhasználói számára, és lehetővé teszi a felhasználók számára, hogy csak a megjelenített tulajdonságok egy részét szerkesszen.

A fájltípus támogatja az Ön által definiált egyéni tulajdonságokat, valamint a rendszer által definiált tulajdonságok készletét. Egyéni tulajdonság létrehozása előtt tekintse át Rendszertulajdonságok, hogy a támogatni kívánt tulajdonságot már definiálta-e egy rendszertulajdonság. Mindig győződjön meg arról, hogy támogatja a rendszer által definiált legfontosabb tulajdonságokat.

Javasoljuk, hogy a tulajdonságok tervezéséhez használjon mátrixot:

Ezen tulajdonságok mindegyikéhez meg kell határoznia, hogy milyen attribútumokkal kell rendelkeznie, majd formálisan le kell írnia őket a Tulajdonság leírása XML-fájlokban (.propdesc). Az attribútumok közé tartozik a tulajdonság adattípusa, címkéje, súgósztringje stb. Az indexelhető tulajdonságok esetében különös figyelmet kell fordítania a tulajdonságleírásfájl searchInfo XML-elemében található alábbi tulajdonságattribútumokra.

Teljes szöveges támogatás

Általánosságban elmondható, hogy a teljes szöveges keresést szűrőknek nevezett összetevők támogatják; A nem komplikált fájlformátumú szövegalapú fájltípusok esetében azonban a tulajdonságkezelők kevesebb fejlesztési erőfeszítést igényelhetnek. A szűrő- és tulajdonságkezelő funkciók összehasonlításához tekintse át a Full-Text Tartalom szakaszt, hogy eldönthesse, mi a legjobb a fájltípushoz. Különösen fontos az a tény, hogy a szűrők fájlonként több nyelvi kódazonosítót (LCID-t) képesek kezelni, míg a tulajdonságkezelők nem.

Az operációs rendszer implementálási szempontjai

A Windows 7 implementálási információi

A Windows 7-ben és újabb verziókban új viselkedés tapasztalható egy tulajdonságkezelő, IFiltervagy új bővítmény regisztrálásakor. Új tulajdonságkezelő és/vagy IFilter telepítésekor a rendszer automatikusan újraindexeli a megfelelő kiterjesztésű fájlokat.

Windows 7 rendszerben ajánlott az IFilter-t a megfelelő tulajdonságkezelőkkel együtt telepíteni, és hogy az IFilter a tulajdonságkezelő előtt legyen regisztrálva. A tulajdonságkezelő regisztrálása a korábban indexelt fájlok azonnali újraindexelését kezdeményezi anélkül, hogy újraindítást kellene igényelnie, és a tartalomindexelés céljából kihasználja a korábban regisztrált IFilter(ek) előnyeit.

Ha csak egy IFilter van telepítve, megfelelő tulajdonságkezelő nélkül, akkor az automatikus újraindexelés vagy az indexelési szolgáltatás újraindítása vagy a rendszer újraindítása után történik.

A Windows 7-hez kapcsolódó tulajdonságleírás-jelzőkért tekintse meg a következő referenciatémaköröket:

• GETPROPERTYSTOREFLAGS
• PROPDESC_COLUMNINDEX_TYPE
• PROPDESC_SEARCHINFO_FLAGS

A Windows Vista és korábbi verziók implementálási információi

A Windows Vista előtt a szűrők támogatták a fájltartalmak és tulajdonságok elemzését és számbavételét. A tulajdonságrendszer bevezetésével a tulajdonságkezelők kezelik a fájltulajdonságokat, míg a szűrők kezelik a fájltartalmakat. Windows Vista esetén a IFilterfelületének csak részleges implementációját kell kidolgoznia egy tulajdonságkezelővel együttműködve, a Windows-keresés szűrőkezelők létrehozására vonatkozó legjobb gyakorlatokszerint.

Bár a tulajdonságrendszert a Windows XP Windows Search-telepítése is tartalmazza, előfordulhat, hogy a külső és az örökölt alkalmazások megkövetelik, hogy a szűrők mind a tartalmat, mind a tulajdonságokat kezeljék. Ezért ha a Windows XP platformon fejleszt, teljes szűrő implementációt, valamint tulajdonságkezelőt kell biztosítania a fájltípushoz vagy az egyéni tulajdonsághoz.

Tulajdonságleírás-fájlok írása

A tulajdonságleírás XML-fájljainak (.propdesc) szerkezetét a propertyDescription témakör ismerteti. A keresésnél különösen érdekesek a keresési információ elem attribútumai. Miután eldöntötte, hogy mely tulajdonságokat támogatja, minden tulajdonsághoz létre kell hoznia és regisztrálnia kell a tulajdonságleírási fájlokat. Amikor regisztrálja a .propdesc fájlokat, azok bekerülnek a séma tulajdonságleírási listájába, és oszlopnevekké válnak a keresőmotor tulajdonságtárolójában.

Az egyéni tulajdonságleírásokat a PSRegisterPropertySchema függvény használatával regisztrálhatja, amely egy burkoló API, amely meghívja a sémaalrendszer IPropertySystem::RegisterPropertySchema függvényét. Ez a függvény tájékoztatja a sémaalrendszert a tulajdonságleírási sémafájlok (.propdesc) hozzáadásáról, a helyi gépen található .propdesc fájl(ok) fájlelérési útvonal(ok) használatával, általában az alkalmazás "Programfájlok" területén található telepítési könyvtárával. Egy beállítás vagy alkalmazás (például a tulajdonságkezelő telepítője) általában ezt a metódust hívja meg a .propdesc fájl(ok) telepítése után.

Tulajdonságkezelők implementálása

A tulajdonságkezelő fejlesztése a következő felületek implementálásával jár:

• IInitialzeWithStream: A tulajdonságkezelő streamalapú inicializálását biztosítja.
• IPropertyStore: Számba veszi, lekéri és beállítja a tulajdonságértékeket.
• IPropertyStoreCapabilities: Nem kötelező. Meghatározza, hogy a felhasználók szerkeszthetik-e a tulajdonságot egy felhasználói felületen.

IInitializeWithStream

A Tulajdonságrendszer témakörben leírtaknak megfelelően javasoljuk, hogy a streamalapú inicializáláshoz implementálja a IInitializeWithStream tulajdonságkezelőit. Ha úgy döntött, hogy nem implementálja az IInitializeWithStream szolgáltatást, a tulajdonságkezelőnek le kell tiltania a futtatást az elkülönítési folyamat során a DisableProcessIsolation jelölő beállításával a tulajdonságkezelő beállításkulcsán. A folyamatelkülönítés letiltása általában csak örökségi tulajdonságkezelőkre vonatkozik, és az új kódokban szigorúan kerülendő.

IPropertyStore

Tulajdonságkezelő létrehozásához implementálnia kell az IPropertyStore felületet az alábbi módszerekkel.

A felület implementálásának fontos szempontjait az IPropertyStore dokumentációja tartalmazza.

IPropertyStoreCapabilities

A tulajdonságkezelők igény szerint implementálhatják ezt az felületet, hogy letiltsák a felhasználó adott tulajdonságok szerkesztési képességét. Ezek a tulajdonságok általában szerkeszthetők a Részletek lapon és panelen, de szerkesztésük nem engedélyezett a implementálási tulajdonságkezelőben. Ennek a felületnek a helyes implementálása jobb felhasználói élményt nyújt, mint az alternatív megoldás – ez a Shell egyszerű futásidejű hibája.

Az elemek indexeltségének biztosítása

Most, hogy implementálta a tulajdonságkezelőt, meg kell győződnie arról, hogy a kezelő által regisztrált elemek indexelhetők. A Catalog Manager használatával kezdeményezheti az újraindexelést, és a bejárási hatókör-kezelő is beállíthatja az indexelő által bejárni kívánt URL-címeket jelző alapértelmezett szabályokat. Egy másik lehetőség a ReIndex-kódminta követése a Windows keresési kódminták.

További információért tekintse meg: A Catalog Manager és A bejárási hatókörkezelőhasználata.

Tulajdonságkezelők telepítése és regisztrálása

Miután a tulajdonságkezelő implementálásra került, regisztrálni kell, és hozzá kell társítani a fájlnévkiterjesztést. Az alábbi példa az ehhez szükséges beállításkulcsokat és értékeket mutatja be.

HKEY_CLASSES_ROOT
   CLSID
      {<CLSID for property handler>}
         (Default) = <Property Handler Name>
         InProcServer32
            (Default) = <full path to property handler dll>
            ThreadingModel = <your threading model>

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               PropertySystem
                  PropertyHandlers
                     <.fileextention>
                        (Default) = {<CLSID for property handler>}

Tulajdonságkezelők tesztelése és hibaelhárítása

Az alábbi lista tanácsokat ad a végrehajtandó tesztek típusával kapcsolatban:

• Tesztelje a fájltípus által támogatott összes tulajdonság kimenetének lekérését.
• Használjon nagy tulajdonságértékeket, például használjon nagy metacímkét HTML-dokumentumokban.
• Ellenőrizze, hogy a tulajdonságkezelő nem okoz-e fájlfogópont szivárgást azáltal, hogy szerkeszti azt a tulajdonságkezelő kimenetének megszerzése után, vagy egy olyan eszköz, mint a oh.exe használatával a fájltulajdonságok felsorolása előtt és után.
• Tesztelje a tulajdonságkezelőhöz társított összes fájltípust. Ellenőrizze például, hogy a HTML-szűrő működik-e .htm és .html fájltípusokkal.
• Tesztelje sérült fájlokkal. A tulajdonságkezelőnek zökkenőmentesen kell kezelnie a hibákat.
• Ha egy alkalmazás támogatja a titkosítást, ellenőrizze, hogy a tulajdonságkezelő nem ad-e ki titkosított szöveget.
• Ha a tulajdonságkezelő támogatja a teljes szöveges keresést:
  • Használjon több speciális Unicode-karaktert a fájl tartalmában, és tesztelje a kimenetüket.
  • Tesztelje a nagy méretű dokumentumok kezelését, hogy a tulajdonságkezelő a várt módon működik.

Telepítési és beállítási tesztek

Végül tesztelnie kell a telepítési és eltávolítási rutinokat.

• A telepítésnek helyre kell állnia a sikertelen telepítésekből (például a telepítés megszakításából, majd újraindításából).
• Az eltávolításnak törölnie kell a tulajdonságkezelőhöz társított összes fájlt.
• Az eltávolítás nem törölheti a tulajdonságkezelő telepítéséhez társított fájlokon kívül más fájlokat.
• A tulajdonságkezelőhöz társított beállításkulcsokat el kell távolítani az eltávolításkor.
• Az eltávolításnak akkor is működnie kell, ha a fájlok törlődnek a telepítési könyvtárból.

Tulajdonságkezelők hibaelhárítása

Az alábbiakban néhány gyakori hiba történt a tulajdonságkezelők fejlesztése során:

• .propdesc-fájlok vagy DLL-ek telepítése egy felhasználói címtárban.
• Összetevők regisztrálása relatív elérési utak használatával.
• Összetevők regisztrálása HKEY_LOCAL_MACHINE helyett HKEY_CURRENT_USER alatt.
• Elfelejtette beállítani a DisableProcessIsolation beállítást a nem streamkezelők számára.
• A tesztfájl nem indexelt helyre helyezése.

Ha problémákat tapasztal a tulajdonságkezelő indexelővel való használatakor, az alábbi tippek segítenek a hibaelhárításban:

• Ellenőrizze, hogy a tulajdonságleírások (.propdesc fájlok) megfelelően meg vannak-e jelölve azzal, hogy isColumn="igaz", isViewable="igaz", és isQueryable="igaz".
• Ellenőrizze, hogy a .propdesc-fájlok globális helyen vannak-e.
• Ellenőrizze, hogy abszolút elérési utak használatával regisztrálta-e a .propdesc-fájlokat.
• Ellenőrizze, hogy az eseménynapló nem rögzítette-e a .propdesc fájl regisztrálásának hibáit.
• Ellenőrizze, hogy a DLL-ek globális helyen találhatók-e (és nem a felhasználói profilja alatt).
• Ellenőrizze, hogy a DLL-ek regisztrálva vannak-e a HKEY_LOCAL_MACHINE\Software\Classesalatt.
• Ellenőrizze, hogy a DLL-ek teljes elérési utakkal vannak-e regisztrálva (vagy olyan REG_EXPAND_SZ sztringekkel, amelyek a rendszerfiók által ismert környezeti változókat használva abszolút elérési utakra bővülnek ki).
• Ellenőrizze, hogy a tulajdonságkezelő működik-e a Windows Intézőben.
• Bár az IInitializeWithStream használatát javasoljuk, ha az IInitializeWithFile vagy az IInitializeWithItem fájlt kell használnia, ellenőrizze, hogy megadja-e a DisableProcessIsolation parancsot.
• Ellenőrizze, hogy az Indexelési beállítások vezérlőpultja indexelt fájltípusként sorolja-e fel a fájltípust.
• Ellenőrizze, hogy a tesztfájl indexelt helyen van-e.
• Ellenőrizze, hogy a tesztfájl módosult-e a tulajdonságkezelő telepítése óta.

Ha a tesztfájl indexelt helyen van, és az indexelő már bejárta ezt a helyet, módosítania kell a fájlt valamilyen módon a fájl újraindexelésének aktiválásához.

Rendszer által biztosított tulajdonságkezelők használata

A Windows számos rendszer által biztosított tulajdonságkezelőt tartalmaz, amelyeket akkor használhat, ha a fájltípus formátuma kompatibilis. Ha ezen formátumok egyikét használó új fájlkiterjesztést határoz meg, a rendszer által biztosított kezelőket a fájlkiterjesztés kezelőosztály-azonosítójának (CLSID) regisztrálásával használhatja.

A következő táblázatban felsorolt CLSID használatával regisztrálhatja a rendszer által biztosított tulajdonságkezelőket a fájlformátum típusához.

Egyéni tulajdonság létrehozása előtt győződjön meg arról, hogy nincs rendszer által definiált tulajdonság, amelyet használhat helyette. A rendszer által definiált tulajdonságok számbavételéhez meghívhatja PSEnumeratePropertyDescriptions vagy a prop.exe parancssori eszközét.

A rendszerséma határozza meg, hogyan működnek ezek a tulajdonságok az indexelővel, és ezt nem módosíthatja. Emellett a fájltípus létrehozásához, szerkesztéséhez és mentéséhez használt alkalmazásnak is meg kell felelnie bizonyos viselkedésnek. Ha például az alkalmazás biztonságos mentést valósít meg (amelynek során egy ideiglenes fájl jön létre a szerkesztés során, majd a ReplaceFile() az új verzió felcserélésére a régire), az összes tulajdonságot át kell helyeznie az eredeti fájlból az új fájlba. A sikertelenség azt jelenti, hogy a fájl elveszíti a felhasználók vagy más alkalmazások által hozzáadott tulajdonságokat.

példa

Az alábbiakban a rendszer által szállított OLE DocFile-kezelő regisztrációját mutatjuk be egy fájltípushoz, amelynek kiterjesztése .OLEDocFile.

HKEY_CLASSES_ROOT
   SystemFileAssociations
      .OLEDocFile
         shellex
            {BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}
               (Default) = {9DBD2C50-62AD-11d0-B806-00C04FD706EC}

Az alábbiakban a tulajdonságlista információinak regisztrálását láthatjuk, hogy az OLEDocFile fájlok tulajdonságai a Részletek lapon és a panelen megjelenjenek.

HKEY_CLASSES_ROOT
   SystemFileAssociations
      .OLEDocFile
         ExtendedTileInfo = prop:System.ItemType;System.Size;System.DateModified;System.Author;System.OfflineAvailability
         FullDetails = prop:System.PropGroup.Description;System.Title;System.Subject;
System.Keywords;System.Category;System.Comment;System.PropGroup.Origin;
System.Author;System.Document.LastAuthor;System.Document.RevisionNumber;
System.Document.Version;System.ApplicationName;System.Company;System.Document.Manager;
System.Document.DateCreated;System.Document.DateSaved;System.Document.DatePrinted;
System.Document.TotalEditingTime;System.PropGroup.Content;System.ContentStatus;
System.ContentType;System.Document.PageCount;System.Document.WordCount;
System.Document.CharacterCount;System.Document.LineCount;
System.Document.ParagraphCount;System.Document.Template;System.Document.Scale;
System.Document.LinksDirty;System.Language;System.PropGroup.FileSystem;
System.ItemNameDisplay;System.ItemType;System.ItemFolderPathDisplay;
System.DateCreated;System.DateModified;System.Size;System.FileAttributes;
System.OfflineAvailability;System.OfflineStatus;System.SharedWith;
System.FileOwner;System.ComputerName
         InfoTip = prop:System.ItemType;System.Size;System.DateModified;System.Document.PageCoun
         PerceivedType = document
         PreviewDetails = prop:*System.DateModified;System.Author;System.Keywords;
*System.Size;System.Title;System.Comment;System.Category;
*System.Document.PageCount;System.ContentStatus;System.ContentType;
*System.OfflineAvailability;*System.OfflineStatus;System.Subject;
*System.DateCreated;*System.SharedWith

Kapcsolódó témakörök

referencia

tulajdonságleképezések

fogalmi

Ajánlott eljárások szűrőkezelők windowsos keresési

Indexelési folyamat

Protokollkezelők fejlesztése

System-Defined egyéni fájlformátumok tulajdonságai

Egyéb erőforrások

tulajdonságrendszer

rendszertulajdonságok

Windows keresési kódminták