Windows Search için özellik işleyicileri geliştirme

Microsoft Windows Search, öğelerden özelliklerin değerlerini ayıklamak için özellik işleyicilerini kullanır ve belirli bir özelliğin nasıl dizine alınması gerektiğini belirlemek için özellik sistem şemasını kullanır. Özellik değerlerini okumak ve dizine almak için, güvenlik ve sağlamlığı artırmak için özellik işleyicileri Windows Search tarafından işlem dışı çağrılır. Buna karşılık özellik işleyicileri, özellik değerlerini okumak ve yazmak için Windows Gezgini tarafından işlem içinde çağrılır.

Bu konu, Özellik Sistemi konusunu Windows Search'e özgü bilgilerle tamamlar ve aşağıdaki bölümleri içerir:

• özellik işleyicileri için tasarım kararlarını
  • Mülkiyet Kararları
  • Full-Text Destek
  • İşletim Sistemi Uygulama Konuları
• Özellik Açıklama Dosyaları Yazma
• Özellik İşleyicilerinin Uygulanması
  • IInitializeWithStream
  • IPropertyStore
  • IPropertyStoreCapabilities
• Öğelerinizin Dizinlendiğinden Emin Olma
• Özellik İşleyicilerini Yükleme ve Kaydetme
• Özellik İşleyicilerini Test Etme ve Sorun Giderme
  • Kurulum ve Ayar Testleri
  • Sorun Giderme Özellik İşlemcileri
• System-Supplied Özellik İşleyicileri Kullanarak
• İlgili konular

Özellik işleyicilerine yönelik tasarım kararları

Özellik işleyicilerinin uygulanması aşağıdaki adımları içerir:

1. Desteklemek istediğiniz özelliklerle ilgili tasarım kararları alma.
2. Özellik sisteminde henüz bulunmayan özellikler için Özellik Açıklaması (.propdesc) dosyası oluşturma.
3. Özellik yöneticisini uygulayıp test etme.
4. Özellik işleyicisi ve özellik açıklaması dosyalarını yükleme ve kaydetme.
5. Özellik işleyici yüklemesi ve kayıt işlemini test etme.

Başlamadan önce aşağıdaki tasarım sorularını göz önünde bulundurmanız gerekir:

• Dosya biçimi hangi özellikleri destekler/desteklemelidir?
• Bu özellikler zaten Sistem şemasında mı?
• Sistem tarafından sağlanan mevcut bir özellik işleyicisini kullanabilir miyim?
• Son kullanıcılara hangi özellikler görüntülenebilir?
• Kullanıcılar hangi özellikleri düzenleyebilir?
• Tam metin arama desteği bir özellik işleyicisinden mi yoksa filtreden mi gelmelidir?
• Eski uygulamaları desteklemem gerekiyor mu? Öyleyse ne uygularım?

Bu kararları aldıktan sonra, Windows Search altyapısının dosyalarınızı ve özelliklerinizi dizine eklemeye başlayabilmesi için özel özelliklerinizin resmi açıklamalarını yazabilirsiniz. Bu resmi açıklamalar, Özellik Açıklaması Şeması'nde açıklanan XML dosyalarıdır.

Mülk kararları

Hangi özelliklerin desteklenmesi gerektiğini düşünürken, kullanıcılarınızın dizin oluşturma ve arama gereksinimlerini belirlemeniz gerekir. Örneğin, dosya türünüz için yüzlerce yararlı olabilecek özellik tanımlayabilirsiniz, ancak kullanıcılar yalnızca birkaçı üzerinde arama yapmak isteyebilir. Ayrıca, bu özelliklerin farklı, daha büyük veya daha küçük bir grubunu Windows Gezgini'ndeki kullanıcılara görüntülemek ve kullanıcıların görüntülenen bu özelliklerin yalnızca bir alt kümesini düzenlemesine izin vermek isteyebilirsiniz.

Dosya türünüz, tanımladığınız tüm özel özellikleri ve sistem tanımlı özellikler kümesini destekleyebilir. Özel bir özellik oluşturmadan önce, lütfen Sistem Özellikleri gözden geçirerek desteklemek istediğiniz özelliğin zaten bir sistem özelliği tarafından tanımlandığını görün. Her zaman en önemli sistem tanımlı özellikleri desteklediğinden emin olun.

