Paramètres de configuration de Message Connector

Pour configurer Message Connector, vous pouvez modifier le fichier XML appelé MessageConnectorConfig.xml qui se trouve dans votre répertoire Message Connector sur le serveur d'exécution Interact, en général <Interact_home>/msgconnector/config/MessageConnectorConfig.xml. Chacune des configurations de ce fichier XML sont décrites ici. N'oubliez pas que si vous modifiez ce fichier une fois que Message Connector est déployé et en cours d'exécution, vous devez annuler le déploiement puis redéployer Message Connector ou redémarrer le serveur d'applications pour recharger ces paramètres lorsque vous avez fini de modifier le fichier.

Paramètres généraux

Le tableau suivant contient la liste des paramètres facultatifs et obligatoires contenus dans la section generalSettings du fichier MessageConnectorConfig.xml.

Paramètres généraux de Message Connector
Elément	Description	Valeur par défaut
<interactURL>	Adresse URL du serveur d'exécution Interact qui gère les appels à partir des balises de page de Message Connector, tels que le serveur d'exécution sur lequel Message Connector s'exécute. Cet élément est obligatoire.	http://localhost:7001/interact
<defaultDateTimeFormat>	Format de date par défaut.	JJ/MM/aaaa
<log4jConfigFileLocation>	Emplacement du fichier de propriétés Log4j. Il est relatif à la variable d'environnement $MESSAGE_CONNECTOR_HOME si elle est définie ; sinon, cette valeur est relative au chemin de la racine de l'application Web Message Connector.	config/MessageConnectorLog4j.properties

Valeurs de paramètre par défaut

Le tableau suivant contient la liste des paramètres facultatifs et obligatoires contenus dans la section defaultParameterValues du fichier MessageConnectorConfig.xml.

Paramètres par défaut de Message Connector
Elément	Description	Valeur par défaut
<interactiveChannel>	Nom du canal interactif par défaut.
<interactionPoint>	Nom du point d'interaction par défaut.
<debugFlag>	Détermine si le débogage est activé. Les valeurs admises sont true et false.	false
<contactEventName>	Nom par défaut de l'événement de contact publié.
<acceptEventName>	Nom par défaut de l'événement d'acceptation publié.
<imageUrlAttribute>	Nom d'attribut de l'offre par défaut qui contient l'adresse URL de l'image de l'offre, si aucun n'est indiqué dans le lien Message Connector.
<landingPageUrlAttribute>	Adresse URL par défaut de la page d'arrivée de clics si aucune n'est spécifiée dans le lien de Message Connector.

Paramètres de comportement

Le tableau suivant contient la liste des paramètres facultatifs et obligatoires contenus dans la section behaviorSettings du fichier MessageConnectorConfig.xml.

Paramètres de comportement de Message Connector

Elément

Description

Valeur par défaut

URL vers laquelle le connecteur redirige si une erreur se produit lors du traitement d'une requête d'une image d'offre. Ce paramètre est obligatoire.

/images/default.jpg

URL vers laquelle le connecteur redirige si une erreur se produit lors du traitement d'une requête d'une page d'arrivée de clics. Ce paramètre est obligatoire.

/jsp/default.jsp

Détermine si l'offre en mémoire cache doit être renvoyée, même si elle a déjà expiré. Les valeurs admises sont true et false.

false

L'action à entreprendre si l'offre initiale est trouvé, mais a déjà expiré. Les valeurs autorisées sont les suivantes :

Paramètres de stockage

Le tableau suivant contient la liste des paramètres facultatifs et obligatoires contenus dans la section storageSettings du fichier MessageConnectorConfig.xml.

Paramètres de stockage de MessageConnector
Elément	Description	Valeur par défaut
<persistenceMode>	Lorsque le cache persiste de nouvelles entrées dans la base de données. Les valeurs autorisées sont WRITE-DERRIERE (où les données sont écrites initialement dans la mémoire cache et mises à jour ultérieurement dans la base de données) et WRITE-THROUGH (où les données sont écrites dans la mémoire cache et dans la base de données en même temps).	WRITE-THROUGH
<maxCacheSize>	Nombre maximal d'entrées dans le mémoire cache.	5000
<maxPersistenceBatchSize>	Taille de lot maximale lors de la conservation des entrées dans la base de données.	200
<macCachePersistInterval>	Durée maximale en secondes pendant laquelle une entrée demeure dans la mémoire cache avant d'être conservée dans la base de données.	3
<maxElementOnDisk>	Nombre maximal d'entrées dans le cache disque.	5000
<cacheEntryTimeToExpireInSeconds>	Durée maximale pendant laquelle les entrées présentes dans le cache disque sont conservées avant expiration.	60000
<jdbcSettings>	Section du fichier XML contenant des informations spécifiques si une connexion JDBC est utilisée. Elle s'exclut mutuellement avec la section <dataSourceSettings>.	Configuré par défaut pour se connecter à une base de données Serveur SQL configurée sur le serveur local, mais si vous activez cette section, vous devez fournir les paramètres JDBC réels et les données d'identification pour la connexion.
<dataSourceSettings>	Section du fichier XML contenant des informations spécifiques si une source de données est utilisée. Elle s'exclut mutuellement avec la section <jdbcSettings>.	Configuré par défaut pour se connecter à la source de données InteractDS définie sur le serveur d'applications Web local.

Niveaux d'audience

Le tableau suivant contient la liste des paramètres facultatifs et obligatoires contenus dans la section audienceLevels du fichier MessageConnectorConfig.xml.

Notez que l'élément audienceLevels est utilisé facultativement pour spécifier le référentiel par défaut à utiliser si aucun n'est spécifié dans le lien du connecteur de Message Connector, comme dans l'exemple suivant :

Dans cet exemple, la valeur de l'attribut par défaut correspond au nom d'un audienceLevel défini dans cette section. Il doit y avoir au moins un niveau d'audience défini dans ce fichier de configuration.

Paramètres de niveaux d'audience MessageConnector
Elément	Elément	Description	Valeur par défaut
<Niveau d'audience>		Elément contenant la configuration du niveau d'audience. Fournissez un attribut de nom, comme dans <audienceLevel name="Customer">
	<messageLogTable>	Nom de la table de journal. Cette valeur est obligatoire.	UACI_MESSAGE_CONNECTOR_LOG
<fields>	<field>	Définition d'une ou de plusieurs zones d'ID audience pour ce audienceLevel.
	<name>	Nom de la zone d'ID audience, comme indiqué dans l'exécution Interact.
	<httpParameterName>	Nom du paramètre correspondant à cette zone d'ID audience.
	<dbColumnName>	Nom de la colonne correspondante dans la base de données pour cette zone d'ID audience.
	<type>	Type de la zone d'ID audience, tel qu'il est indiqué dans l'exécution Interact. Les valeurs peuvent être string ou numeric.