...

...

Integration Overview

Transactions to be sent from RJO Hrvyst Hedge to AGRIS

1. New contracts (Purchase or Sales)

   1. Basis

   2. Hedge-To-Arrive

   3. Flat Price

   4. AutoHedge Contracts

2. Changes to a contract (or a portion of a contract)

   1. Edit contract details

   2. Price a contract (including ability to price a portion of a delivery/price schedule)

   3. Roll a contract

3. Cancel a contract

NOTE: The 4 contract types mentioned above will be a one-to-one relationship between Hrvyst Hedge and AGRIS (Basis, HTA, Flat Price, Hedge). If there are more contract types configured in AGRIS, they will not be communicated from Hrvyst Hedge.

Information requested from AGRIS by RJO Hrvyst Hedge

1. Customer Storage Balances

These requests will be for specific customers, locations, and commodities, on an on-demand basis.

Transactions to be sent to RJO Hrvyst Hedge from AGRIS

1. Name/Address Changes (When changes are made to Name, Address, Phone, Email, Active Status)

2. Hedge Transactions (Spot Contracts, Cancel Contracts, Contract Overfills)

3. Configurable by multiple Name ID Types, multiple Locations, and multiple Commodities.

NOTE: All Contracts are expected to originate, be updated and priced from Hrvyst Hedge (except for Spot Contracts). As mentioned above, the only transactions that should originate from AGRIS would be Spot Contracts, Cancel Contracts, and Contract Overfills.

...

• RJO permissions

• Greenstone Datahub Permissions (see “Setup the RJO Hrvyst Hedge Provider“ page)

• Datahub connectivity

• Hook and test connections

• Setup Users on Provider Screen

...

A. AGRIS setup/configuration steps

...

5. CFT Integration Service Setup

Explaining the Service

1. The AGRIS CFT Integration Service is a true Windows Service that is also a Web Server for communicating between AGRIS Clients and the Service via ReST API calls.

2. Within this Service we can support multiple integrations which can all be configured differently. 

   1. We have the concept of starting an individual integration process (which is a thread/task within the Windows Service)

   2. These tasks can run simultaneously and will follow the Interval settings in the CFT Integration Setup for each Extract

 Assumptions (as discussed in above sections):

...

• The CFT integration MUST be configured in the same dataset as the live commodity system.

• You can give any description for the Integration Name (Use the integration name RJO Hrvyst Hedge for example)the description as the Integration Name

• The Dataset Number and Data Path MUST be set to be the current dataset (or blank).

• You can leave the Dataset Number and Data Path blank as long as the current dataset has a UNC path.

• If message below Data Path shows “Blank = (a mapped drive)”, then the Data Path must be filled in with a UNC path.

• The Component Server can be left blank, or point to an AGRIS Web Service server.

• Output Option 3 with Transaction Integration 05 indicates that it is RJO Hrvyst Hedge.

• Select Next to go to the next options on the screen.

• Use CFT Service URL must be set to “Y”.

• The CFT Service URL and the Transaction URL should automatically default for you once you select OK.

  • The CFT Service URL should be http://localhost:9090/api/CftRequest (change if needed)

  • The Transaction URL (NOTE) by default is set to work with PSQL

    • http://localhost:8080/AgrisPSQL/RESTCommandWebService/ExecuteServerCommand/AgentProcessor/AgrisMessage?TransactionType=0

    • IF MSSQL please use this URL replacing local host with the correct server name. http://CULGSSQATS02:8080/AgrisSQL/RESTCommandWebService/ExecuteServerCommand/AgentProcessor/AgrisMessage?TransactionType=0

• The CFT Service is a new service installed with AGRIS, that will retrieve transactions from the AGRIS database via the AGRIS Web Service and send them to the Transaction URL (SOGE Agent).

• The Transaction URL (SOGE Agent) will then send the transactions to the hosted Greenstone Data Hub, which will send them on to RJO Hrvyst Hedge.

...

Note that this is “Screen #1 of 6”. You may wish to include information from other screens.

8. Import modify the configuration.

Set the import modify feature to support unique info from the hrvyst system.

...

*Note all configurations below will drive the same value in AGRIS.. if a specific value is needed for some fields on a contract vs a different value for other contracts when interfacing with RJO hrvyst… contact your RJO representative for additional instruction.

1. Navigate to Maintenance>Import Maintenace>Insert, to add new import

   1. Name the import RJO Hrvyst Hedge (note as discussed in step 6 it must be RJO Hrvyst Hedge)

2. Contract Header details

   1. Contract Signed status - Force to “N”

   2. Transporation mode - Set to “T” if this is the expected contract type for all contracts.

3. Contract Schedule details - custom field configuration.

   1. Determine what transaction code should be used to identify that the contract originated in RJO Hrvyst

   2. Configure any remaining schedule configuration for “ALL” contract schedule required fields that would be the same for all contracts.

4. Contract schedule details - standard field configuration

   1. Board name

   2. Signed

   3. Transport mode

5. Import Maintenance screen Import Path & File Names should be left as defaulted in.

...

9. Import the reports/widgets to manage the Hrvyst Interface

Import and configure the widget to manage the status from AGRIS, GDH and RJO hrvyst system.

1. Download the attached zip

   1. Send the following to the customer

1. Extract to the AGRIS/Support/CFT folder on the AGRIS database server.

2. Import using the Transfer reports and forms

   1. Image Added
   2. Image Added
   3. Image Added

3. Enable the reports for the user who is managing as a Dashboard widget.

   1. Image Added
   2. Image Added

Click https://culturatech.atlassian.net/wiki/x/NwBaY for instructions on

• How to Monitor the Hryvst Integration

• How to Balance the Position between AGRIS and Hrvyst

...