Özelliklerinizi tasarlamanıza yardımcı olması için matris kullanmanızı öneririz:

Bu özelliklerin her biri için, sahip olması gereken öznitelikleri belirlemeniz ve sonra bunları Özellik Açıklaması XML dosyalarında (.propdesc) resmi olarak açıklamanız gerekir. Öznitelikler özelliğin veri türünü, etiketini, yardım dizesini ve daha fazlasını içerir. Dizine alınabilen özellikler için, Özellik Açıklaması dosyasının searchInfo XML öğesinde bulunan aşağıdaki özellik özniteliklerine özellikle dikkat etmelisiniz.

Tam metin desteği

Genel olarak bakıldığında, tam metin araması filtreleri olarak adlandırılan bileşenler tarafından desteklenir; ancak, karmaşık olmayan dosya biçimlerine sahip metin tabanlı dosya türleri için özellik işleyicileri bu işlevselliği daha az geliştirme çabasıyla sağlayabilir. Dosya türünüz için en uygun olanı belirlemenize yardımcı olmak için filtre ve özellik işleyici işlevselliğinin karşılaştırması için Full-Text İçeriği bölümünü gözden geçirmelisiniz. Özellikle önemli olan, özellik işleyicilerinin işleyememesine rağmen filtrelerin dosya başına birden çok dil kodu tanımlayıcısını (LCID) işleyebildiğidir.

İşletim sistemi uygulama konusunda dikkat edilmesi gerekenler

Windows 7 için uygulama bilgileri

Windows 7 ve sonraki sürümlerde, bir özellik işleyicisi, IFilterveya yeni bir uzantıkaydederken yeni bir davranış ortaya çıkar. Yeni bir özellik işleyicisi ve/veya IFilter yüklendiğinde, ilgili uzantılara sahip dosyalar otomatik olarak yeniden dizine eklenir.

Windows 7'de, bir IFilter ilgili özellik işleyicileriyle birlikte yüklenmesi ve IFilter özellik işleyiciden önce kaydedilmesi önerilir. Özellik işleyicisinin kaydı, önce yeniden başlatma gerektirmeden önceden dizinlenmiş dosyaların hemen yeniden dizine alınmasını başlatır ve içerik dizini oluşturma amacıyla önceden kaydedilmiş IFilter'lardan yararlanır.

Yalnızca bir IFilter yüklüyse, ilgili özellik işleyicisi olmadan otomatik yeniden dizinleme, dizin oluşturma hizmetinin yeniden başlatılmasından veya sistemin yeniden başlatılmasından sonra gerçekleşir.

Windows 7'ye özgü özellik açıklaması bayrakları için aşağıdaki başvuru konularına bakın:

• GETPROPERTYSTOREFLAGS
• PROPDESC_SÜTUNİNDEKS_TİPİ
• PROPDESC_SEARCHINFO_FLAGS

Windows Vista ve önceki sürümler için uygulama bilgileri

Windows Vista'nın öncesinde, filtreler dosya içeriğini ve özelliklerini ayrıştırma ve numaralandırma desteği sağlamıştı. Özellik sisteminin kullanıma sunulmasıyla birlikte, özellik işleyicileri dosya özelliklerini işlerken filtreler dosya içeriğini işler. Windows Vista için, IFilterarabiriminin, Windows Search 'da Filtre İşleyicileri Oluşturmaya yönelik en iyiyöntemleri bölümünde açıklandığı gibi, bir özellik işleyicisi ile eşgüdümlü olarak yalnızca kısmi bir uygulama geliştirmeniz gerekir.

Özellik sistemi, Windows XP için Windows Search yüklemesine de dahil olsa da, üçüncü taraf ve eski uygulamalar filtrelerin hem içeriği hem de özellikleri işlemesini gerektirebilir. Bu nedenle, Windows XP platformunda geliştiriyorsanız, tam bir filtre uygulamasının yanı sıra dosya türünüz veya özel özelliğiniz için bir özellik işleyicisi sağlamanız gerekir.

