Show TOC

Starting a Test SessionLocate this document in the navigation structure

To start your test session, set up the Agentry test environment, and import an Agentry client project. Start the client, log in to the test server, then use the test tools. You can stop the client at any time.


  • In Eclipse, install the Agentry Editor plug-in.
  • You must have access to a configured test server and database.
  • The test client application must be published to the test server; defined, configured, and loaded on the server; and ready to serve definitions and data to connected clients.
  • To start the test client, you must import an application project into the Agentry Editor.
  • To specify how the client window is managed, set Agentry test environment preferences.


Test environment client data is stored with the Agentry project that is open in your workspace. Since test environments for Agentry projects are maintained independently of one another, you need not reset your test client each time you switch to a different project.

Best practices for the Agentry test environment:
  • Although you can use only one monitor, but you might want to use two monitors for testing (for example, show Eclipse on one monitor, and the Agentry test environment on the second).
  • For ease of use, maximize the Agentry test environment window.


  1. In Eclipse, you must open an Agentry perspective. Click Start of the navigation path Window Next navigation step Open Perspective Next navigation step Other Next navigation step Agentry (Properties) End of the navigation path (or Agentry (Diagram)).
  2. Import an application project; for example, using Start of the navigation path File Next navigation step Import Next navigation step Agentry Project Next navigation step Exported project into workspace (.agx or .agxz) End of the navigation path.
  3. From the Editor menu, select Start of the navigation path Window Next navigation step Show View Next navigation step Other Next navigation step Agentry Views Next navigation step Test Environment End of the navigation path.
    If you are using two monitors, drag the Agentry test environment tab onto the second monitor.
  4. In the Agentry test environment view, select Start of the navigation path Test Next navigation step Start Test Client End of the navigation path.
    The test client window opens.
  5. From the Select Agentry window, log in and enter the test server URL when prompted. For example: https://<server_name_or_address>.
  6. Use the Agentry test environment tools to test the Agentry test client, for example, select a different platform, force a transmit, use debugging tools, and test locales.
    Note The Agentry test environment status bar indicates current settings or status, such as client status, selected platform, server URL, server debug status, window anchoring, and the current locale.

  7. Use the status bar to check current settings and status. N/A indicates that the Agentry project is not open.
    Status Description
    Client Status
    • RUNNING ‒ the client is running.
    • STOPPED ‒ the client is not running.
    Selected Platform
    • Indicates the platform, for example, Android, iOS, or Windows.
    • Blank indicates that no platform is selected.
    Server URL
    • A URL indicates that an initial transmit has completed for the server.
    • Blank indicates that the initial transmit has not completed for the server.
    Server Debug
    • ON ‒ the server debug feature has been requested.
    • OFF ‒ the server debug feature has not been requested.
    • ANCHORED ‒ the Agentry test client window is anchored.
    • FLOATING ‒ the Agentry test client window is not anchored (default).
    Current Locale Indicates the currently selected or default language, regardless of whether the project is open and the client is running.
  8. At any time, you can stop the test client by logging out or exiting from the application.