Intégration de la recherche Coveo .NET dans l'Éditeur de contenu Sitecore

Vous pouvez intégrer les interfaces de recherche Coveo .NET dans votre site Web Sitecore afin de fournir une meilleure expérience de recherche pour vos utilisateurs de site Web (voir Intégration de l'interface de recherche Coveo .NET dans un site Web Sitecore).

Vous pouvez également intégrer la recherche Coveo dans l'Éditeur de contenu Sitecore afin que les personnes qui contribuent au contenu du site puissent également bénéficier des fonctionnalités de recherche Coveo et trouver plus facilement de l'information dans tout le contenu, non seulement dans le contenu publié.

Pour intégrer la recherche Coveo dans l'Éditeur de contenu Sitecore

1. Si ce n'est pas déjà fait, installez les composantes de Coveo Front-End dans votre serveur Sitecore (voir Installation de Coveo .NET Front-End).

2. Installez Recherche de contenu Coveo pour Sitecore :

   1. Connectez-vous à l'interface utilisateur du Bureau Sitecore à l'aide d'un compte d'administrateur.

   2. Sur le Bureau Sitecore, sélectionnez Sitecore > Outils de développement (Development Tools) > Assistant Installation (Installation Wizard).

   3. Dans la boîte de dialogue Assistant Installation (Installation Wizard) :

      1. Dans l'écran Bienvenue dans l'Assistant Installation d'un package (Welcome to the Install Package Wizard), cliquez sur Suivant (Next).

      2. Dans l'écran Sélectionner un package (Select Package) :

         1. Cliquez sur Upload, puis naviguez dans le serveur principal de Coveo afin de sélectionner la trousse de la recherche de contenu Coveo, qui est distribué avec CES :

            [CES_Install_Path]\Bin\Sitecore6.0CoveoContentSearch2.zip

            Note : Utilisez le package Sitecore6.0CoveoContentSearch.zip seulement si vous utilisez l'ancien connecteur Sitecore (voir Ancien connecteur Sitecore).

         2. Cliquez sur Suivant.

      3. Dans l'écran Prêt pour l'installation, cliquez sur Installer.

         Note : Si une Erreur d'accès refusé est affichée pour le dossier bin_install pendant l'installation du package, vérifiez les permissions de sécurité pour ASP.NET dans le dossier de la corbeille de Sitecore ou installez les fichiers manuellement.

   4. Sélectionnez l'option Redémarrer le client Sitecore, puis cliquez sur Terminer.

3. À l'aide d'un compte d'administrateur, connectez-vous au serveur Sitecore.

4. Créez le répertoire virtuel Coveo :

   1. Ouvrez IIS (Internet Information Services).

   2. Dans IIS, localisez et cliquez avec le bouton droit de la souris sur le site Web qui correspond à votre instance de Sitecore, puis sélectionnez Ajouter un répertoire virtuel.

   3. Dans la boîte de dialogue Créer un répertoire virtuel :

      1. Dans la boîte Alias, tapez Coveo.

      2. Dans la boîte Chemin d'accès physique, tapez [.Net_Front-End_Path]\Web\Coveo, habituellement C:\Program Files\Coveo .NET Front-End 12\Web\Coveo.

   4. Fermez IIS.

5. À l'aide d'un éditeur de texte, modifiez le fichier Sitecore web.config :

   Exemple : Pour une instance qui est intitulée Sitecore, le fichier se trouve dans le dossier C:\inetpub\wwwroot\Sitecore\WebSite.

   1. Copiez le code suivant et collez-le juste avant la balise </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>

   2. Copiez le code suivant et collez-le juste avant la balise </controls>, un enfant de la balise <pages>.

      <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" />

   3. Copiez le code suivant et collez-le juste avant la balise </namespace>, un enfant de la balise <namespaces>.

      <add namespace="Coveo.CES.Web.Search"/>
      <add namespace="Coveo.CES.Web.Search.Controls" />
      <add namespace="Coveo.CNL.Web" />

   4. Copiez le code suivant et collez-le juste avant la balise </assemblies>, un enfant de la balise <compilation>.

      <add assembly="Coveo.CNL, 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.CNL.Web, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2"/>
      <add assembly="Coveo.CES.Web.Search, Version=12.0.0.0, Culture=neutral, PublicKeyToken=44110d16825221f2"/>

   5. Copiez le code suivant et collez-le à la fin du fichier, juste avant la balise </configuration>.

      <coveoCnlWeb>
        <customContent uri="~/Coveo/" anonymousUri="~/Coveo/Anonymous/"/>
      </coveoCnlWeb>
      <coveoEnterpriseSearch>
        <server hostname="localhost" port="52800"/>
        <database enabled="false" connectionString="mongodb://localhost/databaseName"/>
        <analytics enabled="false" connectionString="Data Source=yourServerName;Initial Catalog=CoveoAnalytics;Integrated Security=SSPI;"/>
      </coveoEnterpriseSearch>

   6. Enregistrez le fichier.

6. Si CES et Sitecore ne sont pas installés sur le même serveur, copiez le fichier du certificat d'index à partir du serveur maître Coveo vers le serveur Sitecore :

   1. Connectez-vous au serveur maître de Coveo avec un compte d'administrateur.

   2. Copiez le fichier de certificat d'index [Index_Path]\Config\Certificates\cert-iis.p12, habituellement C:\CES7\Config\Certificates\cert-iis.p12.

   3. Collez le fichier de certificat du serveur Sitecore dans le site Web de l'instance de Sitecore.

      Exemple : Pour une instance qui est intitulée Sitecore, le chemin d'accès par défaut est C:\inetpub\wwwroot\Sitecore\Website. Vous pouvez également renommer le fichier de certificat par ces-certificate.p12, par exemple.

7. Configurez la connexion vers l'index CES. À l'aide d'un éditeur de texte :

   1. Ouvrez le fichier web.config de l'instance de Sitecore.

   2. Sous la balise <coveoEnterpriseSearch>, modifiez la balise <server> afin d'inclure les attributs suivants :

      • hostname=”MyCoveoMasterServerHostName” où vous remplacez MyCoveoMasterServerHostName par le nom de votre serveur maître Coveo ou localhost si CES et Sitecore sont sur la même machine.

      • sslCertificatePath=”C:\inetpub\wwwroot\Sitecore\Website\ces-certificate.p12”, ce qui assure que le chemin d'accès pointe vers votre fichier de certificat.

      • port=”52800”, le numéro de port CES par défaut.

      Exemple : Si CES et Sitecore sont sur le même serveur.

      <server hostname="localhost" port="52800" servicesHostname="localhost" servicesPort="52810" instance="default" mirrorName="default" sslCertificatePath="C:\Program Files\Coveo .NET Front-End 12\Web\ces-certificate.p12"/>

8. Configurez la source Sitecore utilisée par la recherche Coveo :

   1. À l'aide d'un éditeur de texte, ouvrez le fichier CoveoSearch.aspx.

      Exemple : Pour une instance de Sitecore qui est intitulée Sitecore, le fichier se retrouve habituellement dans le dossier C:\inetpub\wwwroot\Sitecore\Website\sitecore\shell\Applications\Coveo\.

   2. Localisez le code suivant :

      /* UNCOMMENT THIS SECTION BEFORE FIRST USE p_Args.Builder.AddConstantExpression("@Source=MySourceName"); */

      et remplacez-le par :

      p_Args.Builder.AddConstantExpression("@Source=\”YOUR SITECORE SOURCE NAME HERE\”");

      où vous remplacez YOUR SITECORE SOURCE NAME HERE par le nom de la source que vous avez créée afin de renfermer tout le contenu Sitecore, habituellement pour l'indexation de la base de données master.

   3. Sauvegardez et fermez le fichier.