Özellik Açıklama Dosyaları Yazma

Özellik açıklaması XML dosyalarının (.propdesc) yapısı, propertyDescription konusunda açıklanmıştır. Arama için özellikle ilgi çekici olan, searchInfo öğesinin öznitelikleridir. Hangi özelliklerin desteklendiğine karar verdikten sonra, her özellik için özellik açıklaması dosyaları oluşturmanız ve kaydetmeniz gerekir. .propdesc dosyalarınızı kaydettiğinizde, bunlar şemanın özellik açıklaması listesine eklenir ve Arama altyapısının özellik deposunda sütun adları olur.

Şema alt sisteminin IPropertySystem::RegisterPropertySchema'sını çağıran bir sarmalayıcı APIPSRegisterPropertySchema işlevini kullanarak özel özellik açıklamalarınızı kaydedebilirsiniz. Bu işlev, yerel makinedeki .propdesc dosyalarına (genellikle uygulamanın yükleme dizini olan "Program Files" altında) dosya yollarını kullanarak özellik açıklaması şeması (.propdesc) dosyalarının eklenmesini şema alt sistemine bildirir. Genellikle, bir kurulum veya uygulama (örneğin, özellik işleyici yükleyiciniz) .propdesc dosyalarını yükledikten sonra bu yöntemi çağırır.

Özellik işleyicilerini uygulama

Özellik işleyicisi geliştirmek için aşağıdaki arabirimlerin uygulanması gerekir:

• IInitialzeWithStream: Özellik işleyicinizi akış tabanlı olarak başlatmanızı sağlar.
• IPropertyStore: Özellik değerlerini numaralandırır, alır ve ayarlar.
• IPropertyStoreCapabilities: İsteğe bağlı. Kullanıcıların bir kullanıcı arabiriminden bir özelliği düzenleyip düzenleyemeyeceğini tanımlar.

IInitializeWithStream

Özellik Sistemi konusunda açıklandığı gibi, akış tabanlı başlatma yapmak için IInitializeWithStream ile özellik işleyicilerinin uygulanmasını kesinlikle öneririz. IInitializeWithStream uygulamamayı seçtiyseniz özellik işleyicisi, özellik işleyicisinin kayıt defteri anahtarında DisableProcessIsolation bayrağını ayarlayarak yalıtım işleminde çalıştırmayı durdurmalıdır. İşlem yalıtımının devre dışı bırakılması genellikle yalnızca eski özellik işleyicilerine yöneliktir ve yeni kodlar tarafından uzun süre kaçınılmalıdır.

IPropertyStore

Özellik işleyicisi oluşturmak için aşağıdaki yöntemlerle IPropertyStore arabirimini uygulamanız gerekir.

Bu arabirimi uygulamak için dikkat edilmesi gereken önemli noktalar IPropertyStore belgelerine eklenmiştir.

IPropertyStoreCapabilities

Özellik işleyicileri isteğe bağlı olarak bu arabirimi uygulayarak kullanıcının belirli özellikleri düzenleme becerisini devre dışı bırakabilir. Bu özellikler normalde Ayrıntılar sayfasında ve bölmesinde düzenlenebilir, ancak bunları düzenlemeye uygulama özellik işleyicisi altında izin verilmez. Bu arabirimin doğru bir şekilde uygulanması, kabuktan basit bir çalışma zamanı hatası almaya kıyasla daha iyi bir kullanıcı deneyimi sağlar.

Öğelerinizin dizine alınmasını sağlama

Özellik işleyicinizi uyguladığınıza göre, işleyicinizin sorumlu olduğu öğelerin dizine alınmasını sağlamak istiyorsunuz. Yeniden dizin oluşturmayı başlatmak için Katalog Yöneticisi kullanabilir ve dizin oluşturucunun gezinmesini istediğiniz URL'leri belirten varsayılan kuralları ayarlamak için Gezinme Kapsamı Yöneticisi de kullanabilirsiniz. Bir diğer seçenek de Windows Arama Kodu ÖrnekleriReIndex kod örneğini izlemektir.

