Communauté

Doc produitsMenu

Modification de paramètres de source cachés de Sitecore

Les pages Ajouter une source et Source:.. Général de l'Outil d'administration présentent les paramètres avec lesquels vous pouvez configurer le connecteur pour la plupart des installations de Sitecore. Les paramètres plus avancés et moins souvent utilisés sont cachés. Vous pouvez choisir de faire apparaître un ou plusieurs de ces paramètres dans les pages Ajouter une source et Source:.. Général de l'Outil d'administration afin que vous puissiez changer leur valeur par défaut.

La liste suivante décrit les paramètres avancés cachés qui sont disponibles pour les sources de Sitecore avec le connecteur. Le type de paramètre (entier, chaîne…) apparaît entre parenthèses après le nom du paramètre.

AllowAutoRedirect (Booléen)

Spécifie si le connecteur permet d'être redirigé pendant l'extraction de la page Web d'un élément de Sitecore. Ce paramètre est utilisé avec l'authentification par formulaire.

AnonymousUserNames (Chaîne)

Spécifie une liste d'utilisateurs (séparés par des points-virgules) qui sont considérés comme étant des utilisateurs anonymes. La valeur par défaut est extranet\anonymous. Il s'agit d'un paramètre important afin de calculer correctement les permissions dans le contenu de Sitecore. Si d'autres utilisateurs dans votre installation sont comptés comme étant anonymes, ils doivent être définis dans ce paramètre.

AspNetStateTags (chaîne)

Spécifie les balises d'état ASP.Net qui sont utilisées afin d'extraire une page Web si l'authentification par formulaire est utilisée.

ConfigFilePath (chaîne)

