...

The first time you launch the app you will be prompted to create a new instance. Provide a name in the dialogue window and press the OK button. The name can be arbitrary.

Setup

...

MySQL Connection

The commodity reader requires that you setup the connection to your MySQL database used by the Chameleon instance. You can do this easily by entering the Flow URL you use when you login.

Example: localhost/chameleon/

Then press the Get DB Info from Flow URL button. Assuming it is able to connect it will fill in the server, port and database fields with the correct connection information.

Datafeed

The reader requires an API key from Barchart to be able to access the commodity data. You can type in or paste in the key. Then press the Apply key to be saved and have it take effect.The Documentation link will take you to the Barchart API documentation

onlineYou can also specify how often (in seconds) the reader will grab the latest data from the datafeed.

Commodities

...

You can manage the topics and commodities updated by the reader on the Commodities tab.

...

To add a commodity to a topic in the reader:

1. Select the Content Group and then Topic.

2. Type the symbol name of the commodity in the text box beside the Add Symbol button.

   1. Symbols should either be fully specified or use a wildcard notation like this: ZC*1

      1. The *1 indicates that it uses the first contract month for the commodity

      2. You could use *2 to specify the second available month for the commodity

3. If the symbol you typed in is valid it will automatically display the name of the commodity associated to the left of the text box.

4. Press the Add Symbol button.

5. The symbol will be add to the list and the list will be refreshed.

...

1. Login and navigate to the Financials module.

2. Select the appropriate Content Group and Topic

3. Click on the Add New button in the header of the grid showing the current list of commodities

   

4. Provide the required information

   1. Symbol

      1. Symbols should either be fully specified or use a wildcard notation like this: ZC*1

         1. The *1 indicates that it uses the first contract month for the commodity

         2. You could use *2 to specify the second available month for the commodity

   2. Name

   3. Price

5. Press the Add button.

6. The symbol will be added to the list and the list will be refreshed.

...

1. Open the Help menu

2. Click on Check for Updates

3. If updates are available you will then be presented with a button to start downloading the update.

4. Once the update installer has been downloaded you should

   1. close the reader

   and

   2. run the installer

   .

Logging and Debugging

The app will record debug and general operation information to its logs. You can read these logs by using the Help menu and then selecting the appropriate option in the Logs submenu.

...