Implementation Guide › Implementation › Data Gathering (Data Source Expert) › How to Configure Adapters and Translations › File Adapter Case Study › Configuration File General Section

Configuration File General Section

• MajorVersion And MinorVersion: Should be set by default to the application version.
• WorkingDirectoryName (optional): Specifies the default path for Adapter output files (data source control, translation, sends). In this case, it is set to "output", and as such this folder is then created under the Adapters main folder.

The following Indicators control the way the Adapter reads and translates the records:

• RunOnce: If set to "Yes", the Adapter executes once, reading all available data and then stops.
• DataSourceDifferenceFromUTC: Indicates the time difference between UTC (Universal Time Constant, always with zero time offset. Equivalent to GMT) and the time zone of the data source. The time zone of the data source is the time zone with which the time fields in it are denoted. The reason for having this attribute is because the Adapter normalizes all dates into UTC. Having all dates in UTC allows the application the flexibility to then display times according to the user's requirements. The following attributes provide the Adapter the details of how to transform the time fields from the input to UTC:
  • DefaultOffset: Offset from UTC when not in daylight saving time. In this case, it is set to '1' for central European time (CET).
  • TimeFormat: The format by which the Daylight Saving details (described next) should be parsed. The European time format is 'dd/mm/yyyy hh:mi:ss', whereas CA Business Service Insight format specifications are set as '%d/%m/%Y %H:%M:%S'.
  • DayLightSaving: One daylight saving period of the data source time zone. This element is optional (meaning, if not selected, there are no daylight saving times) and it can exist more than once; Once for each daylight savings period entered. When some elements exist, they must be ordered by time, and the periods must not overlap. Usually when configuring Adapters, this element is specified to be a number of years ahead. In this case, only one year is configured as an example.
• From: Begin date of the period. Specified using the time format set above '25/03/2007 02:00:00'.
• To: End date of the period. Specified using the time format set above '28/10/2007 03:00:00'.
• Shift: Time shift added to the DefaultOffset within daylight saving period. Enter '1' as the time shifts forward an hour during this daylight savings period specified between the 2 dates specified.