Adding or Changing Compliance Adapters
Topic Last Modified: 2011-07-13
If compliance logging is enabled, computers running Microsoft Lync Server 2010, Group Chat produce a sequence of events that identify user actions in chat rooms. These events track when users enter a chat room, exit a chat room, and access chat history. They also track all chat content as it is posted. Compliance adapters transform these events into configurable XML files for consumption by third-party compliance systems. The XML transformation that is used can be customized and so can many options related to the verbosity of information in these events. The following procedures describe how you can do this by creating or modifying a custom compliance adapter.
Note
In the Microsoft Lync Server 2010, Group Chat Configuration tool, 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 Lync Server 2010 Group Chat.
Open the Microsoft Lync Server 2010, Group Chat Configuration tool.
On the File menu, click Configure Server Settings.
On the left side of the console tree, 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 Lync 2010 Group Chat conversations are perpetual, the conversation interval is an arbitrary time slice. Larger intervals produce fewer output files that are bigger, 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.
In the Options box, do one of the following:
To produce an output file for each chat room that has activity during the conversation interval, 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, clear the Create separate output files for each chat room check box.
(Optional) 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.
(Optional) 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 non-compliance database. Do not select this check box unless you need full user details in the XML output.
(Optional) To always include full channel details in the output, select the Require full chat room details from non-compliance database check box. This setting causes extra queries to be recorded in the non-compliance database. Do not select this check box unless you need full user details in the XML output.
(Optional) The compliance adapter uses an XSLT transformation to create the output files, based on the compliance events that occur during the conversation interval. To modify 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 regardless of 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 how to customize 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 Lync Server 2010 Group Chat.
Open the Microsoft Lync Server 2010, Group Chat Configuration tool.
On the File menu, click Configure Server Settings.
On the left side of the console tree, click Compliance Service.
Under Configured Adapter, click the adapter, and then click Remove.
To modify the configuration of a compliance adapter
Click Start, point to All Programs, point to Administrative Tools, and then click Lync Server 2010 Group Chat.
Open the Microsoft Lync Server 2010, Group Chat Configuration tool.
On the File menu, click Configure Server Settings.
On the left side of the console tree, 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 that it is populated with the settings for the selected adapter.
In the Modify Compliance Adapter dialog box, edit the settings as needed, and then click OK.