System Connection

A system connection sets the connection type the Agentry Server will use to synchronize data with a back end system. A system connection specifies what type of system the Agentry Server is communicating with: SQL Database, Java Virtual Machine, HTTP-XML Server, or File System.

An Agentry application project must have at least one system connection. More system connections can be added if the application requires the Agentry Server to communicate with multiple back end systems. Each system connection may be of different types, or multiple connections for the same type can be defined, depending on the environment in which the mobile application will run.

There are four supported System Connection types:
  • SQL Database - This system type is used when the Agentry Server needs to communicate with a database system using the Structured Query Language, or SQL. This includes database types such as Oracle or SQL Server.
  • Java Virtual Machine - This system type is used when the Agentry Server needs to communicate with an interface using the Java Virtual Machine. This logic is implemented using the Java development language and includes usage of the Agentry Java API.
  • HTTP/XML Server - This system type is used when the Agentry Server needs to communicate with an HTTP server by making HTTP requests that will return structured XML data.
  • File System - This system type is used when the Agentry Server needs to communicate with the host system upon which the Server has been installed, specifically for file access or command-line processing.

The SQL Database and File System connection types have only the two attributes of Name and the ID number. The name is set by the developer when the system connection is defined. The ID number is generated automatically by the Agentry Editor. This ID number ties the definition to the set of configuration options, configured in the Agentry Server.

The Java Virtual Machine connection type contains the additional attribute API Version. This attribute specifies the version of the Agentry Java API to be used by the mobile application. For all new development, version 5 of this API should be used. Version 4 is available for existing applications developed on versions of the Agentry Mobile Platform prior to the version 5.0 release.

A system connection defined for the HTTP-XML connection type contains the child definition type Validate User Request. This is an HTTP Request definition intended to validate the client user, as well as to capture user information to be stored in the <<user.info>> SDML data tag.