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.
This procedure describes the steps necessary to export definitions from an Agentry application project. During this process 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.
- 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.
- 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:
- 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:
- 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:
- 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:
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.