Adding or Changing Compliance Adapters
Topic Last Modified: 2009-02-27
If compliance logging is enabled, Group Chat Servers produce a sequence of events that identify user actions in chat rooms. These events track users entering a chat room, users exiting a chat room, access to chat history, and all chat content as it is posted. Compliance adapters transform these events into configurable XML documents for consumption by third-party compliance systems. The XML transformation that is used, as well as numerous options related to the verbosity of information in these events, can be customized. The following procedures describe how you can do this by creating or modifying a custom compliance adapter.
Note
The Adapter Type box is set to XML by default, and it cannot be changed.
To create a compliance adapter
Click Start, point to All Programs, point to Administrative Tools, and then click Office Communications Server 2007 R2 Group Chat Server.
In the Group Chat Server Configuration Tool, on the File menu, click Configure Server Settings.
On the left navigation bar, click Compliance Service.
Under Configured Adapters, click Add.
In the New Compliance Adapter dialog box, in the Name box, type a name for the new adapter. This name is used to identify this adapter in the Configured Adapters list.
In the Conversation Interval in Minutes box, type or select an interval, in minutes. This is the window of time used to create an output file. Because group chat conversations are perpetual, the conversation interval is an arbitrary time slice. Larger intervals produce fewer output files that are bigger in size, and shorter intervals produce a greater number of smaller output files.
In the Output Directory box, select or create a folder to retain the output created in the compliance process. Each adapter should have its own output directory.
To produce an output file for each chat room that has activity during the conversation interval, in the Options box, select the Create separate output files for each chat room check box. No output file is created if there are no compliance events during the conversation interval.
To produce a single output file for all chat rooms during the conversation interval, in the Options box, clear the Create separate output files for each chat room check box.
To produce files that record when an upload or download event occurs, select the Create additional output files to track file transfer events check box. These files have an extension of .attach.
To always include full user details in output, select the Require full user details from non-compliance database check box. This setting causes additional queries to be recorded in the noncompliance database. Do not select this check box this unless you need full user details in the XML output.
To always include full channel details in the output, select the Requires full channel details from non-compliance database check box. This setting causes extra queries to be recorded in the noncompliance database. Do not select this check box unless you need full user details in the XML output.
The compliance adapter uses an XSLT transformation to create the output files based on the compliance events that occur during the conversation interval. To edit the configuration of the XSLT definition of the compliance adapter, click Edit Custom Configuration.
In the Edit Compliance Adapter Custom Configuration dialog box, do one of the following:
- To enter a sample configuration, click Default. This is the same text no matter what adapter is edited.
- To import a configuration for the adapter from a text file, click Import.
- In the Custom Configuration box, type or paste a configuration for the adapter.
For details about customizing the XSLT definition file, see Customizing the XSLT Definition File.
Restart the server.
To remove a compliance adapter from the Configured Adapter list
Click Start, point to All Programs, point to Administrative Tools, and then click Office Communications Server 2007 R2 Group Chat Server.
In the Group Chat Server Configuration Tool, on the File menu, click Configure Server Settings.
On the left navigation bar, click Compliance Service.
Under Configured Adapter , click the adapter.
Click Remove.
To modify the configuration of a compliance adapter
Click Start, point to All Programs, point to Administrative Tools, and then click Office Communications Server 2007 R2 Group Chat Server.
In the Group Chat Server Configuration Tool, on the File menu, click Configure Server Settings.
On the left navigation bar, click Compliance Service.
Under Configured Adapter, click the adapter, and then click Modify.
This dialog box contains the same information as the New Compliance Adapter dialog box, except it is populated with the settings for the selected adapter.
In the Modify Compliance Adaptor dialog box, edit these settings as needed, and then click OK.