<docbook><section><title>VirtSetFCTRegistryForOpenSearch</title><para> </para>
<title> Setting OpenSearch ShortName to ease deployment of Virtuoso Faceted Browser (FCT) as search engine</title> Setting OpenSearch ShortName to ease deployment of Virtuoso Faceted Browser (FCT) as search engine
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> What</bridgehead>
<para>Virtuoso&#39;s Faceted Browser can be used as a search engine by any <ulink url="http://www.opensearch.org/Specifications/OpenSearch/1.1">OpenSearch</ulink>-compliant browser.</para>
<para>All the user needs to do is click on the <emphasis><emphasis>add this engine</emphasis></emphasis> link on the FCT page, e.g., http://linkeddata.uriburner.com/fct/, which will automatically add that Faceted Browser to their browser&#39;s list of search engines:</para>
<ulink url="VirtSetFCTRegistryForOpenSearch/fct-add-engine.png"><figure><graphic fileref="VirtSetFCTRegistryForOpenSearch/fct-add-engine.png" /></figure></ulink><para>The name shown in the browser&#39;s search engine menu will be the human-readable <ulink url="http://www.opensearch.org/Specifications/OpenSearch/1.1#The_.22ShortName.22_element">&quot;ShortName&quot;</ulink> from the OpenSearch Description Document, automatically generated by FCT&#39;s built-in opensearchdescription.vsp.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Why</bridgehead>
<para>Unless otherwise configured, Virtuoso will use the DefaultHost value from the [URIQA] section of the INI file as this ShortName.</para>
<para>However, OpenSearch dictates that this plain-text value be <ulink url="http://www.opensearch.org/Specifications/OpenSearch/1.1#The_.22ShortName.22_element">no more than 16 characters long</ulink>, which is often exceeded by the DefaultHost value (e.g., linkeddata.uriburner.com).</para>
<para>When the DefaultHost value is longer than 16 characters, the following warning will be presented in the Virtuoso log: </para>
<programlisting>14:47:21 PL LOG: facets: ShortName from URIQA too long. Please set &#39;fct_opensearch_shortname&#39; in registry
</programlisting><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> How</bridgehead>
<para>To avoid or resolve the warning above, a command of the following form should be executed in iSQL or through your local Virtuoso instance Conductor (at http://{virtuoso-host-FQDN[:{listen-port}]}/conductor, e.g., <ulink url="http://my-host.example.com:8890/conductor):">http://my-host.example.com:8890/conductor):</ulink> </para>
<programlisting>set registry_set (&#39;fct_opensearch_shortname&#39;, &#39;16 or fewer chars&#39;)
</programlisting><para> For example, </para>
<programlisting>set registry_set (&#39;fct_opensearch_shortname&#39;, &#39;URIBurner FCT&#39;)
</programlisting><bridgehead class="http://www.w3.org/1999/xhtml:h2"> Related</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="VirtTipsAndTricksGuide">Virtuoso Tips and Tricks Collection</ulink> </listitem>
<listitem><ulink url="VirtFacetBrowserInstallConfig">Install and Configure Virtuoso Faceted Browser</ulink> </listitem>
<listitem><ulink url="VirtuosoFacetsWebService">Use the Virtuoso Faceted Search &amp; Find Engine</ulink> </listitem>
<listitem><ulink url="VirtuosoLODSampleTutorial">Use Faceted Navigation to Explore Virtuoso hosted Linked Data</ulink> </listitem>
<listitem><ulink url="http://www.opensearch.org/Specifications/OpenSearch/1.1#The_.22ShortName.22_element">The &quot;ShortName&quot; element in OpenSearch spec</ulink></listitem>
</itemizedlist></section></docbook>