How can we help?

DataXchange Service

You are here:
< All Topics

Overview

The DataXchange Service, referred to as the DX Service, is the engine of the collection process. The Service communicates with the equipment and evaluates expressions to determine what data should be entered into the data collection system. The DX Service is a separate installation and should be installed on all computers in the plant that will actually be communicating with the equipment. At least one DX Service is required, but additional services can be installed to distribute the load if there is a large quantity of equipment or multiple physical locations.

Each DX Service that is installed needs to be defined in the Manage → DX Service section. All Services that have been defined will show in the drop down menu when the DataXchange → Connect button is clicked. Each Service can be configured through the client application by connecting to the Service.

Connecting to the DX Service

The application will attempt to connect to the computer running the service using HTTP. Assuming the defaults were used when defining the DataXchange Service in the Manage → DX Service section, the communication will take place over port 80. It is also possible to designate a different port under the DX Service Settings. If you’re interested in changing the port see the how-to. This will guide you through the proper steps on how to change the http communication port of the service.

Once connected the ribbon bar will fill with additional buttons and the current configuration for the connected service will be displayed. Click here for detailed information on these buttons.

Configuring the DX Service

When connected to a DX Service, clicking on the service flag will show the DX Service settings.

The DataXchange service must be configured to use the appropriate account information. 

The Account NumberAccount Password and DX Service Identifier need to be entered. If the information has never been entered then the information from the Account Settings on the User tab and DX Service settings on the Manage tab will be filled in automatically.

Proxy Settings

If a proxy server is used for Internet access the proxy settings can be used to match the required settings for the organization. The majority of the time these settings will not need to be modified. These settings will be copied over from the User tab automatically if they have been configured there.

Advanced Settings

The Advanced Settings outlined below should not be modified unless instructed by authorized support personnel. The application has a built in Application Username called DXService and Application Password for the DX Service. An administrator of the system can reset the DXService password if needed.

The Connection Interval determines how often the service will attempt to reconnect to the Cloud services if the connection has been lost. The Maximum Retries determines how many times the service will attempt to insert ‘bad data’. Bad data may be caused by a temporary error on either the client side or the Cloud side. If the Connection Interval is set at 2 minutes, and the Maximum Retires is set at 3600, then the service will attempt to retry the failed records for 120 hours, or 5 days. At that point the bad data will be removed.

The Batch Count determines how many records will be processed at a time when the service is able to reconnect and process records that have been built up.

The Service URL is the web address of the Cloud services.

The HTTP Services Port gives you the ability to change the port at which the service operates on. See the how-to for more clarification on how to change the operating port.

Backing Up the DX Service Configuration

The configuration for the DX service is stored in the cloud database. The configuration can be backed up to a snapshot and then exported later if needed. Details on the snapshot and export process can be found on the Snapshot and Export page.

Updating the DX Service

The DX Service must be manually installed, but after the initial installation the service will update itself automatically. The details on the update process can be found on the Update page.

Table of Contents