Daha fazla bilgi için Katalog Yöneticisi'ni kullanma ve Gezinme Kapsamı Yöneticisi'ni kullanmabölümüne bakın.

Özellik işleyicilerini yükleme ve kaydetme

Özellik işleyicisi uygulandıktan sonra kaydedilmeli ve dosya adı uzantısı işleyici ile ilişkilendirilmelidir. Aşağıdaki örnekte, bunu yapmak için gereken kayıt defteri anahtarları ve değerleri gösterilmektedir.

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>}

Özellik işleyicilerini test etme ve sorun giderme

Aşağıdaki liste, gerçekleştirmeniz gereken test türleri hakkında öneriler sağlar:

• Dosya türü tarafından desteklenen her bir özellikten çıkış almayı test edin.
• Büyük özellik değerlerini kullanın, örneğin, HTML belgelerinde büyük bir meta etiket kullanın.
• Özellik işleyicisinin dosya tanıtıcılarını sızdırmadığını doğrulamak için, özellik işleyicisinden çıktı aldıktan sonra düzenleyin veya dosya özelliklerini listelemeye başlamadan önce ve sonra oh.exe gibi bir araç kullanın.
• Özellik işleyicisiyle ilişkili tüm dosya türlerini test edin. Örneğin, HTML filtresinin .htm ve .html dosya türleriyle çalışıp çalışmadığını denetleyin.
• Bozuk dosyalarla test edin. Özellik işleyici başarısızlık durumunda sorunsuz bir şekilde çalışmalıdır.
• Bir uygulama şifrelemeyi destekliyorsa, özellik işleyicisinin şifrelenmiş metin çıktısı vermediğini test edin.
• Özellik işleyiciniz tam metin aramayı destekliyorsa:
  • Dosya içeriğinde birden çok özel Unicode karakteri kullanın ve çıktılarını test edin.
  • Özellik işleyicisinin beklendiği gibi çalıştığını doğrulamak için çok büyük belgelerin işlenmesini test edin.

Yükleme ve kurulum testleri

Son olarak, yükleme ve kaldırma yordamlarınızı test etmeniz gerekir.

• Yüklemenin başarısız yüklemelerden kurtarılması gerekir (örneğin, kurulumu iptal edip yeniden başlatma).
• Kaldırma işleminin, özellik işleyicisiyle ilişkili tüm dosyaları silmesi gerekir.
• Kaldırma, özellik işleyicisi yüklemesiyle ilişkilendirilmiş dosyalar dışındaki dosyaları silmemelidir.
• Özellik işleyicisi ile ilişkili kayıt defteri anahtarları, program kaldırıldığında silinmelidir.
• Yükleme dizininden dosyalar silinse bile kaldırma işleminin çalışması gerekir.

Özellik işleyicileriyle ilgili sorunları giderme

Özellik işleyicileri geliştirilirken yapılan bazı yaygın hatalar şunlardır:

• .propdesc dosyalarını veya DLL'lerini bir kullanıcı dizini altına yükleme.
• Göreli yolları kullanarak bileşenleri kaydetme.
• Bileşenleri HKEY_LOCAL_MACHINE yerine HKEY_CURRENT_USER altına kaydetme.
• Akış dışı işleyiciler için DisableProcessIsolation ayarlamayı unutma.
• Test dosyasını dizinlenmemiş bir konuma yerleştirme.

Özellik işleyicinizi dizin oluşturucuyla çalışmasını sağlamakta sorun yaşıyorsanız, sorun gidermenize yardımcı olacak bazı ipuçları şunlardır:

