Ajout de plusieurs fournisseurs d'analyse au fichier biConfig.xml

Ajoutez plusieurs fournisseurs d'analyse à votre magasin en mettant à jour l'élément <biproviders> de votre fichier de configuration biConfig.xml. Indiquez le storeId et le fournisseur d'analyse que vous souhaitez utiliser pour ce magasin. Pour gagner du temps, vous pouvez également indiquer un fournisseur d'analyse par défaut en mettant à jour l'élément <defaults>.

Pourquoi et quand exécuter cette tâche

Vous pouvez effectuer cette tâche en même temps que vous intégrez un fournisseur d'analyse externe ou après que le fournisseur est déjà intégré.

Lorsque vous mettez le fichier biConfig.xml pour définir la configuration du fournisseur d'analyse, vous pouvez définir des valeurs par défaut pour chaque paramètre de configuration. En définissant des valeurs par défaut, vous pouvez configurer rapidement plusieurs magasins pour utiliser la même configuration pour un fournisseur d'analyse. Vous pouvez également remplacer l'une des valeurs par défaut d'un magasin individuel en incluant une valeur différente dans la configuration du magasin. Pour plus d'informations, voir Configuration des valeurs par défaut pour un fournisseur d'analyse.

Pour mettre à jour la configuration de votre fournisseur d'analyse, mettez à jour le fichier biConfig.xml de votre environnement de développement, puis déployez votre fichier dans l'archive d'entreprise HCL Commerce (EAR) sur votre environnement de transfert ou de production.

HCL Commerce Developer Lorsque vous mettez à jour le fichier biConfig.xml dans votre environnement de développement, vous pouvez utiliser un fichier de rechargement pour vous aider à tester rapidement les modifications de configuration. En utilisant ce fichier de rechargement, vous n'avez pas besoin de redémarrer continuellement votre serveur pour appliquer des modifications de configuration à partir du fichier biConfig.xml.

Procédure

Accédez au fichier de configuration biConfig.xml à l'emplacement suivant :

workspace_dir/WC/xml/config/bi/biConfig.xml
Mettez à jour votre fichier de configuration biConfig.xml pour refléter les fournisseurs d'analyse que vous souhaitez utiliser dans l'élément <biproviders>. Consultez l'exemple de fichier de configuration biConfig.xml dans l'exemple suivant.
Enregistrez votre fichier.
Facultatif : Vous pouvez remplacer les valeurs par défaut pour que l'élément <output> utilise la configuration d'un fournisseur spécifique.
Pour spécifier la configuration de la section de sortie à utiliser pour remplacer les valeurs par défaut, vous devez mettre à jour la configuration de balise dans le fichier CommonJSToInclude.jspf de votre magasin.
Par exemple, pour mettre à jour la balise <cm:output />, recherchez le code suivant.
```
<flow:ifEnabled feature="Analytics">
	<%-- The CM header tag must be in the <head> tag of the JSP --%>
	<cm:output section="header" />
</flow:ifEnabled>
```
Mettez à jour la balise pour identifier le fournisseur d'analyse à utiliser en incluant le nom du fournisseur d'analyse :
```
<flow:ifEnabled feature="Analytics">
	<%-- The CM header tag must be in the <head> tag of the JSP --%>
	<cm:output section="header" biprovider="analytics_provider" />
</flow:ifEnabled>
```
Où analytics_provider est le nom du fournisseur d'analyse que vous souhaitez utiliser.

Exemple

L'exemple de fichier de configuration biConfig.xml suivant a deux fournisseurs d'analyse configurés : coremetrics et additionalprovider.

<?xml version="1.0" encoding="UTF-8"?>
<BIConfiguration>
  1 <biproviders>
      1a <biprovider name = "coremetrics">
            <header>
                <![CDATA[
                ]]>
            </header>
            <footer>
                <![CDATA[
                ]]>
            </footer>
        </biprovider>
      1b <biprovider name = "additionalprovider">
            <header>
                <![CDATA[
                ]]>
            </header>
            <footer>
                <![CDATA[
                ]]>
            </footer>
        </biprovider>
    </biproviders>
  2 <defaults>
        <store storeId = "10101">
            <biprovider name = "coremetrics"/>
        </store>
    </defaults>
 3 <stores>
      3a <store storeId = "10101" biprovider = "coremetrics" debug = "false" enabled = "true">
            <clientid>12345</clientid>
            <output section = "header">
                <![CDATA[
                <script language="JavaScript1.1" type="text/JavaScript" src="/wcsstore/coremetrics/v40/eluminate.js"></script>
                <script language="JavaScript1.1" type="text/JavaScript" src="/wcsstore/coremetrics/v40/techprops.js"></script>
                <script language="JavaScript1.1" type="text/JavaScript" src="/wcsstore/coremetrics/cmdatatagutils.js"></script>
                <script language="JavaScript1.1" type="text/JavaScript">
                <!--
                //cmSetProduction();
                //-->
                </script>
                <script language="JavaScript1.1" type="text/JavaScript">
                <!--
                ]]>
            </output>
            <output section = "footer">
                <![CDATA[
                //-->
                </script>]]>
            </output>
        </store>
      3b <store storeId = "10101" biprovider = "additionalprovider" debug = "false" enabled = "true">
            <output section = "header">
               <![CDATA[
               <!-- Beginning of additional analytics provider header code -->
               <!-- End of additional analytics provider header code -->
                                ]]>
            </output>
            <output section = "footer">
              <![CDATA[
              <!-- Beginning of additional analytics provider footer code -->
              <!-- End of additional analytics provider footer code -->
                ]]>
            </output>
        </store>
    </stores>
</BIConfiguration>

1 L'élément <biproviders> définit les fournisseurs d'analyse auxquels le magasin est intégré. Dans cet exemple, la ligne 1a définit le premier fournisseur d'analyse comme étant coremetrics et la ligne 1b définit le deuxième fournisseur d'analyse comme étant additionalprovider.
2 L'élément <defaults> spécifie le magasin et l'un des fournisseurs d'analyse de l'élément <biproviders>sera la valeur par défaut que le magasin utilise.
3 L'élément <stores> définit les détails de chacun des fournisseurs d'analyse. Dans cet exemple, il y a deux éléments <store>, qui sont définis dans les lignes 3a et 3b : l'un pour coremetrics et l'autre pour additionalprovider. Dans chaque élément <store>, vous devez définir les paramètres suivants :
storeId

ID du magasin que vous intégrez à un fournisseur d'analyse.

biprovider

Nom du fournisseur d'analyse avec lequel vous effectuez une intégration. Ce nom est le même que la valeur name spécifiée dans l'élément <biprovider> près du haut du fichier biconfig.xml.

activé
Indicateur qui contrôle si les balises d'analyse dans les pages de magasin sont activées pour envoyer des données au fournisseur d'analyse. Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - Les balises d'analyse sont activées.
- false - Les balises d'analyse ne sont pas activées ; les données d'analyse ne sont pas envoyées au fournisseur d'analyse.
debug
Indicateur qui contrôle si les balises d'analyse sont activées dans le mode débogage. (Les messages de débogage apparaissent sur la page Web à l'emplacement de la balise, généralement au bas de la page.) Vous pouvez définir les valeurs suivantes pour cet indicateur :
- true - Le débogage est activé.
- false - Le débogage n'est pas activé.