An adapter provides a means of mapping data from a specific system to Kinetic Calendar events. An adapter is code that is written specifically to connect to one type of data system, such as BMC Action Request System, or Microsoft Exchange. The adapters.json file is essentially a list of the types of sytems available for Kinetic Calendar to connect with. If other adapters are needed, the appropriate adapter package can be added to the Kinetic Calendar application, and the adapter class name can be added to the file. This file must be named adapters.json, and must exist in the root of the configuration directory, as specified here: Configuration Files. A list of available adapters for Kinetic Calendar can be found here: Adapters.
Below is a sample adapters configuration file. As stated, the file uses the JSON format to define the adapter class names.
[ "com.kineticdata.calendar.adapters.ars.ArsAdapter", "com.kineticdata.calendar.adapters.exchange.ExchangeAdapter" ]
This example shows two adapters defined in the file. The first adapter is the class name of the BMC Remedy ARS adapter. This adapter is used to connect to BMC Remedy servers (version 7.0 or higher). The second adapter is the class name of the Microsoft Exchange adapter. This adapter is used to connect to Microsoft Exchange server (version 2007 or higher).
On line 1, there is a opening bracket. Since Kinetic Calendar supports multiple connections, it expects a list of adapters in the configuraton file, even if only one adapter will ever be used. The opening bracket indicates this is the start of a list of items.
Line 2 defines the class name of the first adapter. In this example we listed the BMC Remedy ARS adapter, so we need to indicate the class for this adapter. Please consult the adapter configuration page to determine the class name expected for your adapter. This class name is used in the Kinetic Calendar application to load the adapter.
Notice that line 2 has a comma at the end of the line. This indicates there are more items that belong in the list.
Line 3 defines the class name of the second adapter. In this example, we listed the Microsoft Exchange adapter, so the class name for this adapter is listed.
Notice that line 3 does not have a comma at the end of the line. This indicates it is the last item in the list. The last item in a list cannot contain a comma at the end of the line, this would make the file contain invalid syntax.
Line 4 contains a closing bracket, indicating the end of the list.