• Özellik açıklamalarınızın (.propdesc dosyaları) isColumn="true", isViewable="true", ve isQueryable="true" olarak uygun şekilde işaretlendiğini doğrulayın.
• .propdesc dosyalarınızın genel bir konumda olduğunu doğrulayın.
• .propdesc dosyalarınızı mutlak yolları kullanarak kaydettiğinizi doğrulayın.
• Olay günlüğünün .propdesc dosyanızı kaydederken herhangi bir hata kaydetmediğini doğrulayın.
• DLL'lerinizin genel bir konumda (kullanıcı profilinizin altında değil) olduğunu doğrulayın.
• DLL'lerinizin HKEY_LOCAL_MACHINE\Software\Classesaltında kaydedildiğini doğrulayın.
• DLL'lerinizin, Sistem hesabı tarafından bilinen ortam değişkenlerini kullanarak mutlak yollara genişleyen tam yollar veya REG_EXPAND_SZ dizeleri kullanılarak kayıtlı olduğundan emin olun.
• Özellik işleyicinizin Windows Gezgini altında çalıştığını doğrulayın.
• IInitializeWithStream kullanmanızı öneririz ancak IInitializeWithFile veya IInitializeWithItem kullanmanız gerekiyorsa DisableProcessIsolation belirttiğinizden emin olun.
• Dizin Oluşturma Seçenekleri Denetim Masası'nda dosya türünüzün dizinlenmiş dosya türü olarak listelendiğini doğrulayın.
• Test dosyasının dizinlenmiş bir konumda olduğunu doğrulayın.
• Özellik işleyicinizi yükledikten sonra test dosyasının değiştirildiğini doğrulayın.

Test dosyanız dizinlenmiş bir konumdaysa ve dizin oluşturucu bu konumda zaten gezindiyse, dosyanın yeniden dizine alınmasını tetikleyebilmek için dosyayı bir şekilde değiştirmeniz gerekir.

Sistem tarafından sağlanan özellik işleyicilerini kullanma

Windows, dosya türünüzün biçimi uyumluysa kullanabileceğiniz bir dizi sistem tarafından sağlanan özellik işleyicisi içerir. Bu biçimlerden birini kullanan yeni bir dosya uzantısı tanımlarsanız, dosya uzantınız için işleyici sınıfı tanımlayıcısını (CLSID) kaydederek sistem tarafından sağlanan işleyicileri kullanabilirsiniz.

Dosya biçimi türünüz için sistem tarafından sağlanan özellik işleyicilerini kaydetmek için aşağıdaki tabloda listelenen CLSID'yi kullanabilirsiniz.

Özel özellik oluşturmadan önce, bunun yerine kullanabileceğiniz sistem tanımlı bir özellik olmadığından emin olmalısınız. PSEnumeratePropertyDescriptions çağırarak veya prop.exe komut satırı aracını kullanarak sistem tanımlı özellikleri numaralandırabilirsiniz.

Sistem şeması bu özelliklerin dizin oluşturucuyla nasıl etkileşim kurduğunu tanımlar ve bunu değiştiremezsiniz. Ayrıca, dosya türünüzü oluşturmak, düzenlemek ve kaydetmek için kullandığınız uygulamanın da belirli davranışlara uyması gerekir. Örneğin, uygulama güvenli kaydetme uygularsa (burada düzenleme sırasında geçici bir dosya oluşturulur ve ardından eski sürümle yeni sürümü değiştirmek için ReplaceFile() kullanılırsa), özgün dosyadaki tüm özellikleri yeni dosyaya aktarması gerekir. Bunun yapılmaması, dosyanın kullanıcılar veya diğer uygulamalar tarafından eklenen özellikleri kaybettiği anlamına gelir.

Örnek

Aşağıda, .OLEDocFile uzantısına sahip bir dosya türü için sistem tarafından sağlanan OLE DocFile işleyicisinin kaydı gösterilmektedir.

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

Aşağıda, özellik listesi bilgilerinin kaydı gösterilmektedir, böylece .OLEDocFile dosyalarının özellikleri Ayrıntılar sekmesinde ve bölmesinde görüntülenir.

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

İlgili konular

Başvuru

Özellik Haritalamaları

kavramsal

Windows Search 'da Filtre İşleyicileri Oluşturmak için En İyi Yöntemler

Dizin Oluşturma İşlemi

Protokol İşleyicileri Geliştirme

Özel Dosya Biçimleri içinSystem-Defined Özellikleri

Diğer Kaynaklar

Özellik Sistemi

Sistem Özellikleri

Windows Arama Kodu Örnekleri