Developer

Exporting Agentry Application Project Definitions

This procedure describes the steps necessary to export definitions from an Agentry application project.

Prerequisites

The following items must be addressed prior to performing this procedure:

  • The application project to be exported must be open in the Agentry Perspective.
  • Identify the location of the export file to be created by this process and verify read-write and network access to that location.
  • Determine the desired file name and a brief description for the export file that will be useful for later reference and identification. This information is entered during the export process.
  • If exporting a subset of the definitions within the application project, identify and take note of those definitions before proceeding.

Context

During the process of exporting definitions from an Agentry application project, it is possible to select definitions with the application project to be exported, or to export the entire application. When selecting individual definitions, all child definitions to the one selected will also be selected by default. It is possible to export definitions down to the module-level.

This procedure should be performed to:
  • Archive an application project for version control and back up purposes.
  • Export and archive components of a project for version control and back up purposes, or to make available for merge into a master application in a multi-developer effort (see information provided on Team Configuration for an alternative to this manual procedure).

With the release of the Agentry Mobile Platform 6.0 the default behavior is to create a compressed export file (.agxz). The preference pages in Eclipse for the Agentry Editor plug-in provide the ability to change this default behavior to create standard export files. The process for creating an export file is the same regardless of whether or not the file is compressed.

Procedure

  1. To begin the export process, right click the root project node in the Project Explorer view of the open Agentry application project. In the context menu select the item Export...

    This displays the Export type selection screen:


  2. Select the Agentry Project | Export Application item in this screen. Click the [Next >] button.

    This will display the first screen of the Export Wizard where the application definitions to export can be selected:


  3. Within this screen the definitions of the application project are displayed and can be selected for export by checking the associated box for each. Checking a given definition will automatically select all child definitions. Alternately, one or more of the tag buttons to the left of the project can be selected, which will then automatically select all definitions with the associated tag to be exported. To export an entire application project, simply check the root Application node in this screen. Click the [Next >] button to proceed.

    This will display the next screen of the Export Wizard where the name and location for the export file is entered, as well as an optional comment:


  4. In this screen select the location and file name for the export file to be created. Ensure the selected location is one to which the Windows user has read-write privileges and network access where applicable. A comment can also be entered at this time. The contents of the comment field are displayed as tool tip for the export file once it is created. Information concerning the date and time of creation and the version of Agentry are always a part of the tool tip for the file and need not be a part of the comments. Click the [Next >] button to proceed.

    The export will now begin. When completed, the following summary screen is displayed:


  5. Click the [Finish] button to close the Export Wizard.

Results

Completion of this procedure results in the creation of an Agentry Export File containing the selected definitions from the Agentry application project. This file can now be archived in a version control system, made available to other developers for import, or moved or copied to any desired location. It can be used as an import source to create new Agentry application projects or to import definitions into another project where needed.