Configuring the Web Connector
Configuration settings for the Interact Web Connector are stored in a file called jsconnector.xml that is stored on the system where the Web Connector is deployed (such as the Interact runtime server itself, or a separate system running a web application server). You can edit the jsconnector.xml file directly using any text editor or XML editor; however, an easier way to configure almost all of the available configuration settings is to use the Web Connector Configuration page from your web browser.
Before you can use the web interface to configure the Web Connector, you must install and deploy the web application that provides the Web Connector. On the Interact runtime server, an instance of the Web Connector is installed automatically when you install and deploy Interact. On any other web application server, you must install and deploy the Web Connector web application as described in Installing the Web Connector as a separate web application.
1.
http://<host>:<port>/interact/jsp/WebConnector.jsp
*
Replace <host> with the server on which the Web Connector is running, such as the host name of the runtime server or the name of the server on which you deployed a separate instance of the Web Connector.
*
Replace <port> with the port number on which the Web Connector web application is listening for connections, which usually matches the web application server's default port.
2.
Use the Basic Settings page to configure the overall Web Connector behavior for the site on which you'll be rolling out the tagged pages. These settings include the base URL for the site, information that Interact needs to use about the visitors to the site, and similar settings that apply to all of the pages you plan to tag with Web Connector code.
Configuration settings on this page correspond to the interactionPoints section of the jsconnector.xml configuration file.
Configuration settings on this page correspond to the pageMapping section of the jsconnector.xml configuration file.
3.
On the Basic Settings page, verify that the site-wide settings are valid for your installation, and optionally specify debug mode (not recommended unless you are troubleshooting a problem), Digital Analytics for On Premises Page Tag integration, and the default settings for most Interaction Points, then click the HTML Display Types link under Configurations.
4.
By default, display templates (.flt files) are stored in <jsconnector_home>/conf/html.
a.
Information about the template's contents, if any, appears next to the template list.
b.
Optionally, modify the name of the template in the File name for this display type field. For a new template, update CHANGE_ME.flt to something more meaningful.
If you rename the template here, the Web Connector creates a new file with that name the next time the template is saved. Templates are saved when you modify the body of the text, and then navigate to any other field.
c.
Modify or complete the HTML Snippet information as needed, including any stylesheet (CSS), JavaScript, and HTML code you want to include. Note that you can also include variables that will be replaced by Interact parameters at runtime. For example, ${offer.HighlightTitle} is automatically replaced by the offer title in the specified location of the Interaction Point.
Use the examples that appear below the HTML Snippet field for indications of how to format your CSS, JavaScript, or HTML code blocks.
5.
6.
Clicking Roll Out the Changes performs the following actions:
*
Displays the IBM® Interact Web Connector page tag, which contains the JavaScript code that you can copy from the Web Connector page and insert onto your web pages.
*
Backs up the existing Web Connector configuration file on the Interact server (the jsconnector.xml file on the server where the Web Connector is installed) and creates a new configuration file with the settings you've defined.
Backup configuration files are stored in <jsconnector_home>/conf/archive/jsconnector.xml.<date>.<time>, as in jsconnector.xml.20111113.214933.750-0500 (where the date string is 20111113 and the time string, including the time zone indicator, is 214933.750-0500)
You have now completed configuring the Web Connector.
To modify your configuration, you can either return to the beginning of these steps and perform them again with new values, or you can open the configuration file (<Interact_home>/jsconnector/conf/jsconnector.xml) in any text or XML editor and modify it as needed.
WebConnector Configuration Basic Options
WebConnector Configuration HTML Display Types
WebConnector Configuration Enhanced Pages
Web Connector Configuration Options