Creating an adapter channel

The adapter is the interface between an external data source and the Device Management Enablement system. In this step, you configure a channel for a receiver.

1. Log on as <solutionID> administrator.
2. Click Solution Administration > Configuration Tools > Data Sources.
3. Click Create, and select From my own source with my own property mapping. The Create Data Source window opens.
4. In the Create Data Source window:
   1. Enter values for Data source label, and Data source unique text identifier.
   2. Optional: If you want the data source to be a boundary area, select Yes from the Boundary area list.
   3. Select a value from the Geometry list. The options that are displayed depend on the value that you selected for Boundary area. Also, the value that you select here affects the options that are displayed in the Acquisition method list.
   4. From the Data source definition list, select the option User-defined service to database mapping.
   5. Select the import method, for example Import data for Device Management Enablement, from the Acquisition method list.
   6. Click Next.
   The window Step 2 of 3: Connection Information opens.
5. In the General, Connection, and Format panes of the Step 2 of 3: Connection Information window:
   1. Select a solution from Domain solution.
   2. Optional: Select a model from Model. If no model is selected, then the channel is applied to all models in the solution.
   3. Enter a description in the Description field.
   4. Specify the connection information for the channel in the Connection field.
   5. Specify the reader type in Reader. Select either File Reader or IBM® Integration Bus Object Reader. Enter the folder and the file name. A dojo module is loaded, dependent on the reader that you selected. For a file reader, specify a directory location and file name. The file is automatically uploaded to the server. For a CSV file, specify the file format. The CSV file is parsed automatically.
   6. Specify the format of the ingestion or incoming message. The format specifies how each field is recognized by Device Management Enablement, for example by mapping to WaterML elements. Specify whether the first line of the CSV file is a header or not to determine whether data is included or excluded.
   7. Optional: If the channel is to be used as input, select Is reading channel.
   8. Click OK.
   9. Click Next.
   The window Step 3 of 3: Data Ingestion opens.
6. In the Step 3 of 3: Data Ingestion window, choose which properties you want to import into your data source. All the properties are selected by default.
   1. Select the Mapping tab to add mapping properties for the channel.
   2. Select the target type for the channel from the available options.

      If the incoming data for the channel is used by assets, select asset.

      If incoming data is used by measurement readings, select Measurement.

      Select the asset type, and click to add a mapping.

      Note: When you add a mapping, and you specify the timestamp source properties for the UPDATE_TIME target type, a new time format reading is available: {"FORMAT_STRING":"yyyy-MM-dd'T'HH:mm:ss.SSSZ"}. In prior releases, the format used was: {"FORMAT_STRING":"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"}.

      Option	Sample reading
      {"FORMAT_STRING":"yyyy-MM-dd'T'HH:mm:ss.SSSZ"}	PRV23_Setting_Value,6.1,2016-01-21T01:41:21.0+0000
      {"FORMAT_STRING":"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"}	PRV23_Setting_Value,6.1,2016-01-21T01:41:21.0+00:00

   3. After you add the mapping definition, activate the channel by selecting the check box. When you activate the channel, the batch asset registration service is used for reading data. Channel data is loaded and the IBM Integration Bus instance can accept channel data.
   4. Click OK to save the data source.
7. In the list of data sources, click the name of the data source that you created. Icons are displayed next to the data source name to indicate whether data flow into the data source has started.

   Red square

   When a Red square is displayed next to the name of a data source, this indicates that data flow into the data source cannot start. You must configure one or more settings before data flow into the data source can start.

   Green triangle

   When a green triangle is displayed next to the name of a data source, this indicates that data flow into the data source has started. You can view data items from the data source, and you can add data items to the data source.