Spécifie le chemin d'accès vers un fichier de configuration du connecteur Sitecore, s'il faut en utiliser un (voir Création et utilisation d'un fichier de configuration Sitecore).

ContentStartPaths (Chaîne)

Spécifie une liste d'URI relatifs du contenu de Sitecore qui restreignent l'analyse.

Exemple : Pour n'analyser que le contenu qui se trouve sous le nœud Nicam Products dans votre serveur Sitecore, tapez : Sitecore/Nicam/Products

Vous pouvez spécifier un ou plusieurs chemins d'accès de départ en séparant plusieurs nœuds racines avec le caractère ;.

Exemple : /sitecore/content/home/MyNewRootNode;/sitecore/content/Resources

Ce paramètre est vide par défaut afin d'analyser à partir du chemin d'accès racine.

Note : Vous pouvez trouver le chemin d'accès racine par défaut dans le fichier web.config de Sitecore, en concaténant les attributs rootPath et startItem pour un site cible.

CrawlerUserAgent (chaîne)

Spécifie le nom de l'agent utilisateur avec lequel le connecteur s'identifie pendant l'analyse du contenu de Sitecore. La meilleure pratique de Sitecore demande que vous définissiez ce paramètre afin que Sitecore puisse sélectionner un périphérique dédié à utiliser afin d'afficher du HTML pour cette identité (voir Création d'un appareil Sitecore pour le robot Coveo). Ce paramètre est également utile afin de mieux identifier les requêtes qui sont effectuées par le connecteur Coveo pendant la surveillance du site web Sitecore.

Note : Le paramètre CrawlerUserAgent est visible par défaut dans CES 7.0.5785+ (août 2013).

EnableNTLMAuthentication (Booléen)

Définissez ce paramètre à true seulement lorsque vous extrayez du contenu HTML (Extract Html Content est sélectionné) et votre site Sitecore est sécurisé avec le module Active Directory. Ceci demande au connecteur Coveo de s'authentifier avec l'identité d'utilisateur définie dans la source où il fait une requête web pour extraire le HTML. Autrement, les requêtes GET retournent des erreurs HTTP 401 Unauthorized. Le nom d'utilisateur dans l'identité d'utilisateur doit être sous la forme domain\username. Si vous obtenez une erreur de configuration, veillez à utiliser les mêmes paramètres de connexion pour l'identité d'utilisateur définie dans le fournisseur de sécurité et le nom d'utilisateur utilisé pour définir le fournisseur d'adhésion AD dans le fichier web.config. La valeur par défaut est false.

Note : Le paramètre EnableNTLMAuthentication est disponible à partir de CES 7.0.6547 (mars 2014).

ExtractHtmlContent (Booléen)

Une meilleure pratique consiste à sélectionner cette option afin que le robot soit affiché en HTML par Sitecore. Vous devez également définir le paramètre Crawler User Agent afin que Sitecore puisse identifier de façon unique le robot Coveo (voir Ajout de paramètres clés du connecteur Sitecore) et sélectionner un périphérique qui affiche du HTML afin de ne présenter que ce qui doit être indexé (dont les métadonnées) et d'être utilisé comme Aperçu rapide (voir Création d'un appareil Sitecore pour le robot Coveo). Le robot retrouve le HTML pour les éléments qui ne sont pas médias, n'ont pas de correspondance pour le corps dans le fichier de correspondances, et ont un URI qui peut être cliqué.

Pour un site privé, vous devez configurer l'authentification par formulaire afin d'obtenir du contenu.

Notes :

  • Le paramètre ExtractHtmlContent est visible et sélectionné par défaut dans CES 7.0.5785+ (août 2013).

  • L'authentification par formulaires était nécessaire même pour les sites publics dans des versions antérieures à CES 7.0.5556 (juin 2013).

FormsAuthLoginCommand (Chaîne)

Spécifie la commande de connexion à utiliser afin d'effectuer l'authentification par formulaire.

FormsAuthLoginPage (chaîne)

Spécifie l'URL de la page de connexion à utiliser afin d'effectuer l'authentification par formulaire.

FormsAuthPasswordControl (chaîne)

Spécifie l'identificateur du contrôle dans la page de connexion pour taper le mot de passe afin d'effectuer l'authentification par formulaire.

FormsAuthUserControl (chaîne)

Spécifie l'identificateur du contrôle dans la page de connexion pour taper le nom d'utilisateur afin d'effectuer l'authentification par formulaire.

Astuce : Vous pouvez obtenir l'identificateur en inspectant la balise HTML input correspondante de la source de la page Web à l'aide de vos fonctionnalités d'inspection du navigateur.
Certains sites Web utilisent le contenu dynamique (AJAX). Dans ce cas, la source de page peut ne pas être suffisante pour retrouver l'identificateur de contrôle. Vous pouvez alors utiliser un débogueur Web externe comme Fiddler afin de savoir quelles sont les valeurs qui sont transférées dans le serveur si la commande de connexion est invoquée.
Exemple : Dans le menu Internet Explorer, sélectionnez Afficher > Source, localisez la balise input, et extrayez le id correspondant (ctl00_ctlContentPlaceHolder_ctl00_ctlLogonControl_ctlPanelBar_txtUserName dans le code ci-dessous).
<input name="ctl00$ctlContentPlaceHolder$ctl00$ctlLogonControl$ctlPanelBar$txtUserName" type="text" id="ctl00_ctlContentPlaceHolder_ctl00_ctlLogonControl_ctlPanelBar_txtUserName" class="FormInputText" Focus="True" style="width:" />

FormsAllowAutoRedirect (chaîne)

Spécifie si le connecteur permet d'être redirigé ou non pendant l'extraction de la page Web d'un élément de Sitecore. La valeur par défaut est true.

FormsAspNetStateTags (chaîne)

La balise d'état ASP.NET à utiliser pour l'authentification par formulaire. La valeur par défaut est {"__VIEWSTATE","__VIEWSTATEENCRYPTED","__EVENTVALIDATION","__EVENTTARGET","__EVENTARGUMENT"}.

IndexAllVersions (Booléen) - robot
IncludeAllVersions (Booléen) - Connecteur

Si défini à true, toutes les versions de chaque élément seront indexées plutôt que seulement la version la plus récente.

Languages (Chaîne)

Spécifie une liste de langues, séparées par des points-virgules, à indexer. Vous pouvez spécifier les langues à analyser en entrant un ou plusieurs codes de langues. Tapez le caractère de remplacement * afin d'indexer toutes les langues. Un document est indexé pour chaque langue. Par défaut, si la boîte est vide, un seul document est indexé à l'aide de la langue par défaut du Site cible. Si aucune langue n'est définie dans le site, l'anglais est utilisé.

Exemple : en;fr-CA

NumberOfRefreshThreads (entier)

Nombre de fils utilisés pour l'analyse. La valeur par défaut est 2.

RetrieveSecurities (Booléen)​

Spécifie si le connecteur récupère également les permissions de Sitecore qui sont associées à chaque élément pendant l'analyse. La valeur par défaut est false​.

TargetSite (chaîne)

Spécifie le site Sitecore ciblé à indexer. La valeur par défaut est website. Si le site Web Sitecore n'utilise pas le nom par défaut (website), vous devez utiliser ce paramètre et fournir le nom approprié. Vous pouvez obtenir le nom du site à partir du fichier web.config de Sitecore.

Exemple : Le code suivant affiche un extrait d'un fichier web.config de Sitecore, qui définit cinq sites Web. Tous les sites Web qui sont hébergés dans une seule installation de Sitecore sont définis sous le nœud <site> et la chaîne à entrer dans le paramètre TargetSite est celui de l'attribut name. 

<sites>
 ...
 <site name="danish" hostName="da.printers" language="da-DK" virtualFolder="/" 
 <site name="german" hostName="de.printers" language="de-DE" virtualFolder="/" 
 <site name="english" hostName="en.printers" language="en" virtualFolder="/" 
 <site name="british" hostName="gb.printers" language="en-GB" virtualFolder="/" 
 <site name="website" virtualFolder="/" physicalFolder="/" 
  ...
</sites>

Timeout (Entier)

Modifie le temps pendant lequel le connecteur attend qu'une requête dans le service Web du contenu soit complétée. Toute valeur en secondes. La valeur par défaut est 100 secondes.

WebServiceLocation (chaîne)

Spécifie la dernière partie de l'URI qui mène vers le service web. Cette chaîne est ajoutée au paramètre de source Addresses. La valeur par défaut est : /sitecore modules/web/coveo/webservice/SitecoreWebService.asmx

Utilisez la procédure suivante seulement si vous souhaitez modifier un ou plusieurs des paramètres de source cachés qui sont présentés ci-dessus.

Pour modifier les paramètres de source cachés de Sitecore

  1. Veuillez vous référer à Ajout d'un paramètre de connecteur précis afin d'ajouter un ou plusieurs paramètres de source cachés de Sitecore.

  2. Pour une nouvelle source Sitecore, accédez à la page Ajouter une source de l'Outil d'administration afin de modifier la valeur du paramètre avancé tout juste ajouté :

    1. Sélectionnez Index > Sources et collections.

    2. Sous Collections, sélectionnez la collection dans laquelle vous souhaitez ajouter la source.

    3. Sous Sources, cliquez sur Ajouter.

    4. Dans la page Ajouter une source, modifiez la valeur du paramètre avancé tout juste ajouté.

  3. Pour une source Sitecore existante, accédez à la page Source:.. Général de l'Outil d'administration afin de modifier la valeur du paramètre avancé tout juste ajouté :

    1. Sélectionnez Index > Sources et collections.

    2. Sous Collections, sélectionnez la collection renfermant la source que vous souhaitez modifier.

    3. Sous Sources, cliquez sur la source Sitecore existante dans laquelle vous souhaitez modifier le paramètre avancé nouvellement ajouté.

    4. Dans la page Source:.. Général, modifiez la valeur du paramètre avancé tout juste ajouté.