About DCA 2.01 Changes to CCS Files

The DCA-CCS Updater adds, modifies, or overwrites the Collaboration Server configuration files listed below. If you have modified one or more of these files previously, you should assess the extent and nature of this modification to determine whether any desired settings or customization will be lost when you run the Updater. Of course, this is not an issue when deploying the DCA with a new CCS installation.

The DCA-CCS Updater automatically creates backups of CCS files it modifies or replaces. After running the Updater, you can reintroduce any desired customization that was lost. DO NOT reintroduce customization by overwriting the Updater-modified files with the originals. Rather, re-enter or copy and paste code, settings, etc. in the files as necessary. When you do this, be careful not to change any settings or code required by the DCA (DCA-required settings/code are commented as such in files the DCA overwrites but not in those it modifies).

Note: In the 'Location' column the directory path '\' refer to the windows path. For Solaris, the path is "/".  

Files Added to CCS

The DCA-CCS Updater adds these new files on your CCS Server:

 

File

Location

Description

DCARolesOverride.properties

<CCSrootdirectory>\servlet\properties

Sets multi-session and single-session agent role properties required by the DCA. Primarily, this consists of  Disables items in the agent desktop that conflict with the DCA.

startdca.jhtml

<CCSrootdirectory>\pub\html\caller

For multi-session configurations, loads the Collaboration Toolbar for callers and agents.

AgentWrapper.jhtml

 

<CCSrootdirectory>\pub\html\agent

 

Provides a wrapper for the agent desktop that allows it to forward JavaScript function calls (for example, from ScriptBuilder) to the DCA.

Overwritten CCS Files

The DCA-CCS Updater completely overwrites these files on your CCS Server (sorted by directory):

 

File

Location

Description of Change

AgentFrame.jhtml

<CCSrootdirectory>\pub\html\agent

Adds a hidden frame to the agent desktop frameset which stores AgentWrapper.jhtml.

screenpopbody.jhtml

<CCSrootdirectory>\pub\html\agent\default

Creates the Reload Toolbar button on the Agent Desktop.

RequestinProcess.jhtml

<CCSrootdirectory>\pub\html\caller\default

Resolves a timing issue related to the loading the Collaboration Toolbar for callers.

CallForm.html

CallMe.html

MscCallForm.html

msccallme.jhtml

<CCSrootdirectory>\pub\html\forms

InitSessionPage in caller forms is commented out, thus allowing the DCA CCS Collaboration Toolbar to load in its place.

AgentPanel.jhtml

<CCSrootdirectory>\pub\html\multichatui

Adds a JavaScript function required by the DCA for page sharing.

callerinfo.jhtml

<CCSrootdirectory>\pub\html\multichatui

For multi-session configurations, allows the DCA to keep track of sessions as agents switch back and forth between them.

Multichatui.jhtml and nowDefunctWindow.jhtml

<CCSrootdirectory>\pub\html\multichatui

Removes the Forward, Back, and Refresh buttons from the multi-session chat Agent Desktop.

PageDisplay.jhtml

 

<CCSrootdirectory>\pub\html\multichatui

For multi-session configurations, removes the browser controls from the agents' external Shared View window (for single-session configurations, this is done in the agent.properties file).

sessionMirror.jhtml

<CCSrootdirectory>\pub\html\multichatui

For multi-session configurations, causes pages to be pushed through the DCA rather than CCS's page display applet.

Toolbar.jhtml

<CCSrootdirectory>\pub\html\multichatui

Removes the Page Synch button from the multi-session chat Agent Desktop.

UIComponents.jhtml

<CCSrootdirectory>\pub\html\multichatui

For multi-session configurations, prevents the External View toggle button in the Agent Desktop from displaying an internal view.

Modified CCS Files

The DCA-CCS Updater makes changes to these files on your CCS Server without overwriting them. Modified settings are denoted by comments within the files.

 

File

Description / Location

Description of Change

caller.properties

caller.properties stores settings for controls and behaviors in the single-session caller desktop.

<CCSrootdirectory>\servlet\properties

Disables items in the caller desktop that conflict with the DCA. Sets the Caller Complexity Mode to Simple.

msccaller.properties

Stores settings for controls and behaviors in the multi-session Caller Desktop.

<CCSrootdirectory>\servlet\properties

Disables items in the caller desktop that conflict with the DCA. Sets the Caller Complexity Mode to Simple.

wlserver.properties

wlserver.properties stores basic settings for Collaboration Server, including server connection, database, and session settings.

<CCSrootdirectory>\servlet\properties

Adds the DCA host name so that CCS knows how and from where to load the Collaboration Toolbar. Also establishes the protocol (HTTP or HTTPS) used by the DCA.

Agent.properties

<CCSrootdirectory>\servlet\properties

Agent.properties stores settings for controls and behaviors of the Agent UI.

WlConfigMgr.default

<CCSrootdirectory>\servlet\properties

WLConfigManager.default is used to load property files.

See Also

For related information, see:

About DCA-CCS Integration

About the DCA-CCS Updater

About DCA 2.01 Changes to Agent Role Settings

How to Add DCA Code to Localized CCS Files

How to Install the DCA-CCS Updater