Intégration d'un hub de recherche dans ASP

Le hub de recherche est cité dans le document par défaut défini dans IIS (Internet Information Services) pour votre site Web de recherche Coveo.

Exemple : Lorsque vous installez CES (Coveo Enterprise Search) dans le dossier d'installation par défaut, le programme d'installation crée le site Web par défaut Coveo Enterprise Search 7, le document par défaut défini dans IIS pour le site Web est le fichier C:\Program Files\Coveo .NET Front-End 12\Web\Coveo\default.aspx et le hub de recherche par défaut est cité dans ce fichier par la ligne de code <ces:SearchHub id="h" runat="server"/>.

Si vous créez un nouveau hub de recherche, vous pouvez l'utiliser en le citant dans le document par défaut défini dans IIS pour votre site Web ou dans d'autres pages ASP (Active Server Pages) personnalisées que vous devriez créer et utiliser dans d'autres contextes.

Pour intégrer un hub de recherche Coveo à une page ASP.NET

À l'aide d'un compte d'administrateur, connectez-vous au serveur du site Web auquel vous souhaitez intégrer le hub de recherche Coveo.
À l'aide d'un éditeur de texte :
1. Ouvrez le fichier .aspx de la page ASP.NET dans laquelle vous souhaitez intégrer le hub de recherche Coveo.
2. Ajoutez la déclaration suivante ou veillez à ce qu'elle apparaisse après la directive @page.
```
<%@ Register TagPrefix="ces" Namespace="Coveo.CES.Web.Search.Controls" Assembly="Coveo.CES.Web.Search, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" %>
```
3. Localisez le lieu où le hub de recherche sera inséré (par exemple, après les en-têtes personnalisés) et ajoutez ou modifiez le contrôle suivant :
```
<ces:SearchHub Name="MyHubName" runat="server"/>
```
  où vous remplacez MyHubName par le nom de votre hub de recherche.
  
  Note : Le contrôle ces:SearchHub doit être inséré dans la page ASPX dans le nœud <form> existant, ou dans un nouveau nœud.
4. Enregistrez les modifications.
Dans IIS, pour le site renfermant la page à laquelle vous intégrez le hub de recherche, créez un dossier virtuel intitulé Coveo qui pointe vers le dossier [.Net_Front-End_Path]\Web\Coveo (voir le document Create a Virtual Directory (IIS 7) de Microsoft).

À l'aide d'un éditeur de texte :

Ouvrez le fichier web.config du site dans lequel vous intégrez le hub de recherche Coveo.

Ajoutez les définitions suivantes à la section Configuration > ConfigSections.

<sectionGroup name="coveoCnlWeb">
  <section name="customContent" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>
<sectionGroup name="coveoEnterpriseSearch">
  <section name="database" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="analytics" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="locations" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="server" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>

Dans la section configuration\configSections, ajoutez le code suivant :

<sectionGroup name="coveoCnlWeb">
  <section name="customContent" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>
<sectionGroup name="coveoEnterpriseSearch">
  <section name="database" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="analytics" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="locations" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <section name="server" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>

Dans la section configuration\system.web\pages, ajoutez le code suivant :

<controls>
  <add tagPrefix="cnla" namespace="Coveo.CNL.Web.Ajax" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cnlb" namespace="Coveo.CNL.Web.BetterControls" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cnlm" namespace="Coveo.CNL.Web.Misc" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cnlv" namespace="Coveo.CNL.Web.Validators" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cnlvs" namespace="Coveo.CNL.Web.Validators.ServerSide" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cnlw" namespace="Coveo.CNL.Web.Widgets" assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="ces" namespace="Coveo.CES.Web.Search.Controls" assembly="Coveo.CES.Web.Search, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add tagPrefix="cs" namespace="Coveo.CES.Web.Search.Controls.CustomerService" assembly="Coveo.CES.Web.Search, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
</controls>
<namespaces>
  <add namespace="Coveo.CES.Web.Search" />
  <add namespace="Coveo.CES.Web.Search.Controls" />
  <add namespace="Coveo.CNL.Web" />
</namespaces>

Dans la section configuration\system.web\compilation, ajoutez le code suivant :

<assemblies>
  <add assembly="Coveo.CNL, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add assembly="Coveo.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add assembly="Coveo.CES.Common, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
  <add assembly="Coveo.CES.Web.Search, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2" />
</assemblies>

Dans la section configuration, ajoutez le code suivant :

<coveoCnlWeb>
  <customContent uri="~/Coveo/" anonymousUri="~/Coveo/Anonymous/" />
</coveoCnlWeb>
<coveoEnterpriseSearch>
  <server hostname="localhost" port="52800" servicesHostname="localhost" servicesPort="52810" instance="default" mirrorName="default" sslCertificatePath="C:\Program Files\Coveo .NET Front-End 12\Web\certificate.p12" />
  <database enabled="false" connectionString="mongodb://localhost/databaseName" />
  <analytics enabled="false" connectionString="Data Source=yourServerName;Initial Catalog=CoveoAnalytics;Integrated Security=SSPI;" />
</coveoEnterpriseSearch>

Enregistrez le fichier.

À l'aide d'un navigateur, accédez à la page modifiée pour tenter de voir le hub de recherche.

La page de la première installation de la Configuration du serveur d'interfaces apparaît afin que vous puissiez compléter l'installation (voir Première installation de Coveo .NET Front-End).

Obtenez des réponses à vos questions sur answers.coveo.com.

Communauté

Doc produitsMenu

Intégration d'un hub de recherche dans ASP