Nové sdružené vyhledávání informací v systému nápovědy používá pojmy typy vyhledávačů a vyhledávač. Typ vyhledávače je metavyhledávač, ze kterého lze parametrizací vytvářet řadu konkrétních vyhledávačů.
Nové typy vyhledávačů se vkládají prostřednictvím org.eclipse.help.ui.searchEngine:
Tento bod rozšíření se používá k zapojování účastníků hledání do vyhledávání informací. Jednotlivé vyhledávače lze vzájemně nezávisle konfigurovat. Po zahájení vyhledávání se jednotlivé vyhledávače provádějí na pozadí a výsledky jsou průběžně shromažďovány v pohledu Nápověda.<extension point="org.eclipse.help.ui.searchEngine"> <engineType scopeFactory="com.example.xyz.XYZScopeFactory" label="XYZ Search" class="com.example.xyz.search.XYZSearch" icon="icons/etool16/xyzsearch.gif" pageClass="com.example.xyz.search.XYZSearchPage" id="com.example.xyz.XYZSearch"> <description> Instance hledání XYZ Search na webu XYZ. </description> </engineType>
Zde definované vyhledávače se nezapojují do sdruženého vyhledávání jako účastníci automaticky, dokud není zřízena vazba produktu a vyhledávače, pokud atribut
productId
není definován. Z vyhledávačů, které tento atribut definují, se při spuštění určitého produktu zobrazí pouze ty, které jsou vázány k tomuto produktu.
Vyhledávače mohou sestavit adresu URL a poskytnout jediný odkaz obsahující tuto adresu URL v href
. Tímto způsobem lze zapojit oblíbené vyhledávače, jejichž rozhraní API vyžaduje licenci. Na opačném konci linky mohou vyhledávače komunikovat se serverem a přijímat jednotlivé odkazy doplněné o informace o štítku, hypertextového odkazu, stručného popisu, hodnocení atd. Generátor lokální nápovědy může vytvářet odkazy tímto způsobem.
Nezávisle na mechanizmu vyhledávání vyhledávače mohou poskytovat různá nastavení rozsahu vyhledávání s použitím stránek předvoleb JFace. Tyto stránky se zobrazí po použití odkazu 'Rozšířené nastavení' v pohledu Nápověda. Kromě kořenových stránek předvoleb definovaných vyhledávačem lze zapojovat přídavné podřízené stránky předvoleb za účelem zpřístupnění dalších rozšířených nastavení.
Nastavení rozsahu se načítají a ukládají s použitím objektů IPreferenceStore
. Nastavení rozsahu pro všechny vyhledávače se seskupují pod názvem
sada rozsahů. Při prvním otevření dojde k vytvoření výchozí sady rozsahů ('Default'), uživatelé však mohou definovat další sady rozsahů a přepínat je.
Protože podpora sdruženého vyhledávání je součástí modulu plug-in org.eclipse.help.base
, je k vytvoření objektů rozsahu hledání z dat v úložišti předvoleb zapotřebí továrna. Klienti zapojovaní do stránek předvoleb rozsahu se musejí zapojovat rovněž do továren rozsahů.
Vyhledávače definované v tomto bodu rozšíření se při výchozím nastavení v uživatelském rozhraní nezobrazují. Zobrazuje se zde konkrétní instance vyhledávače, kterou lze samostatně upravovat. Produkty mohou předběžně konfigurovat systém nápovědy řadou instancí registrovaných typů vyhledávačů volitelně parametrizovaných za účelem dosažení požadované funkce. Dále uživatelé mohou přidávat své vlastní instance registrovaných vyhledávačů a konfigurovat je podle vlastního uvážení:
<engine enabled="true" engineTypeId="com.example.xyz.search.XYZSearch" id="com.example.xyz.XYZSearch" label="XYZ Search"> </engine> <engine enabled="true" engineTypeId="org.eclipse.help.ui.web" id="org.eclipse.sdk.Eclipse" label="%search.Eclipse.label"> <description> %search.Eclipse.desc </description> <param name="url" value="http://eclipse.org/search/search.cgi?q={expression}&ul=&ps=20&m=all"> </param> </engine>